---
title: "Agregar metadatos al objeto"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/put-object-meta/
description: "Esta API te permite crear una firma para el bucket."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Agregar metadatos al objeto

### Descripción

Esta API te permite agregar metadatos al [objeto](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/) requerido almacenado en un bucket. El bucket se referencia por su [nombre único de bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket), y el objeto requerido se referencia usando su nombre.

> **Nota:**

* Puedes usar caracteres alfanuméricos, guiones bajos o caracteres de espacio en blanco, así como guiones, para escribir tus metadatos. No se permite ningún otro carácter especial aparte de los mencionados.

* Puedes obtener los metadatos de un objeto usando el método de solicitud `HEAD`. En la respuesta, los metadatos se listarán en la clave '`x-user-meta`'.

* El límite máximo de tamaño de caracteres permitido para los metadatos en general es de **2047** caracteres. El conteo de caracteres usado para determinar el límite de tamaño también incluye el carácter especial dos puntos ":" usado para definir el par clave-valor.

### Detalles de la solicitud

#### URL de solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/bucket/object/metadata

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### JSON de solicitud

Debes enviar un JSON con sus valores correspondientes como se muestra a continuación.

**Sample Payload**

```json

    {
    "meta_data": {
        "key1": "value1",
        "key2": "value2"
    }
    }

```

Alimentarás este **JSON de solicitud** en tu **cuerpo de la solicitud**, y necesitas proporcionar el valor de:

- **meta_data** ( , mandatory):  Este JSON contendrá los [metadatos](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#metadata) requeridos en forma de pares clave-valor JSON.

#### Parámetros de consulta

- **bucket_name** (Alphanumeric, mandatory): El [nombre del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **object_key** (String, mandatory): Contendrá el nombre completo del objeto.

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.buckets.objects.CREATE

### Detalles de la respuesta

Tras la ejecución exitosa, la respuesta contendrá el mensaje de éxito indicando que los metadatos se han agregado al objeto requerido.

**Sample Request**

```bash

curl -X PUT https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/metadata?bucket_name=myBucketName&object_key=image2.png/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"
-H "Content-Type:application/json"
-\-data-raw $'{"{"meta_data" : {"key1" : "value1","key2" : "value2"}}"}'

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "message": "Metadata added successfully"
    }
    }

```

### SDK Documentation

* [Put Object Meta Data - Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/put-object-meta/)
* [Put Object Meta Data - Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/put-object-meta/)
* [Put Object Meta Data - Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/put-object-meta/)
* [Stratus - Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/overview/)
* [Stratus - iOS SDK](https://docs.catalyst.zoho.com/es/sdk/ios/v2/cloud-scale/stratus/overview/)
* [Stratus - Android SDK](https://docs.catalyst.zoho.com/es/sdk/android/v2/cloud-scale/stratus/overview/)
* [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/stratus/overview/)