全部产品
Search

搜索本产品

    Elastic Compute Service：DescribeDiskReplicaPairs

    文档中心

    Elastic Compute Service：DescribeDiskReplicaPairs

    更新时间：Dec 21, 2025

    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 suatu pasangan replikasi berada di wilayah yang ditentukan, kueri akan mengembalikan informasi mengenai 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

    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 tempat disk primary atau secondary dari pasangan replikasi berada. Anda dapat memanggil operasi DescribeRegions untuk menanyakan wilayah yang mendukung replikasi asinkron.

    cn-beijing
    MaxResults

    integer

    No

    Jumlah maksimum entri yang dikembalikan per halaman. Anda dapat menggunakan 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. Anda dapat menentukan 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 ditanyakan. Anda dapat menentukan hingga 100 ID pasangan replikasi.

    pair-cn-dsa****
    Site

    string

    No

    Situs tempat data ditanyakan. Anda dapat menanyakan 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. Anda dapat menentukan ID grup konsisten pasangan replikasi untuk menanyakan pasangan replikasi dalam grup tersebut. ID harus dalam format pg-****.

    Jika Anda mengosongkan parameter ini, semua pasangan replikasi di wilayah saat ini akan ditanyakan.

    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

    Jenis 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, pasangan ini 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 telah dihentikan.

    • stop_failed: Penghentian pasangan replikasi gagal.

    • failovering: Failover sedang berlangsung.

    • failovered: Failover telah 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 dari disk primary atau secondary telah berubah.

    • DeviceSizeChanged: DeviceSize dari disk primary atau secondary telah berubah.

    • OperationDenied.QuotaExceed: Jumlah pasangan replikasi yang dibuat melebihi Kuota.

    PrePayOrderExpired
    EnableRtc

    boolean

    Menunjukkan apakah real-time replication control (RTC) diaktifkan. 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": true,
      "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

    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.