DescribeAutoSnapshotPolicyEx - - Alibaba Cloud Documentation Center

Mengambil daftar kebijakan snapshot otomatis yang ada di suatu wilayah.

Debugging

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

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	DescribeAutoSnapshotPolicyEx	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeAutoSnapshotPolicyEx.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari kebijakan snapshot otomatis. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah saat ini.
AutoSnapshotPolicyId	String	No	sp-bp67acfmxazb4ph****	ID kebijakan snapshot otomatis.
AutoSnapshotPolicyName	String	No	TestName	Nama kebijakan snapshot otomatis.
PageNumber	Integer	No	1	Nomor halaman yang akan dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 100. Nilai default: 10.
Tag.N.Key	String	No	TestKey	Kunci tag N dari kebijakan snapshot otomatis. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjangnya maksimal 128 karakter dan tidak boleh diawali dengan acs: atau aliyun. Tidak boleh mengandung http:// atau https://.
Tag.N.Value	String	No	TestValue	Nilai tag N dari kebijakan snapshot otomatis. Nilai N yang valid: 1 hingga 20. Nilai tag boleh berupa string kosong. Panjangnya maksimal 128 karakter dan tidak boleh diawali dengan acs: atau mengandung http:// atau https://.
ResourceGroupId	String	No	rg-aek2kkmhmhs****	ID kelompok sumber daya. Jika parameter ini ditentukan untuk mengkueri resource, respons dapat menampilkan hingga 1.000 resource yang termasuk dalam kelompok sumber daya tersebut. Catatan Resource dalam kelompok sumber daya default tetap ditampilkan dalam respons terlepas dari pengaturan parameter ini.

Parameter respons

Parameter	Type	Contoh	Deskripsi
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
TotalCount	Integer	1	Total jumlah kebijakan snapshot otomatis.
AutoSnapshotPolicies	Array of AutoSnapshotPolicy		Detail mengenai kebijakan snapshot otomatis.
AutoSnapshotPolicy
TimePoints	String	["1"]	Titik waktu dalam sehari saat snapshot otomatis dibuat. Waktu ditampilkan dalam UTC+8. Satuan: jam. Nilai yang valid adalah 0 hingga 23, yang masing-masing mewakili 24 titik waktu tepat pada jam dari pukul 00:00:00 hingga 23:00:00. Angka 1 merepresentasikan pukul 01:00:00. Beberapa titik waktu dapat ditentukan. Nilai parameter ini merupakan array JSON yang berisi hingga 24 titik waktu yang dipisahkan koma (,). Contoh: `["0", "1", ... "23"]`.
CreationTime	String	2019-12-10T16:00Z	Waktu pembuatan kebijakan snapshot otomatis. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ. Waktu ditampilkan dalam UTC.
Status	String	Normal	Status kebijakan snapshot otomatis. Nilai yang valid: Normal: Kebijakan snapshot otomatis dalam kondisi normal. Expire: Kebijakan snapshot otomatis tidak dapat digunakan karena akun Anda memiliki pembayaran tertunda.
AutoSnapshotPolicyName	String	testAutoSnapshotPolicyName	Nama kebijakan snapshot otomatis.
TargetCopyRegions	String	test	Catatan Parameter ini sedang dalam pratinjau undangan dan tidak tersedia untuk pengguna umum.
CopiedSnapshotsRetentionDays	Integer	0	Catatan Parameter ini sedang dalam pratinjau undangan dan tidak tersedia untuk pengguna umum.
AutoSnapshotPolicyId	String	sp-bp67acfmxazb4ph****	ID kebijakan snapshot otomatis.
RetentionDays	Integer	7	Periode retensi snapshot otomatis. Satuan: hari. Nilai yang valid: -1: Snapshot otomatis disimpan hingga dihapus. 1 hingga 65536: Snapshot otomatis disimpan selama jumlah hari yang ditentukan.
RegionId	String	cn-hangzhou	ID wilayah kebijakan snapshot otomatis.
DiskNums	Integer	1	Jumlah disk tempat kebijakan snapshot otomatis diterapkan.
EnableCrossRegionCopy	Boolean	false	Catatan Parameter ini sedang dalam pratinjau undangan dan tidak tersedia untuk pengguna umum.
RepeatWeekdays	String	["6"]	Hari dalam seminggu saat snapshot otomatis dibuat. Nilai yang valid: 1 hingga 7, yang masing-masing mewakili hari dalam seminggu. Angka 1 merepresentasikan Senin. Satu atau beberapa hari dapat ditentukan.
VolumeNums	Integer	2	Jumlah volume tambahan tempat kebijakan snapshot otomatis diterapkan.
ResourceGroupId	String	rg-aek2kkmhmhs****	ID kelompok sumber daya.
Tags	Array of Tag		Tag dari kebijakan snapshot otomatis.
Tag
TagValue	String	TestValue	Nilai tag dari kebijakan snapshot otomatis.
TagKey	String	TestKey	Kunci tag dari kebijakan snapshot otomatis.

Contoh

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=DescribeAutoSnapshotPolicyEx
&RegionId=cn-hangzhou
&AutoSnapshotPolicyId=sp-bp67acfmxazb4ph****
&AutoSnapshotPolicyName=p-23f2i9s4t
&PageNumber=1
&PageSize=1
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&ResourceGroupId=rg-aek2kkmhmhs****
&Common request parameters

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAutoSnapshotPolicyExResponse>
    <PageSize>10</PageSize>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <AutoSnapshotPolicies>
        <TimePoints>["1"]</TimePoints>
        <CreationTime>2021-09-01 15:30:01</CreationTime>
        <Status>Normal</Status>
        <AutoSnapshotPolicyName>testAutoSnapshotPolicyName</AutoSnapshotPolicyName>
        <TargetCopyRegions>test</TargetCopyRegions>
        <CopiedSnapshotsRetentionDays>0</CopiedSnapshotsRetentionDays>
        <AutoSnapshotPolicyId>sp-bp67acfmxazb4ph****</AutoSnapshotPolicyId>
        <RetentionDays>7</RetentionDays>
        <RegionId>cn-hangzhou</RegionId>
        <DiskNums>1</DiskNums>
        <EnableCrossRegionCopy>false</EnableCrossRegionCopy>
        <RepeatWeekdays>["6"]</RepeatWeekdays>
        <VolumeNums>2</VolumeNums>
        <ResourceGroupId>rg-aek2kkmhmhs****</ResourceGroupId>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
    </AutoSnapshotPolicies>
</DescribeAutoSnapshotPolicyExResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 10,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "AutoSnapshotPolicies" : [ {
    "TimePoints" : "[\"1\"]",
    "CreationTime" : "2021-09-01 15:30:01",
    "Status" : "Normal",
    "AutoSnapshotPolicyName" : "testAutoSnapshotPolicyName",
    "TargetCopyRegions" : "test",
    "CopiedSnapshotsRetentionDays" : 0,
    "AutoSnapshotPolicyId" : "sp-bp67acfmxazb4ph****",
    "RetentionDays" : 7,
    "RegionId" : "cn-hangzhou",
    "DiskNums" : 1,
    "EnableCrossRegionCopy" : false,
    "RepeatWeekdays" : "[\"6\"]",
    "VolumeNums" : 2,
    "ResourceGroupId" : "rg-aek2kkmhmhs****",
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ]
  } ]
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key yang ditentukan tidak sesuai dengan parameter Tag.N.Value yang ditentukan.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Pesan kesalahan yang dikembalikan karena jumlah tag yang ditentukan melebihi batas atas.

Untuk daftar kode kesalahan, kunjungi API Error Center.