查詢磁碟快照鏈。快照鏈是一個磁碟所有快照組成的關係鏈,一個磁碟對應一條快照鏈,所以快照鏈 ID 即磁碟 ID。

描述

調用該介面時,您需要注意:

  • 請求參數 RegionIdDiskIdsInstanceId 等充當過濾器功能,參數間是邏輯與關係。

  • 如果不指定任何參數,則過濾器不起作用。當 DiskIdsSnapshotLinkIds 都為空數組時,即 [],同樣視該過濾器有效,但是返回結果為空。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeSnapshotLinks
RegionId String 磁碟所屬於的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId String 執行個體 ID。
DiskIds String 磁碟 ID。一次最多指定 100 個磁碟 ID。DiskIds 參數取值格式為 JSON 數組,如 ["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"],ID 之間用半形逗號(,)隔開。
SnapshotLinkIds String 快照 ID。一次最多指定 100 個快照 ID。SnapshotLinkIds參數取值格式為 JSON 數組,如 ["p-xxxxxxxxx", "p-yyyyyyyyy", … "p-zzzzzzzzz"],ID 之間用半形逗號(,)隔開。
PageNumber Integer 磁碟狀態列表的頁碼。起始值:1

預設值:1

PageSize Integer 分頁查詢時設定的每頁行數。取值範圍:[1, 50]。

預設值:10

返回參數

名稱 類型 描述
RegionId String 快照鏈源磁碟所屬地域 ID
TotalCount Integer 快照鏈總個數
PageNumber Integer 快照鏈列表的頁碼
PageSize Integer 輸入時設定的每頁行數
SnapshotLinks SnapshotLinkType 快照鏈資訊組成的集合

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-beijing
&ZoneId=cn-beijing-btc-a01
&PageNumber=1
&<公共請求參數>
返回樣本

XML 格式

<DescribeSnapshotLinksResponse>
    <SnapshotLinks>
        <SnapshotLink>
            <SnapshotLinkId>d-25okbh2pj</SnapshotLinkId >
            <SourceDiskId>d-25okbh2pj</SourceDiskId>
            <SourceDiskType>data</SourceDiskType>
            <SourceDiskSize>20</SourceDiskSize>
            <RegionId> cn-beijing-btc-a01</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-btc-a01</RegionId>
            <TotalCount>1</TotalCount>
            <TotalSize>2097152</TotalSize>
         </SnapshotLink>
    </SnapshotLinks>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <TotalCount>9</TotalCount>
    <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeSnapshotLinksResponse>
JSON 格式
{
    "SnapshotLinks": {
    "SnapshotLink": [
    {
        "SourceDiskSize": 20,
        "TotalSize": 2097152,
        "SourceDiskType": "data",
        "RegionId": "cn-beijing-btc-a01",
        "SnapshotLinkId": "d-25okbh2pj",
        "SourceDiskId": "d-25okbh2pj",
        "TotalCount": 1
    },
    {
        "SourceDiskSize": 40,
        "TotalSize": 2097152,
        "SourceDiskType": "data",
        "RegionId": "cn-beijing-btc-a01",
        "SnapshotLinkId": "d-2ze0y1jwzpb1geqxkroq",
        "SourceDiskId": "d-2ze0y1jwzpb1geqxkroq",
        "TotalCount": 1
    }
    ]
    },
    "PageNumber": 1,
    "PageSize": 2,
    "RequestId": "ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
    "TotalCount": 9
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidDiskIds The specified diskIds is invalid. 400 指定的 DiskIds 不合法。
InvalidRegionId The specified regionId is invalid. 400 指定的 RegionId 不合法。
InvalidSnapshotLinkIds The specified snapshotLinkIds is invalid. 400 指定的 SnapshotLinkIds 不合法。
InternalError The request processing has failed due to some unknown error. 500 內部錯誤。