Virtual Clusters - Update

Service:

SQL Database

API Version:

2021-11-01

Mises à jour un cluster virtuel.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
virtualClusterName	path	True	string	Nom du cluster virtuel.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
properties.family	string	Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici.
properties.maintenanceConfigurationId	string	Spécifie l’ID de configuration de maintenance à appliquer à ce cluster virtuel.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	VirtualCluster	Mise à jour réussie du cluster virtuel.
202 Accepted		La mise à jour du cluster virtuel est en cours.
Other Status Codes		Réponses d’erreur : *** 400 SubscriptionNotEnabledForFeature : abonnement utilisateur non activé pour la fonctionnalité que l’utilisateur a tenté d’utiliser. 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée. 400 InvalidMaintenanceWindowSettings : paramètres de fenêtre de maintenance non valides. 400 InvalidMaintenanceWindowProperty : la propriété de fenêtre de maintenance non valide a été spécifiée. 400 InvalidMaintenanceWindowPropertyNull : fenêtre de maintenance non valide avec les propriétés requises null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified : certaines propriétés ne doivent pas être spécifiées pour le type de fenêtre maintenance. 400 UpdateOfParameterNotSupported : la mise à jour de «{0} » n’est pas prise en charge. 404 VirtualClusterDoesNotExist : le cluster virtuel n’existe pas. 404 ResourceDoesNotExist : la ressource portant le nom «{0} » n’existe pas. Pour continuer, spécifiez un nom de ressource valide. 404 VirtualClusterNotInSubscriptionResourceGroup : le cluster virtuel spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 SubscriptionDoesNotHaveVirtualCluster : le cluster virtuel demandé est introuvable 404 ResourceNotFound : la ressource demandée est introuvable. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 409 VirtualClusterRemovalAlreadyInProgress : la suppression du cluster virtuel est déjà en cours. Le cluster virtuel est automatiquement créé lors de la première instance création et automatiquement supprimé avec la dernière suppression instance. Pour plus d’informations : https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty : le cluster virtuel n’est pas vide et ne peut pas être supprimé. 409 VirtualClusterIsBusy : le cluster virtuel est actuellement occupé. Veuillez réessayer l’opération ultérieurement. 409 VirtualClusterRemovalFailed : la demande de suppression du cluster virtuel a échoué. Vérifiez s’il existe des ressources dépendantes actives. 409 ConflictingVirtualClusterOperation : une opération est en cours pour le cluster virtuel. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 ConflictingSubscriptionOperation : une opération est en cours pour l’abonnement. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

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

Définitions

Nom	Description
VirtualCluster	Un cluster virtuel Azure SQL.
VirtualClusterUpdate	Demande de mise à jour pour un cluster virtuel de base de données Azure SQL.

VirtualCluster

Un cluster virtuel Azure SQL.

Nom	Type	Description
id	string	ID de la ressource
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.childResources	string[]	Liste des ressources de ce cluster virtuel.
properties.family	string	Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici.
properties.maintenanceConfigurationId	string	Spécifie l’ID de configuration de maintenance à appliquer à ce cluster virtuel.
properties.subnetId	string	ID de ressource de sous-réseau pour le cluster virtuel.
tags	object	Balises de ressource.
type	string	Type de ressource.

VirtualClusterUpdate

Demande de mise à jour pour un cluster virtuel de base de données Azure SQL.

Nom	Type	Description
properties.childResources	string[]	Liste des ressources de ce cluster virtuel.
properties.family	string	Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici.
properties.maintenanceConfigurationId	string	Spécifie l’ID de configuration de maintenance à appliquer à ce cluster virtuel.
properties.subnetId	string	ID de ressource de sous-réseau pour le cluster virtuel.
tags	object	Balises de ressource.