Operaciones de renombrar y mover un objeto

# Operaciones de renombrar y mover un objeto

Para renombrar y mover un objeto, usaremos el mismo método del SDK {{%badge%}}renameObject(){{%/badge%}}.

### Renombrar un objeto

Usando el método del SDK {{%badge%}}renameObject(){{%/badge%}} puedes renombrar objetos presentes en un bucket.

{{%info%}}{{%bold%}}Info:{{%/bold%}} Para usar este método del SDK, necesitas inicializarlo con el scope {{%bold%}}Admin{{%/bold%}}. Puedes obtener más información sobre este requisito en esta {{%link href="/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes" %}}sección{{%/link%}}{{%/info%}}

{{%note%}}{{%bold%}}Nota:{{%/bold%}} 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.{{%/note%}}

**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>{{%badge%}}key{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>El nombre original del objeto que necesitas renombrar</td>
		</tr>
		<tr>
			<td>{{%badge%}}destination{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>El nuevo nombre con el que renombras el objeto</td>
		</tr>
	</tbody>
</table>

#### Fragmento de código de ejemplo 
<br>
{{% panel_without_adjustment header="Package Imports" class="language-java line-numbers" %}}import org.json.simple.JSONObject;{{% /panel_without_adjustment %}}

{{%code class="language-java"%}}JSONObject res = bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt"); 
System.out.println(res);{{%/code%}}

{{%note%}}{{%bold%}}Nota:{{%/bold%}} No puedes renombrar objetos en un bucket que tiene {{%link href="/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}Versioning{{%/link%}} habilitado.{{%/note%}}

### Mover un objeto

Usando el método del SDK {{%badge%}}renameObject(){{%/badge%}}, podemos mover el objeto de una ruta a otra dentro de un bucket.

**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>{{%badge%}}key{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>El nombre completo y la {{%link href="/es/cloud-scale/help/stratus/objects/introduction/#path" %}}ruta{{%/link%}} del objeto que necesitas mover.</td>
		</tr>
		<tr>
			<td>{{%badge%}}destination{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>El nombre completo y la nueva ruta del objeto.</td>
		</tr>
	</tbody>
</table>

{{%note%}}{{%bold%}}Nota:{{%/bold%}}

* Necesitas proporcionar el nombre completo del objeto, junto con la {{%link href="/es/cloud-scale/help/stratus/objects/introduction/#path" %}}{{%bold%}}ruta{{%/bold%}}{{%/link%}} para ambos valores de {{%badge%}}key{{%/badge%}} y {{%badge%}}destination{{%/badge%}}.

* Por ejemplo, si tienes un archivo llamado "{{%badge%}}kitten.png{{%/badge%}}" en la ruta {{%badge%}}pictures/puppy{{%/badge%}}, y necesitas mover el archivo a la ruta {{%badge%}}pictures/kitten{{%/badge%}}, entonces: <br />

El valor de {{%badge%}}key{{%/badge%}} será '{{%badge%}}pictures/puppy/kitten.png{{%/badge%}}'<br />

El valor de {{%badge%}}destination{{%/badge%}} será '{{%badge%}}pictures/kitten/kitten.png{{%/badge%}}'{{%/note%}}<br />

{{%code class="language-java"%}}JSONObject res = bucket.renameObject("sam/out/sample.txt", "output/sample.txt"); 
System.out.println(res);{{%/code%}}<br />

{{%note%}}{{%bold%}}Nota:{{%/bold%}} No puedes realizar operaciones de mover en un bucket que tiene {{%link href="/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}Versioning{{%/link%}} habilitado.{{%/note%}}

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

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

Nombre del parámetro	Tipo de dato	Definición
key	String	El nombre original del objeto que necesitas renombrar
destination	String	El nuevo nombre con el que renombras el objeto

Fragmento de código de ejemplo

Package Imports
copy

         import org.json.simple.JSONObject;
    

copy

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

Parámetros utilizados

Nombre del parámetro	Tipo de dato	Definición
key	String	El nombre completo y la ruta del objeto que necesitas mover.
destination	String	El nombre completo y la nueva ruta del objeto.

Nota:

Necesitas proporcionar el nombre completo del objeto, junto con la ruta 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
copy

         import org.json.simple.JSONObject;
    

copy

         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 habilitado.

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Stratus Component Help Documentation Node.js SDK Python SDK Web SDK iOS SDK Android SDK Flutter SDK REST API

Java SDK

Operaciones del SDK

Operaciones de renombrar y mover un objeto

Renombrar un objeto

Fragmento de código de ejemplo

Mover un objeto

Fragmento de código de ejemplo