你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Managed Instances - Start

服务:: SQL Database

API 版本:: 2023-08-01

启动托管实例。

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	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
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 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - 用户尝试启动未处于“已停止”状态的 Azure SQL 托管实例。 400 ManagementServiceStartManagedInstanceFeatureDisabled - 用户尝试使用禁用的“启动 Azure SQL 托管实例”功能。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 InvalidServerName - 指定的服务器名称无效。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 OperationIdNotFound - ID作不存在。 404 ResourceNotFound - 找不到请求的资源。 404 OperationIdNotFound - ID作不存在。 409 SubscriptionDisabled - 已禁用订阅。 409 CannotCancelOperation - 管理作处于无法取消的状态。 409 OperationCancelled -作已被用户取消。 409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 500 OperationTimedOut -作超时并自动回滚。请重试该作。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

名称

类型

说明

200 OK

ManagedInstance

已成功启动托管实例。

202 Accepted

正在启动托管实例。

标头

Location: string

Other Status Codes

ErrorResponse

错误响应： ***

400 NameAlreadyExists - 提供的名称已存在。
400 InvalidServerName - 指定的服务器名称无效。
400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - 给定 SKU 不支持启动作。
400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 用户尝试使用启动/停止功能，而无需为相应的订阅功能列出订阅允许列表。
400 StartStopOfManagedInstanceIsDisabled - 未在托管实例上启动和停止作。
400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - 用户尝试启动未处于“已停止”状态的 Azure SQL 托管实例。
400 ManagementServiceStartManagedInstanceFeatureDisabled - 用户尝试使用禁用的“启动 Azure SQL 托管实例”功能。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 InvalidServerName - 指定的服务器名称无效。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 TokenTooLong - 提供的令牌太长。
404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 OperationIdNotFound - ID作不存在。
404 ResourceNotFound - 找不到请求的资源。
404 OperationIdNotFound - ID作不存在。
409 SubscriptionDisabled - 已禁用订阅。
409 CannotCancelOperation - 管理作处于无法取消的状态。
409 OperationCancelled -作已被用户取消。
409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。
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

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

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/StartManagedInstance.json
// this example is just showing the usage of "ManagedInstances_Start" 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://free.blessedness.top/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 ManagedInstanceResource created on azure
// for more information of creating ManagedInstanceResource, please refer to the document of ManagedInstanceResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "startrg";
string managedInstanceName = "mitostart";
ResourceIdentifier managedInstanceResourceId = ManagedInstanceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName);
ManagedInstanceResource managedInstance = client.GetManagedInstanceResource(managedInstanceResourceId);

// invoke the operation
ArmOperation<ManagedInstanceResource> lro = await managedInstance.StartAsync(WaitUntil.Completed);
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

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

状态代码:: 202

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 （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ExternalGovernanceStatus	外部治理的状态。
HybridSecondaryUsage	混合辅助用途。可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。
HybridSecondaryUsageDetected	检测到混合辅助使用情况。可能的值为“主动”（客户不满足将辅助数据库用作被动 DR 的要求）和“被动”（客户满足将辅助数据库用作被动 DR 的要求）。
IdentityType	标识类型。将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。
ManagedInstance	Azure SQL 托管实例。
ManagedInstanceDatabaseFormat	指定特定于 SQL 引擎版本的实例数据库的内部格式。
ManagedInstanceExternalAdministrator	Active Directory 管理员的属性。
ManagedInstanceLicenseType	许可证类型。可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。
ManagedInstancePecProperty	托管实例下的专用终结点连接
ManagedInstancePrivateEndpointConnectionProperties	专用终结点连接的属性。
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	用于连接到实例的连接类型。
ManagedServerCreateMode	指定数据库创建模式。默认值：定期创建实例。还原：通过将一组备份还原到特定的时间点来创建实例。必须指定 RestorePointInTime 和 SourceManagedInstanceId。
PricingModel	托管实例的定价模型。
PrincipalType	服务器管理员的主体类型。
ProvisioningState	托管实例的预配状态。
ResourceIdentity	资源的 Azure Active Directory 标识配置。
ServicePrincipal	资源的托管实例的服务主体配置。
ServicePrincipalType	服务主体类型。
Sku	ARM 资源 SKU。
UserIdentity	资源的 Azure Active Directory 标识配置。

AdministratorType

枚举

服务器管理员的类型。

值	说明
ActiveDirectory

AuthMetadataLookupModes

枚举

托管实例的身份验证元数据查找模式。

值	说明
AzureAD
Paired
Windows

BackupStorageRedundancy

枚举

用于存储此实例备份的存储帐户类型。选项包括 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）

值	说明
Geo
Local
Zone
GeoZone

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ExternalGovernanceStatus

枚举

外部治理的状态。

值	说明
Enabled
Disabled

HybridSecondaryUsage

枚举

混合辅助用途。可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。

值	说明
Active
Passive

HybridSecondaryUsageDetected

枚举

检测到混合辅助使用情况。可能的值为“主动”（客户不满足将辅助数据库用作被动 DR 的要求）和“被动”（客户满足将辅助数据库用作被动 DR 的要求）。

值	说明
Active
Passive

IdentityType

枚举

标识类型。将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。

值	说明
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned