Verificar disponibilidad del bucket

# Verificar disponibilidad del bucket
Usando el método del SDK {{%badge%}}head_bucket(){{%/badge%}}, puedes verificar la existencia de un bucket en Stratus y además comprobar si el usuario tiene los permisos relevantes para acceder a los objetos presentes en el bucket. La referencia {{%badge%}}stratus{{%/badge%}} utilizada en el siguiente fragmento de código es la {{%link href="/es/sdk/python/v1/cloud-scale/stratus/create-stratus-instance/" %}}instancia del componente{{%/link%}}.
Posibles respuestas al usar este SDK:
* Si el bucket existe y 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%}}bucket_name{{%/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%}}throw_err{{%/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-python" scroll="set-scroll" %}}bucket_res = stratus.head_bucket('bucket_name', throw_err=False)
print(bucket_res)
{{%/code%}}
#### Posibles errores
{{%note%}}{{%bold%}}Note:{{%/bold%}} Si usas el SDK con el parámetro {{%badge%}}throw_err{{%/badge%}}, y el bucket no existe, o si no tienes permisos suficientes, 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 en particular.</td>
                </tr>
                <tr>
                        <td>{{%badge%}}{{%bold%}}403{{%/bold%}}{{%/badge%}}</td>
                        <td>Permiso denegado - El usuario no tiene permiso para acceder al bucket en particular.</td>
                </tr>
        </tbody>
</table>

Usando el método del SDK head_bucket(), puedes verificar la existencia de un bucket en Stratus y además comprobar si el usuario tiene los permisos relevantes para acceder a los objetos presentes en el bucket. La referencia stratus utilizada en el siguiente fragmento de código es la instancia del componente. Posibles respuestas al usar este SDK:

Si el bucket existe y 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
bucket_name	String	Un parámetro obligatorio. Contendrá el nombre único del bucket.
throw_err	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

         bucket_res = stratus.head_bucket('bucket_name', throw_err=False)
print(bucket_res)

Posibles errores

Note: Si usas el SDK con el parámetro throw_err, y el bucket no existe, o si no tienes permisos suficientes, 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 en particular.
403	Permiso denegado - El usuario no tiene permiso para acceder al bucket en particular.

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Stratus Component Help Documentation Java SDK Node.js SDK Web SDK iOS SDK Android SDK Flutter SDK REST API

SDK de Python

Operaciones del SDK

Verificar disponibilidad del bucket

Posibles errores