Instance Pools - Create Or Update

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Создает или обновляет пул экземпляров.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
instancePoolName	path	True	string	Имя создаваемого или обновляемого пула экземпляров.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Расположение ресурса.
properties.licenseType	True	InstancePoolLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (включена цена лицензии SQL) и BasePrice (без лицензии SQL).
properties.subnetId	True	string	Идентификатор ресурса подсети для размещения этого пула экземпляров.
properties.vCores	True	integer	Количество виртуальных ядер, принадлежащих этому пулу экземпляров.
sku		Sku	Имя и уровень номера SKU.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	InstancePool	Пул экземпляров успешно обновлен.
201 Created	InstancePool	Пул экземпляров успешно создан.
202 Accepted		Принято
Other Status Codes		Ответы на ошибки: *** 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 MissingSkuName — требуется имя SKU. 400 InstancePoolRequestedVcoreCountIsInvalid — запрошенное количество виртуальных ядер для пула экземпляров недопустимо 400 InstancePoolRequestMissingSku — запрос пула экземпляров отсутствует SKU 400 InstancePoolRequestMissingSkuTier — запрос пула экземпляров отсутствует уровень SKU 400 InstancePoolRequestMissingSkuFamily — в запросе пула экземпляров отсутствует семейство SKU 400 InstancePoolRequestedSubnetResourceIdIsInvalid — идентификатор подсети для пула экземпляров имеет значение NULL или пустой. 404 OperationIdNotFound — операция с идентификатором не существует. 409 InstancePoolBusy — пул экземпляров занят другой текущей операцией. 409 OperationCancelled — операция отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — истекло время ожидания операции и автоматически выполняется откат. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

Примеры

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

Пример ответа

Код состояния:: 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"
}

Код состояния:: 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"
}

Код состояния:: 202

Create an instance pool with min properties.

Образец запроса

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

Пример ответа

Код состояния:: 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"
}

Код состояния:: 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"
}

Код состояния:: 202

Определения

Имя	Описание
InstancePool	Пул экземпляров Azure SQL.
InstancePoolLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (включена цена лицензии SQL) и BasePrice (без лицензии SQL).
Sku	SKU ресурса ARM.

InstancePool

Пул экземпляров Azure SQL.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.licenseType	InstancePoolLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (включена цена лицензии SQL) и BasePrice (без лицензии SQL).
properties.subnetId	string	Идентификатор ресурса подсети для размещения этого пула экземпляров.
properties.vCores	integer	Количество виртуальных ядер, принадлежащих этому пулу экземпляров.
sku	Sku	Имя и уровень номера SKU.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

InstancePoolLicenseType

Тип лицензии. Возможные значения: LicenseIncluded (включена цена лицензии SQL) и BasePrice (без лицензии SQL).

Имя	Тип	Описание
BasePrice	string
LicenseIncluded	string

Sku

SKU ресурса ARM.

Имя	Тип	Описание
capacity	integer	Емкость конкретного номера SKU.
family	string	Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь.
name	string	Имя номера SKU, как правило, буква + числовой код, например P3.
size	string	Размер конкретного номера SKU
tier	string	Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум".

Поделиться через

Instance Pools - Create Or Update

Параметры URI

Текст запроса

Ответы

Примеры

Create an instance pool with all properties.

Образец запроса

Пример ответа

Create an instance pool with min properties.

Образец запроса

Пример ответа

Определения

InstancePool

InstancePoolLicenseType

Sku

Дополнительные ресурсы