Verificar disponibilidad de Bucket

# Verificar disponibilidad de Bucket

Usando el método del SDK {{%badge%}}headBucket(){{%/badge%}}, 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 {{%link href="/es/sdk/nodejs/v2/cloud-scale/stratus/create-stratus-instance/" %}}instancia del componente{{%/link%}}.

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>{{%badge%}}bucketName{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>Un parámetro {{%bold%}}obligatorio{{%/bold%}}. Contendrá el {{%link href="/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket" %}}nombre único del bucket{{%/link%}}.</td>
		</tr>
		<tr>
			<td>{{%badge%}}throwErr{{%/badge%}}</td>
			<td>{{%bold%}}Boolean{{%/bold%}}</td>
			<td>Un parámetro {{%bold%}}opcional{{%/bold%}}. Si estableces este parámetro como "{{%bold%}}true{{%/bold%}}", entonces lanzará un error cuando el bucket no se encuentre en el proyecto. El valor predeterminado es "{{%bold%}}false{{%/bold%}}"</td>
		</tr>
	</tbody>
</table>

{{%code class="language-javascript" scroll="set-scroll" %}}const headBucketResponse = await stratus.headBucket('bucketName'); // verificar si el bucket está disponible en Stratus
console.log(headBucketResponse);{{%/code%}}

**Errores posibles**

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Si usas el SDK con el parámetro {{%badge%}}throw_err{{%/badge%}}, y el bucket no existe, o si no tienes permisos suficientes, entonces puedes encontrar cualquiera de los errores listados a continuación.{{%/note%}}

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">Código de error</th>
			<th class="w70p">Significado</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>{{%badge%}}{{%bold%}}404{{%/bold%}}{{%/badge%}}</td>
			<td>No encontrado. Bucket no encontrado en Stratus.</td>
		</tr>
		<tr>
			<td>{{%badge%}}{{%bold%}}401{{%/bold%}}{{%/badge%}}</td>
			<td>No autorizado/Acceso denegado - El usuario no tiene permiso para realizar la operación particular.</td>
		</tr>
		<tr>
			<td>{{%badge%}}{{%bold%}}403{{%/bold%}}{{%/badge%}}</td>
			<td>Permiso denegado - El usuario no tiene permiso para acceder al bucket particular.</td>
		</tr>
	</tbody>
</table>

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.

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

Nombre del parámetro	Tipo de dato	Definición
bucketName	String	Un parámetro obligatorio. Contendrá el nombre único del bucket.
throwErr	Boolean	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"

copy

         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.

Código de error	Significado
404	No encontrado. Bucket no encontrado en Stratus.
401	No autorizado/Acceso denegado - El usuario no tiene permiso para realizar la operación particular.
403	Permiso denegado - El usuario no tiene permiso para acceder al bucket particular.

Última actualización 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Stratus Component Help Documentation Java SDK Python SDK Web SDK iOS SDK Android SDK Flutter SDK REST API

Node JS SDK

Operaciones del SDK

Verificar disponibilidad de Bucket