---
title: "Verificar disponibilidad de objeto"
url: https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/check-object/
description: "Esta página describe el método del Web SDK para verificar si un objeto está presente en un bucket."
last_updated: 2026-03-30T08:10:30Z
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/check-bucket/
  - name: "Node.js SDK"
    url: /es/sdk/nodejs/v2/cloud-scale/stratus/check-bucket/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/check-bucket/
  - 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
---

# Verificar disponibilidad de objeto

Usando el método del SDK `headObject()`, puedes verificar la existencia de un objeto en un bucket y, además, comprobar si el usuario tiene los permisos relevantes para acceder a los objetos presentes en el bucket. La referencia de Bucket utilizada en el fragmento de código a continuación es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/initialize-stratus-instance/#initialize-bucket-instance).

Respuestas posibles al usar este SDK:

* Si el bucket existe y el usuario tiene los permisos relevantes para acceder a los objetos en él, se devolverá la respuesta '**true**'.

* Si el bucket no existe, o si el usuario no tiene permiso para acceder a los objetos en él, se devolverá la respuesta '**false**'.

**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>Un parámetro **obligatorio**. Contendrá el nombre completo del objeto junto con su [ruta](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#path).</td>
		</tr>
		<tr>
			<td>`options`</td>
			<td>**JSON Object**</td>
			<td>Un parámetro **opcional** para contener los siguientes parámetros:
				<ul>
					<li>`versionId`: 
						<ul>
							<li>Un parámetro **String** opcional.</li>
							<li>Si el [Versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) está habilitado para tu bucket, este parámetro te ayudará a hacer referencia a una versión particular usando su Version ID único.</li>
						</ul>
					</li>
					<li>`throwErr`: 
						<ul>
							<li>Un parámetro **Boolean** opcional.</li>
							<li>Si estableces este parámetro como "**true**", lanzará un error cuando el bucket no se encuentre en el proyecto.</li>
							<li>El valor por defecto es "**false**"</li>
						</ul>
					</li>
				</ul>
			</td>
		</tr>
	</tbody>
</table>

### Verificar disponibilidad de objeto sin VersionID

El siguiente método del SDK te proporcionará la `topVersion` (última versión) del objeto en el bucket.

```javascript
// Verificar si un objeto está disponible
const checkObjectAvailability = await bucket.headObject("key")
```

### Verificar disponibilidad de objeto con VersionID

El siguiente método del SDK verificará la disponibilidad de una versión específica del objeto. La versión requerida se referenciará por su `versionId` único.

```javascript
// Verificar si cierta versión de un objeto está disponible

const options = {
	versionId: 'djkfhdiufy762',
	throwErr: false
};
const checkObjectAvailability = await bucket.headObject("key", options)
```

**Respuesta de ejemplo**

```json
{
 	"status": 200,
 	"content": true | false,
 	"message": "OK"
}
```