Sql Virtual Machine Groups - Create Or Update

  • Referensi
Service:
SQL VM
API Version:
2021-11-01-preview

Membuat atau memperbarui grup komputer virtual SQL.

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

Parameter URI

Name In Required Type Description
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 Required Type Description
location True
  • string

Lokasi sumber daya.
properties.sqlImageOffer
  • string

SQL penawaran gambar. Contohnya dapat mencakup SQL2016-WS2016, SQL2017-WS2016.
properties.sqlImageSku

SQL gambar sku.
properties.wsfcDomainProfile

Profil domain Direktori Aktif Kluster.
tags
  • object

Tag sumber daya.

Respons

Name Type Description
200 OK

Berhasil memperbarui grup komputer virtual SQL.
201 Created

Berhasil membuat grup komputer virtual SQL.
Other Status Codes

Respons Kesalahan: ***

  • 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 disediakan, 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 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 SqlVmGroupUpdateFailVmAttached - SQL grup komputer virtual tidak dapat diperbarui karena telah melampirkan komputer virtual SQL.

  • 400 InvalidSqlImageOffer - Penawaran gambar SQL yang disediakan tidak valid.

  • 400 InvalidSqlSku - Sku SQL yang disediakan tidak valid.

  • 400 OuPathAndDomainMismatch - Jalur OU tidak berada dalam domain yang disediakan.

  • 400 InvalidAccountNameFormat - Format nama akun tidak valid.

  • 400 CloudWitnessUnsupported - Untuk bukti cloud penyiapan Windows Server 2012R2 tidak diizinkan.

  • 400 FileShareWitnessDisAllowed - Untuk pengaturan Windows Server 2016 dan seterusnya, bukti berbagi file tidak diizinkan.

  • 400 InvalidStorageAccountUrl - Url akun penyimpanan tidak valid.

  • 400 SqlVmGroupNameTooLong - SQL nama grup komputer virtual tidak boleh melebihi 15 karakter.

  • 400 InvalidSqlVmGroupName - Nama grup komputer virtual SQL tidak valid.

  • 400 InvalidStorageAccountCredentials - Kredensial akun penyimpanan yang disediakan salah.

  • 400 InvalidStorageAccountType - Hanya akun penyimpanan jenis 'General-Purpose V2' yang diizinkan untuk operasi ini.

  • 400 SqlVmGroupNotEmpty - SQL grup komputer virtual tidak kosong.

  • 400 SqlVmGroupUpdateNotAllowed - Pembaruan ke SQL grup komputer virtual tidak diizinkan.

  • 403 AccessDenied - Akses ditolak.

  • 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 ResourceNotFound - Sumber daya yang diminta 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.

  • 429 TooManyRequestsReceived -

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

  • 500 UnExpectedErrorOccurred - Terjadi kesalahan tak terduga.

  • 500 OperationTimeout - Waktu operasi habis.

Contoh

Creates or updates a SQL virtual machine group.

Sample Request

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

{
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "properties": {
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "domainFqdn": "testdomain.com",
      "ouPath": "OU=WSCluster,DC=testdomain,DC=com",
      "clusterBootstrapAccount": "testrpadmin",
      "clusterOperatorAccount": "testrp@testdomain.com",
      "sqlServiceAccount": "sqlservice@testdomain.com",
      "storageAccountUrl": "https://storgact.blob.core.windows.net/",
      "storageAccountPrimaryKey": "<primary storage access key>"
    }
  }
}

Sample Response

Status code:
200 
{
  "properties": {
    "provisioningState": "UpdatingDomainful",
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "storageAccountUrl": "https://storgact.blob.core.windows.net/"
    }
  },
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup",
  "name": "testvmgroup",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups"
}
Status code:
201 
{
  "properties": {
    "provisioningState": "ProvisioningDomainful",
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "storageAccountUrl": "https://storgact.blob.core.windows.net/"
    }
  },
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup",
  "name": "testvmgroup",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups"
}

Definisi

ClusterConfiguration

Jenis kluster.
ClusterManagerType

Jenis manajer kluster: Windows Server Failover Cluster (WSFC), tersirat oleh jenis skala grup dan jenis OS.
createdByType

Jenis identitas yang membuat sumber daya.
ScaleType

Jenis skala.
SqlVirtualMachineGroup

Grup komputer virtual SQL.
SqlVmGroupImageSku

SQL gambar sku.
systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
WsfcDomainProfile

Detail akun Direktori Aktif untuk beroperasi Windows Kluster Failover Server.

ClusterConfiguration

Jenis kluster.

Name Type Description
Domainful
  • string

ClusterManagerType

Jenis manajer kluster: Windows Server Failover Cluster (WSFC), tersirat oleh jenis skala grup dan jenis OS.

Name Type Description
WSFC
  • string

createdByType

Jenis identitas yang membuat sumber daya.

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

ScaleType

Jenis skala.

Name Type Description
HA
  • string

SqlVirtualMachineGroup

Grup komputer virtual SQL.

Name Type Description
id
  • string

ID Sumber Daya.
location
  • string

Lokasi sumber daya.
name
  • string

Nama sumber daya.
properties.clusterConfiguration

Jenis kluster.
properties.clusterManagerType

Jenis manajer kluster: Windows Server Failover Cluster (WSFC), tersirat oleh jenis skala grup dan jenis OS.
properties.provisioningState
  • string

Status penyediaan untuk melacak status operasi asinkron.
properties.scaleType

Jenis skala.
properties.sqlImageOffer
  • string

SQL penawaran gambar. Contohnya dapat mencakup SQL2016-WS2016, SQL2017-WS2016.
properties.sqlImageSku

SQL gambar sku.
properties.wsfcDomainProfile

Profil domain Direktori Aktif Kluster.
systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
tags
  • object

Tag sumber daya.
type
  • string

Jenis sumber daya

SqlVmGroupImageSku

SQL gambar sku.

Name Type Description
Developer
  • string
Enterprise
  • 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 memodifikasi sumber daya.
lastModifiedByType

Jenis identitas yang terakhir mengubah sumber daya.

WsfcDomainProfile

Detail akun Direktori Aktif untuk beroperasi Windows Kluster Failover Server.

Name Type Description
clusterBootstrapAccount
  • string

Nama akun yang digunakan untuk membuat kluster (minimal memerlukan izin untuk 'Buat Objek Komputer' di domain).
clusterOperatorAccount
  • string

Nama akun yang digunakan untuk kluster operasi yaitu akan menjadi bagian dari grup administrator pada semua komputer virtual yang berpartisipasi dalam kluster.
domainFqdn
  • string

Nama domain yang sepenuhnya memenuhi syarat.
fileShareWitnessPath
  • string

Jalur opsional untuk saksi fileshare.
ouPath
  • string

Jalur Unit Organisasi tempat simpul dan kluster akan ada.
sqlServiceAccount
  • string

Nama akun tempat layanan SQL akan berjalan pada semua komputer virtual SQL yang berpartisipasi dalam kluster.
storageAccountPrimaryKey
  • string

Kunci utama akun penyimpanan bukti.
storageAccountUrl
  • string

Id sumber daya ARM yang sepenuhnya memenuhi syarat dari akun penyimpanan saksi.