Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

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. Si has habilitado 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
Nombre del parámetro Tipo de dato Definición
key String Un parámetro obligatorio. Contendrá el nombre completo del objeto.
version_id String Un parámetro opcional. Contendrá el ID de versión único del objeto, si Versioning está habilitado.
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
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.
Código de error Significado
404 No encontrado. Objeto 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 objeto en particular.

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