---
title: "Verificar disponibilidad del objeto"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/check-object-availability/
description: "Esta página enumera el método del SDK de Python 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: "Node.js SDK"
    url: /es/sdk/nodejs/v2/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 del objeto
Usando este método del SDK, puedes verificar si un objeto particular está presente en el bucket y si el usuario tiene los permisos necesarios para acceder al objeto. La referencia de Bucket utilizada en el siguiente fragmento de código es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/create-bucket-instance/).
Si has habilitado [Versioning](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) para tu bucket, entonces necesitas pasar el `version_id ` como parámetro, para verificar si una versión particular del objeto está disponible.
Cuando uses este método del SDK, obtendrás una 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 necesarios 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>`key`</td>
                        <td>**String**</td>
                        <td>Un parámetro **obligatorio**. Contendrá el nombre completo del objeto.</td>
                </tr>
                <tr>
                        <td>`version_id`</td>
                        <td>**String**</td>
                        <td>Un parámetro **opcional**. Contendrá el ID de versión único del objeto, si [Versioning](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) está habilitado.</td>
                </tr>
                <tr>
                        <td>`throw_err`</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>

```python
head_object_res = bucket.head_object( "sam/out/sample.txt", 'version_id', throw_err=False)
print(head_object_res)
```

#### Posibles errores

> **Note:** Si usas el SDK con el parámetro `throw_err`, y el objeto no existe, o si no tienes permisos suficientes, 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 en Stratus.</td>
                </tr>
                <tr>
                        <td>`401`</td>
                        <td>No autorizado/Acceso denegado - El usuario no tiene permiso para realizar la operación en particular.</td>
                </tr>
                <tr>
                        <td>`403`</td>
                        <td>Permiso denegado - El usuario no tiene permiso para acceder al objeto en particular.</td>
                </tr>
        </tbody>
</table>