Verificar disponibilidad de objeto

# Verificar disponibilidad de objeto

Usando este método del SDK, puedes verificar si un objeto particular está presente en el bucket, si el usuario tiene los permisos requeridos para acceder al objeto. La referencia de Bucket utilizada en el siguiente fragmento de código es la {{%link href="/es/sdk/java/v1/cloud-scale/stratus/create-bucket-instance/" %}}instancia del componente{{%/link%}}.

{{%info%}}{{%bold%}}Info:{{%/bold%}} Para usar este método del SDK, necesitas inicializarlo con el scope {{%bold%}}Admin{{%/bold%}}. Puedes obtener más información sobre este requisito en esta {{%link href="/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes" %}}sección{{%/link%}}{{%/info%}}

Si has habilitado {{%link href="/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}Versioning{{%/link%}} para tu bucket, entonces necesitas pasar el {{%badge%}}versionID{{%/badge%}} 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:

- {{%badge%}}**true**{{%/badge%}}: Si el objeto está disponible, la versión especificada está disponible, y si el usuario tiene los permisos relevantes para acceder a los objetos.
- {{%badge%}}**false**{{%/badge%}}:
  - Si el objeto o la versión particular del objeto no está disponible en el bucket.
  - Si el usuario no tiene los permisos requeridos 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>{{%badge%}}key{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>Un parámetro {{%bold%}}obligatorio{{%/bold%}}. Contendrá el nombre completo del objeto.</td>
		</tr>
		<tr>
			<td>{{%badge%}}versionId{{%/badge%}}</td>
			<td>{{%bold%}}String{{%/bold%}}</td>
			<td>Un parámetro {{%bold%}}opcional{{%/bold%}}. Contendrá el ID de versión único del objeto, si {{%link href="/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}Versioning{{%/link%}} está habilitado.</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%}}", se lanzará un error cuando el objeto no se encuentre en el proyecto. El valor predeterminado es "{{%bold%}}false{{%/bold%}}"</td>
		</tr>
	</tbody>
</table>

{{%code class="language-java"%}}Boolean throwErr = true;
Boolean headObjectRes = bucket.headObject("sam/out/sample.txt", "versionId", throwErr);
System.out.println(headObjectRes);{{%/code%}}

**Posibles errores**

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Si usas el SDK con el parámetro {{%badge%}}throw_err{{%/badge%}}, y el objeto 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. Objeto no encontrado.</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 objeto particular.</td>
		</tr>
	</tbody>
</table>

Info: Para usar este método del SDK, necesitas inicializarlo con el scope Admin. Puedes obtener más información sobre este requisito en esta sección

Si has habilitado Versioning para tu bucket, entonces necesitas pasar el versionID 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 requeridos 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.
versionId	String	Un parámetro opcional. Contendrá el ID de versión único del objeto, si Versioning está habilitado.
throwErr	Boolean	Un parámetro opcional. Si estableces este parámetro como "true", se lanzará un error cuando el objeto no se encuentre en el proyecto. El valor predeterminado es "false"

copy

         Boolean throwErr = true;
Boolean headObjectRes = bucket.headObject("sam/out/sample.txt", "versionId", throwErr);
System.out.println(headObjectRes);
    

Posibles errores

Nota: Si usas el SDK con el parámetro throw_err, y el objeto 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. Objeto no encontrado.
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 objeto 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 Objects Help Documentation Node.js SDK Python SDK Web SDK iOS SDK Android SDK Flutter SDK REST API

Java SDK

Operaciones del SDK

Verificar disponibilidad de objeto