Virtual Clusters - Update

Service:

SQL Database

API Version:

2021-11-01

Updates kluster virtual.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters/{virtualClusterName}?api-version=2021-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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.
virtualClusterName	path	True	string	Nama kluster virtual.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
properties.maintenanceConfigurationId	string	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke kluster virtual ini.
tags	object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	VirtualCluster	Berhasil memperbarui kluster virtual.
202 Accepted		Memperbarui kluster virtual sedang berlangsung.
Other Status Codes		Respons Kesalahan: *** 400 SubscriptionNotEnabledForFeature - Langganan pengguna tidak diaktifkan untuk pengguna fitur yang mencoba digunakan. 400 ManagementServiceFeatureDisabled - Pengguna mencoba menggunakan fitur yang dinonaktifkan. 400 InvalidMaintenanceWindowSettings - Pengaturan jendela pemeliharaan tidak valid. 400 InvalidMaintenanceWindowProperty - Properti jendela pemeliharaan tidak valid ditentukan. 400 InvalidMaintenanceWindowPropertyNull - Jendela pemeliharaan tidak valid dengan properti yang diperlukan null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified - Jenis jendela pemeliharaan tidak boleh memiliki properti tertentu yang ditentukan. 400 UpdateOfParameterNotSupported - Pembaruan '{0}' tidak didukung. 404 VirtualClusterDoesNotExist - Kluster virtual tidak ada. 404 ResourceDoesNotExist - Sumber daya dengan nama '{0}' tidak ada. Untuk melanjutkan, tentukan nama sumber daya yang valid. 404 VirtualClusterNotInSubscriptionResourceGroup - Kluster virtual yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan. 404 SubscriptionDoesNotHaveVirtualCluster - Kluster virtual yang diminta tidak ditemukan 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 VirtualClusterRemovalAlreadyInProgress - Penghapusan kluster virtual sudah berlangsung. Kluster virtual secara otomatis dibuat dengan pembuatan instans pertama, dan secara otomatis dihapus dengan penghapusan instans terakhir. Pelajari lebih lanjut di sini: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty - Kluster virtual tidak kosong dan tidak dapat dihapus. 409 VirtualClusterIsBusy - Kluster virtual saat ini sibuk. Silakan coba lagi operasi nanti. 409 VirtualClusterRemovalFailed - Permintaan untuk menghilangkan kluster virtual gagal. Periksa apakah ada sumber daya dependen aktif. 409 ConflictingVirtualClusterOperation - Operasi saat ini sedang berlangsung untuk kluster virtual. 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. 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 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 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. 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.

Contoh

Update virtual cluster with tags

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2?api-version=2021-11-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.VirtualClusterUpdate;

/** Samples for VirtualClusters Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterUpdate.json
     */
    /**
     * Sample code: Update virtual cluster with tags.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateVirtualClusterWithTags(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().update("testrg",
            "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
            new VirtualClusterUpdate().withMaintenanceConfigurationId(
                "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "properties": {
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "childResources": [
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance1",
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance2"
    ],
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  },
  "location": "onebox",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "name": "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "type": "Microsoft.Sql/virtualClusters"
}

Status code:

202

Definisi

Nama	Deskripsi
VirtualCluster	Kluster virtual Azure SQL.
VirtualClusterUpdate	Permintaan pembaruan untuk kluster virtual Azure SQL Database.

VirtualCluster

Kluster virtual Azure SQL.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.childResources	string[]	Daftar sumber daya dalam kluster virtual ini.
properties.family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
properties.maintenanceConfigurationId	string	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke kluster virtual ini.
properties.subnetId	string	ID sumber daya subnet untuk kluster virtual.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya

VirtualClusterUpdate

Permintaan pembaruan untuk kluster virtual Azure SQL Database.

Nama	Jenis	Deskripsi
properties.childResources	string[]	Daftar sumber daya dalam kluster virtual ini.
properties.family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
properties.maintenanceConfigurationId	string	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke kluster virtual ini.
properties.subnetId	string	ID sumber daya subnet untuk kluster virtual.
tags	object	Tag sumber daya.