PostObject

Article summary

Did you find this summary helpful?

Thank you for your feedback

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 For more information on how to check the project ID, see Archive Storage overview
`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

Was this article helpful?

What's Next

GetContainerList

Table of contents

Requests
Responses