---
title: "Verificar disponibilidad del objeto"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/head-object/
description: "Esta API te permite verificar si un objeto particular está presente en un bucket."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Verificar disponibilidad del objeto

### Descripción

Esta API te permite verificar si un [objeto](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/) particular está 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.

Si el [versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) está habilitado, entonces el objeto requerido también se puede referenciar usando su `version ID` único.

### Detalles de la solicitud

#### URL de solicitud

`HEAD` {api-domain}/baas/v1/project/{project_id}/bucket/objects

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

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

- **version_id** (String, optional): Este es un ID generado por Stratus cuando el versionado está habilitado. Puedes usar `version_id` para referenciar al objeto requerido.

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

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.buckets.objects.READ

### Detalles de la respuesta

Tras la ejecución exitosa, la respuesta contendrá el código de estado **200**, para indicar que el objeto está presente en el bucket. Si el objeto es incorrecto o no está presente en el bucket, obtendrás un código de estado **404** como respuesta.

**Sample Request**

```bash

curl -X HEAD https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object?bucket_name=myBucketName&object_key=image.jpeg&version_id=dfd233fcds2wd223/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

### SDK Documentation

* [Check Object Availability - Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/check-object-availability/)
* [Check Object Availability - Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/check-object-availability/)
* [Check Object Availability - Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/check-object-availability/)
* [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/)