Instance Pools - Get

Служба:
SQL Database
Версия API:
2025-01-01

Возвращает пул экземпляров.

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

Параметры URI

Имя В Обязательно Тип Описание
instancePoolName
 path True

string

Имя извлекаемого пула экземпляров.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.
subscriptionId
 path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

Ответы

Имя Тип Описание
200 OK

InstancePool

Операция Azure успешно завершена.
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Get an instance pool

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

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

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

Код состояния:
200 
{
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "location": "japaneast",
  "properties": {
    "dnsZone": "1234567890",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "a": "b"
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo

Ошибка управления ресурсами дополнительная информация.
ErrorDetail

Детали ошибки.
ErrorResponse

Ответ на ошибку
InstancePool

An Azure SQL instance pool.
InstancePoolLicenseType

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

SKU ресурса ARM.
systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Ошибка управления ресурсами дополнительная информация.

Имя Тип Описание
info

object

Дополнительная информация.
type

string

Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Ошибка дополнительная информация.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

InstancePool

Объект

An Azure SQL instance pool.

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Географическое расположение, в котором находится ресурс
name

string

Имя ресурса
properties.dnsZone

string

Зона Dns, в которую находится пул управляемых экземпляров.
properties.licenseType

InstancePoolLicenseType

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

string (arm-id)

Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру.
properties.subnetId

string

Идентификатор ресурса подсети для размещения этого пула экземпляров.
properties.vCores

integer (int32)

Количество виртуальных ядер, принадлежащих этому пулу экземпляров.
sku

Sku

Имя и уровень номера SKU.
systemData

systemData

Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags

object

Теги ресурсов.
type

string

Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

InstancePoolLicenseType

Перечисление

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

Значение Описание
LicenseIncluded

ЛицензияВключено
BasePrice

BasePrice

Sku

Объект

SKU ресурса ARM.

Имя Тип Описание
capacity

integer (int32)

Емкость конкретного номера SKU.
family

string

Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь.
name

string

Имя номера SKU, как правило, буква + код номера, например P3.
size

string

Размер конкретного номера SKU
tier

string

Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум".

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string (date-time)

Временная метка последнего изменения ресурса (UTC)
lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.
lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.