MENU
      PostObject

        PostObject


        Article summary

        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.

        MethodURI
        POST/v1/AUTH_{project_id}/{container}/{object}

        Request headers

        The following describes the headers.

        FieldTypeRequiredDescription
        X-Auth-TokenStringOptionalValue of the issued token
        X-Object-Meta-{name}StringOptionalMetadata to set
        • Enter the key for the metadata in the {name} part
        • Enter the metadata value in the header value
        X-Delete-AtIntegerOptionalScheduled 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-AfterIntegerOptionalWhen 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-DispositionStringOptionalBrowser's response handling method
        Content-EncodingStringOptionalObject's encoding method
        Content-TypeStringOptionalObject's MIME type

        Request path parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        project_idStringRequiredProject ID
        containerStringRequiredName of the container where the target object is stored
        objectStringRequiredTarget object name

        Request query parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        bulk-deleteStringOptionalDelete 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-archiveStringOptionalUpload 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'
        Curl

        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 codeCodeMessageDescription
        202-AcceptedRequest 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
        HTTP

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.