---
title: "オブジェクトバージョンの一覧取得"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/list-object-versions/
description: "このページでは、オブジェクトのバージョンを取得するためのNode.js SDKメソッドについて説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus コンポーネントヘルプドキュメント"
    url: /ja/cloud-scale/help/stratus/introduction
  - name: "オブジェクトバージョニングヘルプドキュメント"
    url: /ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning
  - name: "Java SDK"
    url: /ja/sdk/java/v1/cloud-scale/stratus/get-object-versions/
  - name: "Python SDK"
    url: /ja/sdk/python/v1/cloud-scale/stratus/get-object-versions/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /ja/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /ja/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# オブジェクトバージョンの一覧取得

### ページネーションによるオブジェクトの全バージョン一覧取得

バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)を有効にすると、同じオブジェクトの複数のバージョンをバケットに保存できます。オブジェクトの各バージョンには固有の`versionId`が割り当てられます。このSDKメソッドを使用すると、バケット内のオブジェクトに存在するすべてのバージョンをページネーションで取得できます。以下のコードスニペットで使用されているObjectの参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/create-object-instance/)です。

> **情報:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご参照ください。

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
			<th class="w20p">データ型</th>
      <th class="w60p">説明</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`nextToken`</td>
			<td>**String**</td>
			<td>次のバージョンセットを取得するための値を保持します。</td>
		</tr>
		<tr>
			<td>`maxVersions`</td>
			<td>**int**</td>
			<td>**任意**のパラメータです。1回のイテレーションで一覧表示できるオブジェクトの最大バージョン数の値を保持します。</td>
		</tr>
	</tbody>
</table>

```javascript
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);
```

**レスポンス例**

```json
{
  "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"
    }
  ]
}
```

### イテレーションによるオブジェクトの全バージョン一覧取得

以下のSDKメソッドを使用すると、オブジェクトの利用可能なすべてのバージョンを1回の呼び出しで取得できます。

> **情報:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご参照ください。

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

**レスポンス例**

```json
{
	"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"
}
```