オブジェクト・ストレージ・オブジェクトの名前変更
Object Storageバケット内のオブジェクトの名前を変更します。
オブジェクトのネーミングの詳細は、オブジェクト名を参照してください。
バケット内のオブジェクトの名前を変更するには、oci os object renameコマンドと必要なパラメータを使用します:
oci os object rename --bucket-name bucket_name --name object_original_name --new-name object_new_name [OPTIONS]
例:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e" }
特定のエンティティ・タグを持つオブジェクトの名前変更
名前の変更操作を特定のエンティティ・タグを持つオブジェクトに依存させるには、
--src-obj-if-match-e-tag
オプションを使用します例:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --src-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
オブジェクトの上書き
バケット内のあるオブジェクトを別のオブジェクトで上書きする名前変更操作では、特定のエンティティ・タグがあるかどうかに依存した名前変更を行うことができます。これを行うには、
--new-obj-if-match-e-tag
オプションを使用します例:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
オブジェクトの上書きの防止
オブジェクトの名前を変更する際、
--new-obj-if-none-match-e-tag *
オプションを使用することで、同じバケット内の別のオブジェクトが上書きされないようにできます。このオプションは、指定された--new-name
値とソース・オブジェクトの同じエンティティ・タグを持つオブジェクトが存在する場合、名前の変更操作が完了しないようにします。例:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-none-match-e-tag *
CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。
RenameObject操作を実行して、バケット内のオブジェクトの名前を変更します。
オブジェクト・ストレージは、APIで使用するURLを作成する際に、オブジェクト・ストレージ・ネームスペース文字列とバケット名をオブジェクト名の先頭に付加します:
/n/object_storage_namespace/b/bucket/o/object_name
オブジェクト名は、
/o/
の後のすべてになります。これには、階層レベルおよび接頭辞文字列を含めることができます。