All Products
Search

This Product

    Elastic Compute Service:DescribeDiskReplicaPairs

    Document Center

    Elastic Compute Service:DescribeDiskReplicaPairs

    Last Updated:Jun 10, 2026

    Mengkueri informasi tentang satu atau beberapa pasangan replikasi di region yang ditentukan.

    Deskripsi operasi

    Deskripsi

    • Untuk informasi tentang region yang mendukung replikasi asinkron, lihat Ikhtisar replikasi asinkron untuk disk.

    • Jika disk primer atau sekunder dari pasangan replikasi asinkron berada di region yang ditentukan, kueri akan mengembalikan informasi tentang pasangan replikasi tersebut.

    • Untuk melakukan kueri berhalaman, gunakan parameter MaxResults dan NextToken. Untuk halaman pertama, atur MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam respons adalah token untuk halaman berikutnya. Untuk halaman selanjutnya, atur NextToken ke nilai dari respons sebelumnya dan atur 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 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region tempat disk primer atau sekunder dari pasangan replikasi berada. Panggil operasi DescribeRegions untuk mengkueri region yang mendukung replikasi asinkron.

    cn-beijing
    MaxResults

    integer

    No

    Jumlah maksimum entri yang dikembalikan pada setiap halaman. Gunakan parameter ini dengan NextToken.

    Nilai yang valid: 1 hingga 500.

    Nilai default: 10.

    1
    NextToken

    string

    No

    Token kueri. Atur parameter ini ke nilai NextToken yang dikembalikan dari panggilan sebelumnya ke operasi ini. Anda tidak perlu mengatur parameter ini untuk panggilan 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 region saat ini akan dikueri. Anda dapat menentukan hingga 100 ID pasangan replikasi.

    pair-cn-dsa****
    Site

    string

    No

    Site tempat data akan dikueri. Kueri data dari site produksi atau site disaster recovery. Nilai yang valid:

    • production: site produksi.

    • backup: site 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. ID harus dalam format pg-****.

    Jika Anda mengosongkan parameter ini, semua pasangan replikasi di region saat ini akan dikueri.

    Catatan

    Jika Anda mengatur parameter ini ke -, pasangan replikasi yang tidak berada dalam grup konsisten pasangan replikasi mana pun akan dikembalikan.

    pg-****
    PageNumber

    integer

    No

    Nomor halaman.

    5
    PageSize

    integer

    No

    Jumlah entri per halaman. Nilai yang valid: 1 hingga 100.

    10
    ResourceGroupId

    string

    No

    ID grup 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 panggilan ini.

    AAAAAdDWBF2****
    ReplicaPairs

    array<object>

    Pasangan replikasi.

    array<object>

    Site

    string

    Tipe site dari pasangan replikasi atau grup konsisten pasangan replikasi. Nilai yang valid:

    • production: site produksi.

    • backup: site disaster recovery.

    production
    DestinationDiskId

    string

    ID disk sekunder.

    d-asdfjl2342kj2l3k4****
    Description

    string

    Deskripsi pasangan replikasi.

    This is description.
    StandbyZone

    string

    Zona tujuan awal pasangan replikasi.

    cn-shanghai-b
    ResourceGroupId

    string

    ID grup sumber daya tempat pasangan replikasi berada.

    rg-acfmvs*****
    DestinationRegion

    string

    Region disk sekunder.

    cn-shanghai
    ReplicaPairId

    string

    ID pasangan replikasi.

    pair-cn-dsa****
    LastRecoverPoint

    integer

    Waktu ketika replikasi asinkron terakhir selesai. Nilai ini adalah UNIX timestamp. Satuan: detik.

    1649751977
    ReplicaGroupId

    string

    ID grup konsisten pasangan replikasi tempat pasangan replikasi berada.

    pg-xxxx****
    SourceDiskId

    string

    ID disk primer.

    d-bp131n0q38u3a4zi****
    RPO

    integer

    Recovery point objective (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 adalah UNIX timestamp. Satuan: detik.

    1649750977
    PrimaryZone

    string

    Zona sumber awal pasangan replikasi.

    cn-beijing-a
    SourceZoneId

    string

    Zona disk primer.

    cn-beijing-a
    Tags

    array<object>

    Tag dari pasangan replikasi.

    object

    Tag.

    TagKey

    string

    The key of the tag.

    testKey
    TagValue

    string

    The value of the tag.

    testValue
    Status

    string

    Status pasangan replikasi. Nilai yang 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: Pasangan replikasi gagal dibuat.

    • initial_syncing: Pasangan replikasi dalam status sinkronisasi awal. Setelah pasangan replikasi dibuat dan dimulai, pasangan tersebut memasuki status ini selama replikasi asinkron pertama data dari disk primer ke disk sekunder.

    • manual_syncing: Pasangan replikasi sedang disinkronkan secara manual. Setelah sinkronisasi manual selesai, pasangan replikasi kembali ke status stopped. Jika ini adalah sinkronisasi one-time pertama, statusnya juga manual_syncing.

    • syncing: Pasangan replikasi sedang menyinkronkan data. Pasangan replikasi berada dalam status ini ketika data direplikasi secara asinkron dari disk primer ke disk sekunder untuk kedua kalinya atau selanjutnya.

    • normal: Pasangan replikasi 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: Pasangan replikasi gagal dihentikan.

    • failovering: Failover sedang berlangsung.

    • failovered: Failover selesai.

    • failover_failed: Failover gagal.

    • reprotecting: Replikasi sebaliknya sedang berlangsung.

    • reprotect_failed: Replikasi sebaliknya gagal.

    • deleting: Pasangan replikasi sedang dihapus.

    • delete_failed: Pasangan replikasi gagal dihapus.

    • deleted: Pasangan replikasi telah dihapus.

    created
    PrimaryRegion

    string

    Region sumber awal pasangan replikasi.

    cn-beijing
    CreateTime

    integer

    Waktu pembuatan. Nilai ini adalah UNIX timestamp. Satuan: detik.

    1649750977
    SourceRegion

    string

    Region disk primer.

    cn-beijing
    StatusMessage

    string

    Pesan status pasangan replikasi. Parameter ini dikembalikan ketika Status adalah invalid atau create_failed. Nilai yang valid:

    • PrePayOrderExpired: Pasangan replikasi langganan telah kedaluwarsa.

    • PostPayOrderCeaseService: Layanan untuk pasangan replikasi pay-as-you-go ditangguhkan, biasanya karena pembayaran tertunggak.

    • DeviceRemoved: Disk primer atau sekunder telah dihapus.

    • DeviceKeyChanged: Pemetaan DeviceKey dari disk primer atau sekunder telah berubah.

    • DeviceSizeChanged: DeviceSize dari disk primer atau sekunder telah berubah.

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

    PrePayOrderExpired
    EnableRtc

    boolean

    Menentukan apakah real-time control (RTC) diaktifkan. Nilai yang 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 yang valid:

    • PREPAY: langganan.

    • POSTPAY: pay-as-you-go.

    PREPAY
    DestinationZoneId

    string

    Zona disk sekunder.

    cn-shanghai-b
    ReplicaGroupName

    string

    Nama grup konsisten pasangan replikasi tempat pasangan replikasi berada.

    pg-name****
    StandbyRegion

    string

    Region tujuan awal pasangan replikasi.

    cn-shanghai
    PageNumber

    integer

    Nomor halaman.

    1
    PageSize

    integer

    Jumlah entri per halaman.

    10
    TotalCount

    integer

    Jumlah total 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

    Description
    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.