Blobs
class Blobs extends Resource (View source)
The "blobs" collection of methods.
Typical usage is:
$remotebuildexecutionService = new Google\Service\RemoteBuildExecution(...);
$blobs = $remotebuildexecutionService->blobs;
Methods
Download many blobs at once. The server may enforce a limit of the combined
total size of blobs to be downloaded using this API. This limit may be
obtained using the Capabilities API. Requests exceeding the limit should
either be split into smaller chunks or downloaded using the ByteStream API,
as appropriate. This request is equivalent to calling a Bytestream Read
request on each individual blob, in parallel. The requests may succeed or
fail independently. Errors: * INVALID_ARGUMENT
: The client attempted to
read more than the server supported limit. Every error on individual read
will be returned in the corresponding digest status. (blobs.batchRead)
Upload many blobs at once. The server may enforce a limit of the combined
total size of blobs to be uploaded using this API. This limit may be obtained
using the Capabilities API. Requests exceeding the limit should either be
split into smaller chunks or uploaded using the ByteStream API, as
appropriate. This request is equivalent to calling a Bytestream Write
request on each individual blob, in parallel. The requests may succeed or
fail independently. Errors: INVALID_ARGUMENT
: The client attempted to
upload more than the server supported limit. Individual requests may return
the following errors, additionally: RESOURCE_EXHAUSTED
: There is
insufficient disk quota to store the blob. * INVALID_ARGUMENT
: The Digest
does not match the provided data. (blobs.batchUpdate)
Determine if blobs are present in the CAS. Clients can use this API before uploading blobs to determine which ones are already present in the CAS and do not need to be uploaded again. Servers SHOULD increase the lifetimes of the referenced blobs if necessary and applicable. There are no method-specific errors. (blobs.findMissing)
Fetch the entire directory tree rooted at a node. This request must be
targeted at a Directory stored in the ContentAddressableStorage (CAS). The
server will enumerate the Directory
tree recursively and return every node
descended from the root. The GetTreeRequest.page_token parameter can be used
to skip ahead in the stream (e.g. when retrying a partially completed and
aborted request), by setting it to a value taken from
GetTreeResponse.next_page_token of the last successfully processed
GetTreeResponse). The exact traversal order is unspecified and, unless
retrieving subsequent pages from an earlier request, is not guaranteed to be
stable across multiple invocations of GetTree
. If part of the tree is
missing from the CAS, the server will return the portion present and omit the
rest. Errors: * NOT_FOUND
: The requested tree root is not present in the
CAS. (blobs.getTree)
Details
BuildBazelRemoteExecutionV2BatchReadBlobsResponse
batchRead(string $instanceName, BuildBazelRemoteExecutionV2BatchReadBlobsRequest $postBody, array $optParams = [])
Download many blobs at once. The server may enforce a limit of the combined
total size of blobs to be downloaded using this API. This limit may be
obtained using the Capabilities API. Requests exceeding the limit should
either be split into smaller chunks or downloaded using the ByteStream API,
as appropriate. This request is equivalent to calling a Bytestream Read
request on each individual blob, in parallel. The requests may succeed or
fail independently. Errors: * INVALID_ARGUMENT
: The client attempted to
read more than the server supported limit. Every error on individual read
will be returned in the corresponding digest status. (blobs.batchRead)
BuildBazelRemoteExecutionV2BatchUpdateBlobsResponse
batchUpdate(string $instanceName, BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest $postBody, array $optParams = [])
Upload many blobs at once. The server may enforce a limit of the combined
total size of blobs to be uploaded using this API. This limit may be obtained
using the Capabilities API. Requests exceeding the limit should either be
split into smaller chunks or uploaded using the ByteStream API, as
appropriate. This request is equivalent to calling a Bytestream Write
request on each individual blob, in parallel. The requests may succeed or
fail independently. Errors: INVALID_ARGUMENT
: The client attempted to
upload more than the server supported limit. Individual requests may return
the following errors, additionally: RESOURCE_EXHAUSTED
: There is
insufficient disk quota to store the blob. * INVALID_ARGUMENT
: The Digest
does not match the provided data. (blobs.batchUpdate)
BuildBazelRemoteExecutionV2FindMissingBlobsResponse
findMissing(string $instanceName, BuildBazelRemoteExecutionV2FindMissingBlobsRequest $postBody, array $optParams = [])
Determine if blobs are present in the CAS. Clients can use this API before uploading blobs to determine which ones are already present in the CAS and do not need to be uploaded again. Servers SHOULD increase the lifetimes of the referenced blobs if necessary and applicable. There are no method-specific errors. (blobs.findMissing)
BuildBazelRemoteExecutionV2GetTreeResponse
getTree(string $instanceName, string $hash, string $sizeBytes, array $optParams = [])
Fetch the entire directory tree rooted at a node. This request must be
targeted at a Directory stored in the ContentAddressableStorage (CAS). The
server will enumerate the Directory
tree recursively and return every node
descended from the root. The GetTreeRequest.page_token parameter can be used
to skip ahead in the stream (e.g. when retrying a partially completed and
aborted request), by setting it to a value taken from
GetTreeResponse.next_page_token of the last successfully processed
GetTreeResponse). The exact traversal order is unspecified and, unless
retrieving subsequent pages from an earlier request, is not guaranteed to be
stable across multiple invocations of GetTree
. If part of the tree is
missing from the CAS, the server will return the portion present and omit the
rest. Errors: * NOT_FOUND
: The requested tree root is not present in the
CAS. (blobs.getTree)