Managed Instances - Create Or Update

Служба:

SQL Database

Версия API:

2025-01-01

Создает или обновляет управляемый экземпляр.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
managedInstanceName	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, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
identity		ResourceIdentity	Идентификация Azure Active Directory управляемого экземпляра.
properties.administratorLogin		string	Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания).
properties.administratorLoginPassword		string (password)	Пароль для входа администратора (требуется для создания управляемого экземпляра).
properties.administrators		ManagedInstanceExternalAdministrator	Администратор Azure Active Directory может использоваться при создании экземпляров и обновлениях, за исключением свойства azureADOnlyAuthentication. Чтобы обновить свойство azureADOnlyAuthentication, необходимо использовать отдельный API.
properties.authenticationMetadata		AuthMetadataLookupModes	Режим поиска метаданных метаданных управляемого экземпляра.
properties.collation		string	Параметры сортировки управляемого экземпляра.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL.
properties.dnsZonePartner		string (arm-id)	Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления).
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.memorySizeInGB		integer (int32)	Объем памяти в ГБ. Минимальное значение: 28. Максимальное значение: 870. Минимальное и максимальное значение зависят от количества виртуальных ядер и уровня служб. Подробнее об ограничениях ресурсов: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion		string	Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2"
properties.pricingModel		PricingModel	Модель ценообразования Управляемый экземпляр.
properties.primaryUserAssignedIdentityId		string (arm-id)	Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию.
properties.proxyOverride		ManagedInstanceProxyOverride	Тип подключения, используемый для подключения к экземпляру.
properties.publicDataEndpointEnabled		boolean	Включена ли общедоступная конечная точка данных.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Указывает логическую зону доступности, к которой прикреплён Управляемый экземпляр.
properties.restorePointInTime		string (date-time)	Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.servicePrincipal		ServicePrincipal	Субъект-служба управляемого экземпляра.
properties.sourceManagedInstanceId		string (arm-id)	Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра.
properties.storageIOps		integer (int32)	Хранение операций ввода-вывода в секунду. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageSizeInGB		integer (int32)	Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 32768. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageThroughputMBps		integer (int32)	Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра.
properties.subnetId		string (arm-id)	Идентификатор ресурса подсети для управляемого экземпляра.
properties.timezoneId		string	Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows. Windows хранит данные о поддерживаемых часовых поясах, включая идентификатор, в реестре KEY_LOCAL_MACHINE\SOFTWARE\Майкрософт\Windows NT\CurrentVersion\Time Zones. Вы можете получить эти значения реестра через SQL Server, запросив SELECT имя AS timezone_id ИЗ sys.time_zone_info. Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell. Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
properties.vCores		integer (int32)	Количество виртуальных ядер. Допустимые значения: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Поддерживаемые виртуальные ядра зависят от выбранного семейства оборудования и уровня служб.
properties.zoneRedundant		boolean	Включена ли избыточность между зонами.
sku		Sku	SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5 (General Purpose, Standard-series); GP_G8IM (Общего назначения, Премиум-серия); GP_G8IH (Общего назначения, Премиум-серия с оптимизацией памяти); BC_Gen5 (Критически важный для бизнеса, Standard-Series); BC_G8IM (Business Critical, Premium-серия); BC_G8IH (критически важный для бизнеса, оптимизированный для памяти серии Premium).
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	ManagedInstance	Операция обновления ресурса 'ManagedInstance' была успешна
201 Created	ManagedInstance	Операция создания ресурса 'ManagedInstance' успешно выполнена Заголовки Location: string Retry-After: integer
202 Accepted		Операция ресурса принята. Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

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

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned"
    },
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/ManagedInstanceCreateMax.json
// this example is just showing the usage of "ManagedInstances_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "20D7082A-0FC7-4468-82BD-542694D5042B";
string resourceGroupName = "testrg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ManagedInstanceResource
ManagedInstanceCollection collection = resourceGroupResource.GetManagedInstances();

// invoke the operation
string managedInstanceName = "testinstance";
ManagedInstanceData data = new ManagedInstanceData(new AzureLocation("Japan East"))
{
    Sku = new SqlSku("GP_Gen5")
    {
        Tier = "GeneralPurpose",
    },
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    SubnetId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
    LicenseType = ManagedInstanceLicenseType.LicenseIncluded,
    HybridSecondaryUsage = HybridSecondaryUsage.Passive,
    VCores = 8,
    StorageSizeInGB = 1024,
    Collation = "SQL_Latin1_General_CP1_CI_AS",
    ManagedDnsZonePartner = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance"),
    IsPublicDataEndpointEnabled = false,
    ProxyOverride = ManagedInstanceProxyOverride.Redirect,
    TimezoneId = "UTC",
    InstancePoolId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1"),
    MaintenanceConfigurationId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"),
    MinimalTlsVersion = "1.2",
    RequestedBackupStorageRedundancy = SqlBackupStorageRedundancy.Geo,
    Administrators = new ManagedInstanceExternalAdministrator
    {
        PrincipalType = SqlServerPrincipalType.User,
        Login = "bob@contoso.com",
        Sid = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        TenantId = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        IsAzureADOnlyAuthenticationEnabled = true,
    },
    ServicePrincipal = new SqlServicePrincipal
    {
        PrincipalType = SqlServicePrincipalType.SystemAssigned,
    },
    AuthenticationMetadata = AuthMetadataLookupMode.Aad,
    DatabaseFormat = ManagedInstanceDatabaseFormat.AlwaysUpToDate,
    RequestedLogicalAvailabilityZone = SqlAvailabilityZoneType.One,
    Tags =
    {
    ["tagKey1"] = "TagValue1"
    },
};
ArmOperation<ManagedInstanceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, managedInstanceName, data);
ManagedInstanceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedInstanceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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

200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

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

201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

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

202

Create managed instance with minimal properties

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

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "licenseType": "LicenseIncluded",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/ManagedInstanceCreateMin.json
// this example is just showing the usage of "ManagedInstances_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "20D7082A-0FC7-4468-82BD-542694D5042B";
string resourceGroupName = "testrg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ManagedInstanceResource
ManagedInstanceCollection collection = resourceGroupResource.GetManagedInstances();

// invoke the operation
string managedInstanceName = "testinstance";
ManagedInstanceData data = new ManagedInstanceData(new AzureLocation("Japan East"))
{
    Sku = new SqlSku("GP_Gen5")
    {
        Tier = "GeneralPurpose",
    },
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    SubnetId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
    LicenseType = ManagedInstanceLicenseType.LicenseIncluded,
    VCores = 8,
    StorageSizeInGB = 1024,
};
ArmOperation<ManagedInstanceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, managedInstanceName, data);
ManagedInstanceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedInstanceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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

200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

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

201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

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

202

Определения

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

AdministratorType

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

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

Значение	Описание
ActiveDirectory	Служба ActiveDirectory

AuthMetadataLookupModes

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

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

Значение	Описание
AzureAD	AzureAD
Paired	Парный
Windows	Windows

AvailabilityZoneType

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

Указывает зону доступности, к ней закреплена база данных.

Значение	Описание
NoPreference	Отсутствие предпочтений
1	1
2	2
3	3

BackupStorageRedundancy

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

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

Значение	Описание
Geo	Гео
Local	Локальный
Zone	Зона
GeoZone	GeoZone

createdByType

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

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

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

ErrorAdditionalInfo

Объект

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

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

ErrorDetail

Объект

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

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

ErrorResponse

Объект

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

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

ExternalGovernanceStatus

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

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

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

HybridSecondaryUsage

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

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

Значение	Описание
Active	Активный
Passive	Passive

HybridSecondaryUsageDetected

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

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

Значение	Описание
Active	Активный
Passive	Passive

IdentityType

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

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

Значение	Описание
None	Нет
SystemAssigned	Системное назначение
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned,UserAssigned

ManagedInstance

Объект

An Azure SQL managed instance.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	Идентификация Azure Active Directory управляемого экземпляра.
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.administratorLogin	string	Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания).
properties.administratorLoginPassword	string (password)	Пароль для входа администратора (требуется для создания управляемого экземпляра).
properties.administrators	ManagedInstanceExternalAdministrator	Администратор Azure Active Directory может использоваться при создании экземпляров и обновлениях, за исключением свойства azureADOnlyAuthentication. Чтобы обновить свойство azureADOnlyAuthentication, необходимо использовать отдельный 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.memorySizeInGB	integer (int32)	Объем памяти в ГБ. Минимальное значение: 28. Максимальное значение: 870. Минимальное и максимальное значение зависят от количества виртуальных ядер и уровня служб. Подробнее об ограничениях ресурсов: https://aka.ms/mi-resource-limits-api.
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.requestedLogicalAvailabilityZone	AvailabilityZoneType	Указывает логическую зону доступности, к которой прикреплён Управляемый экземпляр.
properties.restorePointInTime	string (date-time)	Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.servicePrincipal	ServicePrincipal	Субъект-служба управляемого экземпляра.
properties.sourceManagedInstanceId	string (arm-id)	Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра.
properties.state	string	Состояние управляемого экземпляра.
properties.storageIOps	integer (int32)	Хранение операций ввода-вывода в секунду. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageSizeInGB	integer (int32)	Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 32768. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер.
properties.storageThroughputMBps	integer (int32)	Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра.
properties.subnetId	string (arm-id)	Идентификатор ресурса подсети для управляемого экземпляра.
properties.timezoneId	string	Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows. Windows хранит данные о поддерживаемых часовых поясах, включая идентификатор, в реестре KEY_LOCAL_MACHINE\SOFTWARE\Майкрософт\Windows NT\CurrentVersion\Time Zones. Вы можете получить эти значения реестра через SQL Server, запросив SELECT имя AS timezone_id ИЗ sys.time_zone_info. Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell. Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
properties.vCores	integer (int32)	Количество виртуальных ядер. Допустимые значения: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Поддерживаемые виртуальные ядра зависят от выбранного семейства оборудования и уровня служб.
properties.virtualClusterId	string	Идентификатор ресурса виртуального кластера для Управляемый экземпляр.
properties.zoneRedundant	boolean	Включена ли избыточность между зонами.
sku	Sku	SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5 (General Purpose, Standard-series); GP_G8IM (Общего назначения, Премиум-серия); GP_G8IH (Общего назначения, Премиум-серия с оптимизацией памяти); BC_Gen5 (Критически важный для бизнеса, Standard-Series); BC_G8IM (Business Critical, Premium-серия); BC_G8IH (критически важный для бизнеса, оптимизированный для памяти серии Premium).
systemData	systemData	Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

ManagedInstanceDatabaseFormat

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

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

Значение	Описание
AlwaysUpToDate	ВсегдаАктуально
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Объект

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

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

ManagedInstanceLicenseType

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

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

Значение	Описание
LicenseIncluded	ЛицензияВключено
BasePrice	BasePrice

ManagedInstancePecProperty

Объект

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

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

ManagedInstancePrivateEndpointConnectionProperties

Объект

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

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

ManagedInstancePrivateEndpointProperty

Объект

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Объект

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

ManagedInstanceProxyOverride

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

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

Значение	Описание
Proxy	Proxy
Redirect	Перенаправить
Default	По умолчанию

ManagedServerCreateMode

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

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

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

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

Значение	Описание
Default	По умолчанию
PointInTimeRestore	PointInTimeRestore

PricingModel

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

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

Значение	Описание
Regular	Регулярный
Freemium	Freemium

PrincipalType

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

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

Значение	Описание
User	User
Group	Группа
Application	Заявление

ProvisioningState

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

Состояние подготовки ARM выполнения задания.

Значение	Описание
Created	Создано
InProgress	InProgress
Succeeded	Succeeded
Failed	Неудача
Canceled	Отменено

ResourceIdentity

Объект

Azure Active Directory identity configuration for a resource.

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

ServicePrincipal

Объект

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

Имя	Тип	Описание
clientId	string	The Azure Active Directory application client id.
principalId	string	The Azure Active Directory application object id.
tenantId	string	The Azure Active Directory tenant id.
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, например "Базовый", "Премиум".

systemData

Объект

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

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

UserIdentity

Объект

Azure Active Directory identity configuration for a resource.

Имя	Тип	Описание
clientId	string (uuid)	The Azure Active Directory client id.
principalId	string (uuid)	The Azure Active Directory principal id.