---
title: "Operaciones de renombrar y mover en un objeto"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/rename-move-object/
description: "Esta página lista el método del SDK de Node.js para realizar operaciones de renombrar y mover en un objeto."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /es/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /es/sdk/java/v1/cloud-scale/stratus/rename-move-object/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/rename-move-object/
  - name: "Web SDK"
    url: /es/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /es/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /es/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /es/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /es/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Operaciones de renombrar y mover en un objeto

Para renombrar y mover un objeto, usaremos el mismo método del SDK `renameObject()`. La referencia del Bucket utilizada en el fragmento de código a continuación es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/create-bucket-instance/).

> **Info:** Para usar este método del SDK, necesitas inicializarlo con el ámbito **Admin**. Puedes obtener más información sobre este requisito en esta [sección](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

**Parámetros utilizados**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Nombre del parámetro</th>
			<th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>El nombre original del objeto que necesitas renombrar</td>
		</tr>
		<tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>El nuevo nombre con el que renombras el objeto</td>
		</tr>
	</tbody>
</table>

> **Note:** 

* Necesitas proporcionar el nombre completo del objeto, junto con la [**ruta**](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#path) tanto para los valores de `key` como de `destination`.

* Por ejemplo, si tienes un archivo llamado "`kitten.png`" en la ruta `pictures/puppy`, y necesitas renombrar o mover el archivo a la ruta `pictures/kitten`, entonces: 

El valor de `key` será '`pictures/puppy/kitten.png`'

El valor de `destination` será '`pictures/kitten/kitten.png`'

### Rename an Object

Usando el método del SDK `renameObject()` puedes renombrar objetos presentes en un bucket.

> **Info:** Para usar este método del SDK, necesitas inicializarlo con el ámbito **Admin**. Puedes obtener más información sobre este requisito en esta [sección](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

> **Note:** 

* No puedes renombrar objetos en un bucket que tiene el [Versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) habilitado.

* Los siguientes caracteres, incluyendo el espacio, no son compatibles cuando creas una ruta o un objeto: comilla doble, ambos corchetes angulares, hashtag, barra invertida y símbolo de barra vertical.

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

### Move an Object

Usando el método del SDK `renameObject()`, podemos mover el objeto de una ruta a otra dentro de un bucket.

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

> **Note:** No puedes realizar operaciones de mover en un bucket que tiene el [Versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) habilitado.

#### Respuesta de ejemplo para operaciones de renombrar y mover

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