Instance Failover Groups - List By Location

Membuat daftar grup failover di lokasi.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups?api-version=2021-02-01-preview

Parameter URI

Name In Required Type Description
locationName
path True
  • string

Nama wilayah tempat sumber daya berada.

resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Respons

Name Type Description
200 OK

Berhasil mengambil grup failover.

Other Status Codes

Respons Kesalahan: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - Bidang mitra yang diberikan dalam membuat atau memperbarui isi permintaan grup failover instans kosong atau tidak valid.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - Satu atau beberapa server mitra yang disediakan sudah menjadi bagian dari grup failover instans. Pastikan server utama dan semua server mitra yang diberikan unik.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - Wilayah instans terkelola mitra yang disediakan dalam isi permintaan grup failover instans kosong atau tidak valid.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Hanya satu wilayah mitra yang didukung.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Hanya satu pasangan instans terkelola yang didukung.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - Bidang readWriteEndpoint diperlukan untuk membuat atau memperbarui permintaan.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - Isi permintaan grup failover instans buat atau perbarui kosong atau tidak valid.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - Modifikasi pada grup failover instans tidak diizinkan di server sekunder. Jalankan permintaan di server utama.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - Nilai masa tenggang untuk titik akhir baca-tulis harus non-negatif.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Properti failoverWithDataLossGracePeriodMinutes harus disediakan ketika kebijakan failover Otomatis dipilih untuk titik akhir baca-tulis.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Bidang failoverPolicy untuk titik akhir baca-tulis diperlukan untuk membuat atau memperbarui permintaan.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Nilai masa tenggang tidak boleh disediakan saat kebijakan failover Manual dipilih untuk titik akhir baca-tulis.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - Isi permintaan grup failover instans buat atau perbarui tidak boleh memodifikasi properti baca-saja '{0}'.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary - Permintaan failover harus dimulai pada server sekunder grup failover instans.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Server utama dan server mitra grup failover berasal dari langganan yang berbeda. Langganan silang untuk server grup failover tidak diperbolehkan.

  • 400 InvalidTargetSubregion - Server target sekunder yang tidak dapat dibaca tidak berada di wilayah Azure berpasangan DR.

  • 400 GeoDrInstanceSizeMismatch - Instans terkelola utama dan instans terkelola mitra tidak memiliki ukuran penyimpanan yang sama.

  • 400 SecurityAdalPrincipalCertExpiredError - Operasi tidak dapat diselesaikan karena sertifikat utama Azure Key Vault telah kedaluwarsa.

  • 400 GeoDrSecondaryInstanceNotEmpty - Instans terkelola sekunder memiliki database pengguna. Untuk membuat grup failover instans, instans terkelola sekunder harus kosong.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Konfigurasi jaringan salah. Lalu lintas replikasi server utama tidak dapat mencapai server sekunder.

  • 400 IncorrectReplicationLinkState - Operasi mengharapkan database berada dalam status yang diharapkan pada tautan replikasi.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - Uri Key Vault yang disediakan tidak valid.

  • 400 KeyMaterialNotFoundOnRemoteServer - Server jarak jauh tidak memiliki akses ke materi kunci yang digunakan sebagai pelindung TDE.

  • 400 AzureKeyVaultMismatchError - Wilayah Key Vault tak terduga ditemukan dalam respons http.

  • 400 AzureKeyVaultRsaKeyNotSupported - Brankas kunci yang disediakan menggunakan Ukuran Kunci RSA atau Jenis Kunci yang tidak didukung. Ukuran kunci RSA yang didukung adalah 2048 atau 3072 dan Jenis Kunci adalah RSA atau RSA-HSM.

  • 400 UnableToResolveRemoteServer - Nama server mitra jarak jauh tidak dapat diselesaikan karena nama server atau masalah konektivitas DNS yang tidak valid.

  • 400 RemoteDatabaseCopyPermission - Pengguna tidak memiliki izin yang memadai untuk membuat salinan database di server yang ditentukan.

  • 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini.

  • 400 InvalidFailoverGroupRegion - Server yang ditentukan dalam Grup Failover Instans harus berada di wilayah yang berbeda untuk memberikan isolasi.

  • 400 InstanceFailoverGroupDoesNotExist - Grup failover tidak ada di server.

  • 400 InstanceFailoverGroupNotSecondary - Failover tidak dapat dimulai dari server utama dalam grup failover instans.

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid.

  • 400 TokenTooLong - Token yang disediakan terlalu panjang.

  • 400 AzureKeyVaultKeyDisabled - Operasi tidak dapat diselesaikan di server karena kunci Azure Key Vault dinonaktifkan.

  • 400 AzureKeyVaultInvalidExpirationDate - Operasi tidak dapat diselesaikan karena tanggal kedaluwarsa kunci Azure Key Vault tidak valid.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Operasi tidak dapat diselesaikan karena Azure Key Vault Uri null atau kosong.

  • 400 InvalidSku - Pengguna menentukan sku yang tidak valid.

  • 400 InvalidAddSecondaryPermission - Pengguna tidak memiliki izin yang memadai untuk menambahkan sekunder pada server yang ditentukan.

  • 400 ServerNotFound - Server yang diminta tidak ditemukan.

  • 400 AzureKeyVaultNoServerIdentity - Identitas server tidak dikonfigurasi dengan benar.

  • 400 AzureKeyVaultInvalidUri - Respons yang tidak valid dari Azure Key Vault. Gunakan Azure Key Vault URI yang valid.

  • 400 AzureKeyVaultMissingPermissions - Server kehilangan izin yang diperlukan di Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName - Operasi tidak dapat diselesaikan karena nama Kunci Server yang tidak valid.

  • 400 PlannedFailoverTimedOutForDatabase - Pengguna memanggil failover yang direncanakan, waktunya habis, dan database tertentu tampaknya harus disalahkan.

  • 400 PlannedFailoverTimedOut - Pengguna memanggil failover yang direncanakan, dan waktunya habis saat mencoba menghubungi layanan manajemen mitra.

  • 400 AdalGenericError - Operasi tidak dapat diselesaikan karena terjadi kesalahan Azure Active Directory.

  • 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi.

  • 400 AdalServicePrincipalNotFound - Operasi tidak dapat diselesaikan karena pustaka Azure Active Directory Perwakilan Layanan tidak menemukan kesalahan yang ditemukan.

  • 400 AzureKeyVaultMalformedVaultUri - uri Key Vault yang disediakan tidak valid.

  • 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 SourceDatabaseNotFound - Database sumber tidak ada.

  • 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan.

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 405 UnsupportedReplicationOperation - Operasi replikasi yang tidak didukung dimulai pada database.

  • 409 ManagedInstanceHasHybridLink - Pengguna mencoba memulai operasi yang tidak didukung ketika instans terkelola memiliki tautan hibrid yang dikonfigurasi.

  • 409 RemoteDatabaseExists - Nama database tujuan sudah ada di server tujuan.

  • 409 ConflictingServerOperation - Operasi saat ini sedang berlangsung untuk server.

  • 409 SubscriptionDisabled - Langganan dinonaktifkan.

  • 409 InstanceFailoverGroupAlreadyExists - Grup failover sudah ada di server tertentu.

  • 409 InstanceFailoverGroupBusy - Grup failover instans sibuk dengan operasi lain.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - Pengguna mencoba melakukan failover atau menghentikan paksa geo-link saat sekunder berada dalam keadaan di mana mungkin tidak konsisten secara fisik sehingga tidak dapat memasukkan peran utama.

  • 409 InstanceFailoverGroupDnsRecordInUse - Ada catatan DNS duplikat untuk titik akhir yang diminta.

  • 409 ServerKeyNameAlreadyExists - Kunci server sudah ada di server.

  • 409 ServerKeyUriAlreadyExists - URI kunci server sudah ada di server.

  • 409 ServerKeyDoesNotExists - Kunci server tidak ada.

  • 409 InvalidFailoverGroupName - Nama Grup Failover Instans Tidak Valid disediakan.

  • 409 UpdateSloInProgress - Pengguna mencoba memulai operasi yang tidak kompatibel saat pembaruan SLO sedang berlangsung.

  • 409 AzureKeyVaultKeyNameNotFound - Operasi tidak dapat diselesaikan karena nama Azure Key Vault Key tidak ada.

  • 409 AzureKeyVaultKeyInUse - Kunci saat ini sedang digunakan oleh server.

  • 409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu sampai selesai.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - Operasi penyemaian replikasi dilakukan pada database yang sudah berada dalam hubungan replikasi.

  • 409 InvalidDatabaseStateForOperation - Operasi tidak diizinkan pada database dalam status replikasi saat ini.

  • 409 DuplicateGeoDrRelation - Database sudah berada dalam relasi replikasi. Ini adalah permintaan duplikat.

  • 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 503 AzureKeyVaultConnectionFailed - Operasi tidak dapat diselesaikan di server karena upaya untuk menyambungkan ke Azure Key Vault gagal

  • 503 AzureKeyVaultGenericConnectionError - Operasi tidak dapat diselesaikan karena terjadi kesalahan saat mencoba mengambil informasi Key Vault .

  • 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan.

Contoh

List failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test",
      "name": "failover-group-test",
      "type": "Microsoft.Sql/locations/failoverGroups",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerRegions": [
          {
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "managedInstancePairs": [
          {
            "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-1",
      "name": "failover-group-test-1",
      "type": "Microsoft.Sql/locations/failoverGroups",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerRegions": [
          {
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "managedInstancePairs": [
          {
            "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance-1",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance-1"
          }
        ]
      }
    }
  ]
}

Definisi

InstanceFailoverGroup

Grup failover instans.

InstanceFailoverGroupListResult

Daftar grup failover instans.

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

ManagedInstancePairInfo

Pasangan Instans Terkelola dalam grup failover.

PartnerRegionInfo

Informasi wilayah mitra untuk grup failover.

ReadOnlyEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

ReadWriteEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

InstanceFailoverGroup

Grup failover instans.

Name Type Description
id
  • string

ID Sumber Daya.

name
  • string

Nama sumber daya.

properties.managedInstancePairs

Daftar pasangan instans terkelola dalam grup failover.

properties.partnerRegions

Informasi wilayah mitra untuk grup failover.

properties.readOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

properties.readWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

properties.replicationRole

Peran replikasi lokal instans grup failover.

properties.replicationState
  • string

Status replikasi instans grup failover.

type
  • string

Jenis sumber daya

InstanceFailoverGroupListResult

Daftar grup failover instans.

Name Type Description
nextLink
  • string

Tautan untuk mengambil halaman hasil berikutnya.

value

Array hasil.

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

Name Type Description
failoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

Name Type Description
failoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

failoverWithDataLossGracePeriodMinutes
  • integer

Masa tenggang sebelum failover dengan kehilangan data dicoba untuk titik akhir baca-tulis. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

Pasangan Instans Terkelola dalam grup failover.

Name Type Description
partnerManagedInstanceId
  • string

Id Instans Terkelola Mitra berpasangan.

primaryManagedInstanceId
  • string

Id Instans Terkelola Utama berpasangan.

PartnerRegionInfo

Informasi wilayah mitra untuk grup failover.

Name Type Description
location
  • string

Lokasi geografis instans terkelola mitra.

replicationRole

Peran replikasi instans terkelola mitra.

ReadOnlyEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

Name Type Description
Disabled
  • string
Enabled
  • string

ReadWriteEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

Name Type Description
Automatic
  • string
Manual
  • string