---
title: "Verificar disponibilidad de objeto"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/check-object-availability/
description: "Esta página enumera el método del SDK de Node.js para verificar si un objeto está presente en un bucket."
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: "Java SDK"
    url: /es/sdk/java/v1/cloud-scale/stratus/check-object-availability/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/check-object-availability/
  - 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
---

# Verificar disponibilidad de objeto

Usando este método del SDK, puedes verificar si un objeto particular está presente en el bucket, si el usuario tiene los permisos requeridos para acceder al objeto. 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/nodejs/v2/cloud-scale/stratus/create-bucket-instance/).

Si has habilitado el [Versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) para tu bucket, entonces necesitas pasar el `versionID` como parámetro, para verificar si una versión particular del objeto está disponible.

> **Info:** Para usar este método del SDK, necesitas inicializarlo con alcance de **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)

Cuando usas este método del SDK, obtendrás cualquiera de las siguientes respuestas:

- `true`: Si el objeto está disponible, la versión especificada está disponible, y si el usuario tiene los permisos relevantes para acceder a los objetos.
- `false`:
  - Si el objeto o la versión particular del objeto no está disponible en el bucket.
  - Si el usuario no tiene los permisos requeridos para acceder al objeto.
  - Si el bucket no existe.

**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>`objectName`</td>
			<td>**String**</td>
			<td>Un parámetro **obligatorio**. Contendrá el nombre completo del objeto.</td>
		</tr>
		<tr>
			<td>`versionId`</td>
			<td>**String**</td>
			<td>Un parámetro **opcional**. Contendrá el ID de versión único del objeto, si el [Versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) está habilitado.</td>
		</tr>
		<tr>
			<td>`throwErr`</td>
			<td>**Boolean**</td>
			<td>Un parámetro **opcional**. Si estableces este parámetro como "**true**", entonces lanzará un error cuando el bucket no se encuentre en el proyecto. El valor predeterminado es "**false**"</td>
		</tr>
	</tbody>
</table>

```javascript
const options = {
versionId: 'djkfhdiufy762',
throwErr: false
};
const headObjectRes = await bucket.headObject("sam/out/sample.txt", options);
console.log(headObjectRes);
```

**Errores posibles**

> **Nota:** Si usas el SDK con el parámetro `throwErr`, y el objeto no existe, o si no tienes permisos suficientes, entonces puedes encontrar cualquiera de los errores listados a continuación.

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">Código de error</th>
			<th class="w70p">Significado</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`404`</td>
			<td>No encontrado. Objeto no encontrado.</td>
		</tr>
		<tr>
			<td>`401`</td>
			<td>No autorizado/Acceso denegado - El usuario no tiene permiso para realizar la operación particular.</td>
		</tr>
		<tr>
			<td>`403`</td>
			<td>Permiso denegado - El usuario no tiene permiso para acceder al objeto particular.</td>
		</tr>
	</tbody>
</table>