Availability Group Listeners - Create Or Update

Membuat atau memperbarui listener grup ketersediaan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/{sqlVirtualMachineGroupName}/availabilityGroupListeners/{availabilityGroupListenerName}?api-version=2021-11-01-preview

Parameter URI

Name In Required Type Description
availabilityGroupListenerName
path True
  • string

Nama pendengar grup ketersediaan.

resourceGroupName
path True
  • string

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

sqlVirtualMachineGroupName
path True
  • string

Nama grup komputer virtual SQL.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang akan digunakan untuk permintaan tersebut.

Isi Permintaan

Name Type Description
properties.availabilityGroupConfiguration

Konfigurasi Grup Ketersediaan.

properties.availabilityGroupName
  • string

Nama grup ketersediaan.

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Buat grup ketersediaan default jika tidak ada.

properties.loadBalancerConfigurations

Daftar konfigurasi load balancer untuk pendengar grup ketersediaan.

properties.port
  • integer

Port pendengar.

Respons

Name Type Description
200 OK

Berhasil memperbarui listener grup ketersediaan.

201 Created

Berhasil membuat listener grup ketersediaan.

Other Status Codes

Respons Kesalahan: ***

  • 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 RPGenericUser - Kegagalan Pengguna saat memanggil Penyedia Sumber Daya lainnya.

  • 400 RPResponseMissingAsyncOperationHeader - Respons kehilangan informasi header operasi Asinkron

  • 400 InvalidArgument - Argumen tidak valid '{0}'.

  • 400 ArgumentNotInRange - Argumen '{0}' tidak dalam rentang.

  • 400 ResourceNotProvisioned - Karena sumber daya: {0} tidak dalam status tersedia, permintaan tidak dapat dilanjutkan ke depan

  • 400 CRPNotAllowedOperation - Operasi tidak dapat diselesaikan karena kesalahan berikut: {0}

  • 400 AadAppDisabled - Aplikasi Microsoft AAD SQLVMResourceProviderAuth ({0}) dinonaktifkan di penyewa Anda.

  • 400 InvalidRgResourceId - Id sumber daya Resourcegroup yang ditentukan tidak valid.

  • 400 InternalAPIAccessDenied - Akses API Internal ditolak. Id {0} Aplikasi tidak valid untuk menggunakan API ini.

  • 400 AgDoesNotExist - Grup ketersediaan tidak ada.

  • 400 AgListDoesNotMatch - daftar grup Ketersediaan SQL tidak cocok dengan daftar komputer virtual di grup komputer virtual SQL.

  • 400 NoIpProvided - Setidaknya satu IP perlu disediakan.

  • 400 MoreIpProvided - Hanya satu IP yang perlu disediakan.

  • 400 SqlVmGroupDoesNotHaveAGListener - SQL grup komputer virtual tidak memiliki pendengar AG.

  • 400 AgListenerUpdateNotAllowed - Hanya beberapa properti pendengar grup ketersediaan yang dapat diperbarui.

  • 400 SqlVmNotInGroup - SQL komputer virtual bukan bagian dari grup.

  • 400 SqlVmListCannotBeEmpty - daftar komputer virtual SQL tidak boleh kosong.

  • 400 PublicIpNotIPv4 - IP Publik harus alamat IPv4.

  • 400 PublicIPDynamicAllocation - Mode alokasi IP publik harus statis

  • 400 PublicLBInvalid - Load balancer yang ditentukan bukan publik.

  • 400 SubnetMissingFromPrivateIP - Subnet harus disediakan dengan IP privat.

  • 400 IPNotInSubnet - IP bukan bagian dari subnet.

  • 400 NoActivePrimaryInAG - Tidak ada simpul di AvailabilityGroup yang Utama

  • 400 MultipleListenerSameAG - Beberapa listener grup ketersediaan untuk grup ketersediaan yang sama tidak diizinkan.

  • 400 AgListenerNotEmpty - Listener grup ketersediaan tidak kosong.

  • 400 AgListenerVnetMismatch - VNet yang disediakan untuk listener grup Ketersediaan tidak cocok dengan Vnet penyeimbang beban internal.

  • 400 InternalLBInvalid - Load balancer yang ditentukan tidak internal.

  • 400 InvalidSqlVmResourceIdParameterValue - SQL id sumber daya komputer virtual yang disediakan tidak valid.

  • 400 DifferentSubSqlVmList - Semua komputer virtual SQL harus berada di bawah langganan yang sama.

  • 400 OnlyStandardPublicIp - Setiap komputer virtual harus memiliki IP publik standar.

  • 400 ListenerNameTooLong - Nama pendengar tidak boleh melebihi 15 karakter.

  • 400 InvalidListenerName - Nama pendengar tidak valid.

  • 400 InvalidLBResourceIdParameterValue - Id sumber daya load balancer tidak valid.

  • 400 InvalidPublicIpResourceIdParameterValue - Id sumber daya IP publik tidak valid.

  • 400 InvalidSubnetIdParameterValue - Id sumber daya tidak valid yang disediakan untuk parameter subnet.

  • 400 InvalidPrivateIpParameterValue - Alamat tidak valid yang diberikan untuk alamat IP privat.

  • 400 ExtVersionNotSupported - Komputer virtual: {0} menjalankan versi SqlIaasExtension yang lebih lama yang tidak didukung oleh operasi ini. Harap perbarui ekstensi dan coba lagi operasi.

  • 400 InvalidReplicaRole - Peran replika tidak valid: {0} ditentukan untuk SQL VM: {1}.

  • 400 InvalidReplicaFailover - Failover replika tidak valid: {0} untuk VM SQL: {1}.

  • 400 InvalidReplicaReadableSecondary - Replika sekunder yang dapat dibaca tidak valid: {0} untuk VM SQL: {1}.

  • 400 InvalidReplicaCommit - Mode penerapan replika tidak valid: {0} untuk VM SQL: {1}.

  • 400 ExpectedSynchronousCommitForAutomaticFailover - Mode penerapan replika tidak valid: {0} untuk SQL VM: {1}. {2} diharapkan untuk mode failover: {3}.

  • 400 NoPrimaryInAg - Tidak ada replika dengan peran utama. Harus ada tepat satu replika dengan peran sebagai primer.

  • 400 MoreThanOnePrimaryInAg - Ada lebih dari satu replika dengan peran utama. Harus ada tepat satu replika dengan peran sebagai primer.

  • 400 MoreThanThreeSynchronousCommitInAg - Ada lebih dari tiga replika dengan mode penerapan sebagai: {0}. Harus ada paling banyak tiga replika dengan mode penerapan sebagai: {0}

  • 400 MoreThanEightSecondariesInAg - Ada lebih dari delapan replika sekunder dengan peran sekunder. Harus ada paling banyak delapan replika dengan peran sebagai sekunder.

  • 400 AlwaysOnNotEnabled - Fitur Alwayson tidak diaktifkan di Komputer virtual: {0}.

  • 400 ExpectedReplicaNotPrimary - VM: {0} tidak menghosting replika utama.

  • 400 LoadBalancerSqlvmsMismatchWithReplicaSqlvms - Daftar VM SQL yang ditentukan dalam Grup ketersediaan tidak cocok dengan daftar VM SQL dalam konfigurasi load balancer.

  • 400 ReplicaSqlvmHasDuplicateEntries - Konfigurasi replika harus unik untuk setiap komputer virtual SQL. Kami telah menemukan satu atau beberapa konfigurasi untuk sumber daya komputer virtual SQL yang sama.

  • 400 ReplicaDeleteNotAllowed - Penghapusan replika melalui SQL VM RP belum didukung.

  • 400 OnlyBasicPublicIP - Semua VM yang ditentukan hanya boleh berisi IP Publik Dasar, saat menyediakan Sku Dasar Loadbalancer.

  • 400 NICCannotUseMultipleLBsOfSameType - NIC: {0} tidak dapat mereferensikan lebih dari satu penyeimbang beban jenis INTERNAL atau PUBLIK

  • 400 AGReplicaSQLStartupAccount - Akun layanan NT tidak dapat digunakan sebagai akun startup SQL untuk penyiapan AG. Anda harus menggunakan akun domain.

  • 400 AgListenerMultiSubnetUpdateNotAllowed - Pembaruan listener AG multi subnet tidak diizinkan.

  • 400 ListenerIpSubnetVmSubnetMismatch - Subnet alamat ip statis pendengar dan subnet VM harus sama

  • 400 VmNicVnetMismatch - Komputer virtual NIC VNet tidak cocok.

  • 400 NoAvailabilitySet - Vm tidak terkait dengan set ketersediaan apa pun.

  • 400 AvailabilitySetMismatch - Kumpulan ketersediaan komputer virtual tidak cocok.

  • 400 MismatchVmGroupSubscription - Id langganan untuk komputer virtual SQL dan grup komputer virtual SQL berbeda.

  • 400 VmNotRunning - VM tidak dalam status berjalan.

  • 400 VmAgentNotRunning - Agen VM tidak diinstal atau dalam status berjalan.

  • 400 NoIpAvailable - Tidak ada IP yang tersedia.

  • 403 AccessDenied - Akses ditolak.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 SubscriptionDoesNotExist - Id langganan tidak ada.

  • 404 ResourceDoesNotExist - Sumber daya tidak ada.

  • 404 RPOperationNotFound - Operasi tidak ditemukan

  • 404 OperationIdNotFound - Id operasi tidak dapat ditemukan.

  • 404 OperationTypeNotFound - Jenis Operasi tidak ditemukan.

  • 404 SubscriptionDoesNotHaveSqlVMGroupInResourceGroup - Langganan tidak memiliki grup komputer virtual SQL dalam grup sumber daya.

  • 409 ResourceAlreadyExists - Sumber daya sudah ada.

  • 409 LBGenericErrors - Operasi LB gagal

  • 409 NICGenericError - Operasi NIC gagal

  • 409 SqlExtensionNotInstalled - ekstensi SQL tidak diinstal.

  • 409 RPPluginSubstatusMissing - substatus plugin RP hilang

  • 409 MissingMoveResources - Tidak dapat memindahkan sumber daya karena beberapa sumber daya hilang dalam permintaan.

  • 409 ResourceExists - Ada kesalahan internal dalam membersihkan sumber daya.

  • 409 SubscriptionOperationInProgress - Operasi pada langganan sudah berlangsung

  • 409 OperationInProgress - Operasi yang sedang berlangsung pada sumber daya sudah.

  • 409 OperationCanceled - Operasi Dibatalkan.

  • 409 ReplicasWithDifferentSqlStartupAccounts - Pastikan semua akun startup server SQL Anda di replika yang ditentukan sama. Ini adalah salah satu prasyarat kami untuk menyiapkan grup ketersediaan.

  • 409 ReplicasJoinedToMoreThanOneCluster - Replika AG digabungkan ke lebih dari satu kluster failover. Pastikan semua replika Anda bergabung ke kluster failover yang sama.

  • 409 IPNotAvailable - IP {0} tidak tersedia{1}. Pertimbangkan untuk menggunakan satu dari ({2})

  • 409 IpAddressAlreadyReserved - Alamat IP yang disediakan untuk listener ini sudah ada. Silakan gunakan alamat IP

  • 429 TooManyRequestsReceived -

  • 500 RPGenericSystem - Kegagalan Sistem saat memanggil Penyedia Sumber Daya lainnya.

  • 500 UnExpectedErrorOccurred - Terjadi kesalahan tak terduga.

  • 500 OperationTimeout - Waktu operasi habis.

  • 500 SqlVmGroupIsBusy - SQL grup komputer virtual sibuk.

Contoh

Creates or updates an availability group listener.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test?api-version=2021-11-01-preview

{
  "properties": {
    "availabilityGroupName": "ag-test",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.112",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "loadBalancerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/loadBalancers/lb-test",
        "probePort": 59983,
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  }
}

Sample Response

{
  "properties": {
    "provisioningState": "Updating",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.113",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test",
  "name": "agl-test",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/availabilityGroupListeners"
}
{
  "properties": {
    "provisioningState": "Provisioning",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.112",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test",
  "name": "agl-test",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/availabilityGroupListeners"
}

Definisi

AgConfiguration

Konfigurasi grup ketersediaan.

AgReplica

Konfigurasi replika grup ketersediaan.

AvailabilityGroupListener

Pendengar grup ketersediaan SQL Server.

Commit

Mode penerapan replika dalam grup ketersediaan.

createdByType

Jenis identitas yang membuat sumber daya.

Failover

Mode failover replika dalam grup ketersediaan.

LoadBalancerConfiguration

Konfigurasi load balancer untuk pendengar grup ketersediaan.

PrivateIPAddress

Alamat IP privat yang terikat ke pendengar grup ketersediaan.

ReadableSecondary

Mode sekunder yang dapat dibaca replika dalam grup ketersediaan.

Role

Peran Replika dalam grup ketersediaan.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AgConfiguration

Konfigurasi grup ketersediaan.

Name Type Description
replicas

Konfigurasi replika.

AgReplica

Konfigurasi replika grup ketersediaan.

Name Type Description
commit

Mode penerapan replika dalam grup ketersediaan.

failover

Mode failover replika dalam grup ketersediaan.

readableSecondary

Mode sekunder yang dapat dibaca replika dalam grup ketersediaan.

role

Peran Replika dalam grup ketersediaan.

sqlVirtualMachineInstanceId
  • string

Id Instans Sql VirtualMachine.

AvailabilityGroupListener

Pendengar grup ketersediaan SQL Server.

Name Type Description
id
  • string

ID Sumber Daya.

name
  • string

Nama sumber daya.

properties.availabilityGroupConfiguration

Konfigurasi Grup Ketersediaan.

properties.availabilityGroupName
  • string

Nama grup ketersediaan.

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Buat grup ketersediaan default jika tidak ada.

properties.loadBalancerConfigurations

Daftar konfigurasi load balancer untuk pendengar grup ketersediaan.

properties.port
  • integer

Port pendengar.

properties.provisioningState
  • string

Status provisi untuk melacak status operasi asinkron.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

type
  • string

Jenis sumber daya

Commit

Mode penerapan replika dalam grup ketersediaan.

Name Type Description
ASYNCHRONOUS_COMMIT
  • string
SYNCHRONOUS_COMMIT
  • string

createdByType

Jenis identitas yang membuat sumber daya.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

Failover

Mode failover replika dalam grup ketersediaan.

Name Type Description
AUTOMATIC
  • string
MANUAL
  • string

LoadBalancerConfiguration

Konfigurasi load balancer untuk pendengar grup ketersediaan.

Name Type Description
loadBalancerResourceId
  • string

Id sumber daya dari load balancer.

privateIpAddress

Alamat IP privat.

probePort
  • integer

Port probe.

publicIpAddressResourceId
  • string

Id sumber daya IP publik.

sqlVirtualMachineInstances
  • string[]

Daftar id sumber daya instans komputer virtual SQL yang terdaftar ke pendengar grup ketersediaan.

PrivateIPAddress

Alamat IP privat yang terikat ke pendengar grup ketersediaan.

Name Type Description
ipAddress
  • string

Alamat IP privat terikat ke pendengar grup ketersediaan.

subnetResourceId
  • string

Subnet digunakan untuk menyertakan IP privat.

ReadableSecondary

Mode sekunder yang dapat dibaca replika dalam grup ketersediaan.

Name Type Description
ALL
  • string
NO
  • string
READ_ONLY
  • string

Role

Peran Replika dalam grup ketersediaan.

Name Type Description
PRIMARY
  • string
SECONDARY
  • string

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Name Type Description
createdAt
  • string

Tanda waktu pembuatan sumber daya (UTC).

createdBy
  • string

Identitas yang membuat sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt
  • string

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy
  • string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

Jenis identitas yang terakhir mengubah sumber daya.