MENU
      PostAccount

        PostAccount


        Article summary

        Available in Classic and VPC

        Set or change metadata for an account.

        Requests

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

        MethodURI
        POST/v1/AUTH_{project_id}

        Request headers

        The following describes headers.

        FieldTypeRequiredDescription
        X-Auth-TokenStringRequiredValue of the issued token
        X-Account-Meta-Temp-URL-KeyStringOptionalSecret key value for the temporary URL
        X-Account-Meta-Temp-URL-Key-2StringOptionalSecond secret key value for the temporary URL
        X-Account-Meta-nameStringOptionalSet metadata for the account
        • The name part of the header name acts as a key for metadata
        X-Remove-Account-nameStringOptionalDelete metadata from the account
        • The name part of the header name acts as a key for metadata
        Note

        You can request deletion by entering an empty value in the metadata X-Account-Meta-name header, but some tools may not allow you to enter an empty value in the header.
        In this case, make the request with X-Remove-Account-Meta-name.

        The result of the request based on the request header settings is as follows.

        Request headersResult
        If the request header contains no values in the account metadata, only a key, and the key already exists in the accountThe API deletes the applicable metadata item
        If the request header contains no value of account metadata, only a key, and the key does not exist in the account.The API ignores the applicable metadata key
        If both the key and value of the account metadata are present in the request header, and the key already exists in the accountThe API updates the applicable metadata
        If both the key and value of the account metadata are present in the request header, and the key does not exist in the accountThe API adds the applicable metadata
        If the request header omits account metadata, and the account already has the metadataThe API doesn't change metadata that already exists
        Note
        • Metadata keys are not case sensitive and can be composed of any ASCII 7-bit character. However, this excludes ASCII characters 0 - 31, the DEL character, etc.
          • The underscore character (_) is converted to a hyphen character (-).
          • For more information, see [HTTP/1.1](https://www.w3.org/Protocols/rfc2616/rfc2616.html){target="_blank"}.
        • Metadata values must be UTF-8 encoded and then URL encoded. This is the default rule for HTTP/1.1.

        Request path parameters

        The following describes the request path parameters.

        FieldTypeRequiredDescription
        project_idStringRequiredProject ID

        Request example

        The following is a sample request.

        Request metadata creation

        The following is a sample request of creating metadata.

        curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
        -H "X-Auth-Token: $token"
        -H "X-Account-Meta-{name}: $account-metadata-string"
        Curl

        Request metadata modification

        The following is a sample request of editing metadata.

        curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
        -H "X-Auth-Token: $token"
        -H "X-Account-Meta-{name}: $account-metadata-string"
        Curl

        Request metadata deletion

        The following is a sample request of deleting metadata.

        curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
        -H "X-Auth-Token: $token"
        -H "X-Remove-Account-Meta-{name}: $account-metadata-string"
        Curl

        Responses

        The following describes the response format.

        Response headers

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

        Response example

        The following is a sample response.

        Response when requesting creation of metadata

        The following is a sample response when requesting to create metadata.

        HTTP/1.1 204 No Content
        Content-Type: text/html; charset=UTF-8
        Content-Length: 0
        X-Trans-Id: txad3702ae436640d1a9897-005b975c51
        X-Openstack-Request-Id: txad3702ae436640d1a9897-005b975c51
        Date: Tue, 11 Sep 2018 06:10:25 GMT
        HTTP

        Response when requesting modification of metadata

        The following is a sample response when requesting to edit metadata.

        HTTP/1.1 204 No Content
        Content-Length: 0
        Content-Type: text/html; charset=UTF-8
        X-Trans-Id: txc5a65e1d20074023912c6-005b975c97
        X-Openstack-Request-Id: txc5a65e1d20074023912c6-005b975c97
        Date: Tue, 11 Sep 2018 06:11:35 GMT
        HTTP

        Response when requesting deletion of metadata

        The following is a sample response when requesting to delete metadata.

        HTTP/1.1 204 No Content
        Content-Length: 0
        Content-Type: text/html; charset=UTF-8
        X-Trans-Id: txf2874df785bd470eaf3b8-005b975d40
        X-Openstack-Request-Id: txf2874df785bd470eaf3b8-005b975d40
        Date: Tue, 11 Sep 2018 06:14:24 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.