post

Classic/VPC環境で利用できます。

アカウント、コンテナー(バケット)またはオブジェクトのメタデータを変更します。コンテナが存在しない場合は、自動的に作成されます。

構文

post構文は次の通りです。

アカウント

swift post \
    [--meta <name:value>] \
    [--header <header:value>]

コンテナ

swift post \
    <container> \
    [--read-acl <acl>] \
    [--write-acl <acl>] \
    [--meta <name:value>] \
    [--header <header:value>]

オブジェクト

swift post \
    <container> <object> \
    [--meta <name:value>] \
    [--header <header:value>]

postの実行時に指定できるオプションについて説明します。

postの必須オプションです。

オプション	タイプ	必須の有無	説明
`<container>`	String	Conditional	コンテナ名未入力の場合、アカウントのメタデータを変更存在しないコンテナを入力した場合、自動作成 `<object>`入力時、必ず入力

postの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`<object>`	String	Optional	オブジェクト名 `<container>`と併せて入力
`--read-acl`	String	Optional	コンテナの読み取り ACL 例: `.r:`、`.r:-.example.com`、`.r:www.example.com`、`account1:`、`account2:user2` `account1`形式は v1.0認証 APIでのみ使用可能全体 ACL構文はOpenStack Swift CLIドキュメントを参照
`--write-acl`	String	Optional	コンテナの書き込み ACL 例: `account1:*`、`account2:user2` 　`account1`形式は v1.0認証 APIでのみ使用可能全体 ACL構文はOpenStack Swift CLIドキュメントを参照
`--meta`	String	Optional	メタデータ項目 `name:value`形式で入力複数メタデータの設定が可能 (例: `--meta name1:value1 --meta name2:value2`)
`--header`	String	Optional	リクエストで使用するユーザー定義ヘッダ `header:value`形式で入力

swiftコマンドで共通して使用するオプションについては、Archive Storageのオプションをご参照ください。

postコマンドを使用してコンテナを作成したり、メタデータを設定したりする例です。

コンテナを作成するコマンドの例は次の通りです。

swift post test-container-01

コンテナにメタデータを設定するコマンドの例は次の通りです。

swift post test-container-01 --meta Purpose:Documentation

リクエストが成功すると、出力される内容はありません。変更後のメタデータはstatで確認できます。