Instance Pools - Update

Служба:

SQL Database

Версия API:

2021-11-01

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

PATCH 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 для использования в запросе.

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

Имя	Тип	Описание
tags	object	Теги ресурсов.

Ответы

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

Примеры

Patch an instance pool

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

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.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")), 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/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"
}

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

202

Определения

Имя	Описание
InstancePool	Пул экземпляров Azure SQL.
InstancePoolLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (включена цена лицензии SQL) и BasePrice (без лицензии SQL).
InstancePoolUpdate	Обновление пула экземпляров.
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

InstancePoolUpdate

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

Имя	Тип	Описание
tags	object	Теги ресурсов.

Sku

SKU ресурса ARM.

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