Instance Pools - Update

Service:

SQL Database

API Version:

2021-11-01

Aktualizacje puli wystąpień.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
instancePoolName	path	True	string	Nazwa puli wystąpień, która ma zostać zaktualizowana.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	InstancePool	Pomyślnie zaktualizowano pulę wystąpień.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 OperationInterrupted — 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 maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Patch an instance pool

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2021-11-01

{
  "tags": {
    "x": "y"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.InstancePoolUpdate;
import java.util.HashMap;
import java.util.Map;

/** Samples for InstancePools Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/PatchInstancePool.json
     */
    /**
     * Sample code: Patch an instance pool.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void patchAnInstancePool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstancePools().update("group1", "testIP",
            new InstancePoolUpdate().withTags(mapOf("x", "y")), Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  },
  "location": "japaneast",
  "tags": {
    "x": "y"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Status code:

202

Definicje

Nazwa	Opis
InstancePool	Pula wystąpień Azure SQL.
InstancePoolLicenseType	Typ licencji. Możliwe wartości to "LicenseIncluded" (cena licencji SQL jest uwzględniona) i "BasePrice" (bez ceny licencji SQL).
InstancePoolUpdate	Aktualizacja puli wystąpień.
Sku	Jednostka SKU zasobu usługi ARM.

InstancePool

Pula wystąpień Azure SQL.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.licenseType	InstancePoolLicenseType	Typ licencji. Możliwe wartości to "LicenseIncluded" (cena licencji SQL jest uwzględniona) i "BasePrice" (bez ceny licencji SQL).
properties.subnetId	string	Identyfikator zasobu podsieci do umieszczenia tej puli wystąpień.
properties.vCores	integer	Liczba rdzeni wirtualnych należących do tej puli wystąpień.
sku	Sku	Nazwa i warstwa jednostki SKU.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

InstancePoolLicenseType

Typ licencji. Możliwe wartości to "LicenseIncluded" (cena licencji SQL jest uwzględniona) i "BasePrice" (bez ceny licencji SQL).

Nazwa	Typ	Opis
BasePrice	string
LicenseIncluded	string

InstancePoolUpdate

Aktualizacja puli wystąpień.

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa	Typ	Opis
capacity	integer	Pojemność określonej jednostki SKU.
family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
name	string	Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.
size	string	Rozmiar określonej jednostki SKU
tier	string	Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.