---
title: "Operaciones de renombrar y mover un objeto"
url: https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/rename-move-object/
description: "Esta página lista el método del Java SDK para realizar operaciones de renombrar y mover 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: "Node.js SDK"
    url: /es/sdk/nodejs/v2/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 un objeto

Para renombrar y mover un objeto, usaremos el mismo método del SDK `renameObject()`.

### Renombrar un objeto

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 scope **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)

> **Nota:** Los siguientes caracteres, incluido el espacio, no son compatibles al crear una ruta o un objeto: comillas dobles, ambos corchetes angulares, numeral, barra invertida y símbolo de barra vertical.

**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>

#### Fragmento de código de ejemplo 

**Package Imports**

```java
import org.json.simple.JSONObject;
```

```java
JSONObject res = bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt"); 
System.out.println(res);
```

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

### Mover un objeto

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

> **Info:** Para usar este método del SDK, necesitas inicializarlo con el scope **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 completo y la [ruta](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#path) del objeto que necesitas mover.</td>
		</tr>
		<tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>El nombre completo y la nueva ruta del objeto.</td>
		</tr>
	</tbody>
</table>

> **Nota:** 

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

* Por ejemplo, si tienes un archivo llamado "`kitten.png`" en la ruta `pictures/puppy`, y necesitas 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`'

#### Fragmento de código de ejemplo 

**Package Imports**

```java
import org.json.simple.JSONObject;
```

```java
JSONObject res = bucket.renameObject("sam/out/sample.txt", "output/sample.txt"); 
System.out.println(res);
```

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