---
title: "Operaciones de renombrar y mover en un objeto"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/rename-move-object/
description: "Esta página enumera el método del SDK de Python 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: "Node.js SDK"
    url: /es/sdk/nodejs/v2/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 `rename_object()`. La referencia de Bucket utilizada en el siguiente fragmento de código es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/create-bucket-instance/).
**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) para ambos valores `sourceObject` y `destObject`.
* Por ejemplo, si tienes un archivo llamado "`kitten.png`" en la ruta `pictures/puppy`, y necesitas mover o renombrar 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`'

### Renombrar un objeto
Usando el método del SDK `rename_object()` puedes renombrar objetos presentes en un bucket.

> **Info:** Para utilizar este método del SDK, necesitas inicializarlo con el alcance **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 tenga [Versioning](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) habilitado.
* Los siguientes caracteres, incluido el espacio, no son compatibles cuando creas una ruta o un objeto: comillas dobles, ambos corchetes angulares, hashtag, barra invertida y símbolo de barra vertical.

```python
rename_res = bucket.rename_object("sam/out/sample.txt","sam/out/update_sample.txt")
print(rename_res)
```

#### Respuesta de ejemplo

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

### Mover un objeto
Usando el método del SDK `rename_object()`, podemos mover el objeto de una ruta a otra dentro de un bucket. La referencia de Bucket utilizada en el siguiente fragmento de código es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/create-bucket-instance/).

> **Info:** Para utilizar este método del SDK, necesitas inicializarlo con el alcance **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)

```python
rename_res = bucket.rename_object("sam/out/sample.txt","output/sample.txt")
print(rename_res)
```

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

#### Respuesta de ejemplo

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