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


Managed Instances - Start

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/start?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, используемая для запроса.

Ответы

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

ManagedInstance

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

202 Accepted

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

Заголовки

Location: string

Other Status Codes

ErrorResponse

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

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

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

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

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

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

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

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

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

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

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

  • 400 TokenTooLong — предоставленный маркер слишком длинный.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

Starts the managed instance.

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

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

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

{
  "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

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

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

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

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

object

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

type

string

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

ErrorDetail

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

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

ErrorAdditionalInfo[]

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

code

string

Код ошибки.

details

ErrorDetail[]

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

message

string

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

target

string

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

ErrorResponse

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

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

ErrorDetail

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

ExternalGovernanceStatus

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

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

HybridSecondaryUsage

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

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

HybridSecondaryUsageDetected

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

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

IdentityType

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

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

ManagedInstance

Управляемый экземпляр 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

Свойства администратора 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

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

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

string

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

properties

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointConnectionProperties

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

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

ManagedInstancePrivateEndpointProperty

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

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

provisioningState

string

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

ManagedInstancePrivateEndpointProperty

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

string

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

Конфигурация удостоверений 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

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

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

string

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

principalId

string

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

tenantId

string

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

type

ServicePrincipalType

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

ServicePrincipalType

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

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

Sku

SKU ресурса ARM.

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

integer (int32)

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

family

string

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

name

string

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

size

string

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

tier

string

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

UserIdentity

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

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

string (uuid)

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

principalId

string (uuid)

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