Listar versiones de objeto

# Listar versiones de objeto

### List All Versions of an Object Through Pagination

Habilitar el Versionado en un bucket te permite almacenar múltiples versiones del mismo objeto en el bucket. Cada versión del objeto tendrá su propio versionId. Este método del SDK te permite obtener todas las versiones existentes de un objeto presente en un bucket mediante paginación. La referencia de Object utilizada en el fragmento de código a continuación es la instancia del componente.

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

**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>nextToken</td>
			<td>String</td>
			<td>Contendrá el valor para determinar el siguiente conjunto de versiones.</td>
		</tr>
		<tr>
			<td>maxVersions</td>
			<td>int</td>
			<td>Un parámetro opcional. Contendrá el valor del número máximo de versiones del objeto que se pueden listar por iteración.</td>
		</tr>
	</tbody>
</table>

async function listMyPaginatedVersions(maxVersion = undefined, nextToken = undefined) {
const response = await objectIns.listPagedVersions({ maxVersion, nextToken});
console.log(response.version);
if(response.is_truncated) {
listMyPaginatedVersions(maxVersion,nextToken)
} 
}
await listMyPaginatedVersions(10);

**Respuesta de ejemplo**

{
  "key": "sam/out/sample.txt",
  "versions_count": 2,
  "max_versions": "2",
  "is_truncated": "False",
  "next_continuation_token": "4YpUdkktt2UeWp6MwEK1LZXELnuVhunHLnGgX29uvszwtJEQE2gVDJYyRiLdUmhNst",
  "version": [
    {
      "version_id": "01hyfh12njtpyvzwq6p1fd2d8s",
      "is_latest": "True",
      "last_modified": "May 22, 2024 12:20 PM",
      "size": 1,
      "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
    },
    {
      "version_id": "01hyfh0xkvwkxxsjfceef201xa",
      "is_latest": "False",
      "last_modified": "May 22, 2024 12:20 PM",
      "size": "1",
      "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
    }
  ]
}

### List All Versions of the Object Through Iteration

Puedes usar el siguiente método del SDK para obtener todas las versiones disponibles del objeto en una sola llamada.

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

const versions = objectIns.listIterableVersions();
for await( const version of versions) {
console.log(version);
}

**Respuesta de ejemplo**

{
	"versionId": "01hyfh12njtpyvzwq6p1fd2d8s",
 	"is_latest": "True", 
	"last_modified": "May 22,2024 12:20 PM",
	"size": "1", "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}
{
    "versionId": "01hyfh0xkvwkxxsjfceef201xa",
    "is_latest": "False",
    "last_modified": "May 22, 2024 12:20 PM",
    "size": "1",
    "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}

List All Versions of an Object Through Pagination

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

Parámetros utilizados

Nombre del parámetro	Tipo de dato	Definición
nextToken	String	Contendrá el valor para determinar el siguiente conjunto de versiones.
maxVersions	int	Un parámetro opcional. Contendrá el valor del número máximo de versiones del objeto que se pueden listar por iteración.

copy

         async function listMyPaginatedVersions(maxVersion = undefined, nextToken = undefined) {
const response = await objectIns.listPagedVersions({ maxVersion, nextToken});
console.log(response.version);
if(response.is_truncated) {
listMyPaginatedVersions(maxVersion,nextToken)
} 
}
await listMyPaginatedVersions(10);
    

Respuesta de ejemplo

copy

         {
  "key": "sam/out/sample.txt",
  "versions_count": 2,
  "max_versions": "2",
  "is_truncated": "False",
  "next_continuation_token": "4YpUdkktt2UeWp6MwEK1LZXELnuVhunHLnGgX29uvszwtJEQE2gVDJYyRiLdUmhNst",
  "version": [
    {
      "version_id": "01hyfh12njtpyvzwq6p1fd2d8s",
      "is_latest": "True",
      "last_modified": "May 22, 2024 12:20 PM",
      "size": 1,
      "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
    },
    {
      "version_id": "01hyfh0xkvwkxxsjfceef201xa",
      "is_latest": "False",
      "last_modified": "May 22, 2024 12:20 PM",
      "size": "1",
      "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
    }
  ]
}
    

List All Versions of the Object Through Iteration

Puedes usar el siguiente método del SDK para obtener todas las versiones disponibles del objeto en una sola llamada.

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

copy

         const versions = objectIns.listIterableVersions();
for await( const version of versions) {
console.log(version);
}
    

Respuesta de ejemplo

copy

         {
	"versionId": "01hyfh12njtpyvzwq6p1fd2d8s",
 	"is_latest": "True", 
	"last_modified": "May 22,2024 12:20 PM",
	"size": "1", "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}
{
    "versionId": "01hyfh0xkvwkxxsjfceef201xa",
    "is_latest": "False",
    "last_modified": "May 22, 2024 12:20 PM",
    "size": "1",
    "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}
    

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