Objectの名前変更と移動操作
オブジェクトの名前変更と移動には、同じrenameObject() SDKメソッドを使用します。以下のコードスニペットで使用されているBucket参照は、コンポーネントインスタンスです。
Info: このSDKメソッドを使用するには、Adminスコープで初期化する必要があります。この要件の詳細については、このセクションをご覧ください。
使用パラメータ
| Parameter Name | Data Type | Definition |
|---|---|---|
| key | String | 名前を変更する必要があるオブジェクトの元の名前 |
| destination | String | オブジェクトの新しい名前 |
Note:
-
keyとdestinationの両方の値には、パスとともに完全なオブジェクト名を指定する必要があります。
-
たとえば、パスpictures/puppyに「kitten.png」というファイルがあり、そのファイルをpictures/kittenパスに名前変更または移動する必要がある場合:
keyの値は「pictures/puppy/kitten.png」になります
destinationの値は「pictures/kitten/kitten.png」になります
Objectの名前変更
renameObject() SDKメソッドを使用して、Bucket内のオブジェクトの名前を変更できます。
Info: このSDKメソッドを使用するには、Adminスコープで初期化する必要があります。この要件の詳細については、このセクションをご覧ください。
Note:
-
Versioningが有効なBucket内のオブジェクトの名前を変更することはできません。
-
パスまたはオブジェクトを作成する際、スペースを含む以下の文字はサポートされていません:ダブルクォーテーション、両方の山括弧、ハッシュタグ、バックスラッシュ、パイプ記号。
copy
const res = await bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt");
console.log(res);
Objectの移動
renameObject() SDKメソッドを使用して、Bucket内のあるパスから別のパスにオブジェクトを移動できます。
copy
const moveRes = await bucket.renameObject("sam/out/sample.txt", "out/sample.txt");
console.log(moveRes);
Note: Versioningが有効なBucketでは移動操作を実行できません。
名前変更と移動操作のレスポンス例
copy
{
"current_key": "sam/out/sample.txt",
"message": "Rename successful",
"rename_to": "sam/out/update_sample.txt"
}
最終更新日 2026-02-23 18:09:41 +0530 IST
Yes
No
Send your feedback to us
Skip
Submit