PostAccount
    • PDF

    PostAccount

    • PDF

    Article Summary

    概要

    アカウントにメタデータを設定及び変更します。

    構文

    POST /v1/AUTH_{project_id}
    

    メタデータヘッダに空の値を入力すると削除リクエストを行えるが、ヘッダに空の値の入力ができないツールがある可能性があります。
    このような場合、X-Account-Meta-nameで空の値をリクエストする代わりにX-Remove-Account-Meta-nameでリクエストすれと実行できます。

    リクエストヘッダ結果
    リクエストヘッダにアカウントメタデータの値がなく、キーのみが存在し、アカウントにキーがすでに存在する場合APIは該当メタデータアイテムを削除します。
    リクエストヘッダにアカウントメタデータの値がなく、キーのみが存在し、アカウントにキーが存在しない場合APIは該当メタデータキーを無視します。
    リクエストヘッダにアカウントメタデータのキーと値がすべて存在し、アカウントにキーがすでに存在する場合APIは該当メタデータをアップデーアします。
    リクエストヘッダにアカウントメタデータのキーと値がすべて存在し、アカウントにキーが存在しない場合APIは該当メタデータを追加します。
    リクエストヘッダにアカウントメタデータが省略されており、アカウントにはすでにメタデータが存在する場合APIは既に存在するメタデータを変更しません。

    メタデータキーは大小文字を区分しないし、ASCII 7-bit文字で構成できます。(ASCII 0-31文字、DEL文字などは除く) underscore文字(_)はhyphen文字(-)に変換されます。
    詳しい内容については該当ドキュメント参照 : HTTP/1.1

    メタデータ値はUTF-8でエンコーディングしてからURLエンコーディングする必要があります。これはHTTP/1.1の基本ルールです。

    リクエスト

    NameInTypeDescription
    project_idpathstringプロジェクトIDを入力します。
    X-Auth-Token (Optional)headerstring発行したToken値を入力します。
    X-Account-Meta-Temp-URL-Key (Optional)headerstringtemporary URLのためのSecret Key値を入力します。
    X-Account-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URLのための2番目のSecret Key値を入力します。
    X-Account-Meta-name (Optional)headerstringアカウントのメタデータを設定します。ヘッダ名のname部分がメタデータのキーの役割をします。
    X-Remove-Account-name (Optional)headerstringアカウントのメタデータを削除します。ヘッダ名のname部分がメタデータのキーの役割をします。

    レスポンス

    NameInTypeDescription
    Dateheaderstring該当リクエストのレスポンス時間です。 (UTC)
    Content-Lengthheaderstringレスポンス結果の長さです。該当リクエストは Response Bodyの内容がないため、リクエスト成功時0です。
    Content-Type (Optional)headerstringレスポンス結果のMIMEタイプです。
    X-Trans-Idheaderstring該当リクエストのトランザクションIDです。
    X-Openstack-Request-Idheaderstring該当リクエストのトランザクションIDです。 (X-Trans-Idと同じです。)

    例示

    リクエスト例示(メタデータ作成)

    curl -i -X POST -H "X-Auth-Token: $token" -H "X-Account-Meta-Book: ncloud-test-book" -H "X-Account-Meta-Subject: ncloud-test-subject" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
    

    レスポンス例示

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

    リクエスト例示(メタデータ修正)

    curl -i -X POST -H "X-Auth-Token: $token" -H "X-Account-Meta-Subject: ncloud-test-sconedSubject" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
    

    レスポンス例示

    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
    

    リクエスト例示(メタデータ削除)

    curl -i -X POST -H "X-Auth-Token: $token" -H "X-Remove-Account-Meta-Subject: x" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
    

    レスポンス例示

    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
    

    リクエストが成功するとNo Content (204)ステータスコードをレスポンスします。


    この記事は役に立ちましたか?

    What's Next
    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.