你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Instance Pools - Create Or Update

参考

Service:: SQL Database

API Version:: 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	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源位置。
properties.licenseType	True	InstancePoolLicenseType	许可证类型。可能的值为“LicenseIncluded” (SQL 许可证) 包含的价格， (不包含 SQL 许可证价格的“BasePrice”) 。
properties.subnetId	True	string	要放置此实例池的子网的资源 ID。
properties.vCores	True	integer	属于此实例池的 vCore 计数。
sku		Sku	SKU 的名称和层。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	InstancePool	已成功更新实例池。
201 Created	InstancePool	已成功创建实例池。
202 Accepted		已接受
Other Status Codes		错误响应：*** 400 InvalidResourceRequestBody - 请求正文中的资源或资源属性为空或无效。 400 MissingSkuName - SKU 名称是必需的。 400 InstancePoolRequestedVcoreCountIsInvalid - 实例池的请求 vcore 计数无效 400 InstancePoolRequestMissingSku - 实例池请求缺少 SKU 400 InstancePoolRequestMissingSkuTier - 实例池请求缺少 SKU 层 400 InstancePoolRequestMissingSkuFamily - 实例池请求缺少 SKU 系列 400 InstancePoolRequestedSubnetResourceIdIsInvalid - 实例池的子网 ID 为 null 或空 404 OperationIdNotFound - ID 为的操作不存在。 409 InstancePoolBusy - 实例池正忙于另一个正在进行的操作 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 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.core.util.Context;
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),
            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/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"
}

Status code:: 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"
}

Status code:: 202

Create an instance pool with min properties.

Sample Request

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.core.util.Context;
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),
            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/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"
}

Status code:: 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"
}

Status code:: 202

定义

名称	说明
InstancePool	Azure SQL实例池。
InstancePoolLicenseType	许可证类型。可能的值为“LicenseIncluded” (SQL 许可证) 包含的价格， (不包含 SQL 许可证价格的“BasePrice”) 。
Sku	ARM 资源 SKU。

InstancePool

Azure SQL实例池。

名称	类型	说明
id	string	资源 ID。
location	string	资源位置。
name	string	资源名称。
properties.licenseType	InstancePoolLicenseType	许可证类型。可能的值为“LicenseIncluded” (SQL 许可证) 包含的价格， (不包含 SQL 许可证价格的“BasePrice”) 。
properties.subnetId	string	要放置此实例池的子网的资源 ID。
properties.vCores	integer	属于此实例池的 vCore 计数。
sku	Sku	SKU 的名称和层。
tags	object	资源标记。
type	string	资源类型。

InstancePoolLicenseType

许可证类型。可能的值为“LicenseIncluded” (SQL 许可证) 包含的价格， (不包含 SQL 许可证价格的“BasePrice”) 。

名称	类型	说明
BasePrice	string
LicenseIncluded	string

Sku

ARM 资源 SKU。

名称	类型	说明
capacity	integer	特定 SKU 的容量。
family	string	如果服务针对同一 SKU 具有不同代系的硬件，则可以在此处捕获。
name	string	SKU 的名称，通常为字母 + 数字代码，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的层或版本，例如基本 SKU、高级 SKU。

Instance Pools - Create Or Update

URI 参数

请求正文

响应

示例

Create an instance pool with all properties.

Sample Request

Sample Response

Create an instance pool with min properties.

Sample Request

Sample Response

定义

InstancePool

InstancePoolLicenseType

Sku

其他资源