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

Managed Instances - Stop

参考

Service:: SQL Database

API Version:: 2023-08-01-preview

停止托管实例。

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

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		正在停止托管实例。
Other Status Codes	ErrorResponse	错误响应：*** 400 ManagementServiceStopManagedInstanceZoneRedundant - 在启用了区域冗余的实例上停止执行。 400 ManagementServiceStopManagedInstancePartOfFailoverGroup - 停止在属于故障转移组的实例上执行。 400 NameAlreadyExists - 提供的名称已存在。 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 用户尝试使用“启动/停止”功能，但未将订阅列入相应订阅功能的允许列表。 400 ManagementServiceStopManagedInstanceNotSupportedOnSKU - 给定 SKU 不支持停止操作。 400 InvalidServerName - 指定的服务器名称无效。 400 StartStopOfManagedInstanceIsDisabled - 未启用托管实例上的启动和停止操作。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 ManagementServiceStopManagedInstanceUsingMILink - 停止在配置了托管实例链接的实例上执行。 400 ManagementServiceStopManagedInstanceFeatureDisabled - 用户尝试使用已禁用的停止Azure SQL 托管实例功能。 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月运行的实例上执行 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 OperationIdNotFound - ID 为的操作不存在。 404 ResourceNotFound - 找不到请求的资源。 404 OperationIdNotFound - ID 为的操作不存在。 409 ManagementServiceStopManagedInstanceAlreadyInProgress - 为处于停止/停止状态的操作提交的停止操作。 409 ManagementServiceStopManagedInstanceConflictingOperation - 停止Azure SQL 托管实例冲突操作消息。 409 ManagementServiceStopManagedInstanceDroppedDuringStop - 停止在处于删除状态或同时被删除的实例上执行。 409 SubscriptionDisabled - 订阅已禁用。 409 CannotCancelOperation - 管理操作处于无法取消的状态。 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。

名称

类型

说明

200 OK

ManagedInstance

已成功停止托管实例。

202 Accepted

正在停止托管实例。

Other Status Codes

ErrorResponse

错误响应：***

400 ManagementServiceStopManagedInstanceZoneRedundant - 在启用了区域冗余的实例上停止执行。
400 ManagementServiceStopManagedInstancePartOfFailoverGroup - 停止在属于故障转移组的实例上执行。
400 NameAlreadyExists - 提供的名称已存在。
400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 用户尝试使用“启动/停止”功能，但未将订阅列入相应订阅功能的允许列表。
400 ManagementServiceStopManagedInstanceNotSupportedOnSKU - 给定 SKU 不支持停止操作。
400 InvalidServerName - 指定的服务器名称无效。
400 StartStopOfManagedInstanceIsDisabled - 未启用托管实例上的启动和停止操作。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 ManagementServiceStopManagedInstanceUsingMILink - 停止在配置了托管实例链接的实例上执行。
400 ManagementServiceStopManagedInstanceFeatureDisabled - 用户尝试使用已禁用的停止Azure SQL 托管实例功能。
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月运行的实例上执行
404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 OperationIdNotFound - ID 为的操作不存在。
404 ResourceNotFound - 找不到请求的资源。
404 OperationIdNotFound - ID 为的操作不存在。
409 ManagementServiceStopManagedInstanceAlreadyInProgress - 为处于停止/停止状态的操作提交的停止操作。
409 ManagementServiceStopManagedInstanceConflictingOperation - 停止Azure SQL 托管实例冲突操作消息。
409 ManagementServiceStopManagedInstanceDroppedDuringStop - 停止在处于删除状态或同时被删除的实例上执行。
409 SubscriptionDisabled - 订阅已禁用。
409 CannotCancelOperation - 管理操作处于无法取消的状态。
409 OperationCancelled - 用户已取消操作。
409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。
429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。
500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。
503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。

示例

Stops the managed instance.

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostop.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Stopped",
    "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/stoprg/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/stoprg/providers/Microsoft.Sql/managedInstances/mitostop",
  "name": "mitostop",
  "type": "Microsoft.Sql/managedInstances"
}

Status code:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

定义

名称	说明
AdministratorType	服务器管理员的类型。
AuthMetadataLookupModes	托管实例的身份验证元数据查找模式。
BackupStorageRedundancy	用于存储此实例的备份的存储帐户类型。选项包括 Local (LocalRedundantStorage) 、Zone (ZoneRedundantStorage) 、Geo (GeoRedundantStorage) 和 GeoZone (GeoZoneRedundantStorage)
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ExternalGovernanceStatus	外部治理的状态。
FreemiumType	天气与否托管实例免费。
HybridSecondaryUsage	混合辅助数据库使用情况。可能的值为“Active” (默认值) 和“Passive”， (客户将辅助数据库用作被动 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。
PrincipalType	服务器管理员的主体类型。
ProvisioningState	托管实例的预配状态。
ResourceIdentity	资源的 Azure Active Directory 标识配置。
ServicePrincipal	资源的托管实例的服务主体配置。
ServicePrincipalType	服务主体类型。
Sku	ARM 资源 SKU。
UserIdentity	资源的 Azure Active Directory 标识配置。

AdministratorType

服务器管理员的类型。

名称	类型	说明
ActiveDirectory	string

AuthMetadataLookupModes

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

名称	类型	说明
AzureAD	string
Paired	string
Windows	string

BackupStorageRedundancy

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

名称	类型	说明
Geo	string
GeoZone	string
Local	string
Zone	string

ErrorAdditionalInfo

资源管理错误附加信息。

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

ErrorDetail

错误详细信息。

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

ErrorResponse

错误响应

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

ExternalGovernanceStatus

外部治理的状态。

名称	类型	说明
Disabled	string
Enabled	string

FreemiumType

天气与否托管实例免费。

名称	类型	说明
Freemium	string
Regular	string

HybridSecondaryUsage

混合辅助数据库使用情况。可能的值为“Active” (默认值) 和“Passive”， (客户将辅助数据库用作被动 DR) 。

名称	类型	说明
Active	string
Passive	string

HybridSecondaryUsageDetected

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

名称	类型	说明
Active	string
Passive	string

IdentityType

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

名称	类型	说明
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string