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 de objeto

Usando el método del SDK headObject(), puedes verificar la existencia de un objeto en un bucket y, además, comprobar si el usuario tiene los permisos relevantes para acceder a los objetos presentes en el bucket. La referencia de Bucket 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 el usuario tiene los permisos relevantes para acceder a los objetos en él, se devolverá la respuesta ‘true’.

  • Si el bucket no existe, o si el usuario no tiene permiso para acceder a los objetos en él, se devolverá la respuesta ‘false’.

Parámetros utilizados

Nombre del parámetro Tipo de dato Definición
key String Un parámetro obligatorio. Contendrá el nombre completo del objeto junto con su ruta.
options JSON Object Un parámetro opcional para contener los siguientes parámetros:
  • versionId:
    • Un parámetro String opcional.
    • Si el Versionado está habilitado para tu bucket, este parámetro te ayudará a hacer referencia a una versión particular usando su Version ID único.
  • throwErr:
    • Un parámetro Boolean opcional.
    • Si estableces este parámetro como "true", lanzará un error cuando el bucket no se encuentre en el proyecto.
    • El valor por defecto es "false"

Verificar disponibilidad de objeto sin VersionID

El siguiente método del SDK te proporcionará la topVersion (última versión) del objeto en el bucket.

copy
// Verificar si un objeto está disponible
const checkObjectAvailability = await bucket.headObject("key")

Verificar disponibilidad de objeto con VersionID

El siguiente método del SDK verificará la disponibilidad de una versión específica del objeto. La versión requerida se referenciará por su versionId único.

copy
// Verificar si cierta versión de un objeto está disponible

const options = { versionId: ‘djkfhdiufy762’, throwErr: false }; const checkObjectAvailability = await bucket.headObject(“key”, options)

Respuesta de ejemplo

copy
{
 	"status": 200,
 	"content": true | false,
 	"message": "OK"
}

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