Object Storage-Objekt umbenennen
Benennen Sie ein Objekt in einem Object Storage-Bucket um.
Informationen zur Objektbenennung finden Sie unter Objektnamen.
Verwenden Sie den Befehl oci os object rename und die erforderlichen Parameter, um ein Objekt in einem Bucket umzubenennen:
oci os object rename --bucket-name bucket_name --name object_original_name --new-name object_new_name [OPTIONS]
Beispiel:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e" }
Objekt mit einem bestimmten Entitytag umbenennen
Wenn der Umbenennungsvorgang davon abhängig sein soll, dass das Objekt ein bestimmtes Entitytag aufweist, verwenden Sie die Option
--src-obj-if-match-e-tag
.Beispiel:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --src-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Objekt überschreiben
Bei Umbenennungsvorgängen, bei denen Sie ein Objekt in einem Bucket mit einem anderen überschreiben möchten, können Sie die Umbenennung von einem bestimmten Entitytag abhängig machen. Verwenden Sie dazu die Option
--new-obj-if-match-e-tag
.Beispiel:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Überschreiben von Objekten verhindern
Beim Umbenennen eines Objekts können Sie mit der Option
--new-obj-if-none-match-e-tag *
verhindern, dass ein anderes Objekt im selben Bucket überschrieben wird. Mit dieser Option wird verhindert, dass der Umbenennungsvorgang abgeschlossen wird, wenn bereits ein Objekt mit dem angegebenen--new-name
-Wert und demselben Entitytag des Quellobjekts vorhanden ist.Beispiel:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-none-match-e-tag *
Eine vollständige Liste der Parameter und Werte für CLI-Befehle ist in der CLI-Befehlsreferenz enthalten.
Führen Sie den Vorgang RenameObject aus, um ein Objekt in einem Bucket umzubenennen.
Beim Erstellen einer URL zur Verwendung mit der API fügt Object Storage die Object Storage-Namespace-Zeichenfolge und den Bucket-Namen an:
/n/object_storage_namespace/b/bucket/o/object_name
Der Objektname umfasst alles nach dem
/o/
, was Hierarchieebenen und Präfixzeichenfolgen beinhalten kann.