全部产品
Search
文档中心

Elastic Compute Service:DescribeDiskReplicaGroups

更新时间:Dec 21, 2025

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

Deskripsi operasi

Description

Untuk melakukan kueri berhalaman, tentukan parameter MaxResults dan NextToken.

Saat melakukan kueri berhalaman untuk halaman pertama, atur parameter MaxResults untuk membatasi jumlah item yang dikembalikan. Nilai NextToken dalam respons berfungsi sebagai token untuk mengambil halaman berikutnya. Untuk mengambil halaman berikutnya, atur parameter NextToken ke nilai NextToken yang diperoleh dari respons sebelumnya.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah dari grup konsisten pasangan replikasi.

cn-beijing

MaxResults

integer

No

Jumlah maksimum entri yang dikembalikan untuk satu kueri. Anda dapat menggunakan parameter ini bersama NextToken.

Nilai valid: 1 hingga 500.

Nilai default: 10.

10

NextToken

string

No

Token kueri. Atur parameter ini ke nilai NextToken yang dikembalikan dari pemanggilan operasi ini sebelumnya. Anda tidak perlu mengatur parameter ini pada pemanggilan pertama. Jika Anda mengatur NextToken, parameter PageSize dan PageNumber akan diabaikan, dan TotalCount dalam respons tidak valid.

AAAAAdDWBF2****

GroupIds

string

No

ID grup konsisten pasangan replikasi. Anda dapat menentukan satu atau beberapa ID grup konsisten pasangan replikasi. Pisahkan beberapa ID dengan koma (,).

Nilai default kosong, yang berarti semua grup konsisten pasangan replikasi di wilayah saat ini akan ditanyakan. Anda dapat menentukan hingga 100 ID grup replikasi.

AAAAAdDWBF2****

Site

string

No

Menanyakan dan mengembalikan catatan dari situs tertentu. Parameter ini terutama digunakan untuk pasangan replikasi yang ditempatkan di zona berbeda.

  • Jika Anda tidak menentukan parameter ini, catatan dan informasi status pasangan replikasi di situs produksi akan dikembalikan.

  • Jika Anda menentukan parameter ini, hanya catatan dan informasi status pasangan replikasi di situs yang ditentukan yang akan dikembalikan. Nilai valid:

    • production: Situs produksi.

    • backup: Situs disaster recovery.

production

PageNumber

integer

No

Nomor halaman untuk kueri berhalaman.

5

PageSize

integer

No

Jumlah entri yang dikembalikan di setiap halaman untuk kueri berhalaman. Nilai valid: 1 hingga 100.

10

ResourceGroupId

string

No

ID kelompok sumber daya tempat grup konsisten pasangan replikasi berada.

rg-aekz*****

Name

string

No

Nama grup replikasi. Pencocokan fuzzy didukung.

pg-name***

Tag

array<object>

No

Daftar tag. Daftar ini dapat berisi hingga 20 tag.

object

No

Tag tersebut.

Value

string

No

Nilai tag dari grup konsisten pasangan replikasi.

tag-value

Key

string

No

Kunci tag dari grup konsisten pasangan replikasi.

tag-key

Elemen respons

Element

Type

Description

Example

object

Skema respons.

RequestId

string

ID permintaan.

AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****

NextToken

string

Token kueri yang dikembalikan dalam pemanggilan ini.

AAAAAdDWBF2****

ReplicaGroups

array<object>

Kumpulan informasi grup konsisten pasangan replikasi.

array<object>

GroupName

string

Nama grup konsisten pasangan replikasi.

myreplicagrouptest

Site

string

Sumber informasi situs dari pasangan replikasi dan grup konsisten pasangan replikasi. Nilai valid:

  • production: Situs produksi.

  • backup: Situs disaster recovery.

production

Description

string

Deskripsi grup konsisten pasangan replikasi.

This is description.

StandbyZone

string

Zona tujuan awal dari grup replikasi.

cn-shanghai-e

ResourceGroupId

string

ID kelompok sumber daya tempat grup replikasi berada.

rg-aek2a*******

LastRecoverPoint

integer

Waktu ketika replikasi asinkron terakhir selesai untuk grup konsisten pasangan replikasi. Parameter ini merupakan Stempel waktu UNIX. Satuan: detik.

1637835114

ReplicaGroupId

string

ID grup konsisten pasangan replikasi.

pg-myreplica****

RPO

integer

RPO dari grup konsisten pasangan replikasi. Satuan: detik.

180

SourceRegionId

string

ID wilayah situs produksi.

cn-beijing

DestinationRegionId

string

ID wilayah situs disaster recovery.

cn-shanghai

Bandwidth

integer

Bandwidth. Satuan: Kbit/s. Parameter ini belum tersedia. Nilai kembali telah ditetapkan oleh sistem.

0

PrimaryZone

string

Zona sumber awal dari grup replikasi.

cn-beijing-h

SourceZoneId

string

ID zona situs produksi.

cn-beijing-f

Tags

array<object>

Tag dari grup replikasi.

object

TagKey

string

Kunci tag dari grup replikasi.

testKey

TagValue

string

Nilai tag dari grup replikasi.

testValue

Status

string

Status grup konsisten pasangan replikasi. Nilai valid:

  • invalid: Grup konsisten pasangan replikasi tidak valid. Status ini menunjukkan bahwa ada pasangan replikasi dalam grup yang abnormal.

  • creating: Grup konsisten pasangan replikasi sedang dibuat.

  • created: Grup konsisten pasangan replikasi telah dibuat.

  • create_failed: Pembuatan grup konsisten pasangan replikasi gagal.

  • manual_syncing: Grup konsisten pasangan replikasi sedang menjalankan sinkronisasi satu kali. Grup juga berada dalam status ini selama sinkronisasi satu kali pertama.

  • syncing: Grup konsisten pasangan replikasi sedang menyinkronkan data. Saat data direplikasi secara asinkron dari disk primer ke disk sekunder untuk kali berikutnya, grup berada dalam status ini.

  • normal: Normal. Saat replikasi data selesai dalam siklus replikasi asinkron saat ini, grup berada dalam status ini.

  • stopping: Grup konsisten pasangan replikasi sedang dihentikan.

  • stopped: Grup konsisten pasangan replikasi telah dihentikan.

  • stop_failed: Penghentian grup konsisten pasangan replikasi gagal.

  • failovering: Failover sedang dilakukan.

  • failovered: Failover telah selesai.

  • failover_failed: Failover gagal.

  • reprotecting: Replikasi balik sedang dilakukan.

  • reprotect_failed: Replikasi balik gagal.

  • deleting: Grup konsisten pasangan replikasi sedang dihapus.

  • delete_failed: Penghapusan grup konsisten pasangan replikasi gagal.

  • deleted: Grup konsisten pasangan replikasi telah dihapus.

created

PairNumber

integer

Jumlah pasangan replikasi dalam grup konsisten pasangan replikasi.

2

PrimaryRegion

string

Wilayah sumber awal dari grup replikasi.

cn-beijing

PairIds

array

Daftar ID pasangan replikasi dalam grup konsisten pasangan replikasi.

string

Daftar ID pasangan replikasi dalam grup konsisten pasangan replikasi.

pair-cn-dsa****,pair-cn-asd****

EnableRtc

boolean

Menunjukkan apakah kontrol waktu replikasi diaktifkan.

true

DestinationZoneId

string

ID zona situs disaster recovery.

cn-shanghai-e

StandbyRegion

string

Wilayah tujuan awal dari grup replikasi.

cn-shanghai

PageNumber

integer

Nomor halaman untuk kueri berhalaman.

1

PageSize

integer

Jumlah entri yang dikembalikan per halaman untuk kueri berhalaman.

10

TotalCount

integer

Total jumlah entri yang dikembalikan untuk kueri berhalaman.

60

Contoh

Respons sukses

JSONformat

{
  "RequestId": "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken": "AAAAAdDWBF2****",
  "ReplicaGroups": [
    {
      "GroupName": "myreplicagrouptest",
      "Site": "production",
      "Description": "This is description.",
      "StandbyZone": "cn-shanghai-e",
      "ResourceGroupId": "rg-aek2a*******",
      "LastRecoverPoint": 1637835114,
      "ReplicaGroupId": "pg-myreplica****",
      "RPO": 180,
      "SourceRegionId": "cn-beijing",
      "DestinationRegionId": "cn-shanghai",
      "Bandwidth": 0,
      "PrimaryZone": "cn-beijing-h",
      "SourceZoneId": "cn-beijing-f",
      "Tags": [
        {
          "TagKey": "testKey",
          "TagValue": "testValue"
        }
      ],
      "Status": "created",
      "PairNumber": 2,
      "PrimaryRegion": "cn-beijing",
      "PairIds": [
        "pair-cn-dsa****,pair-cn-asd****"
      ],
      "EnableRtc": true,
      "DestinationZoneId": "cn-shanghai-e",
      "StandbyRegion": "cn-shanghai\n"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 60
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError The request processing has failed due to some unknown error, exception or failure. An internal error has occurred.
403 OperationDenied The operation is not allowed. The operation is not supported.
403 OperationDenied.InvalidStatus The operation is not allowed in current status. The operation is not supported in the current state.
403 Forbidden User is not authorized to operate. You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account.
403 Forbidden.Action User is not authorized to operate this action. You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account.
404 NoSuchResource The specified resource does not exist. The specified resource does not exist.
504 RequestTimeout The request is timeout, please try again later. The request has timed out. Try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.