Agregar metadatos al objeto

Descripción

Esta API te permite agregar metadatos al objeto requerido almacenado en un bucket. El bucket se referencia por su nombre único de 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

copy

project_id

Numerical

El ID único del proyecto

JSON de solicitud

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

Sample Payload
copy
{
"meta_data": {
    "key1": "value1",
    "key2": "value2"
}
}

View more

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 requeridos en forma de pares clave-valor JSON.

Parámetros de consulta

bucket_name Alphanumeric

mandatory

El nombre del 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
copy

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
copy
{
"status": "success",
"data": {
    "message": "Metadata added successfully"
}
}

View more

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit