---
title: "Objectの名前変更と移動操作"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/rename-move-object/
description: "このページでは、オブジェクトの名前変更と移動操作を実行するためのNode.js SDKメソッドを紹介します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /ja/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /ja/sdk/java/v1/cloud-scale/stratus/rename-move-object/
  - name: "Python SDK"
    url: /ja/sdk/python/v1/cloud-scale/stratus/rename-move-object/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /ja/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /ja/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Objectの名前変更と移動操作

オブジェクトの名前変更と移動には、同じ`renameObject()` SDKメソッドを使用します。以下のコードスニペットで使用されているBucket参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/create-bucket-instance/)です。

> **Info:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、この[セクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご覧ください。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>名前を変更する必要があるオブジェクトの元の名前</td>
		</tr>
		<tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>オブジェクトの新しい名前</td>
		</tr>
	</tbody>
</table>

> **Note:** 

* `key`と`destination`の両方の値には、[**パス**](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#path)とともに完全なオブジェクト名を指定する必要があります。

* たとえば、パス`pictures/puppy`に「`kitten.png`」というファイルがあり、そのファイルを`pictures/kitten`パスに名前変更または移動する必要がある場合：

`key`の値は「`pictures/puppy/kitten.png`」になります

`destination`の値は「`pictures/kitten/kitten.png`」になります

### Objectの名前変更

`renameObject()` SDKメソッドを使用して、Bucket内のオブジェクトの名前を変更できます。

> **Info:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、この[セクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご覧ください。

> **Note:** 

* [Versioning](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効なBucket内のオブジェクトの名前を変更することはできません。

* パスまたはオブジェクトを作成する際、スペースを含む以下の文字はサポートされていません：ダブルクォーテーション、両方の山括弧、ハッシュタグ、バックスラッシュ、パイプ記号。

```javascript
const res = await bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt");
console.log(res);
```

### Objectの移動

`renameObject()` SDKメソッドを使用して、Bucket内のあるパスから別のパスにオブジェクトを移動できます。

```javascript
const moveRes = await bucket.renameObject("sam/out/sample.txt", "out/sample.txt");
console.log(moveRes);
```

> **Note:** [Versioning](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効なBucketでは移動操作を実行できません。

#### 名前変更と移動操作のレスポンス例

```json
{
  "current_key": "sam/out/sample.txt",
  "message": "Rename successful",
  "rename_to": "sam/out/update_sample.txt"
}
```