Bagikan melalui

Instance Failover Groups - Get

Layanan:
SQL Database
Versi API:
2023-08-01

Mendapatkan grup failover.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
failoverGroupName
 path True

string

Nama grup failover.
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 API Azure Resource Manager atau portal.
subscriptionId
 path True

string

ID langganan yang mengidentifikasi langganan Azure.
api-version
 query True

string

Versi API yang akan digunakan untuk permintaan tersebut.

Respons

Nama Jenis Deskripsi
200 OK

InstanceFailoverGroup

Berhasil mengambil grup failover yang ditentukan.
Other Status Codes

ErrorResponse

Respons Kesalahan: ***

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

  • 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 di 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 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Nilai masa tenggang untuk grup failover instans harus lebih besar dari atau sama dengan '{0}' menit masa tenggang minimum

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Properti failoverWithDataLossGracePeriodMinutes harus disediakan saat 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 diizinkan.

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

  • 400 InvalidSku - Pengguna menentukan sku yang tidak valid.

  • 400 ServerNotFound - Server yang diminta tidak ditemukan.

  • 400 ServerEditionMismatch - Edisi harus sama dengan server utama saat membuat server replika.

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

  • 400 TokenTooLong - Token yang disediakan terlalu panjang.

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

  • 400 ManagedInstanceStoppingOrStopped - Operasi yang bertentangan dikirimkan saat instans dalam status berhenti/dihentikan

  • 400 ManagedInstanceStarting - Operasi bertentangan yang dikirimkan saat instans dalam status mulai

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

  • 400 CloudLifterFogInaccessibleDbRoleMismatch - Tidak dapat membuat database {0} pada SQL Managed Instance {1} dapat diakses karena peran instans dalam grup failover berubah dari {2} ke {3} saat database berada dalam status tidak dapat diakses. Harap pulihkan peran database asli dengan menjalankan geo-failover dan coba lagi.

  • 400 CloudLifterGeodrBlocksDbActivate - Tidak dapat membuat database {0} pada SQL Managed Instance {1} dapat diakses karena operasi geodr yang sedang berlangsung. Harap tunggu hingga operasi yang berkonflik selesai dan coba lagi.

  • 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 AzureKeyVaultNoServerIdentity - Identitas server tidak dikonfigurasi dengan benar.

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

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

  • 400 SecurityAzureKeyVaultInvalidKeyName - Operasi tidak dapat diselesaikan karena nama Kunci Server 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 AdalServicePrincipalNotFound - Operasi tidak dapat diselesaikan karena Perwakilan Layanan pustaka Azure Active Directory tidak menemukan kesalahan.

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

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

  • 400 InvalidFailoverGroupRegion - Server yang ditentukan dalam Grup Failover Instans perlu 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 ManagedInstanceGeoDRNotAllowedForInstancePool - Membuat grup failover otomatis (GeoDR) tidak didukung untuk Instans Terkelola yang disediakan di dalam kumpulan instans. Grup failover otomatis hanya dapat dibuat untuk Instans Terkelola mandiri.

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - Grup failover tidak dapat dibuat karena format database instans utama tidak kompatibel dengan format database instans sekunder. Lihat https://go.microsoft.com/fwlink/?linkid=2251601 untuk detail selengkapnya.

  • 400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions - Operasi failover tidak dapat dilakukan karena format database tidak cocok antara instans dalam grup failover. Pertimbangkan untuk meningkatkan format database instans utama atau menghapus grup failover untuk mempromosikan instans sekunder saat ini ke instans mandiri. Lihat https://go.microsoft.com/fwlink/?linkid=2251601 untuk detail selengkapnya.

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

  • 400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium - Menyebarkan grup failover tidak didukung dengan penawaran Azure SQL Managed Instance gratis.

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

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

  • 400 ManagedInstanceGeoFailoverCannotBeExecuted - Geo-failover Instans Terkelola tidak dapat dijalankan saat ini. Alasan: '{0}'.

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

  • 400 SameKeyUriNotFoundOnRemoteServer - Server sekunder tidak memiliki materi kunci dari brankas kunci yang sama dengan pelindung enkripsi server utama dengan rotasi otomatis kunci diaktifkan.

  • 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 SameKeyMaterialNotFoundOnRemoteServer - Server sekunder tidak memiliki materi kunci pelindung enkripsi server utama.

  • 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi.

  • 400 ManagedInstanceUpdateSloOngoing - Operasi tidak dapat diselesaikan karena perubahan tingkat layanan sedang berlangsung untuk instans terkelola '{0}.' Harap tunggu hingga operasi sedang berlangsung selesai, lalu coba lagi.

  • 400 FailoverGroupRegionMismatch - Wilayah mitra yang ditentukan dalam Grup Failover harus sesuai dengan wilayah instans terkelola mitra yang ditunjukkan.

  • 400 DnsZoneMismatch - DNSZone di server mitra berbeda dari DNSZone di server sumber. Ini memutus fungsionalitas InstanceFailoverGroup.

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

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

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

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

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

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

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

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

  • 404 SourceDatabaseNotFound - Database sumber tidak ada.

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

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

  • 409 SubscriptionDisabled - Langganan dinonaktifkan.

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

  • 409 ManagedInstanceContainsInaccessibleDatabases - Operasi tidak dapat diselesaikan karena instans terkelola '{0}' berisi database yang berada dalam status Tidak Dapat Diakses. Silakan hilangkan database yang tidak dapat diakses atau perbaiki masalah dengan akses ke kunci pelindung TDE yang dikelola pelanggan untuk instans terkelola sebelum mencoba kembali operasi. https://go.microsoft.com/fwlink/?linkid=2111623

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

  • 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 ServerKeyNameAlreadyExists - Kunci server sudah ada di server.

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

  • 409 ServerKeyDoesNotExists - Kunci server tidak ada.

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

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

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

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

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

  • 409 InstanceFailoverGroupDnsRecordInUse - Catatan DNS duplikat ada untuk titik akhir yang diminta.

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

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

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

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

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

  • 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 telah 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

Get failover group

Permintaan sampel

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test?api-version=2023-08-01

Respon sampel

Kode status:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "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"
      }
    ],
    "secondaryType": "Geo"
  }
}

Definisi

Nama Deskripsi
ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.
ErrorDetail

Detail kesalahan.
ErrorResponse

Respons kesalahan
InstanceFailoverGroup

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 Adalah Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.
SecondaryInstanceType

Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.
type

string

Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.
code

string

Kode kesalahan.
details

ErrorDetail[]

Detail kesalahan.
message

string

Pesan kesalahan.
target

string

Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

InstanceFailoverGroup

Objek

Grup failover instans.

Nama Jenis Deskripsi
id

string

ID Sumber Daya.
name

string

Nama sumber daya.
properties.managedInstancePairs

ManagedInstancePairInfo[]

Daftar pasangan instans terkelola dalam grup failover.
properties.partnerRegions

PartnerRegionInfo[]

Informasi wilayah mitra untuk grup failover.
properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.
properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.
properties.replicationRole

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.
properties.replicationState

string

Status replikasi instans grup failover.
properties.secondaryType

SecondaryInstanceType

Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR.
type

string

Jenis sumber daya.

InstanceFailoverGroupReadOnlyEndpoint

Objek

Titik akhir baca-saja dari instans grup failover.

Nama Jenis Deskripsi
failoverPolicy

ReadOnlyEndpointFailoverPolicy

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

InstanceFailoverGroupReadWriteEndpoint

Objek

Titik akhir baca-tulis dari instans grup failover.

Nama Jenis Deskripsi
failoverPolicy

ReadWriteEndpointFailoverPolicy

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

integer (int32)

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

InstanceFailoverGroupReplicationRole

Enumerasi

Peran replikasi lokal instans grup failover.

Nilai Deskripsi
Primary
Secondary

ManagedInstancePairInfo

Objek

Pasangan Instans Terkelola dalam grup failover.

Nama Jenis Deskripsi
partnerManagedInstanceId

string

Id Instans Terkelola Mitra berpasangan.
primaryManagedInstanceId

string

Id Instans Terkelola Utama berpasangan.

PartnerRegionInfo

Objek

Informasi wilayah mitra untuk grup failover.

Nama Jenis Deskripsi
location

string

Lokasi geografis instans terkelola mitra.
replicationRole

InstanceFailoverGroupReplicationRole

Peran replikasi instans terkelola mitra.

ReadOnlyEndpointFailoverPolicy

Enumerasi

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

Nilai Deskripsi
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Enumerasi

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

Nilai Deskripsi
Manual
Automatic

SecondaryInstanceType

Enumerasi

Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR.

Nilai Deskripsi
Geo
Standby