Virtual Clusters - Update

Service:

SQL Database

API Version:

2021-11-01

Aktualizacje klastra wirtualnego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
virtualClusterName	path	True	string	Nazwa klastra wirtualnego.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
properties.maintenanceConfigurationId	string	Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego klastra wirtualnego.
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualCluster	Pomyślnie zaktualizowano klaster wirtualny.
202 Accepted		Trwa aktualizowanie klastra wirtualnego.
Other Status Codes		Odpowiedzi na błędy: *** 400 SubscriptionNotEnabledForFeature — subskrypcja użytkownika nie jest włączona dla użytkownika funkcji, który próbował użyć. 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona. 400 InvalidMaintenanceWindowSettings — nieprawidłowe ustawienia okna obsługi. 400 InvalidMaintenanceWindowProperty — określono nieprawidłową właściwość okna obsługi. 400 InvalidMaintenanceWindowPropertyNull — nieprawidłowe okno obsługi z wymaganymi właściwościami o wartości null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified — typ okna obsługi nie może mieć określonych właściwości. 400 UpdateOfParameterNotSupported — aktualizacja "{0}" nie jest obsługiwana. 404 VirtualClusterDoesNotExist — klaster wirtualny nie istnieje. 404 ResourceDoesNotExist — zasób o nazwie "{0}" nie istnieje. Aby kontynuować, określ prawidłową nazwę zasobu. 404 VirtualClusterNotInSubscriptionResourceGroup — określony klaster wirtualny nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji. 404 SubscriptionDoesNotHaveVirtualCluster — nie znaleziono żądanego klastra wirtualnego 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 VirtualClusterRemovalAlreadyInProgress — usuwanie klastra wirtualnego jest już w toku. Klaster wirtualny jest tworzony automatycznie przy użyciu tworzenia pierwszego wystąpienia i automatycznie usuwany po usunięciu ostatniego wystąpienia. Dowiedz się więcej tutaj: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty — klaster wirtualny nie jest pusty i nie można go usunąć. 409 VirtualClusterIsBusy — klaster wirtualny jest obecnie zajęty. Ponów próbę wykonania operacji później. 409 VirtualClusterRemovalFailed — żądanie porzucenia klastra wirtualnego nie powiodło się. Sprawdź, czy istnieją aktywne zasoby zależne. 409 ConflictingVirtualClusterOperation — operacja jest obecnie w toku dla klastra wirtualnego. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

Nazwa	Opis
VirtualCluster	Klaster wirtualny Azure SQL.
VirtualClusterUpdate	Żądanie aktualizacji klastra wirtualnego usługi Azure SQL Database.

VirtualCluster

Klaster wirtualny Azure SQL.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.childResources	string[]	Lista zasobów w tym klastrze wirtualnym.
properties.family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
properties.maintenanceConfigurationId	string	Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego klastra wirtualnego.
properties.subnetId	string	Identyfikator zasobu podsieci dla klastra wirtualnego.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

VirtualClusterUpdate

Żądanie aktualizacji klastra wirtualnego usługi Azure SQL Database.

Nazwa	Typ	Opis
properties.childResources	string[]	Lista zasobów w tym klastrze wirtualnym.
properties.family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
properties.maintenanceConfigurationId	string	Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego klastra wirtualnego.
properties.subnetId	string	Identyfikator zasobu podsieci dla klastra wirtualnego.
tags	object	Tagi zasobów.