Managed Instances - Get

Ссылка

Служба:: SQL Database

Версия API:: 2023-08-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2023-08-01

С использованием необязательных параметров:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2023-08-01

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	ManagedInstance	Успешно получен указанный управляемый экземпляр.
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 SubnetMissingRequiredDelegation — выбранная подсеть не делегирована для управляемого экземпляра SQL. 400 ManagementServiceManagedServerDisabled — операция завершилась сбоем, так как управляемый экземпляр "{0}" отключен. Включите управляемый экземпляр и повторите попытку. 400 MiGeoRestoreWithWrongBackupStorageRedundancy — Geo-Restore не допускается для управляемых экземпляров с избыточностью хранилища резервных копий LRS/ZRS. 400 LastBackupNameHasNewline . Не используйте запрещенные символы (",\n", "\r") в lastBackupName. 400 LastBackupNameHasNonAsciiCharacter — операция была прервана, так как параметр LastBackupName содержит недопустимые символы. Разрешены только символы ASCII. 400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений. 400 LRSCutoverDatabaseDoesNotExist — операция была прервана, так как имя базы данных, указанное в запросе, не соответствует имени базы данных на указанном сервере. 400 LRSCutoverDatabaseNotInRestoringState — операция была прервана, так как указанная база данных не находится в состоянии восстановления. 400 LRSCutoverDatabaseAlreadyRestored — операция была прервана, так как указанная база данных уже восстановлена. 400 LRSCutoverAlreadyInitiated — операция была прервана, так как переключение для указанной базы данных уже выполняется. 400 ManagementServiceFeatureDisabled — пользователь попытался использовать функцию, которая отключена. 400 AadOnlyAuthenticationIsEnabled — включена только проверка подлинности Azure Active Directory. Обратитесь к системному администратору. 400 ОбновлениеInstanceAndBackupRedundancy — избыточность зоны экземпляра и избыточность хранилища резервных копий невозможно обновить в том же запросе. 400 DeleteOfManagedInstanceIsDisabled — операция удаления управляемого экземпляра отключена. 400 RequestCantLandOnPaaSv2Platform — запрос должен приземлиться на платформе PaaSv2, но PaaSv2 не включен. 400 CustomMaintenanceWindowIsDisabled — пользовательское окно обслуживания не включено. 400 DeleteOfVersion2VirtualClusterIsDisabled — удаление виртуального кластера с версией 2 не включено. 400 DeleteOfVirtualClusterIsDisabled — удаление виртуального кластера не включено. 400 MICantBeMovedFromOrToInstancePool — существующий управляемый экземпляр нельзя переместить в пул управляемых экземпляров. 400 DnsRefreshOnVirtualClusterIsDisabled — обновление записей DNS в виртуальном кластере не включено. 404 SubscriptionNotFound — запрошенная подписка не найдена. 404 ManagedInstanceNotInSubscriptionResourceGroup — указанный управляемый экземпляр не существует в указанной группе ресурсов и подписке. 404 SubscriptionNotFound — запрошенная подписка не найдена. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 ResourceNotFound — запрошенный ресурс не найден. 409 MiCreateFailedNonDelegatedSubnet — пользователь пытался развернуть пул управляемых экземпляров или управляемых экземпляров в подсети, которая не делегирована Microsoft.Sql/managedInstances. 409 InstancePoolBusy — пул экземпляров занят другой текущей операцией 409 ConflictingManagedInstanceOperation — операция в настоящее время выполняется для управляемого экземпляра. 409 BackupRedundancyUpdateAndInstanceRedundancyConflict — экземпляр имеет значение multi-az, но хранилище резервных копий обновляется из зоны, избыточной до незоны, избыточной. 409 InstanceRedundancyUpdateTimeBackupRedundancyUpdateInProgresss — не удается обновить избыточность экземпляра, так как обновление избыточности хранилища резервных копий выполняется. 409 InstanceRedundancyUpdateAndBackupRedundancyConflict — хранилище резервных копий является избыточным по зонам, но избыточность экземпляров обновляется до избыточности между зонами. 409 BackupRedundancyUpdateConflict — не удается обновить избыточность хранилища резервных копий, так как обновление избыточности хранилища резервных копий уже выполняется. 409 MiDropFailedOnAuthLocks — пользователь пытался удалить последний управляемый экземпляр в подсети, которая имеет блокировку, примененную к ресурсам. 412 InstanceNotReadyForBackupRedundancyUpAte — не удается обновить избыточность хранилища резервных копий, так как экземпляр не готов. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 ConflictingSubscriptionOperation — операция в настоящее время выполняется для подписки. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 504 RequestTimeout — запрос службы превысил допустимое время ожидания. 504 RequestTimeout — запрос службы превысил допустимое время ожидания.

Имя

Тип

Описание

200 OK

ManagedInstance

Успешно получен указанный управляемый экземпляр.

Other Status Codes

ErrorResponse

Ответы на ошибки: ***

400 SubnetMissingRequiredDelegation — выбранная подсеть не делегирована для управляемого экземпляра SQL.
400 ManagementServiceManagedServerDisabled — операция завершилась сбоем, так как управляемый экземпляр "{0}" отключен. Включите управляемый экземпляр и повторите попытку.
400 MiGeoRestoreWithWrongBackupStorageRedundancy — Geo-Restore не допускается для управляемых экземпляров с избыточностью хранилища резервных копий LRS/ZRS.
400 LastBackupNameHasNewline . Не используйте запрещенные символы (",\n", "\r") в lastBackupName.
400 LastBackupNameHasNonAsciiCharacter — операция была прервана, так как параметр LastBackupName содержит недопустимые символы. Разрешены только символы ASCII.
400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений.
400 LRSCutoverDatabaseDoesNotExist — операция была прервана, так как имя базы данных, указанное в запросе, не соответствует имени базы данных на указанном сервере.
400 LRSCutoverDatabaseNotInRestoringState — операция была прервана, так как указанная база данных не находится в состоянии восстановления.
400 LRSCutoverDatabaseAlreadyRestored — операция была прервана, так как указанная база данных уже восстановлена.
400 LRSCutoverAlreadyInitiated — операция была прервана, так как переключение для указанной базы данных уже выполняется.
400 ManagementServiceFeatureDisabled — пользователь попытался использовать функцию, которая отключена.
400 AadOnlyAuthenticationIsEnabled — включена только проверка подлинности Azure Active Directory. Обратитесь к системному администратору.
400 ОбновлениеInstanceAndBackupRedundancy — избыточность зоны экземпляра и избыточность хранилища резервных копий невозможно обновить в том же запросе.
400 DeleteOfManagedInstanceIsDisabled — операция удаления управляемого экземпляра отключена.
400 RequestCantLandOnPaaSv2Platform — запрос должен приземлиться на платформе PaaSv2, но PaaSv2 не включен.
400 CustomMaintenanceWindowIsDisabled — пользовательское окно обслуживания не включено.
400 DeleteOfVersion2VirtualClusterIsDisabled — удаление виртуального кластера с версией 2 не включено.
400 DeleteOfVirtualClusterIsDisabled — удаление виртуального кластера не включено.
400 MICantBeMovedFromOrToInstancePool — существующий управляемый экземпляр нельзя переместить в пул управляемых экземпляров.
400 DnsRefreshOnVirtualClusterIsDisabled — обновление записей DNS в виртуальном кластере не включено.
404 SubscriptionNotFound — запрошенная подписка не найдена.
404 ManagedInstanceNotInSubscriptionResourceGroup — указанный управляемый экземпляр не существует в указанной группе ресурсов и подписке.
404 SubscriptionNotFound — запрошенная подписка не найдена.
404 ServerNotInSubscription — указанный сервер не существует в указанной подписке.
404 ResourceNotFound — запрошенный ресурс не найден.
409 MiCreateFailedNonDelegatedSubnet — пользователь пытался развернуть пул управляемых экземпляров или управляемых экземпляров в подсети, которая не делегирована Microsoft.Sql/managedInstances.
409 InstancePoolBusy — пул экземпляров занят другой текущей операцией
409 ConflictingManagedInstanceOperation — операция в настоящее время выполняется для управляемого экземпляра.
409 BackupRedundancyUpdateAndInstanceRedundancyConflict — экземпляр имеет значение multi-az, но хранилище резервных копий обновляется из зоны, избыточной до незоны, избыточной.
409 InstanceRedundancyUpdateTimeBackupRedundancyUpdateInProgresss — не удается обновить избыточность экземпляра, так как обновление избыточности хранилища резервных копий выполняется.
409 InstanceRedundancyUpdateAndBackupRedundancyConflict — хранилище резервных копий является избыточным по зонам, но избыточность экземпляров обновляется до избыточности между зонами.
409 BackupRedundancyUpdateConflict — не удается обновить избыточность хранилища резервных копий, так как обновление избыточности хранилища резервных копий уже выполняется.
409 MiDropFailedOnAuthLocks — пользователь пытался удалить последний управляемый экземпляр в подсети, которая имеет блокировку, примененную к ресурсам.
412 InstanceNotReadyForBackupRedundancyUpAte — не удается обновить избыточность хранилища резервных копий, так как экземпляр не готов.
429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 ConflictingSubscriptionOperation — операция в настоящее время выполняется для подписки.
503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
504 RequestTimeout — запрос службы превысил допустимое время ожидания.
504 RequestTimeout — запрос службы превысил допустимое время ожидания.

Примеры

Get managed instance

Get managed instance while resource is updating

Get managed instance with $expand=administrators/activedirectory

Get managed instance

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

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

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

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance while resource is updating

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

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

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

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Updating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "externalGovernanceStatus": "Enabled",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

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

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

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

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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Определения

Имя	Описание
AdministratorType	Тип администратора развера.
AuthMetadataLookupModes	Режим поиска метаданных метаданных управляемого экземпляра.
BackupStorageRedundancy	Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage)
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
ExternalGovernanceStatus	Состояние внешнего управления.
HybridSecondaryUsage	Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления).
HybridSecondaryUsageDetected	Обнаружено гибридное вторичное использование. Возможные значения: "Активный" (клиент не соответствует требованиям для использования вторичного аварийного восстановления в качестве пассивного аварийного восстановления) и "Пассивный" (клиент соответствует требованиям для использования вторичного в качестве пассивного аварийного восстановления).
IdentityType	Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса.
ManagedInstance	Управляемый экземпляр SQL Azure.
ManagedInstanceDatabaseFormat	Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL.
ManagedInstanceExternalAdministrator	Свойства администратора Active Directory.
ManagedInstanceLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL).
ManagedInstancePecProperty	Подключение к частной конечной точке в управляемом экземпляре
ManagedInstancePrivateEndpointConnectionProperties	Свойства подключения частной конечной точки.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Тип подключения, используемый для подключения к экземпляру.
ManagedServerCreateMode	Задает режим создания базы данных. По умолчанию: создание регулярного экземпляра. Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
PricingModel	Модель ценообразования управляемого экземпляра.
PrincipalType	Тип субъекта-администратора.
ProvisioningState	Состояние подготовки управляемого экземпляра.
ResourceIdentity	Конфигурация удостоверений Azure Active Directory для ресурса.
ServicePrincipal	Конфигурация субъекта-службы управляемого экземпляра для ресурса.
ServicePrincipalType	Тип субъекта-службы.
Sku	SKU ресурса ARM.
UserIdentity	Конфигурация удостоверений Azure Active Directory для ресурса.

AdministratorType

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

Тип администратора развера.

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

AuthMetadataLookupModes

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

Режим поиска метаданных метаданных управляемого экземпляра.

Значение	Описание
AzureAD
Paired
Windows

BackupStorageRedundancy

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

Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage)

Значение	Описание
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Object

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

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

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

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

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

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ExternalGovernanceStatus

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

Состояние внешнего управления.

Значение	Описание
Disabled
Enabled

HybridSecondaryUsage

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

Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления).

Значение	Описание
Active
Passive

HybridSecondaryUsageDetected

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

Обнаружено гибридное вторичное использование. Возможные значения: "Активный" (клиент не соответствует требованиям для использования вторичного аварийного восстановления в качестве пассивного аварийного восстановления) и "Пассивный" (клиент соответствует требованиям для использования вторичного в качестве пассивного аварийного восстановления).

Значение	Описание
Active
Passive

IdentityType

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

Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса.

Значение	Описание
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Object

Управляемый экземпляр SQL Azure.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
identity	ResourceIdentity	Удостоверение Azure Active Directory управляемого экземпляра.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.administratorLogin	string	Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания).
properties.administratorLoginPassword	string	Пароль для входа администратора (требуется для создания управляемого экземпляра).
properties.administrators	ManagedInstanceExternalAdministrator	Администратор Azure Active Directory экземпляра. Это можно использовать только во время создания экземпляра. Если оно используется для обновления экземпляра, оно будет игнорироваться или приведет к ошибке. Для обновлений потребуется использовать отдельные API.
properties.authenticationMetadata	AuthMetadataLookupModes	Режим поиска метаданных метаданных управляемого экземпляра.
properties.collation	string	Параметры сортировки управляемого экземпляра.
properties.createTime	string (date-time)	Указывает точку во времени (ISO8601 формате) создания управляемого экземпляра.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL.
properties.dnsZone	string	Зона Dns, в которую находится управляемый экземпляр.
properties.dnsZonePartner	string (arm-id)	Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Состояние внешнего управления.
properties.fullyQualifiedDomainName	string	Полное доменное имя управляемого экземпляра.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Обнаружено гибридное вторичное использование. Возможные значения: "Активный" (клиент не соответствует требованиям для использования вторичного аварийного восстановления в качестве пассивного аварийного восстановления) и "Пассивный" (клиент соответствует требованиям для использования вторичного в качестве пассивного аварийного восстановления).
properties.instancePoolId	string	Идентификатор пула экземпляров, к которому принадлежит управляемый сервер.
properties.isGeneralPurposeV2	boolean	Независимо от того, является ли это вариантом GPv2 выпуска общего назначения.
properties.keyId	string	Универсальный код ресурса (URI) ключа для шифрования.
properties.licenseType	ManagedInstanceLicenseType	Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL).
properties.maintenanceConfigurationId	string	Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Задает режим создания базы данных. По умолчанию: создание регулярного экземпляра. Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
properties.minimalTlsVersion	string	Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2"
properties.pricingModel	PricingModel	Модель ценообразования управляемого экземпляра.
properties.primaryUserAssignedIdentityId	string (arm-id)	Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Список подключений к частной конечной точке в управляемом экземпляре.
properties.provisioningState	ProvisioningState	Состояние подготовки управляемого экземпляра.
properties.proxyOverride	ManagedInstanceProxyOverride	Тип подключения, используемый для подключения к экземпляру.
properties.publicDataEndpointEnabled	boolean	Включена ли общедоступная конечная точка данных.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage)
properties.restorePointInTime	string (date-time)	Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.servicePrincipal	ServicePrincipal	Субъект-служба управляемого экземпляра.
properties.sourceManagedInstanceId	string (arm-id)	Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра.
properties.state	string	Состояние управляемого экземпляра.
properties.storageIOps	integer (int32)	IOps хранилища. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageSizeInGB	integer (int32)	Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 16384. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageThroughputMBps	integer (int32)	Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра.
properties.subnetId	string (arm-id)	Идентификатор ресурса подсети для управляемого экземпляра.
properties.timezoneId	string	Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows. Windows хранит сведения о поддерживаемых часовых поясах, включая идентификатор в реестре в разделе KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\TimeZone. Эти значения реестра можно получить с помощью SQL Server, запросив имя SELECT AS timezone_id FROM sys.time_zone_info. Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell. Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
properties.vCores	integer (int32)	Количество виртуальных ядер. Допустимые значения: 8, 16, 24, 32, 40, 64, 80.
properties.virtualClusterId	string	Идентификатор ресурса виртуального кластера для управляемого экземпляра.
properties.zoneRedundant	boolean	Включена ли функция multi-az.
sku	Sku	SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Теги ресурсов.
type	string	Тип ресурса.

ManagedInstanceDatabaseFormat

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

Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL.

Значение	Описание
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Object

Свойства администратора Active Directory.

Имя	Тип	Описание
administratorType	AdministratorType	Тип администратора развера.
azureADOnlyAuthentication	boolean	Включена только проверка подлинности Azure Active Directory.
login	string	Имя входа администратора сервера.
principalType	PrincipalType	Тип субъекта-администратора.
sid	string (uuid)	ИДЕНТИФИКАТОР безопасности (идентификатор объекта) администратора сервера.
tenantId	string (uuid)	Идентификатор клиента администратора.

ManagedInstanceLicenseType

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

Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL).

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

ManagedInstancePecProperty

Object

Подключение к частной конечной точке в управляемом экземпляре

Имя	Тип	Описание
id	string	Идентификатор ресурса.
properties	ManagedInstancePrivateEndpointConnectionProperties	Свойства подключения к частной конечной точке

ManagedInstancePrivateEndpointConnectionProperties

Object

Свойства подключения частной конечной точки.

Имя	Тип	Описание
privateEndpoint	ManagedInstancePrivateEndpointProperty	Частная конечная точка, к которой принадлежит подключение.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Состояние подключения подключения к частной конечной точке.
provisioningState	string	Состояние подключения к частной конечной точке.

ManagedInstancePrivateEndpointProperty

Object

Имя	Тип	Описание
id	string	Идентификатор ресурса частной конечной точки.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

Имя	Тип	Описание
actionsRequired	string	Описание подключения службы приватного канала.
description	string	Описание подключения службы приватного канала.
status	string	Состояние подключения службы приватного канала.

ManagedInstanceProxyOverride

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

Тип подключения, используемый для подключения к экземпляру.

Значение	Описание
Default
Proxy
Redirect

ManagedServerCreateMode

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

Задает режим создания базы данных.

По умолчанию: создание регулярного экземпляра.

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.

Значение	Описание
Default
PointInTimeRestore

PricingModel

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

Модель ценообразования управляемого экземпляра.

Значение	Описание
Freemium
Regular

PrincipalType

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

Тип субъекта-администратора.

Значение	Описание
Application
Group
User

ProvisioningState

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

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

Значение	Описание
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Object

Конфигурация удостоверений Azure Active Directory для ресурса.

Имя	Тип	Описание
principalId	string (uuid)	Идентификатор субъекта Azure Active Directory.
tenantId	string (uuid)	Идентификатор клиента Azure Active Directory.
type	IdentityType	Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса.
userAssignedIdentities	<string, UserIdentity>	Идентификаторы ресурса назначенных пользователем удостоверений для использования

ServicePrincipal

Object

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

Имя	Тип	Описание
clientId	string	Идентификатор клиента приложения Azure Active Directory.
principalId	string	Идентификатор объекта приложения Azure Active Directory.
tenantId	string	Идентификатор клиента Azure Active Directory.
type	ServicePrincipalType	Тип субъекта-службы.

ServicePrincipalType

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

Тип субъекта-службы.

Значение	Описание
None
SystemAssigned

Sku

Object

SKU ресурса ARM.

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

UserIdentity

Object

Конфигурация удостоверений Azure Active Directory для ресурса.

Имя	Тип	Описание
clientId	string (uuid)	Идентификатор клиента Azure Active Directory.
principalId	string (uuid)	Идентификатор субъекта Azure Active Directory.

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

Managed Instances - Get

Параметры URI

Ответы

Примеры

Get managed instance

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

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

Get managed instance while resource is updating

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

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

Get managed instance with $expand=administrators/activedirectory

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

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

Определения

AdministratorType

AuthMetadataLookupModes

BackupStorageRedundancy

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

UserIdentity

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