DescribeSnapshotLinks - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ini untuk mengkueri rantai snapshot dari satu atau beberapa disk. Rantai snapshot adalah rangkaian semua snapshot yang dibuat untuk suatu disk, dan setiap disk berkorespondensi dengan satu rantai snapshot.

Description

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Anda dapat menentukan beberapa parameter permintaan seperti DiskIds dan InstanceId yang akan dikueri. Parameter yang ditentukan memiliki relasi logis AND.
Hanya parameter yang ditentukan yang digunakan sebagai kondisi filter. Jika baik DiskIds maupun SnapshotLinkIds diatur ke array JSON kosong, keduanya dianggap sebagai kondisi filter yang valid dan respons kosong akan dikembalikan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSnapshotLinks	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeSnapshotLinks.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari disk tersebut. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
InstanceId	String	No	i-bp1h6jmbefj2cyqs****	ID instans.
DiskIds	String	No	["d-bp1d6tsvznfghy7y**", "d-bp1ippxbaql9zet7", ... "d-bp1ib7bcz07lcxa9**"]	ID disk. Nilainya berupa array JSON yang terdiri dari maksimal 100 ID disk. Pisahkan beberapa ID disk dengan koma (,).
SnapshotLinkIds	String	No	["sl-bp1grgphbcc9brb5**", "sl-bp1c4izumvq0i5bs", ... "sl-bp1akk7isz866dds**"]	ID rantai snapshot. Nilainya berupa array JSON yang terdiri dari maksimal 100 ID rantai snapshot. Pisahkan beberapa ID rantai snapshot dengan koma (,).
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1
PageSize	Integer	No	50	Jumlah entri yang dikembalikan pada setiap halaman. Nilai valid: 1 hingga 100. Nilai default: 10.

Response parameters

Parameter	Type	Example	Description
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
PageSize	Integer	50	Jumlah entri yang dikembalikan per halaman.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
SnapshotLinks	Array of SnapshotLink		Detail mengenai rantai snapshot.
SnapshotLink
Category	String	standard	Kategori snapshot. Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan agar Anda menggunakan parameter `InstantAccess` untuk memastikan kompatibilitas di masa depan.
InstanceId	String	i-bp1h6jmbefj2cyqs****	ID instans.
InstanceName	String	testInstanceName	Nama instans.
InstantAccess	Boolean	false	Menunjukkan apakah fitur instant access diaktifkan. Nilai valid: true: Fitur instant access diaktifkan. Fitur ini hanya dapat diaktifkan untuk enhanced SSD (ESSD). false: Fitur instant access dinonaktifkan. Snapshot merupakan snapshot biasa yang tidak memiliki fitur instant access.
RegionId	String	cn-hangzhou	ID wilayah tempat disk sumber dari rantai snapshot berada.
SnapshotLinkId	String	sl-2ze0y1jwzpb1geqx****	ID rantai snapshot.
SourceDiskId	String	d-bp1d6tsvznfghy7y****	ID disk sumber. Parameter ini tetap dipertahankan meskipun disk sumber telah dihapus.
SourceDiskName	String	testSourceDiskName	Nama disk sumber.
SourceDiskSize	Integer	40	Kapasitas disk sumber. Satuan: GiB.
SourceDiskType	String	data	Kategori disk sumber. Nilai valid: system: sistem disk data: data disk
TotalCount	Integer	1	Jumlah total snapshot.
TotalSize	Long	2097152	Kapasitas total semua snapshot dalam rantai snapshot. Satuan: byte.
TotalCount	Integer	9	Jumlah total rantai snapshot.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-bp1h6jmbefj2cyqs****
&DiskIds=["d-bp1d6tsvznfghy7y****", "d-bp1ippxbaql9zet7****", ... "d-bp1ib7bcz07lcxa9****"]
&SnapshotLinkIds=["sl-bp1grgphbcc9brb5****", "sl-bp1c4izumvq0i5bs****", ... "sl-bp1akk7isz866dds****"]
&PageNumber=1
&PageSize=10
&<Common request parameters>

Contoh respons sukses

XML format

<DescribeSnapshotLinksResponse>
      <SnapshotLinks>
            <SnapshotLink>
                  <InstanceName>testInstanceName1</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <SourceDiskSize>40</SourceDiskSize>
                  <InstanceId>i-bp1dh0xo8nucqe1o****</InstanceId>
                  <SnapshotLinkId>sl-bp1hgvjgqo3wn8u7****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName1</SourceDiskName>
                  <RegionId></RegionId>
                  <SourceDiskType>system</SourceDiskType>
                  <TotalSize>3806330880</TotalSize>
                  <SourceDiskId>d-bp149tb0mqn0boy6****</SourceDiskId>
            </SnapshotLink>
            <SnapshotLink>
                  <InstanceName>testInstanceName2</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <InstanceId>i-bp1c84ts5f4b6t6z****</InstanceId>
                  <SnapshotLinkId>sl-bp163h35n7endbpv****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName2</SourceDiskName>
                  <RegionId></RegionId>
                  <TotalSize>2709520384</TotalSize>
                  <SourceDiskType>data</SourceDiskType>
                  <SourceDiskId>d-bp1cl4hqnh0i2u5h****</SourceDiskId>
            </SnapshotLink>
      </SnapshotLinks>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <TotalCount>9</TotalCount>
</DescribeSnapshotLinksResponse>

JSON format

{
    "SnapshotLinks": {
        "SnapshotLink": [
            {
                "InstanceName": "testInstanceName1",
                "TotalCount": 1,
                "Category": "standard",
                "SourceDiskSize": 40,
                "InstanceId": "i-bp1dh0xo8nucqe1o****",
                "SnapshotLinkId": "sl-bp1hgvjgqo3wn8u7****",
                "SourceDiskName": "testSourceDiskName1",
                "RegionId": "",
                "SourceDiskType": "system",
                "TotalSize": 3806330880,
                "SourceDiskId": "d-bp149tb0mqn0boy6****"
            },
            {
                "InstanceName": "testInstanceName2",
                "TotalCount": 1,
                "Category": "standard",
                "InstanceId": "i-bp1c84ts5f4b6t6z****",
                "SnapshotLinkId": "sl-bp163h35n7endbpv****",
                "SourceDiskName": "testSourceDiskName2",
                "RegionId": "",
                "TotalSize": 2709520384,
                "SourceDiskType": "data",
                "SourceDiskId": "d-bp1cl4hqnh0i2u5h****"
            }
        ]
    },
    "PageNumber": 1,
    "PageSize": 1,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "TotalCount": 2
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidRegionId	The specified regionId is invalid.	Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	Pesan kesalahan yang dikembalikan karena parameter SnapshotLinkIds yang ditentukan tidak valid.
400	InvalidDiskIds	The specified diskIds is invalid.	Pesan kesalahan yang dikembalikan karena parameter DiskIds yang ditentukan tidak valid.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti. Jika kesalahan tetap berlanjut, buat Tiket.

Untuk daftar kode kesalahan, kunjungi API Error Center.