DescribeDiskReplicaPairs - Elastic Compute Service

Mengambil informasi tentang satu atau beberapa pasangan replikasi di wilayah tertentu.

Deskripsi operasi

Description

Untuk informasi mengenai wilayah yang mendukung asynchronous replication, lihat Overview of asynchronous replication for disks.
Jika disk primary atau secondary dari pasangan asynchronous replication berada di wilayah yang ditentukan, kueri akan mengembalikan informasi tentang pasangan replikasi tersebut.
Untuk melakukan kueri berhalaman, gunakan parameter MaxResults dan NextToken. Pada halaman pertama, atur MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam respons merupakan token untuk halaman berikutnya. Untuk halaman selanjutnya, atur NextToken ke nilai dari respons sebelumnya dan tetapkan MaxResults untuk membatasi jumlah entri.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ebs:DescribeDiskReplicaPairs

get

*DiskReplicaPair

acs:ebs:{#regionId}:{#accountId}:diskreplicapair/*

*DiskReplicaPair

acs:ebs:{#regionId}:{#accountId}:diskreplicapair/{#ReplicaPairId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tempat disk primary atau secondary dari pasangan replikasi berada. Panggil operasi DescribeRegions untuk mengkueri wilayah yang mendukung replikasi asinkron.	cn-beijing
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan per halaman. Gunakan parameter ini bersama NextToken. Nilai valid: 1 hingga 500. Nilai default: 10.	1
NextToken	string	No	Token kueri. Atur parameter ini ke nilai NextToken yang dikembalikan dari pemanggilan sebelumnya ke operasi ini. Anda tidak perlu mengatur parameter ini pada pemanggilan pertama. Jika Anda mengatur NextToken, parameter PageSize dan PageNumber akan diabaikan, dan nilai TotalCount dalam respons tidak valid.	AAAAAdDWBF2****
PairIds	string	No	ID pasangan replikasi. Tentukan satu atau beberapa ID pasangan replikasi. ID harus dalam format `pair-cn-dsa**,pair-cn-asd**`. Jika Anda mengosongkan parameter ini, semua pasangan replikasi di wilayah saat ini akan dikueri. Anda dapat menentukan hingga 100 ID pasangan replikasi.	pair-cn-dsa****
Site	string	No	Situs tempat data dikueri. Kueri data dari situs produksi atau situs disaster recovery. Nilai valid: production: situs produksi. backup: situs disaster recovery. Nilai default: production.	production
ReplicaGroupId	string	No	ID grup konsisten pasangan replikasi. Tentukan ID grup konsisten pasangan replikasi untuk mengkueri pasangan replikasi dalam grup tersebut. ID harus dalam format `pg-**`. Jika Anda mengosongkan parameter ini, semua pasangan replikasi di wilayah saat ini akan dikueri. Catatan** Jika Anda mengatur parameter ini ke `-`, pasangan replikasi yang tidak termasuk dalam grup konsisten pasangan replikasi apa pun akan dikembalikan.	pg-****
PageNumber	integer	No	Nomor halaman.	5
PageSize	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 100.	10
ResourceGroupId	string	No	ID kelompok sumber daya tempat pasangan replikasi berada.	rg-acfmvs******
Name	string	No	Nama pasangan replikasi. Pencocokan fuzzy didukung.	name***
Tag	array<object>	No	Tag. Anda dapat menentukan hingga 20 tag.
	object	No	Tag.
Value	string	No	Nilai tag.	TestValue
Key	string	No	Kunci tag.	TestKey

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****
NextToken	string	Token kueri yang dikembalikan dari pemanggilan ini.	AAAAAdDWBF2****
ReplicaPairs	array<object>	Pasangan replikasi.
	array<object>
Site	string	Tipe situs dari pasangan replikasi atau grup konsisten pasangan replikasi. Nilai valid: production: situs produksi. backup: situs disaster recovery.	production
DestinationDiskId	string	ID disk secondary.	d-asdfjl2342kj2l3k4****
Description	string	Deskripsi pasangan replikasi.	This is description.
StandbyZone	string	Zona tujuan awal dari pasangan replikasi.	cn-shanghai-b
ResourceGroupId	string	ID kelompok sumber daya tempat pasangan replikasi berada.	rg-acfmvs*****
DestinationRegion	string	Wilayah disk secondary.	cn-shanghai
ReplicaPairId	string	ID pasangan replikasi.	pair-cn-dsa****
LastRecoverPoint	integer	Waktu ketika replikasi asinkron terakhir selesai. Nilai ini merupakan Stempel waktu UNIX. Satuan: detik.	1649751977
ReplicaGroupId	string	ID grup konsisten pasangan replikasi tempat pasangan replikasi berada.	pg-xxxx****
SourceDiskId	string	ID disk primary.	d-bp131n0q38u3a4zi****
RPO	integer	tujuan titik pemulihan (RPO) dari pasangan replikasi. Satuan: detik.	900
PairName	string	Nama pasangan replikasi.	TestReplicaPair
Bandwidth	integer	Bandwidth yang digunakan untuk replikasi asinkron. Satuan: Kbit/s.	10240
ExpiredTime	integer	Waktu kedaluwarsa pasangan replikasi. Nilai ini merupakan Stempel waktu UNIX. Satuan: detik.	1649750977
PrimaryZone	string	Zona sumber awal dari pasangan replikasi.	cn-beijing-a
SourceZoneId	string	Zona disk primary.	cn-beijing-a
Tags	array<object>	Tag pasangan replikasi.
	object	Tag.
TagKey	string	Kunci tag.	testKey
TagValue	string	Nilai tag.	testValue
Status	string	Status pasangan replikasi. Nilai valid: invalid: Pasangan replikasi tidak valid. Status ini menunjukkan bahwa pasangan replikasi tidak berfungsi dengan benar. creating: Pasangan replikasi sedang dibuat. created: Pasangan replikasi telah dibuat. create_failed: Pembuatan pasangan replikasi gagal. initial_syncing: Pasangan replikasi berada dalam status sinkronisasi awal. Setelah pasangan replikasi dibuat dan dijalankan, ia memasuki status ini selama replikasi asinkron pertama data dari disk primary ke disk secondary. manual_syncing: Pasangan replikasi sedang disinkronkan secara manual. Setelah sinkronisasi manual selesai, pasangan replikasi kembali ke status stopped. Jika ini adalah sinkronisasi satu kali pertama, statusnya juga manual_syncing. syncing: Pasangan replikasi sedang menyinkronkan data. Pasangan replikasi berada dalam status ini ketika data direplikasi secara asinkron dari disk primary ke disk secondary untuk kedua kalinya atau seterusnya. normal: Pasangan replikasi berada dalam status normal. Pasangan replikasi memasuki status ini ketika replikasi data selesai dalam siklus replikasi saat ini. stopping: Pasangan replikasi sedang dihentikan. stopped: Pasangan replikasi dihentikan. stop_failed: Penghentian pasangan replikasi gagal. failovering: Failover sedang berlangsung. failovered: Failover selesai. failover_failed: Failover gagal. reprotecting: Replikasi balik sedang berlangsung. reprotect_failed: Replikasi balik gagal. deleting: Pasangan replikasi sedang dihapus. delete_failed: Penghapusan pasangan replikasi gagal. deleted: Pasangan replikasi telah dihapus.	created
PrimaryRegion	string	Wilayah sumber awal dari pasangan replikasi.	cn-beijing
CreateTime	integer	Waktu pembuatan. Nilai ini merupakan Stempel waktu UNIX. Satuan: detik.	1649750977
SourceRegion	string	Wilayah disk primary.	cn-beijing
StatusMessage	string	Pesan status pasangan replikasi. Parameter ini dikembalikan ketika Status bernilai `invalid` atau `create_failed`. Nilai valid: PrePayOrderExpired: Pasangan replikasi subscription telah kedaluwarsa. PostPayOrderCeaseService: Layanan untuk pasangan replikasi pay-as-you-go dihentikan, biasanya karena Pembayaran tertunda. DeviceRemoved: Disk primary atau secondary telah dihapus. DeviceKeyChanged: Pemetaan `DeviceKey` disk primary atau secondary telah berubah. DeviceSizeChanged: `DeviceSize` disk primary atau secondary telah berubah. OperationDenied.QuotaExceed: Jumlah pasangan replikasi yang dibuat melebihi Kuota.	PrePayOrderExpired
EnableRtc	boolean	Menentukan apakah real-time control (RTC) diaktifkan. Nilai valid: false: Dinonaktifkan. true: Diaktifkan. Catatan Jika pasangan replikasi berada dalam grup konsisten pasangan replikasi, nilai parameter ini sama dengan nilai grup tersebut.
ChargeType	string	metode penagihan pasangan replikasi. Nilai valid: PREPAY: subscription. POSTPAY: pay-as-you-go.	PREPAY
DestinationZoneId	string	Zona disk secondary.	cn-shanghai-b
ReplicaGroupName	string	Nama grup konsisten pasangan replikasi tempat pasangan replikasi berada.	pg-name****
StandbyRegion	string	Wilayah tujuan awal dari pasangan replikasi.	cn-shanghai
PageNumber	integer	Nomor halaman.	1
PageSize	integer	Jumlah entri per halaman.	10
TotalCount	integer	Total jumlah entri.	60

Contoh

Respons sukses

JSONformat

{
  "RequestId": "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken": "AAAAAdDWBF2****",
  "ReplicaPairs": [
    {
      "Site": "production",
      "DestinationDiskId": "d-asdfjl2342kj2l3k4****",
      "Description": "This is description.",
      "StandbyZone": "cn-shanghai-b",
      "ResourceGroupId": "rg-acfmvs*****",
      "DestinationRegion": "cn-shanghai",
      "ReplicaPairId": "pair-cn-dsa****",
      "LastRecoverPoint": 1649751977,
      "ReplicaGroupId": "pg-xxxx****",
      "SourceDiskId": "d-bp131n0q38u3a4zi****",
      "RPO": 900,
      "PairName": "TestReplicaPair",
      "Bandwidth": 10240,
      "ExpiredTime": 1649750977,
      "PrimaryZone": "cn-beijing-a",
      "SourceZoneId": "cn-beijing-a",
      "Tags": [
        {
          "TagKey": "testKey",
          "TagValue": "testValue"
        }
      ],
      "Status": "created",
      "PrimaryRegion": "cn-beijing",
      "CreateTime": 1649750977,
      "SourceRegion": "cn-beijing",
      "StatusMessage": "PrePayOrderExpired",
      "EnableRtc": false,
      "ChargeType": "PREPAY",
      "DestinationZoneId": "cn-shanghai-b",
      "ReplicaGroupName": "pg-name****",
      "StandbyRegion": "cn-shanghai"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 60
}

Kode kesalahan

HTTP status code	Error code	Error message
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	OperationDenied	The operation is not allowed.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.
403	Forbidden	User is not authorized to operate.
403	Forbidden.Action	User is not authorized to operate this action.
404	NoSuchResource	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.