---
title: "Agregar metadatos de un objeto"
url: https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/put-object-meta/
description: "Esta página lista el método del Java SDK para agregar metadatos a un objeto almacenado en el 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: "Object Metadata Help Documentation"
    url: /es/cloud-scale/help/stratus/objects/introduction/#metadata
  - name: "Node.js SDK"
    url: /es/sdk/nodejs/v2/cloud-scale/stratus/put-object-meta/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/put-object-meta/
  - 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
---

# Agregar metadatos de un objeto

Usando el siguiente método del SDK, puedes agregar [detalles de metadatos](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#metadata) para un objeto particular almacenado en un bucket en Stratus. La referencia de Object utilizada en el siguiente fragmento de código es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/create-object-instance/).

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

Los detalles de metadatos se pasarán como pares clave-valor JSON. Por ejemplo, {"meta_key" : "meta_value"}

> **Nota:**

* Puedes usar caracteres alfanuméricos, guiones bajos o espacios 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 utilizado para determinar el límite de tamaño también incluye el carácter especial de dos puntos ":" utilizado para definir el par clave-valor.

#### Fragmento de código de ejemplo 

**Package Imports**

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

```java
HashMap<String, String> objectMeta = new HashMap<>();
objectMeta.put("key1", "value1");
objectMeta.put("key2", "value2");
JSONObject res = object.putMeta(objectMeta);
System.out.println(res);
```

> **Nota:** Usar este método para pasar nuevos detalles de metadatos sin agregar los detalles existentes eliminará los detalles existentes y solo colocará los nuevos detalles. Para evitar esto, pasa los nuevos detalles de metadatos junto con los detalles de metadatos existentes.

**Respuesta de ejemplo**

```json
{
    "message": "Metadata added successfully"
}
```