1 つ以上のディスクのスナップショットチェーンを照会します。 スナップショットチェーンはディスクのすべてのスナップショットのチェーンであり、ディスクはスナップショットのチェーンに対応するため、スナップショットチェーン ID がディスク ID になります。

説明

本インターフェイスを呼び出すときは、次の点に留意してください。

  • RegionId、DiskIds、InstanceId などのリクエストパラメーターはフィルター条件として機能し、パラメーター間にはブール値 AND 関係が存在します。
  • パラメーターが指定されていない場合、フィルター条件は適用されません。 DiskIds および SnapshotLinkIds パラメーターが空のJSON 配列([])の場合、フィルター条件は有効と見なされ、空の結果が返されます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を行い API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成などができます。

リクエストパラメーター

名前 データ型 必須 / 省略可能 説明
RegionId String 必須 cn-hangzhou

ディスクが属するリージョンの ID 。 DescribeRegions を呼び出すと、Alibaba Cloud の最新リージョンが表示されます。

Action String 省略可能 DescribeSnapshotLinks

実行する操作。 値を DescribeSnapshotLinks に設定します。

DiskIds String 省略可能 ["ds-xxxxxxxxx", "ds-yyyyyyyyy", … "ds-zzzzzzzzz"]

照会するディスクの ID 。 一度に最大 100 件のディスク ID を指定できます。 パラメーター値は、コンマ(、)で区切られたディスク ID の配列です。

InstanceId String 省略可能 i-instanceid1

インスタンスの ID 。

PageNumber Integer 省略可能 1

ディスクステータスリストで照会するページ番号。 開始値:1。

既定値 : 1。

PageSize Integer 省略可能 10

1 ページあたりのエントリー数。 有効値:1 〜 50 。

既定値: 10 。

SnapshotLinkIds String 省略可能 ["ds-xxxxxxxxx", "ds-yyyyyyyyy", … "ds-zzzzzzzzz"]

照会するスナップショットチェーンの ID 。 一度に最大 100 件のスナップショットチェーン ID を指定できます。 パラメーター値は、カンマ(、)で区切られたスナップショットチェーン ID の配列です。

レスポンスパラメーター

名前 データ型 説明
PageNumber Integer 1

スナップショットチェーンリストでクエリを実行するページ番号。

PageSize Integer 10

1 ページあたりのエントリー数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID 。

SnapshotLinks

一連のスナップショットチェーン。

 └InstanceId String i-instanceid1

インスタンスの ID 。

 └InstanceName String FinanceJoshua

インスタンスの名前。

 └RegionId String cn-hangzhou

スナップショットチェーンのソースディスクが属するリージョンの ID 。

 └SnapshotLinkId String p-2ze0y1jwzpb1geqxkroq

スナップショットチェーンの ID 。

 └SourceDiskId String d-diskid1

ソースインスタンスの ID。 このパラメーターは、スナップショットのソースディスクが削除された後も保持されます。

 └SourceDiskName String FinanceJoshua

ソースディスクの名前。

 └SourceDiskSize Integer 40

ソースディスクのサイズ。 単位:GiB。

 └SourceDiskType String cloud_ssd

ソースディスクのタイプ。 有効値:

  • cloud:ベーシックディスク
  • cloud_efficiency:ウルトラディスク。
  • cloud_ssd:SSD
  • ephemeral_ssd: ローカル SSD
  • cloud_essd:ESSD
 └TotalCount Integer 1

スナップショットの総数。

 └TotalSize Integer 2097152

スナップショットチェーン内のスナップショットのサイズ。 単位:Byte。

TotalCount Integer 9

スナップショットチェーンの総数。

リクエストの例

https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-instance1
&DiskIds=["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"]
&SnapshotLinkIds=["p-xxxxxxxxx", "p-yyyyyyyyy", … "p-zzzzzzzzz"]
&PageNumber=1
&PageSize=100
&<Common request parameters>

通常のレスポンスの例

XML 形式

<DescribeSnapshotLinksResponse>
  <SnapshotLinks>
    <SnapshotLink>
      <SnapshotLinkId> d-25okbh2pj </SnapshotLinkId>
      <SourceDiskId> d-25okbh2pj </SourceDiskId>
      <SourceDiskType> data </SourceDiskType>
      <SourceDiskSize> 20 </SourceDiskSize>
      <RegionId>cn-beijing</RegionId>
      <TotalCount>1</TotalCount>
      <TotalSize> 2097152 </TotalSize>
    </SnapshotLink>
    <SnapshotLink>
      <SnapshotLinkId> d-2ze0y1jwzpb1geqxkroq </SnapshotLinkId>
      <SourceDiskId> d-2ze0y1jwzpb1geqxkroq </SourceDiskId>
      <SourceDiskType> system </SourceDiskType>
      <SourceDiskSize> 40 </SourceDiskSize>
      <RegionId>cn-beijing</RegionId>
      <TotalCount>1</TotalCount>
      <TotalSize>2097152</TotalSize>
    </SnapshotLink>
  </SnapshotLinks>
  <PageNumber>1</PageNumber>
  <PageSize>20</PageSize>
  <TotalCount>1</TotalCount>
  <RequestId> ED5CF6DD-71CA-462C-9C94-A61A78A01479 </RequestId>
</DescribeSnapshotLinksResponse>

JSON 形式

{
	"PageNumber":1,
	"TotalCount":9,
	"PageSize":2,
	"RequestId":"ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
	"SnapshotLinks":{
		"SnapshotLink":[
			{
				"TotalCount":1,
				"SourceDiskType":"data",
				"SourceDiskId":"d-25okbh2pj",
				"RegionId":"cn-beijing",
				"SourceDiskSize":20,
				"SnapshotLinkId":"d-25okbh2pj",
				"TotalSize":2097152
			},
			{
				"TotalCount":1,
				"SourceDiskType":"data",
				"SourceDiskId":"d-2ze0y1jwzpb1geqxkroq",
				"RegionId":"cn-beijing-btc-a01",
				"SourceDiskSize":40,
				"SnapshotLinkId":"d-2ze0y1jwzpb1geqxkroq",
				"TotalSize":2097152
			}
		]
	}
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
400 InvalidDiskIds 指定された diskIds は無効です。 指定された Diskids パラメーターの値が無効な場合に返されるエラーメッセージ。

エラーコードの表示