Failover Groups - Create Or Update

Membuat atau memperbarui grup failover.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
failoverGroupName
path True

string

Nama grup failover.

resourceGroupName
path True

string

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

serverName
path True

string

Nama server yang berisi grup failover.

subscriptionId
path True

string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True

string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
properties.partnerServers True

PartnerInfo[]

Daftar informasi server mitra untuk grup failover.

properties.readWriteEndpoint True

FailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

properties.databases

string[]

Daftar database dalam grup failover.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

tags

object

Tag sumber daya.

Respons

Nama Jenis Deskripsi
200 OK

FailoverGroup

Berhasil memperbarui grup failover.

201 Created

FailoverGroup

Berhasil membuat grup failover.

202 Accepted

Diterima

Other Status Codes

Respons Kesalahan: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases - ID database yang disediakan tidak dibangun dengan benar ID sumber daya database. Untuk contoh pemformatan yang tepat lihat https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner - Bidang mitra yang diberikan dalam membuat atau memperbarui isi permintaan grup failover kosong atau tidak valid. Harap berikan nilai yang valid dari bidang ini. Untuk contoh permintaan yang diformat dengan benar, lihat https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

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

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - Satu atau beberapa database yang disediakan tidak ada di server utama grup failover. Pastikan bahwa semua database ada di server utama.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Hanya satu server mitra untuk Grup Failover yang didukung. Harap ubah permintaan Anda sesuai. Untuk contoh permintaan yang valid, lihat https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

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

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

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

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

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Nilai masa tenggang untuk grup failover harus lebih besar dari atau sama dengan masa tenggang minimum '{0}' menit

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

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

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Nilai masa tenggang tidak boleh disediakan saat kebijakan failover Manual dipilih untuk titik akhir baca-tulis. Silakan hapus dari permintaan.

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

  • 400 FailoverGroupFailoverRequestOnPrimary - Permintaan failover harus dimulai di server sekunder grup failover.

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

  • 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 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 yang dipasangkan DR.

  • 400 PartnerServerNotCompatible - Pengguna mencoba menyalin database dari server SAWA V1 ke server Sterling atau sebaliknya.

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

  • 400 ResourcePoolNotFound - Kumpulan elastis yang ditentukan tidak ada di server logis yang ditentukan.

  • 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 Key Vault Azure 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 penyelamatan kegagalan yang terjadwal, waktu habis, dan database tertentu tampaknya disalahkan.

  • 400 PlannedFailoverTimedOut - Pengguna memanggil penyelamatan kegagalan yang terjadwal, dan kehabisan waktu 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 perlu berada di wilayah yang berbeda untuk menyediakan isolasi.

  • 400 FailoverGroupDoesNotExist - Grup failover tidak ada di server.

  • 400 FailoverGroupNotSecondary - Failover tidak dapat dimulai dari server utama dalam Grup Failover.

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 400 DatabaseInFailoverGroupNotPrimary - Tautan GeoDR untuk database sudah ada, tetapi perannya bukan 'Primer' atau bukan tautan salin berkelanjutan.

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

  • 400 UnableToCreateFailoverGroupDueToTableAuditing - Grup Failover tidak dapat dibuat untuk server yang mengaktifkan audit tabel.

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

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup - Database dengan Pengauditan Tabel diaktifkan tidak akan dapat diakses melalui titik akhir Grup Failover.

  • 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 LimitOfFailoverGroupsPerServerExceeded - Membuat Grup Failover baru akan melebihi jumlah Grup Failover yang diizinkan per server.

  • 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 GeoReplicaLimitReached - Batas replikasi per replika tercapai.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported - Grup Failover yang dikonfigurasi dengan kebijakan failover otomatis saat ini tidak didukung pada server yang dikonfigurasi dengan aturan firewall jaringan virtual. Konfigurasikan grup failover dengan kebijakan failover manual.

  • 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 KeamananAzureKeyVaultGeoChainError - Membuat sekunder sekunder (proses yang dikenal sebagai penautan) tidak didukung saat mengaktifkan Enkripsi Data Transparan menggunakan Azure Key Vault (BYOK).

  • 400 FailoverGroupCreateOrUpdatePartiallySucceeded - Beberapa database tidak dapat ditambahkan atau dihapus.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 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 OperationCancelled - Operasi telah dibatalkan oleh pengguna.

  • 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama.

  • 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 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 memasuki 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 Azure Key Vault Key tidak ada.

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

  • 409 FailoverGroupAlreadyExists - Grup failover sudah ada di server tertentu. Gunakan nama Grup Failover yang berbeda.

  • 409 FailoverGroupBusy - Grup Failover sibuk dengan operasi lain.

  • 409 DatabaseBelongsToOtherFailoverGroup - Database milik Grup Failover lainnya dan tidak dapat dianggap sebagai bagian dari yang satu ini.

  • 409 DatabaseBeingAddedToFailoverGroup - Database saat ini sedang ditambahkan ke Grup Failover, pelanggan perlu menunggu operasi ini selesai dihapus.

  • 409 DatabaseBeingRemovedFromFailoverGroup - Database saat ini sedang dihapus dari grup failover, pelanggan perlu menunggu operasi ini selesai untuk menerbitkan penambahan.

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

  • 409 InvalidFailoverGroupName - Nama Grup Failover tidak valid disediakan.

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

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

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

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

  • 409 FailoverGroupUnableToPerformGroupOperationOnDatabases - Daftar database yang akan ditambahkan/dihapus ke/dari Grup Failover berisi kesalahan yang mencegah operasi selesai.

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

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

  • 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini.

  • 503 TooManyRequests - 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 .

  • 503 DatabaseUnavailable - Operasi gagal karena database tidak tersedia.

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

Contoh

Create failover group

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

Definisi

Nama Deskripsi
FailoverGroup

Grup failover.

FailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

FailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

FailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

PartnerInfo

Informasi server 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.

FailoverGroup

Grup failover.

Nama Jenis Deskripsi
id

string

ID Sumber Daya.

location

string

Lokasi sumber daya.

name

string

Nama sumber daya.

properties.databases

string[]

Daftar database dalam grup failover.

properties.partnerServers

PartnerInfo[]

Daftar informasi server mitra untuk grup failover.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

Titik akhir baca-tulis dari instans grup failover.

properties.replicationRole

FailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

properties.replicationState

string

Status replikasi instans grup failover.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya

FailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

Nama Jenis Deskripsi
failoverPolicy

ReadOnlyEndpointFailoverPolicy

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

FailoverGroupReadWriteEndpoint

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

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

FailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

Nama Jenis Deskripsi
Primary

string

Secondary

string

PartnerInfo

Informasi server mitra untuk grup failover.

Nama Jenis Deskripsi
id

string

Pengidentifikasi sumber daya server mitra.

location

string

Lokasi geografis server mitra.

replicationRole

FailoverGroupReplicationRole

Peran replikasi server mitra.

ReadOnlyEndpointFailoverPolicy

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

Nama Jenis Deskripsi
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

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

Nama Jenis Deskripsi
Automatic

string

Manual

string