Managed Instances - Start

Запускает управляемый экземпляр.

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

Параметры URI

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

string

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

resourceGroupName
path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.

subscriptionId
path True

string

Идентификатор подписки Azure.

api-version
query True

string

Версия API для использования в запросе.

Ответы

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

ManagedInstance

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

202 Accepted

Запуск управляемого экземпляра выполняется.

Other Status Codes

ErrorResponse

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

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress — пользователь пытался запустить Управляемый экземпляр SQL Azure, который не находится в состоянии Остановлено.

  • 400 NameAlreadyExists — предоставленное имя уже существует.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature — пользователь пытался использовать функцию запуска и остановки без наличия списка разрешенных подписок для соответствующей функции подписки.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU — операция запуска не поддерживается для заданного номера SKU.

  • 400 InvalidServerName — указано недопустимое имя сервера.

  • 400 StartStopOfManagedInstanceIsDisabled — операция запуска и остановки в управляемом экземпляре не включена.

  • 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled — пользователь попытался использовать функцию запуска Управляемый экземпляр SQL Azure, которая отключена.

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 404 ResourceNotFound — запрошенный ресурс не найден.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 409 SubscriptionDisabled — подписка отключена.

  • 409 CannotCancelOperation — операция управления находится в состоянии, которое невозможно отменить.

  • 409 OperationCancelled — операция была отменена пользователем.

  • 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию.

  • 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Starts the managed instance.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart/start?api-version=2023-08-01-preview

Sample Response

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/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": "1234567891234",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "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",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

Определения

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

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

AuthMetadataLookupModes

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

BackupStorageRedundancy

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

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

ExternalGovernanceStatus

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

FreemiumType

Погода или нет Управляемый экземпляр freemium.

HybridSecondaryUsage

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

HybridSecondaryUsageDetected

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

IdentityType

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

ManagedInstance

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

ManagedInstanceDatabaseFormat

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

ManagedInstanceExternalAdministrator

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

ManagedInstanceLicenseType

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

ManagedInstancePecProperty

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

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

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

ManagedServerCreateMode

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

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

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

PrincipalType

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

ProvisioningState

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

ResourceIdentity

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

ServicePrincipal

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

ServicePrincipalType

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

Sku

SKU ресурса ARM.

UserIdentity

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

AdministratorType

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

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

string

AuthMetadataLookupModes

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

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

string

Paired

string

Windows

string

BackupStorageRedundancy

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

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

string

GeoZone

string

Local

string

Zone

string

ErrorAdditionalInfo

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

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

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

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

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

ErrorAdditionalInfo[]

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

code

string

Код ошибки.

details

ErrorDetail[]

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

message

string

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

target

string

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

ErrorResponse

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

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

ErrorDetail

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

ExternalGovernanceStatus

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

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

string

Enabled

string

FreemiumType

Погода или нет Управляемый экземпляр freemium.

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

string

Regular

string

HybridSecondaryUsage

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

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

string

Passive

string

HybridSecondaryUsageDetected

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

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

string

Passive

string

IdentityType

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

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

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

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

Имя Тип Описание
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

Указывает точку во времени (ISO8601 формате) создания Управляемый экземпляр.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

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

properties.databaseFormat

ManagedInstanceDatabaseFormat

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

properties.dnsZone

string

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

properties.dnsZonePartner

string

Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания.

properties.externalGovernanceStatus

ExternalGovernanceStatus

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

properties.fullyQualifiedDomainName

string

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

properties.hybridSecondaryUsage

HybridSecondaryUsage

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

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

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

properties.instancePoolId

string

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

properties.isGeneralPurposeV2

boolean

Является ли это вариантом GPv2 общего назначения выпуска.

properties.keyId

string

Универсальный код ресурса (URI) CMK ключа, используемого для шифрования.

properties.licenseType

ManagedInstanceLicenseType

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

properties.maintenanceConfigurationId

string

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

properties.managedInstanceCreateMode

ManagedServerCreateMode

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

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

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

properties.minimalTlsVersion

string

Минимальная версия TLS. Допустимые значения: None, 1.0, 1.1, 1.2

properties.pricingModel

FreemiumType

Погода или нет Управляемый экземпляр freemium.

properties.primaryUserAssignedIdentityId

string

Идентификатор ресурса удостоверения, назначаемого пользователем, который будет использоваться по умолчанию.

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

Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.

properties.servicePrincipal

ServicePrincipal

Субъект-служба управляемого экземпляра.

properties.sourceManagedInstanceId

string

Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра.

properties.state

string

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

properties.storageIOps

integer

Операций ввода-ввода-адреса хранилища. Минимальное значение: 300. Максимальное значение: 80000. Допускается только приращение 1 IOps. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.

properties.storageSizeInGB

integer

Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 16384. Допустимы только приращения 32 ГБ. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.

properties.storageThroughputMBps

integer

Параметр пропускной способности хранилища Мбит/с не поддерживается в операции создания или обновления экземпляра.

properties.subnetId

string

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

properties.timezoneId

string

Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows. Windows хранит сведения о поддерживаемых часовых поясах, включая идентификатор, в реестре в разделе KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zone. Эти значения реестра можно получить с помощью SQL Server, запросив select name AS timezone_id FROM sys.time_zone_info. Список идентификаторов также можно получить, выполнив [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell. Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W. Стандартное время Европы".

properties.totalMemoryMB

integer

Общий объем памяти в МБ. Минимальное значение: 7168. Максимальное значение: 891328. Допустимы только приращения в 1 МБ. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.

properties.vCores

integer

Количество виртуальных ядер. Допустимые значения: 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

string

SQLServer2022

string

ManagedInstanceExternalAdministrator

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

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

AdministratorType

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

azureADOnlyAuthentication

boolean

Включена только проверка подлинности Azure Active Directory.

login

string

Имя входа администратора сервера.

principalType

PrincipalType

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

sid

string

SID (идентификатор объекта) администратора сервера.

tenantId

string

Идентификатор клиента администратора.

ManagedInstanceLicenseType

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

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

string

LicenseIncluded

string

ManagedInstancePecProperty

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

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

string

Идентификатор ресурса.

properties

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointConnectionProperties

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

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

ManagedInstancePrivateEndpointProperty

Частная конечная точка, к которой принадлежит подключение.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

provisioningState

string

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

ManagedInstancePrivateEndpointProperty

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

string

Идентификатор ресурса частной конечной точки.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

string

Описание подключения к службе приватного канала.

description

string

Описание подключения к службе приватного канала.

status

string

Состояние подключения службы приватного канала.

ManagedInstanceProxyOverride

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

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

string

Proxy

string

Redirect

string

ManagedServerCreateMode

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

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

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

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

string

PointInTimeRestore

string

PrincipalType

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

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

string

Group

string

User

string

ProvisioningState

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

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

string

Created

string

Failed

string

InProgress

string

Succeeded

string

ResourceIdentity

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

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

string

Идентификатор субъекта Azure Active Directory.

tenantId

string

Идентификатор клиента Azure Active Directory.

type

IdentityType

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

userAssignedIdentities

<string,  UserIdentity>

Идентификаторы ресурсов назначенных пользователем удостоверений для использования

ServicePrincipal

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

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

string

Идентификатор клиента приложения Azure Active Directory.

principalId

string

Идентификатор объекта приложения Azure Active Directory.

tenantId

string

Идентификатор клиента Azure Active Directory.

type

ServicePrincipalType

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

ServicePrincipalType

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

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

string

SystemAssigned

string

Sku

SKU ресурса ARM.

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

integer

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

family

string

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

name

string

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

size

string

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

tier

string

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

UserIdentity

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

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

string

Идентификатор клиента Azure Active Directory.

principalId

string

Идентификатор субъекта Azure Active Directory.