Class BlobsResource
The "blobs" collection of methods.
Inheritance
Inherited Members
Namespace: Google.Apis.RemoteBuildExecution.v2
Assembly: Google.Apis.RemoteBuildExecution.v2.dll
Syntax
public class BlobsResource
Constructors
BlobsResource(IClientService)
Constructs a new resource.
Declaration
public BlobsResource(IClientService service)
Parameters
Type | Name | Description |
---|---|---|
Google.Apis.Services.IClientService | service |
Methods
BatchRead(BuildBazelRemoteExecutionV2BatchReadBlobsRequest, String)
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.
Declaration
public virtual BlobsResource.BatchReadRequest BatchRead(BuildBazelRemoteExecutionV2BatchReadBlobsRequest body, string instanceName)
Parameters
Type | Name | Description |
---|---|---|
BuildBazelRemoteExecutionV2BatchReadBlobsRequest | body | The body of the request. |
System.String | instanceName | The instance of the execution system to operate against. A server may support multiple instances of the execution system (with their own workers, storage, caches, etc.). The server MAY require use of this field to select between them in an implementation-defined fashion, otherwise it can be omitted. |
Returns
Type | Description |
---|---|
BlobsResource.BatchReadRequest |
BatchUpdate(BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest, String)
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.
Declaration
public virtual BlobsResource.BatchUpdateRequest BatchUpdate(BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest body, string instanceName)
Parameters
Type | Name | Description |
---|---|---|
BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest | body | The body of the request. |
System.String | instanceName | The instance of the execution system to operate against. A server may support multiple instances of the execution system (with their own workers, storage, caches, etc.). The server MAY require use of this field to select between them in an implementation-defined fashion, otherwise it can be omitted. |
Returns
Type | Description |
---|---|
BlobsResource.BatchUpdateRequest |
FindMissing(BuildBazelRemoteExecutionV2FindMissingBlobsRequest, String)
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.
Declaration
public virtual BlobsResource.FindMissingRequest FindMissing(BuildBazelRemoteExecutionV2FindMissingBlobsRequest body, string instanceName)
Parameters
Type | Name | Description |
---|---|---|
BuildBazelRemoteExecutionV2FindMissingBlobsRequest | body | The body of the request. |
System.String | instanceName | The instance of the execution system to operate against. A server may support multiple instances of the execution system (with their own workers, storage, caches, etc.). The server MAY require use of this field to select between them in an implementation-defined fashion, otherwise it can be omitted. |
Returns
Type | Description |
---|---|
BlobsResource.FindMissingRequest |
GetTree(String, String, Int64)
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.
Declaration
public virtual BlobsResource.GetTreeRequest GetTree(string instanceName, string hash, long sizeBytes)
Parameters
Type | Name | Description |
---|---|---|
System.String | instanceName | The instance of the execution system to operate against. A server may support multiple instances of the execution system (with their own workers, storage, caches, etc.). The server MAY require use of this field to select between them in an implementation-defined fashion, otherwise it can be omitted. |
System.String | hash | The hash. In the case of SHA-256, it will always be a lowercase hex string exactly 64 characters long. |
System.Int64 | sizeBytes | The size of the blob, in bytes. |
Returns
Type | Description |
---|---|
BlobsResource.GetTreeRequest |