Distributed Availability Groups - List By Instance

Mendapatkan daftar grup ketersediaan terdistribusi dalam instans.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2021-11-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
managedInstanceName
path True

string

Nama instans terkelola.

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

Nama Jenis Deskripsi
200 OK

DistributedAvailabilityGroupsListResult

Berhasil mengambil daftar grup ketersediaan terdistribusi.

Other Status Codes

Respons Kesalahan: ***

  • 400 NameAlreadyExists - Nama yang disediakan sudah ada.

  • 400 InvalidCollation - Kolae tidak valid.

  • 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan

  • 400 RegionDoesNotAllowProvisioning - Lokasi yang dipilih tidak menerima server Windows Azure SQL Database baru. Ini dapat berubah di lain waktu.

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

  • 400 HkCannotSwitchToInactive - Database tidak dapat melanjutkan pembaruan tingkat harga karena memiliki objek yang dioptimalkan memori. Silakan letakkan objek tersebut, lalu coba kembali.

  • 400 TokenTooLong - Token yang disediakan terlalu panjang.

  • 400 CloudLifterUnsupportedFeature - Fungsionalitas tidak tersedia pada Instans Terkelola saat ini.

  • 400 ManagedInstanceSloUpdateFailed - operasi SLO '{0}' tidak dapat berhasil karena penggunaan memori '{1}' melebihi kuota.

  • 400 OperationCanNotStartDueToMiLink - Operasi '{0}' tidak dapat diselesaikan karena ada database dalam proses pembuatan melalui tautan Instans Terkelola. Harap tunggu hingga pembuatan tautan selesai, atau hapus tautan, dan coba lagi operasi tersebut.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled - Memperbarui SLO untuk instans terkelola dengan penyimpanan lokal belum didukung.

  • 400 InvalidSubnetResourceId - ID sumber daya subnet yang disediakan untuk pembuatan atau pembaruan instans terkelola tidak valid.

  • 400 VnetInWrongRegion - Jaringan virtual berada di wilayah yang salah.

  • 400 AlterDbDeactivatedNotSupported - Operasi Database gagal untuk Server '{0}', Database '{1}' karena penundaan yang tidak terduga. Harap coba lagi.

  • 400 VnetAddressRangeError - Rentang alamat jaringan virtual tidak valid.

  • 400 RegionDoesNotSupportVersion - Pengguna mencoba membuat server dari versi tertentu di lokasi di mana versi server tersebut tidak didukung.

  • 400 VnetConfigIsNotAllowed - Konfigurasi jaringan virtual tidak diizinkan.

  • 400 InstanceFailoverGroupDoesNotExist - Grup failover tidak ada di server.

  • 400 ManagedInstanceClassicVnetNotSupported - Instans Terkelola tidak dapat digabungkan ke jaringan virtual klasik.

  • 400 VnetConfigHasNsg - Pengguna mencoba menyuntikkan subnet Server Terkelola dengan Kelompok Keamanan Jaringan.

  • 400 VnetConfigHasNoUdr - Pengguna mencoba menyuntikkan subnet Server Terkelola tanpa Tabel Rute yang Ditentukan Pengguna default.

  • 400 VnetConfigHasInvalidUdr - Pengguna mencoba menyuntikkan subnet Server Terkelola dengan Tabel Rute yang Ditentukan Pengguna tidak valid.

  • 400 VnetConfigHasInvalidDns - Pengguna mencoba menyuntikkan subnet Server Terkelola dengan DNS kustom yang tidak valid.

  • 400 VnetConfigHasServiceEndpoints - Pengguna mencoba menyuntikkan subnet Server Terkelola dengan titik akhir layanan.

  • 400 VnetSubnetIsInUse - Pengguna mencoba menyuntikkan subnet Server Terkelola yang tidak kosong.

  • 400 VnetSubnetIsLocked - Pengguna mencoba menyuntikkan subnet Server Terkelola yang berada dalam cakupan terkunci.

  • 400 VnetSubnetIsGateway - Pengguna mencoba menyuntikkan subnet Server Terkelola yang merupakan subnet Gateway.

  • 400 VnetSubnetIsUnknown - Pengguna mencoba menyuntikkan subnet Server Terkelola yang tidak ada.

  • 400 VnetSubnetConflictWithIntendedPolicy - Pengguna mencoba menyuntikkan subnet Server Terkelola yang memiliki konflik dengan IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku - Edisi {0} yang ditentukan tidak konsisten dengan SKU {1}yang ditentukan.

  • 400 ManagedInstanceInvalidLicenseType - Jenis {0} lisensi yang ditentukan tidak valid.

  • 400 ManagedInstanceUpdateSloInProgress - "Operasi tidak dapat diselesaikan karena perubahan tingkat layanan sedang berlangsung untuk instans terkelola '{0}.' Silakan tunggu hingga operasi yang sedang berlangsung selesai, lalu coba kembali."

  • 400 VnetResourceNotFound - Sumber daya tidak ditemukan: '{0}'.

  • 400 InstanceCollationUpdateNotSupported - Pengguna tidak dapat mengubah kolase instans pada Instans Terkelola.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported - Pengguna hanya dapat membuat Instans Terkelola dengan kolase 'SQL_Latin1_General_CP1_CI_AS'.

  • 400 ManagedInstanceOperationInProgress - Operasi tidak dapat diselesaikan karena {0} operasi sedang berlangsung. Harap tunggu hingga operasi yang sedang berlangsung selesai, lalu coba lagi.

  • 400 ManagedInstanceExceedMaxAzureStorage - Operasi tidak dapat diselesaikan karena total ukuran penyimpanan yang dialokasikan untuk instans Tujuan Umum akan melebihi {0}. Kurangi jumlah file database dan coba lagi operasi.

  • 400 ManagedInstanceHasGeoReplica - Operasi tidak dapat diselesaikan karena instans telah mengonfigurasi instans sekunder yang direplikasi secara geografis.

  • 400 InvalidDnsZone - Operasi gagal karena Anda mencoba menyebarkan instans terkelola sebagai replikasi geografis sekunder ke subnet {0} tempat sudah ada instans terkelola. Menyebarkan instans terkelola sebagai sekunder replikasi geografis hanya didukung dalam kasus ketika instans terkelola adalah instans pertama yang disebarkan dalam subnet. Pertimbangkan untuk menyebarkan instans terkelola sebagai sekunder replikasi geografis ke subnet yang berbeda di mana tidak ada instans terkelola yang ada, atau jika menyebarkan ke subnet dengan instans terkelola yang ada menonaktifkan opsi replikasi geografis.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed - Ukuran penyimpanan tidak valid: Batas ukuran penyimpanan ({0} GB) kurang dari penyimpanan saat ini yang digunakan ({1} GB). Tentukan batas ukuran penyimpanan yang lebih tinggi.

  • 400 InvalidTimezone - Zona waktu tidak valid.

  • 400 InstanceTimezoneUpdateNotSupported - Pembaruan zona waktu instans tidak didukung.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported - Buat Instans Terkelola dengan zona waktu non-default tidak didukung.

  • 400 ManagedInstanceIpAddressRangeLimit - Tidak dapat melakukan pembuatan/penskalaan instans terkelola karena tidak ada cukup alamat IP yang tersedia di subnet untuk melakukan operasi.

  • 400 VnetDelegationNotAllowed - Pengguna mencoba menyuntikkan Server Terkelola ke subnet yang didelegasikan.

  • 400 SubnetHasResourcesOfDifferentType - Pengguna mencoba membuat MI di subnet yang memiliki sumber daya dengan jenis yang berbeda.

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed - Pembaruan Instans Terkelola dengan pengaturan jendela pemeliharaan tidak diizinkan.

  • 400 VnetPrepareNIPFailed - Pengguna mencoba menyiapkan subnet yang memiliki konflik dengan NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily - Mengubah generasi perangkat keras menjadi generasi yang tidak digunakan lagi tidak dimungkinkan {0} .

  • 400 ManagedInstanceBackupStorageTypeNotSupported - Parameter jenis penyimpanan cadangan tidak diizinkan dalam operasi pembaruan instans.

  • 400 EmptyPDCInvalidDnsZone - Instans terkelola ini tidak dapat disebarkan karena zona DNS-nya tidak cocok dengan awalan DNS kluster virtual yang dimaksudkan untuk subnet {0}. Meskipun kluster virtual ini kosong, awalan DNS-nya tidak dapat diubah. Kluster virtual kosong akan dihapus secara otomatis setelah beberapa jam. Pertimbangkan untuk menunggu kluster virtual ini kedaluwarsa atau menghapus kluster virtual ini secara manual lalu membuat instans terkelola.

  • 400 MissingIdentityId - Tidak ada identitas yang ditetapkan pengguna yang disediakan saat jenis identitas diatur ke UserAssigned

  • 400 InvalidPrimaryIdentityId - Pengguna menyediakan nilai untuk PrimaryUserIdentityId tetapi hal yang sama tidak tercantum dalam parameter IdentityId

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported - Fitur ZoneRedundant tidak didukung untuk tingkat layanan yang dipilih. Untuk detail selengkapnya, kunjungi aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled - Mengaktifkan fitur zoneRedundant tidak dimungkinkan setelah instans terkelola dibuat. Untuk detail selengkapnya, kunjungi aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled - Menonaktifkan fitur zoneRedundant tidak dimungkinkan setelah instans terkelola dibuat. Untuk detail selengkapnya, kunjungi aka.ms/sqlmi-high-availability.

  • 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId yang disediakan oleh pengguna tidak memiliki akses ke KeyId yang disediakan

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId yang disediakan oleh pengguna tidak memiliki akses ke KeyId yang disediakan

  • 400 SubnetIdCantBeUpdated - Mengubah subnet instans terkelola tidak didukung operasi. Hapus parameter ini dari permintaan.

  • 400 MigrationToAnotherVNetNotSupported - Subnet yang dipilih berada di Virtual Network lain. Memindahkan instans terkelola ke Virtual Network lain tidak dimungkinkan. Harap sediakan subnet dari Virtual Network {0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported - Subnet yang disediakan memiliki zona DNS yang berbeda dari saat ini. Mengubah zona DNS instans tidak didukung. Harap sediakan subnet dengan zona DNS yang sama, buat subnet baru atau sediakan yang kosong.

  • 400 MigrationToGen4SubnetNotSupported - Tidak dimungkinkan untuk memperbarui subnet saat berjalan pada perangkat keras Gen4 karena tidak digunakan lagi. Tingkatkan perangkat keras Anda dari Gen4 ke Gen5 sebagai bagian dari operasi subnet instans terkelola yang berubah dengan menentukan kedua parameter secara bersamaan: subnet tujuan dan pembuatan perangkat keras.

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId disediakan oleh pengguna selama pembuatan tetapi PrimaryUserAssignedIdentityId tidak disediakan dalam panggilan API

  • 400 InvalidIdentityTypeForKeyId - KeyId disediakan oleh pengguna selama pembuatan tetapi jenis identitas tidak diatur ke 'UserAssigned'

  • 400 ServerNotFound - Server yang diminta tidak ditemukan.

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit - Operasi tidak dapat diselesaikan karena beberapa file database melebihi batas {0} ukuran file Tujuan Umum maksimum GB.

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

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

  • 400 InstancePoolNotEnoughCapacity - Kumpulan instans tidak memiliki kapasitas yang cukup

  • 400 SourceAndTargetSubnetsMustBeVnetPeered - Subnet yang saat ini digunakan oleh instans terkelola dan subnet tujuan yang disediakan adalah bagian dari jaringan virtual yang tidak terhubung dengan peering jaringan virtual, atau memiliki peering yang dibuat tetapi tidak mengizinkan lalu lintas. Untuk memindahkan instans terkelola dari satu subnet ke subnet lainnya, peering jaringan virtual perlu dibuat dari jaringan virtual sumber dan target. Harap konfigurasikan persyaratan jaringan virtual, lalu coba kembali operasi tersebut. Pelajari lebih lanjut https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks.

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription - Subnet yang disediakan untuk penyebaran instans terkelola terletak pada langganan yang berbeda dari yang dikirimkan untuk instans terkelola. Instans terkelola dan subnet yang digunakan untuk menyebarkan instans harus berada pada langganan yang sama. Harap sediakan subnet lain atau beralih ke langganan subnet lalu coba operasi lagi.

  • 400 CreateManagedInstanceInvalidSubnetSize - Pengguna mencoba membuat instans terkelola dalam subnet yang lebih kecil dari ukuran subnet minimal yang diizinkan.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap - Subnet yang dipilih untuk migrasi instans terkelola memiliki rentang alamat yang tumpang tindih dengan rentang alamat subnet yang menyimpan instans sekunder yang direplikasi secara geografis. Harap verifikasi bahwa subnet Anda dikonfigurasi sesuai dengan panduan di https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication - Subnet yang dipilih untuk migrasi instans terkelola tidak dikonfigurasi untuk mengaktifkan komunikasi dengan instans sekunder yang direplikasi secara geografis. Silakan periksa apakah semua port yang diperlukan terbuka. Untuk mengonfigurasi subnet Anda dengan benar, baca panduan di https://aka.ms/move-managed-instance.

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

  • 400 InvalidLoginName - Nama masuk yang disediakan tidak valid.

  • 400 InvalidUsername - Nama pengguna yang disediakan berisi karakter yang tidak valid.

  • 400 PasswordTooShort - Kata sandi yang disediakan terlalu pendek

  • 400 PasswordTooLong - Kata sandi yang disediakan terlalu panjang.

  • 400 PasswordNotComplex - Kata sandi yang disediakan tidak cukup kompleks.

  • 400 GatewayInvalidEdition - '{0}' bukan edisi database yang valid dalam versi SQL Server ini.

  • 400 InvalidLocation - Lokasi yang tidak valid ditentukan.

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

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 ResourceDoesNotExist - Sumber daya dengan nama '{0}' tidak ada. Untuk melanjutkan, tentukan nama sumber daya yang valid.

  • 404 InstancePoolNotFound - Kumpulan instans tidak dapat ditemukan

  • 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan.

  • 405 InvalidVcoreValue - nilai {0} vCore tidak valid. Tentukan nilai vCore yang valid.

  • 405 InvalidHardwareGenerationValue - HardwareGeneration {0} tidak valid. Tentukan nilai HardwareGeneration yang valid.

  • 405 InvalidStorageSizeValue - "Ukuran penyimpanan tidak valid: {0} GB. Ukuran penyimpanan harus ditentukan antara {1} dan {2} gigabyte, dengan kenaikan {3} GB.

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

  • 409 SubscriptionDisabled - Langganan dinonaktifkan.

  • 409 ServerOverridePreconditionFailed - Gagal menerapkan penimpaan server pada kategori '{0}', karena db fisik atau instans '{1}' di server '{2}' saat ini tidak dalam status 'Siap' atau 'Dinonaktifkan'.

  • 409 ManagedInstanceIsBusy - Server '{0}' saat ini sibuk. Harap tunggu beberapa menit sebelum mencoba lagi.

  • 409 ServerAlreadyExists - Nama server duplikat.

  • 409 ServerDisabled - Server dinonaktifkan.

  • 409 ServerQuotaExceeded - Server tidak dapat ditambahkan ke langganan karena akan melebihi kuota.

  • 429 ConflictingSubscriptionOperation - Operasi saat ini sedang berlangsung untuk langganan.

  • 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 GatewayInternalServerError - Server mengalami pengecualian yang tidak terduga.

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

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

Contoh

Lists all distributed availability groups in instance.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups?api-version=2021-11-01

Sample Response

{
  "value": [
    {
      "properties": {
        "targetDatabase": "testdb",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "6bc05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "543dd519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "7e218aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
      "name": "dag",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    },
    {
      "properties": {
        "targetDatabase": "testdb2",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "7ec05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "d423d519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "32578aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
      "name": "dag2",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    }
  ]
}

Definisi

Nama Deskripsi
DistributedAvailabilityGroup

Grup ketersediaan terdistribusi antara kotak dan Sql Managed Instance.

DistributedAvailabilityGroupsListResult

Daftar grup ketersediaan terdistribusi dalam instans.

ReplicationMode

Mode replikasi grup ketersediaan terdistribusi. Parameter akan diabaikan selama pembuatan tautan.

DistributedAvailabilityGroup

Grup ketersediaan terdistribusi antara kotak dan Sql Managed Instance.

Nama Jenis Deskripsi
id

string

ID Sumber Daya.

name

string

Nama sumber daya.

properties.distributedAvailabilityGroupId

string

Id grup ketersediaan terdistribusi

properties.lastHardenedLsn

string

lsn terakhir mengeras

properties.linkState

string

Status tautan

properties.primaryAvailabilityGroupName

string

Nama grup ketersediaan utama

properties.replicationMode

ReplicationMode

Mode replikasi grup ketersediaan terdistribusi. Parameter akan diabaikan selama pembuatan tautan.

properties.secondaryAvailabilityGroupName

string

Nama grup ketersediaan sekunder

properties.sourceEndpoint

string

Titik akhir sumber

properties.sourceReplicaId

string

Id replika sumber

properties.targetDatabase

string

Nama database target

properties.targetReplicaId

string

Id replika target

type

string

Jenis sumber daya

DistributedAvailabilityGroupsListResult

Daftar grup ketersediaan terdistribusi dalam instans.

Nama Jenis Deskripsi
nextLink

string

Tautan untuk mengambil halaman hasil berikutnya.

value

DistributedAvailabilityGroup[]

Array hasil.

ReplicationMode

Mode replikasi grup ketersediaan terdistribusi. Parameter akan diabaikan selama pembuatan tautan.

Nama Jenis Deskripsi
Async

string

Sync

string