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 參數

名稱	位於	必要	類型	Description
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 版本。

要求本文

名稱	必要	類型	Description
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	混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。
properties.instancePoolId		string	這個受控伺服器所屬之實例集區的標識碼。
properties.isGeneralPurposeV2		boolean	這是否為一般用途版本的 GPv2 變體。
properties.keyId		string	要用於加密之金鑰的 CMK URI。
properties.licenseType		ManagedInstanceLicenseType	授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。
properties.maintenanceConfigurationId		string	指定要套用至這個受控實例的維護組態標識碼。
properties.managedInstanceCreateMode		ManagedServerCreateMode	指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。
properties.memorySizeInGB		integer (int32)	記憶體大小（以 GB 為單位）。 最小值：28。 最大值：870。 最小值和最大值取決於 vCore 數和服務層級。 閱讀有關資源限制的更多資訊： https://aka.ms/mi-resource-limits-api。
properties.minimalTlsVersion		string	最低 TLS 版本。 允許的值：'None'、'1.0'、'1.1'、'1.2'
properties.pricingModel		PricingModel	受控執行個體 的定價模式。
properties.primaryUserAssignedIdentityId		string (arm-id)	預設會使用之使用者指派身分識別的資源標識碼。
properties.proxyOverride		ManagedInstanceProxyOverride	用於連接到實例的連接類型。
properties.publicDataEndpointEnabled		boolean	是否啟用公用資料端點。
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	要用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、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)	儲存體 IOps。 最小值：300。 最大值：80000。 僅允許 1 個 IOps 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。
properties.storageSizeInGB		integer (int32)	以 GB 為單位的記憶體大小。 最小值：32。 最大值：32768。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。
properties.storageThroughputMBps		integer (int32)	實例建立/更新作業不支持記憶體輸送量 MBps 參數。
properties.subnetId		string (arm-id)	受控實例的子網資源標識碼。
properties.timezoneId		string	時區的標識碼。 允許的值是指 Windows 支援的時區。 Windows 在登錄檔中保存支援時區的詳細資訊，包括 ID，分類為 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。 你可以透過查詢 SELECT 名稱作為 timezone_id FROM sys.time_zone_info，取得這些登錄檔值SQL Server。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。
properties.vCores		integer (int32)	虛擬核心數目。 允許的值：4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 支援的 vCore 取決於所選的硬體系列和服務層級。
properties.zoneRedundant		boolean	是否啟用區域冗餘。
sku		Sku	受控實例 SKU。 sku.name 允許的值：GP_Gen5（通用，標準系列）;GP_G8IM（通用，高級系列）;GP_G8IH（通用，高級系列記憶體優化）;BC_Gen5（關鍵業務，Standard-Series）;BC_G8IM（關鍵業務，高級系列）;BC_G8IH（業務關鍵型，高級系列記憶體優化）。
tags		object	資源標籤。

回應

名稱	類型	Description
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

範圍

名稱	Description
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

定義

名稱	Description
AdministratorType	伺服器管理員的類型。
AuthMetadataLookupModes	受控實例的驗證元數據查閱模式。
AvailabilityZoneType	指定資料庫釘選到的可用性區域。
BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
createdByType	建立資源的身分識別類型。
ErrorAdditionalInfo	資源管理錯誤附加資訊。
ErrorDetail	錯誤詳細資料。
ErrorResponse	錯誤回應
ExternalGovernanceStatus	外部治理的狀態。
HybridSecondaryUsage	混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。
HybridSecondaryUsageDetected	偵測到混合式次要使用量。 可能的值為「主動」（客戶不符合使用次要作為被動DR的需求）和「被動」（客戶符合使用次要作為被動DR的需求）。
IdentityType	識別類型。 請將此設定為「SystemAssigned」，以自動建立並指派該資源的 Azure Active Directory 主體。
ManagedInstance	An Azure SQL managed instance.
ManagedInstanceDatabaseFormat	指定 SQL 引擎版本專屬實例資料庫的內部格式。
ManagedInstanceExternalAdministrator	Active Directory 系統管理員的屬性。
ManagedInstanceLicenseType	授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。
ManagedInstancePecProperty	受控實例下的私人端點連線
ManagedInstancePrivateEndpointConnectionProperties	私人端點連線的屬性。
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	用於連接到實例的連接類型。
ManagedServerCreateMode	指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。
PricingModel	受控執行個體 的定價模式。
PrincipalType	伺服器管理員的主體類型。
ProvisioningState	作業執行的 ARM 布建狀態。
ResourceIdentity	Azure Active Directory identity configuration for a resource.
ServicePrincipal	資源的受控實例服務主體組態。
ServicePrincipalType	服務主體類型。
Sku	ARM 資源 SKU。
systemData	與建立和上次修改資源相關的元數據。
UserIdentity	Azure Active Directory identity configuration for a resource.

AdministratorType

列舉型別

伺服器管理員的類型。

值	Description
ActiveDirectory	活動目錄

AuthMetadataLookupModes

列舉型別

受控實例的驗證元數據查閱模式。

值	Description
AzureAD	AzureAD
Paired	配對
Windows	Windows

AvailabilityZoneType

列舉型別

指定資料庫釘選到的可用性區域。

值	Description
NoPreference	無偏好
1	1
2	2
3	3

BackupStorageRedundancy

列舉型別

用來儲存此資料庫的備份的記憶體帳戶類型。

值	Description
Geo	地理位置
Local	本地
Zone	區域
GeoZone	地理區域

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

資源管理錯誤附加資訊。

名稱	類型	Description
info	object	附加資訊。
type	string	其他資訊類型。

ErrorDetail

Object

錯誤詳細資料。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤附加資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳情
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	錯誤物件。

ExternalGovernanceStatus

列舉型別

外部治理的狀態。

值	Description
Enabled	已啟用
Disabled	Disabled

HybridSecondaryUsage

列舉型別

混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。

值	Description
Active	作用中
Passive	Passive

HybridSecondaryUsageDetected

列舉型別

偵測到混合式次要使用量。 可能的值為「主動」（客戶不符合使用次要作為被動DR的需求）和「被動」（客戶符合使用次要作為被動DR的需求）。

值	Description
Active	作用中
Passive	Passive

IdentityType

列舉型別

識別類型。 請將此設定為「SystemAssigned」，以自動建立並指派該資源的 Azure Active Directory 主體。

值	Description
None	沒有
SystemAssigned	系統分配的
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	系統指派，使用者指派

ManagedInstance

Object

An Azure SQL managed instance.

名稱	類型	Description
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 （LocalRedundantStorage）、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	混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	偵測到混合式次要使用量。 可能的值為「主動」（客戶不符合使用次要作為被動DR的需求）和「被動」（客戶符合使用次要作為被動DR的需求）。
properties.instancePoolId	string	這個受控伺服器所屬之實例集區的標識碼。
properties.isGeneralPurposeV2	boolean	這是否為一般用途版本的 GPv2 變體。
properties.keyId	string	要用於加密之金鑰的 CMK URI。
properties.licenseType	ManagedInstanceLicenseType	授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。
properties.maintenanceConfigurationId	string	指定要套用至這個受控實例的維護組態標識碼。
properties.managedInstanceCreateMode	ManagedServerCreateMode	指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。
properties.memorySizeInGB	integer (int32)	記憶體大小（以 GB 為單位）。 最小值：28。 最大值：870。 最小值和最大值取決於 vCore 數和服務層級。 閱讀有關資源限制的更多資訊： https://aka.ms/mi-resource-limits-api。
properties.minimalTlsVersion	string	最低 TLS 版本。 允許的值：'None'、'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 （LocalRedundantStorage）、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)	儲存體 IOps。 最小值：300。 最大值：80000。 僅允許 1 個 IOps 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。
properties.storageSizeInGB	integer (int32)	以 GB 為單位的記憶體大小。 最小值：32。 最大值：32768。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。
properties.storageThroughputMBps	integer (int32)	實例建立/更新作業不支持記憶體輸送量 MBps 參數。
properties.subnetId	string (arm-id)	受控實例的子網資源標識碼。
properties.timezoneId	string	時區的標識碼。 允許的值是指 Windows 支援的時區。 Windows 在登錄檔中保存支援時區的詳細資訊，包括 ID，分類為 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。 你可以透過查詢 SELECT 名稱作為 timezone_id FROM sys.time_zone_info，取得這些登錄檔值SQL Server。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。
properties.vCores	integer (int32)	虛擬核心數目。 允許的值：4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 支援的 vCore 取決於所選的硬體系列和服務層級。
properties.virtualClusterId	string	受控執行個體 的虛擬叢集資源 ID。
properties.zoneRedundant	boolean	是否啟用區域冗餘。
sku	Sku	受控實例 SKU。 sku.name 允許的值：GP_Gen5（通用，標準系列）;GP_G8IM（通用，高級系列）;GP_G8IH（通用，高級系列記憶體優化）;BC_Gen5（關鍵業務，Standard-Series）;BC_G8IM（關鍵業務，高級系列）;BC_G8IH（業務關鍵型，高級系列記憶體優化）。
systemData	systemData	Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。
tags	object	資源標籤。
type	string	資源的類型。 例如：「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」

ManagedInstanceDatabaseFormat

列舉型別

指定 SQL 引擎版本專屬實例資料庫的內部格式。

值	Description
AlwaysUpToDate	AlwaysToDate
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Object

Active Directory 系統管理員的屬性。

名稱	類型	Description
administratorType	AdministratorType	伺服器管理員的類型。
azureADOnlyAuthentication	boolean	Azure Active Directory only authentication enabled.
login	string	伺服器管理員的登入名稱。
principalType	PrincipalType	伺服器管理員的主體類型。
sid	string (uuid)	伺服器管理員的 SID （物件識別符）。
tenantId	string (uuid)	系統管理員的租用戶標識碼。

ManagedInstanceLicenseType

列舉型別

授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。

值	Description
LicenseIncluded	授權包含
BasePrice	BasePrice

ManagedInstancePecProperty

Object

受控實例下的私人端點連線

名稱	類型	Description
id	string	資源標識碼。
properties	ManagedInstancePrivateEndpointConnectionProperties	私人端點連線屬性

ManagedInstancePrivateEndpointConnectionProperties

Object

私人端點連線的屬性。

名稱	類型	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	線上所屬的私人端點。
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	私人端點連線的連接狀態。
provisioningState	string	私人端點連線的狀態。

ManagedInstancePrivateEndpointProperty

Object

名稱	類型	Description
id	string	私人端點的資源標識碼。

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

名稱	類型	Description
actionsRequired	string	私人鏈接服務連線描述。
description	string	私人鏈接服務連線描述。
status	string	私人鏈接服務連線狀態。

ManagedInstanceProxyOverride

列舉型別

用於連接到實例的連接類型。

值	Description
Proxy	Proxy
Redirect	Redirect
Default	預設值

ManagedServerCreateMode

列舉型別

指定資料庫建立模式。

默認值：定期建立實例。

還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。

值	Description
Default	預設值
PointInTimeRestore	PointInTimeRestore

PricingModel

列舉型別

受控執行個體 的定價模式。

值	Description
Regular	定期
Freemium	免費增值

PrincipalType

列舉型別

伺服器管理員的主體類型。

值	Description
User	User
Group	Group
Application	應用程式

ProvisioningState

列舉型別

作業執行的 ARM 布建狀態。

值	Description
Created	已建立
InProgress	進行中
Succeeded	成功
Failed	失敗
Canceled	已取消

ResourceIdentity

Object

Azure Active Directory identity configuration for a resource.

名稱	類型	Description
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

Object

資源的受控實例服務主體組態。

名稱	類型	Description
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

列舉型別

服務主體類型。

值	Description
None	沒有
SystemAssigned	系統分配的

Sku

Object

ARM 資源 SKU。

名稱	類型	Description
capacity	integer (int32)	特定 SKU 的容量。
family	string	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。
name	string	SKU 的名稱，通常是字母 + 數位碼，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的階層或版本，例如基本、進階。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	資源上次修改的時間戳記 （UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

UserIdentity

Object

Azure Active Directory identity configuration for a resource.

名稱	類型	Description
clientId	string (uuid)	The Azure Active Directory client id.
principalId	string (uuid)	The Azure Active Directory principal id.