Create Object Using PUT | Cloud Director Object Storage Extension API

Create Object Using PUT

API code: S3_PUT_OBJECT Pre-authorized role(s): ANONYMOUS_USER or TENANT_ADMIN or TENANT_USER

Request

URI

PUT

https://{api_host}//localhost/api/v1/s3/{bucketName}/{objectKey}

COPY

Path Parameters

string

bucketName

Required

The bucket name. It must be URL encoded.

string

objectKey

Required

The object key. It must be URL encoded.

Header Parameters

string

Cache-Control

Optional

Can be used to specify caching behavior along the request/reply chain.

string

Content-Disposition

Optional

Specifies presentational information for the object.

string

Content-Encoding

Optional

Specifies the content encodings that have been applied to the object and which decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

string

Content-Language

Optional

The language that the content uses.

string

Content-Length

Optional

The size of the resource, in bytes.

string

Content-MD5

Optional

The base64-encoded 128-bit MD5 digest of the part data.

string

Content-Type

Optional

A standard MIME type that describes the format of the object data.

string

Expires

Optional

The date and time at which the object should no longer be cached.

string

x-amz-acl

Optional

The ACL of the bucket using the specified canned ACL. Valid Values: private | public-read | public-read-write | authenticated-read.

string

x-amz-grant-full-control

Optional

Allows grantee the READ, WRITE, READ_ACP, and WRITE_ACP permissions on the bucket.

string

x-amz-grant-read

Optional

Allows the specified grantee(s) to list the objects in the bucket.

string

x-amz-grant-read-acp

Optional

Allows the specified grantee(s) to read the bucket ACL.

string

x-amz-grant-write

Optional

Allows the specified grantee(s) to create, overwrite, and delete any object in the bucket.

string

x-amz-grant-write-acp

Optional

Allows the specified grantee(s) to write the ACL for the applicable bucket.

string

x-amz-meta-*

Optional

Headers starting with x-amz-meta-* are user-defined metadata. Each one is sent and returned as a set of key-value pairs.

string

x-amz-object-lock-legal-hold

Optional

Specifies whether a legal hold will be applied to this object.

string

x-amz-object-lock-mode

Optional

The Object Lock mode that you want to apply to this object.

string

x-amz-object-lock-retain-until-date

Optional

The date and time when you want this object's Object Lock to expire.

string

x-amz-request-payer

Optional

Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests.

string

x-amz-server-side-encryption

Optional

The server-side encryption algorithm for current object.

string

x-amz-server-side-encryption-aws-kms-key-id

Optional

The ID of the Key Management Service that was used for the object.

string

x-amz-server-side-encryption-context

Optional

Specifies the AWS KMS Encryption Context to use for object encryption. The value of this header is a base64-encoded UTF-8 string holding JSON with the encryption context key-value pairs.

string

x-amz-server-side-encryption-customer-algorithm

Optional

The algorithm used during SSE-C encryption.

string

x-amz-server-side-encryption-customer-key

Optional

The 256-bit, base64-encoded key used to encrypt or decrypt data.

string

x-amz-server-side-encryption-customer-key-md5

Optional

The base64-encoded 128-bit MD5 digest of the encryption key.