Virtual Clusters - Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Aktualizace virtuální cluster.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
virtualClusterName	path	True	string	Název virtuálního clusteru.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
properties.family	string	Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat.
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tento virtuální cluster.
tags	object	Značky prostředků.

Odpovědi

Name	Typ	Description
200 OK	VirtualCluster	Virtuální cluster se úspěšně aktualizoval.
202 Accepted		Probíhá aktualizace virtuálního clusteru.
Other Status Codes		Chybové odpovědi: *** 400 SubscriptionNotEnabledForFeature – Uživatelské předplatné není povolené pro funkci, kterou se uživatel pokusil použít. 400 ManagementServiceFeatureDisabled – uživatel se pokusil použít funkci, která je zakázaná. 400 InvalidMaintenanceWindowSettings – neplatné nastavení časového období údržby. 400 InvalidMaintenanceWindowProperty – Byla zadána neplatná vlastnost časového období údržby. 400 InvalidMaintenanceWindowPropertyNull – neplatné časové období údržby s požadovanými vlastnostmi null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified – Typ časového období údržby nesmí mít zadané určité vlastnosti. 400 UpdateOfParameterNotSupported – aktualizace '{0}' není podporována. 404 VirtualClusterDoesNotExist – virtuální cluster neexistuje. 404 ResourceDoesNotExist – prostředek s názvem{0} neexistuje. Pokračujte zadáním platného názvu prostředku. 404 VirtualClusterNotInSubscriptionResourceGroup – Zadaný virtuální cluster v zadané skupině prostředků a předplatném neexistuje. 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno. 404 SubscriptionDoesNotHaveVirtualCluster – Požadovaný virtuální cluster se nenašel 404 ResourceNotFound – Požadovaný prostředek se nenašel. 404 OperationIdNotFound – operace s ID neexistuje. 409 VirtualClusterRemovalAlreadyInProgress – Odebrání virtuálního clusteru již probíhá. Virtuální cluster se automaticky vytvoří při vytvoření první instance a při odstranění poslední instance se automaticky odebere. Další informace najdete tady: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – Virtuální cluster není prázdný a nelze ho odstranit. 409 VirtualClusterIsBusy – virtuální cluster je momentálně zaneprázdněný. Zkuste operaci zopakovat později. 409 VirtualClusterRemovalFailed – Požadavek na vyřazení virtuálního clusteru selhal. Zkontrolujte, jestli existují aktivní závislé prostředky. 409 ConflictingVirtualClusterOperation – aktuálně probíhá operace pro virtuální cluster. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Update virtual cluster with tags

Ukázkový požadavek

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.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"),
            com.azure.core.util.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

Ukázková odpověď

Stavový kód:

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"
}

Stavový kód:

202

Definice

Name	Description
VirtualCluster	Virtuální cluster Azure SQL.
VirtualClusterUpdate	Žádost o aktualizaci virtuálního clusteru Azure SQL Database.

VirtualCluster

Virtuální cluster Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.childResources	string[]	Seznam prostředků v tomto virtuálním clusteru
properties.family	string	Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat.
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tento virtuální cluster.
properties.subnetId	string	ID prostředku podsítě pro virtuální cluster.
tags	object	Značky prostředků.
type	string	Typ prostředku.

VirtualClusterUpdate

Žádost o aktualizaci virtuálního clusteru Azure SQL Database.

Name	Typ	Description
properties.childResources	string[]	Seznam prostředků v tomto virtuálním clusteru
properties.family	string	Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat.
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tento virtuální cluster.
properties.subnetId	string	ID prostředku podsítě pro virtuální cluster.
tags	object	Značky prostředků.