バケットに設定されている保持ポリシーを照会します。
使用上の注意
バケットに設定された保持ポリシーを照会するには、
oss:GetBucketWorm権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。OSS は、指定された期間にわたってオブジェクトが削除または上書きされないようにする Write Once Read Many (WORM) 方式をサポートしています。 バケットの時間ベースの保持ポリシーを設定できます。 保持ポリシーには、1日から70年の範囲の保持期間があります。
バケットに設定された保持ポリシーがロックされた後、バケットからオブジェクトを読み取ったり、バケットにオブジェクトをアップロードしたりできます。 ただし、バケット内の保持ポリシーとオブジェクトは、保持期間内に削除することはできません。 バケット内のオブジェクトは、保持期間が終了した後にのみ削除できます。
コマンド構文
ossutil api get-bucket-worm -- bucket value [flags]パラメーター | 必須 | 説明 |
-- bucket | String | バケットの名前です。 |
説明
詳細については、「コマンドラインオプション」をご参照ください。
例
examplebucketバケットに設定された保持ポリシーを照会します。
ossutil api get-bucket-worm -- bucket examplebucketexamplebucketバケットに設定された保持ポリシーを照会し、出力をJSONでフォーマットします。
ossutil api get-bucket-worm --bucket examplebucket --output-format jsonexamplebucketバケットに設定された保持ポリシーを照会し、YAMLで出力をフォーマットします。
ossutil api get-bucket-worm --bucket examplebucket --output-format yaml