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 Resource Manager 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 - ユーザーは、適切なサブスクリプション機能のサブスクリプション許可リストを持たずに、Start/Stop 機能を使用しようとしました。 400 StartStopOfManagedInstanceIsDisabled - マネージドインスタンスでの開始操作と停止操作が有効になっていません。 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - ユーザーが停止状態ではない Azure SQL Managed Instance を起動しようとしました。 400 ManagementServiceStartManagedInstanceFeatureDisabled - ユーザーは、無効になっている Azure SQL Managed Instance の開始機能を使用しようとしました。 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 - ユーザーは、適切なサブスクリプション機能のサブスクリプション許可リストを持たずに、Start/Stop 機能を使用しようとしました。
400 StartStopOfManagedInstanceIsDisabled - マネージドインスタンスでの開始操作と停止操作が有効になっていません。
400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - ユーザーが停止状態ではない Azure SQL Managed Instance を起動しようとしました。
400 ManagementServiceStartManagedInstanceFeatureDisabled - ユーザーは、無効になっている Azure SQL Managed Instance の開始機能を使用しようとしました。
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.

要求のサンプル

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

定義

名前	説明
AdministratorType	管理者の種類。
AuthMetadataLookupModes	マネージドインスタンスの認証メタデータ参照モード。
BackupStorageRedundancy	このインスタンスのバックアップを格納するために使用されるストレージアカウントの種類。オプションは、Local (LocallyRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage)、GeoZone(GeoZoneRedundantStorage) です。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ExternalGovernanceStatus	外部ガバナンスの状態。
HybridSecondaryUsage	ハイブリッドセカンダリの使用。指定できる値は、"アクティブ" (既定値) と "パッシブ" です (お客様はセカンダリをパッシブ DR として使用します)。
HybridSecondaryUsageDetected	ハイブリッドセカンダリの使用が検出されました。使用可能な値は、"アクティブ" (お客様はセカンダリをパッシブ DR として使用する要件を満たしていません) と "パッシブ" です (お客様は、セカンダリをパッシブ DR として使用する要件を満たしています)。
IdentityType	ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。
ManagedInstance	Azure SQL マネージドインスタンス。
ManagedInstanceDatabaseFormat	SQL エンジンのバージョンに固有のインスタンスデータベースの内部形式を指定します。
ManagedInstanceExternalAdministrator	Active Directory 管理者のプロパティ。
ManagedInstanceLicenseType	ライセンスの種類。指定できる値は、'LicenseIncluded' (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込む場合の AHB 価格の割引) です。
ManagedInstancePecProperty	マネージドインスタンスでのプライベートエンドポイント接続
ManagedInstancePrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ。
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	インスタンスへの接続に使用される接続の種類。
ManagedServerCreateMode	データベースの作成モードを指定します。既定値: 通常のインスタンスの作成。復元: 特定の時点に一連のバックアップを復元してインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。
PricingModel	Managed Instance の価格モデル。
PrincipalType	サーバー管理者のプリンシパルの種類。
ProvisioningState	マネージドインスタンスのプロビジョニング状態。
ResourceIdentity	リソースの Azure Active Directory ID 構成。
ServicePrincipal	リソースのマネージドインスタンスのサービスプリンシパル構成。
ServicePrincipalType	サービスプリンシパルの種類。
Sku	ARM リソース SKU。
UserIdentity	リソースの Azure Active Directory ID 構成。

AdministratorType

列挙

管理者の種類。

値	説明
ActiveDirectory

AuthMetadataLookupModes

列挙

マネージドインスタンスの認証メタデータ参照モード。

値	説明
AzureAD
Paired
Windows

BackupStorageRedundancy

列挙

このインスタンスのバックアップを格納するために使用されるストレージアカウントの種類。オプションは、Local (LocallyRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage)、GeoZone(GeoZoneRedundantStorage) です。

値	説明
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

ExternalGovernanceStatus

列挙

外部ガバナンスの状態。

値	説明
Disabled
Enabled

HybridSecondaryUsage

列挙

ハイブリッドセカンダリの使用。指定できる値は、"アクティブ" (既定値) と "パッシブ" です (お客様はセカンダリをパッシブ DR として使用します)。

値	説明
Active
Passive

HybridSecondaryUsageDetected

列挙

ハイブリッドセカンダリの使用が検出されました。使用可能な値は、"アクティブ" (お客様はセカンダリをパッシブ DR として使用する要件を満たしていません) と "パッシブ" です (お客様は、セカンダリをパッシブ DR として使用する要件を満たしています)。

値	説明
Active
Passive

IdentityType

列挙

ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。

値	説明
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned