バケットのバージョン管理を設定します。
使用上の注意
バケットのバージョン管理状態を設定する前に、PutBucketVersioning権限が必要です。
バケットは、無効、有効、または一時停止のいずれかのバージョン管理状態にすることができます。 デフォルトでは、バケットのバージョン管理は無効になっています。
バケットのバージョン管理が有効になっている場合、バケットに追加されたすべてのオブジェクトに対して一意のバージョンIDが生成されます。 この場合、OSSは複数のバージョンのオブジェクトを保存します。
バケットのバージョン管理が一時停止されている場合、バケットに追加されたすべてのオブジェクトに対してバージョンID nullが生成されます。 この場合、削除または上書きされたオブジェクトの新しいバージョンは保存されません。
バージョン管理の詳細については、「概要」をご参照ください。
コマンド構文
ossutil api put-bucket-versioning -- bucket value -- versioning-configuration value [flags]パラメーター | データ型 | 説明 |
-- bucket | String | バケットの名前です。 |
-- versioning-configuration | String | バージョン管理設定を格納するコンテナー。 |
put-bucket-versioningコマンドは、PutBucketVersioning操作に相当します。 API操作の詳細については、「PutBucketVersioning」をご参照ください。
-- versioning-configuration
-- versioning-configurationオプションは、XMLおよびJSON形式をサポートします。
XML 形式：
<VersioningConfiguration> <Status>string</Status> </VersioningConfiguration>JSON 形式：
{ "Status": "string" }
詳細については、「コマンドラインオプション」をご参照ください。
例
examplebucketという名前のバケットのバージョン管理を構成します。
XML構成ファイルの使用 (この例ではversioning-configuration.xml)
<?xml version="1.0" encoding="UTF-8"?> <VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>サンプルコマンド:
ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.xmlJSON設定ファイルの使用 (この例のversioning-configuration.json)
{ "Status": "Enabled" }サンプルコマンド:
ossutil api put-bucket-versioning -- bucket examplebucket -- versioning-configuration file:// versioning-configuration.jsonコマンドラインでJSONパラメーターを使用する
ossutil api put-bucket-versioning -- bucket examplebucket -- versioning-configuration "{\" Status\":\" Enabled\"}"