Google Cloud Storage v1 API - Class UploadObjectOptions (4.6.0)

public sealed class UploadObjectOptions

Reference documentation and code samples for the Google Cloud Storage v1 API class UploadObjectOptions.

Options for UploadObject operations.

Inheritance

object > UploadObjectOptions

Namespace

Google.Cloud.Storage.V1

Assembly

Google.Cloud.Storage.V1.dll

Fields

MinimumChunkSize

public const int MinimumChunkSize = 262144

The minimum chunk size for uploading.

Field Value
TypeDescription
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
TypeDescription
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
TypeDescription
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
TypeDescription
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
TypeDescription
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
TypeDescription
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
TypeDescription
long

KmsKeyName

public string KmsKeyName { get; set; }

The name of the Cloud KMS key to use to encrypt the object.

Property Value
TypeDescription
string
Remarks

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
TypeDescription
string

PredefinedAcl

public PredefinedObjectAcl? PredefinedAcl { get; set; }

A pre-defined ACL for simple access control scenarios.

Property Value
TypeDescription
PredefinedObjectAcl

Projection

public Projection? Projection { get; set; }

The projection of the uploaded object to retrieve.

Property Value
TypeDescription
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
TypeDescription
UploadValidationMode
Remarks

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
TypeDescription
string