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

名稱	位於	必要	類型	Description
managedInstanceName	path	True	string	受控實例的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure Resource Manager API 或入口網站取得此值。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK	ManagedInstance	已成功啟動受控實例。
202 Accepted		啟動受控實例正在進行中。標題 Location: string
Other Status Codes	ErrorResponse	錯誤回應： *** 400 NameAlreadyExists - 提供的名稱已經存在。 400 InvalidServerName - 指定的伺服器名稱無效。 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - 指定的 SKU 不支持啟動作業。 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 用戶嘗試使用 Start/Stop 功能，而不需針對適當的訂用帳戶功能列出訂用帳戶。 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 - 標識符為的作業不存在。 404 ResourceNotFound - 找不到要求的資源。 404 OperationIdNotFound - 標識符為的作業不存在。 409 SubscriptionDisabled - 已停用訂用帳戶。 409 CannotCancelOperation - 管理作業處於無法取消的狀態。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。請重試作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

名稱

類型

Description

200 OK

ManagedInstance

已成功啟動受控實例。

202 Accepted

啟動受控實例正在進行中。

標題

Location: string

Other Status Codes

ErrorResponse

錯誤回應： ***

400 NameAlreadyExists - 提供的名稱已經存在。
400 InvalidServerName - 指定的伺服器名稱無效。
400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - 指定的 SKU 不支持啟動作業。
400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 用戶嘗試使用 Start/Stop 功能，而不需針對適當的訂用帳戶功能列出訂用帳戶。
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 - 標識符為的作業不存在。
404 ResourceNotFound - 找不到要求的資源。
404 OperationIdNotFound - 標識符為的作業不存在。
409 SubscriptionDisabled - 已停用訂用帳戶。
409 CannotCancelOperation - 管理作業處於無法取消的狀態。
409 OperationCancelled - 使用者已取消作業。
409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。
429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。
500 OperationTimedOut - 作業逾時並自動回復。請重試作業。
503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

Starts the managed instance.

範例要求

HTTP

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

範例回覆

狀態碼:: 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

定義

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

列舉型別

伺服器管理員的類型。

值	Description
ActiveDirectory

AuthMetadataLookupModes

列舉型別

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

值	Description
AzureAD
Paired
Windows

BackupStorageRedundancy

列舉型別

用來儲存此實例備份的記憶體帳戶類型。選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）

值	Description
Geo
GeoZone
Local
Zone

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	error 物件。

ExternalGovernanceStatus

列舉型別

外部治理的狀態。

值	Description
Disabled
Enabled

HybridSecondaryUsage

列舉型別

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

值	Description
Active
Passive

HybridSecondaryUsageDetected

列舉型別

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

值	Description
Active
Passive

IdentityType

列舉型別

識別類型。將此設定為『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。

值	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned