S3 Post Add Object

S3 Post Add Object

API code: S3_POST_ADD_OBJECT
Pre-authorized role(s): TENANT_USER | TENANT_ADMIN | ANONYMOUS

Request
URI
POST
https://{api_host}//api/v1/s3/{bucketName}/{objectKey}
COPY
Path Parameters
string
bucketName
Required

The bucket name. It must be URL encoded.

Query Parameters
acl
Optional

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

file
Optional

The object to be uploaded.

key
Optional

The name of the uploaded object.

tagging
Optional

Specifies a set of tags to associate with the object.

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.

x-amz-server-side-encryption
Optional

The server-side encryption algorithm for current object.

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

The algorithm used during SSE-C encryption.

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

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

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

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

Header Parameters
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.


Request Body
{
    "file": "string"
}
string As binary As binary
file
Required

file

Authentication
This operation uses the following authentication methods.
Responses
200

Success

Returns PostResponse of type(s) application/json
{
    "bucket": "string",
    "etag": "string",
    "key": "string",
    "location": "string"
}
string
bucket
Optional

bucket

string
etag
Optional

etag

string
key
Optional

key

string
location
Optional

location

Response Headers

undefined
ETag

${api_response_header.etag}

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

${api_response_header.customerKeyMD5}

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

${api_response_header.customerAlgorithm}

undefined
x-amz-server-side-encryption

${api_response_header.sse}

undefined
Location

${api_response_header.location}