Instance Pools - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza um conjunto de instâncias.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
instancePoolName	path	True	string	O nome do conjunto de instâncias a criar ou atualizar.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso.
properties.licenseType	True	InstancePoolLicenseType	O tipo de licença. Os valores possíveis são "LicenseIncluded" (o preço da licença SQL está incluído) e "Preço Base" (sem o preço de licença do SQL).
properties.subnetId	True	string	ID de recurso da sub-rede onde colocar este conjunto de instâncias.
properties.vCores	True	integer	Contagem de vCores pertencentes a este conjunto de instâncias.
sku		Sku	O nome e a camada do SKU.
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	InstancePool	O conjunto de instâncias foi atualizado com êxito.
201 Created	InstancePool	O conjunto de instâncias foi criado com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidResourceRequestBody – as propriedades do recurso ou recurso no corpo do pedido estão vazias ou são inválidas. 400 MissingSkuName – é necessário o nome do SKU. 400 InstancePoolRequestedVcoreCountIsInvalid – a contagem de vcores pedida para o conjunto de instâncias é inválida 400 InstancePoolRequestMissingSku – O pedido do conjunto de instâncias está em falta 400 InstancePoolRequestMissingSkuTier – O pedido do conjunto de instâncias está em falta na camada de SKU 400 InstancePoolRequestMissingSkuFamily – O pedido do conjunto de instâncias está em falta na família de SKU 400 InstancePoolRequestedSubnetResourceIdIsInvalid - O ID da sub-rede do conjunto de instâncias é nulo ou está vazio 404 OperationIdNotFound – a operação com o ID não existe. 409 InstancePoolBusy - Um conjunto de instâncias está ocupado com outra operação em curso 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Create an instance pool with all properties.

Create an instance pool with min properties.

Create an instance pool with all properties.

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "location": "japaneast",
  "tags": {
    "a": "b"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  }
}


import com.azure.resourcemanager.sql.fluent.models.InstancePoolInner;
import com.azure.resourcemanager.sql.models.InstancePoolLicenseType;
import com.azure.resourcemanager.sql.models.Sku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for InstancePools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateInstancePoolMax.json
     */
    /**
     * Sample code: Create an instance pool with all properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAnInstancePoolWithAllProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstancePools().createOrUpdate("group1", "testIP",
            new InstancePoolInner().withLocation("japaneast").withTags(mapOf("a", "b"))
                .withSku(new Sku().withName("GP_Gen5").withTier("GeneralPurpose").withFamily("Gen5"))
                .withSubnetId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1")
                .withVCores(8).withLicenseType(InstancePoolLicenseType.LICENSE_INCLUDED),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 201

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

Código de estado:: 202

Create an instance pool with min properties.

Pedido de amostra

HTTP
Java

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "location": "japaneast",
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  }
}


import com.azure.resourcemanager.sql.fluent.models.InstancePoolInner;
import com.azure.resourcemanager.sql.models.InstancePoolLicenseType;
import com.azure.resourcemanager.sql.models.Sku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for InstancePools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateInstancePoolMin.json
     */
    /**
     * Sample code: Create an instance pool with min properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAnInstancePoolWithMinProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstancePools().createOrUpdate("group1", "testIP",
            new InstancePoolInner().withLocation("japaneast")
                .withSku(new Sku().withName("GP_Gen5").withTier("GeneralPurpose").withFamily("Gen5"))
                .withSubnetId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1")
                .withVCores(8).withLicenseType(InstancePoolLicenseType.LICENSE_INCLUDED),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 201

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

Código de estado:: 202

Definições

Name	Description
InstancePool	Um conjunto de instâncias SQL do Azure.
InstancePoolLicenseType	O tipo de licença. Os valores possíveis são "LicenseIncluded" (o preço da licença SQL está incluído) e "Preço Base" (sem o preço de licença do SQL).
Sku	Um SKU de Recurso do ARM.

InstancePool

Um conjunto de instâncias SQL do Azure.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.licenseType	InstancePoolLicenseType	O tipo de licença. Os valores possíveis são "LicenseIncluded" (o preço da licença SQL está incluído) e "Preço Base" (sem o preço de licença do SQL).
properties.subnetId	string	ID de recurso da sub-rede onde colocar este conjunto de instâncias.
properties.vCores	integer	Contagem de vCores pertencentes a este conjunto de instâncias.
sku	Sku	O nome e a camada do SKU.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

InstancePoolLicenseType

O tipo de licença. Os valores possíveis são "LicenseIncluded" (o preço da licença SQL está incluído) e "Preço Base" (sem o preço de licença do SQL).

Name	Tipo	Description
BasePrice	string
LicenseIncluded	string

Sku

Um SKU de Recurso do ARM.

Name	Tipo	Description
capacity	integer	Capacidade do SKU específico.
family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
name	string	O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3.
size	string	Tamanho do SKU específico
tier	string	O escalão ou edição do SKU específico, por exemplo, Básico, Premium.

Partilhar via

Instance Pools - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Create an instance pool with all properties.

Pedido de amostra

Resposta da amostra

Create an instance pool with min properties.

Pedido de amostra

Resposta da amostra

Definições

InstancePool

InstancePoolLicenseType

Sku

Recursos adicionais