Virtual Clusters - Update

Tjänst:

SQL Database

API-version:

2021-11-01

Uppdateringar ett virtuellt kluster.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
virtualClusterName	path	True	string	Namnet på det virtuella klustret.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på det här virtuella klustret.
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	VirtualCluster	Det virtuella klustret har uppdaterats.
202 Accepted		Uppdatering av virtuellt kluster pågår.
Other Status Codes		Felsvar: *** 400 SubscriptionNotEnabledForFeature – Användarprenumerationen är inte aktiverad för funktionsanvändare som försöker använda. 400 ManagementServiceFeatureDisabled – Användaren försökte använda en funktion som är inaktiverad. 400 InvalidMaintenanceWindowSettings – Ogiltiga inställningar för underhållsperiod. 400 InvalidMaintenanceWindowProperty – Egenskapen Ogiltig underhållsperiod angavs. 400 InvalidMaintenanceWindowPropertyNull – Ogiltigt underhållsperiod med nödvändiga egenskaper null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified – Underhållsfönstertypen får inte ha vissa egenskaper angivna. 400 UpdateOfParameterNotSupported – uppdatering av stöds{0} inte. 404 VirtualClusterDoesNotExist – det virtuella klustret finns inte. 404 ResourceDoesNotExist – Resurs med namnet "{0}" finns inte. Om du vill fortsätta anger du ett giltigt resursnamn. 404 VirtualClusterNotInSubscriptionResourceGroup – Det angivna virtuella klustret finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte. 404 SubscriptionDoesNotHaveVirtualCluster – Det begärda virtuella klustret hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 404 OperationIdNotFound – Åtgärden med ID finns inte. 409 VirtualClusterRemovalAlreadyInProgress – Borttagning av virtuellt kluster pågår redan. Det virtuella klustret skapas automatiskt när första instansen skapas och tas bort automatiskt med den senaste instansen. Läs mer här: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – Det virtuella klustret är inte tomt och kan inte tas bort. 409 VirtualClusterIsBusy – Det virtuella klustret är för närvarande upptaget. Försök igen senare. 409 VirtualClusterRemovalFailed – Begäran om att släppa det virtuella klustret misslyckades. Kontrollera om det finns aktiva beroende resurser. 409 ConflictingVirtualClusterOperation – En åtgärd pågår för det virtuella klustret. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 ConflictingSubscriptionOperation – En åtgärd pågår för prenumerationen. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Update virtual cluster with tags

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Statuskod:

202

Definitioner

Name	Description
VirtualCluster	Ett Azure SQL virtuellt kluster.
VirtualClusterUpdate	En uppdateringsbegäran för ett virtuellt Azure SQL Database-kluster.

VirtualCluster

Ett Azure SQL virtuellt kluster.

Name	Typ	Description
id	string	Resurs-ID.
location	string	Resursplats.
name	string	Resursnamn.
properties.childResources	string[]	Lista över resurser i det här virtuella klustret.
properties.family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på det här virtuella klustret.
properties.subnetId	string	Resurs-ID för undernätet för det virtuella klustret.
tags	object	Resurstaggar.
type	string	Resurstyp.

VirtualClusterUpdate

En uppdateringsbegäran för ett virtuellt Azure SQL Database-kluster.

Name	Typ	Description
properties.childResources	string[]	Lista över resurser i det här virtuella klustret.
properties.family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på det här virtuella klustret.
properties.subnetId	string	Resurs-ID för undernätet för det virtuella klustret.
tags	object	Resurstaggar.