public sealed class UploadObjectOptions
Reference documentation and code samples for the Google Cloud Storage v1 API class UploadObjectOptions.
Options for UploadObject
operations.
Namespace
Google.Cloud.Storage.V1Assembly
Google.Cloud.Storage.V1.dll
Fields
MinimumChunkSize
public const int MinimumChunkSize = 262144
The minimum chunk size for uploading.
Field Value | |
---|---|
Type | Description |
int |
Properties
ChunkSize
public int? ChunkSize { get; set; }
The chunk size to use for each request. When setting to a non-null value, this must be a positive multiple of MinimumChunkSize.
Property Value | |
---|---|
Type | Description |
int |
EncryptionKey
public EncryptionKey EncryptionKey { get; set; }
The customer-supplied encryption key to use for this operation. If this property is null, the EncryptionKey will be used instead. Use None to remove encryption headers from this request.
Property Value | |
---|---|
Type | Description |
EncryptionKey |
IfGenerationMatch
public long? IfGenerationMatch { get; set; }
Precondition for upload: the object is only uploaded if the existing object's generation matches the given value.
Property Value | |
---|---|
Type | Description |
long |
IfGenerationNotMatch
public long? IfGenerationNotMatch { get; set; }
Precondition for upload: the object is only uploaded if the existing object's generation does not match the given value.
Property Value | |
---|---|
Type | Description |
long |
IfMetagenerationMatch
public long? IfMetagenerationMatch { get; set; }
Precondition for upload: the object is only uploaded if the existing object's meta-generation matches the given value.
Property Value | |
---|---|
Type | Description |
long |
IfMetagenerationNotMatch
public long? IfMetagenerationNotMatch { get; set; }
Precondition for upload: the object is only uploaded if the existing object's meta-generation does not match the given value.
Property Value | |
---|---|
Type | Description |
long |
KmsKeyName
public string KmsKeyName { get; set; }
The name of the Cloud KMS key to use to encrypt the object.
Property Value | |
---|---|
Type | Description |
string |
Currently, either customer-supplied encryption or a Cloud KMS key can be used, but not both. If this property is null and customer-supplied encryption is not being used, the bucket encryption defaults will be used to determine the encryption for the object. If this property is non-null and the client object has a default encryption key, the EncryptionKey property of this options object must be set to None to make the intention clear.
Origin
public string Origin { get; set; }
If set, an Origin header is included when initiating the resumable upload. This allows for Cross-Origin Resource Sharing, as documented at https://cloud.google.com/storage/docs/cross-origin.
Property Value | |
---|---|
Type | Description |
string |
PredefinedAcl
public PredefinedObjectAcl? PredefinedAcl { get; set; }
A pre-defined ACL for simple access control scenarios.
Property Value | |
---|---|
Type | Description |
PredefinedObjectAcl |
Projection
public Projection? Projection { get; set; }
The projection of the uploaded object to retrieve.
Property Value | |
---|---|
Type | Description |
Projection |
UploadValidationMode
public UploadValidationMode? UploadValidationMode { get; set; }
Specifies how the upload should be validated for data integrity. If this property is null, this is equivalent to DeleteAndThrow.
Property Value | |
---|---|
Type | Description |
UploadValidationMode |
The hash is only validated at the end of the upload, after the object has been created. An exception is thrown if it's incorrect, but the object will still exist unless the validation action deletes it.
UserProject
public string UserProject { get; set; }
If set, this is the ID of the project which will be billed for the request. The caller must have suitable permissions for the project being billed.
Property Value | |
---|---|
Type | Description |
string |