PostObject

Prev Next

Available in Classic and VPC

Set or change metadata of an object.

Requests

The following describes the request format for the endpoint. The request format is as follows.

Method URI
POST /v1/AUTH_{project_id}/{container}/{object}

Request headers

The following describes the headers.

Field Type Required Description
X-Auth-Token String Optional Value of the issued token
X-Object-Meta-{name} String Optional Metadata to set
  • Enter the key for the metadata in the {name} part
  • Enter the metadata value in the header value
X-Delete-At Integer Optional Scheduled time for automatic deletion of the object (Unix timestamp)
  • Use when you want to temporarily store data
  • It deletes the object at the entered date and time
X-Delete-After Integer Optional When to delete the object automatically (enter in seconds)
  • Use when you want to temporarily store data
  • It deletes the object after the entered time from the time of upload
  • It takes precedence when used concurrently with the X-Delete-At header
Content-Disposition String Optional Browser's response handling method
Content-Encoding String Optional Object's encoding method
Content-Type String Optional Object's MIME type

Request path parameters

The following describes the parameters.

Field Type Required Description
project_id String Required Project ID
container String Required Name of the container where the target object is stored
object String Required Target object name

Request query parameters

The following describes the parameters.

Field Type Required Description
bulk-delete String Optional Delete multiple objects and containers at once
  • Up to 10,000 can be requested
  • Enter the deletion target in the request body after entering the key
extract-archive String Optional Upload compressed file
  • Enter the file extension to decompress as a value
  • Uploaded files are automatically unzipped and saved to a specified location

Request example

The following is a sample request.

curl -L -X POST 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C3' \
-H 'X-Delete-After: 3600' \
-H 'X-Object-Meta-Row: C3-A8'

Responses

The following describes the response format.

Response headers

For headers common to all Archive Storage APIs, see Archive Storage common headers.

Response status codes

The following describes the response status codes.

HTTP status code Code Message Description
202 - Accepted Request succeeded

Response example

The following is a sample response.

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
X-Openstack-Request-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
Date: Mon, 17 Sep 2018 09:27:37 GMT