DescribeSnapshotLinks - - Alibaba Cloud ドキュメントセンター

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 パラメーターの値が無効な場合に返されるエラーメッセージ。

エラーコードの表示