---
title: "Verificar disponibilidad de Bucket"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/check-bucket/
description: "Esta página enumera el método del SDK de Node.js para verificar si el bucket existe en tu proyecto."
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: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/check-bucket/
  - name: "Web SDK"
    url: /es/sdk/web/v4/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 Bucket

Usando el método del SDK `headBucket()`, puedes verificar la existencia de un bucket en Stratus, y además verificar si el usuario tiene los permisos relevantes para acceder a los objetos presentes en el bucket. La referencia de Stratus 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-stratus-instance/).

Respuestas posibles al usar este SDK:

* Si el bucket existe y si el usuario tiene los permisos relevantes para acceder al bucket, se devolverá la respuesta '**true**'.

* Si el bucket no existe, o si el usuario no tiene permiso para acceder al bucket, 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>`bucketName`</td>
			<td>**String**</td>
			<td>Un parámetro **obligatorio**. Contendrá el [nombre único del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket).</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 headBucketResponse = await stratus.headBucket('bucketName'); // verificar si el bucket está disponible en Stratus
console.log(headBucketResponse);
```

**Errores posibles**

> **Nota:** Si usas el SDK con el parámetro `throw_err`, y el bucket 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. Bucket no encontrado en Stratus.</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 bucket particular.</td>
		</tr>
	</tbody>
</table>