Virtual Clusters - Update

Service:

SQL Database

API Version:

2022-02-01-preview

Mises à jour un cluster virtuel.

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

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. 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. 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. 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=2022-02-01-preview

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

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.