Managed Instances - Start

マネージド インスタンスを開始します。

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

URI パラメーター

名前 / 必須 説明
managedInstanceName
path True

string

マネージド インスタンスの名前。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前の大文字と小文字は区別されません。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

応答

名前 説明
200 OK

ManagedInstance

Azureの運用は無事に完了しました。

202 Accepted

リソース操作が受け入れられます。

ヘッダー

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

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=2025-01-01

応答のサンプル

{
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "authenticationMetadata": "Windows",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1234567891234",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Succeeded",
    "proxyOverride": "Default",
    "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/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "key": "value"
  }
}
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111

定義

名前 説明
AdministratorType

管理者の種類。

AuthMetadataLookupModes

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

AvailabilityZoneType

データベースがピン留めされる可用性ゾーンを指定します。

BackupStorageRedundancy

このデータベースのバックアップを格納するために使用されるストレージ アカウントの種類。

createdByType

リソースを作成した ID の種類。

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

ExternalGovernanceStatus

外部ガバナンスの状態。

HybridSecondaryUsage

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

HybridSecondaryUsageDetected

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

IdentityType

ID の種類。 これを「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

Managed Instanceの価格モデル。

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

管理者の種類。

説明
ActiveDirectory

アクティブディレクトリ

AuthMetadataLookupModes

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

説明
AzureAD

AzureAD

Paired

対をなすデータの t 検定

Windows

Windows

AvailabilityZoneType

データベースがピン留めされる可用性ゾーンを指定します。

説明
NoPreference

ノープリファレンス

1

1

2

2

3

3

BackupStorageRedundancy

このデータベースのバックアップを格納するために使用されるストレージ アカウントの種類。

説明
Geo

ジオ

Local

ローカル

Zone

ゾーン

GeoZone

GeoZone

createdByType

リソースを作成した ID の種類。

説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

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

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

エラー オブジェクト。

ExternalGovernanceStatus

外部ガバナンスの状態。

説明
Enabled

有効

Disabled

Disabled

HybridSecondaryUsage

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

説明
Active

アクティブ

Passive

Passive

HybridSecondaryUsageDetected

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

説明
Active

アクティブ

Passive

Passive

IdentityType

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

説明
None

なし

SystemAssigned

システム割り当て

UserAssigned

UserAssigned

SystemAssigned,UserAssigned

SystemAssigned, UserAssigned

ManagedInstance

An Azure SQL managed instance.

名前 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ResourceIdentity

管理されたインスタンスのAzure Active Directory IDです。

location

string

リソースが存在する地理的な場所

name

string

リソースの名前

properties.administratorLogin

string

マネージド インスタンスの管理者ユーザー名。 マネージド インスタンスの作成時にのみ指定できます (作成に必要です)。

properties.administratorLoginPassword

string (password)

管理者ログイン パスワード (マネージド インスタンスの作成に必要)。

properties.administrators

ManagedInstanceExternalAdministrator

Azure Active Directory管理者は、instanceの作成やインスタンスの更新時に利用できますが、azureADOnlyAuthentication プロパティは例外です。 azureADOnlyAuthentication プロパティを更新するには、個々の API を使用する必要があります。

properties.authenticationMetadata

AuthMetadataLookupModes

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

properties.collation

string

マネージド インスタンスの照合順序。

properties.createTime

string (date-time)

Managed Instance作成の時点(ISO8601形式)を指定します。

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

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

properties.databaseFormat

ManagedInstanceDatabaseFormat

SQL エンジンのバージョンに固有のインスタンス データベースの内部形式を指定します。

properties.dnsZone

string

マネージド インスタンスが存在する Dns ゾーン。

properties.dnsZonePartner

string (arm-id)

このマネージド インスタンスが作成後に共有する DNS ゾーンを持つ別のマネージド インスタンスのリソース ID。

properties.externalGovernanceStatus

ExternalGovernanceStatus

外部ガバナンスの状態。

properties.fullyQualifiedDomainName

string

マネージド インスタンスの完全修飾ドメイン名。

properties.hybridSecondaryUsage

HybridSecondaryUsage

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

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

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

properties.instancePoolId

string

このマネージド サーバーが属しているインスタンス プールの ID。

properties.isGeneralPurposeV2

boolean

これが General Purpose エディションの GPv2 バリアントであるかどうか。

properties.keyId

string

暗号化に使用するキーの CMK URI。

properties.licenseType

ManagedInstanceLicenseType

ライセンスの種類。 指定できる値は、'LicenseIncluded' (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込む場合の AHB 価格の割引) です。

properties.maintenanceConfigurationId

string

このマネージド インスタンスに適用するメンテナンス構成 ID を指定します。

properties.managedInstanceCreateMode

ManagedServerCreateMode

データベースの作成モードを指定します。

既定値: 通常のインスタンスの作成。

復元: 特定の時点に一連のバックアップを復元してインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。

properties.memorySizeInGB

integer (int32)

メモリサイズ(GB)。 最小値: 28。 最大値: 870。 最小値と最大値は、仮想コアの数とサービス レベルによって異なります。 リソース制限の詳細については、 https://aka.ms/mi-resource-limits-apiを参照してください。

properties.minimalTlsVersion

string

最小 TLS バージョン。 使用できる値: 'None'、'1.0'、'1.1'、'1.2'

properties.pricingModel

PricingModel

Managed Instanceの価格モデル。

properties.primaryUserAssignedIdentityId

string (arm-id)

既定で使用されるユーザー割り当て ID のリソース ID。

properties.privateEndpointConnections

ManagedInstancePecProperty[]

マネージド インスタンス上のプライベート エンドポイント接続の一覧。

properties.provisioningState

ProvisioningState

マネージド インスタンスのプロビジョニング状態。

properties.proxyOverride

ManagedInstanceProxyOverride

インスタンスへの接続に使用される接続の種類。

properties.publicDataEndpointEnabled

boolean

パブリック データ エンドポイントが有効かどうか。

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

Managed Instanceがピン留めされている論理的可用性ゾーンを指定します。

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)

マネージド インスタンスのサブネット リソース ID。

properties.timezoneId

string

タイムゾーンの ID。 許可された値はWindowsでサポートされているタイムゾーンです。 Windowsは、KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zonesのレジストリに、IDを含むサポートタイムゾーンの詳細を保持しています。 SELECT nameをtimezone_id FROM sys.time_zone_infoでクエリすることで、SQL Serverでレジストリ値を取得できます。 Id の一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行して取得することもできます。 有効なタイムゾーン ID の例として、"Pacific Standard Time" または "W" があります。 ヨーロッパ標準時"。

properties.vCores

integer (int32)

仮想コアの数。 使用できる値: 4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 サポートされている仮想コアは、選択したハードウェア ファミリとサービス レベルによって異なります。

properties.virtualClusterId

string

Managed InstanceのVirtual Cluster Resource IDです。

properties.zoneRedundant

boolean

ゾーン冗長性が有効になっているかどうか。

sku

Sku

マネージド インスタンス SKU。 sku.name に使用できる値: GP_Gen5 (汎用、標準シリーズ);GP_G8IM (汎用、プレミアムシリーズ);GP_G8IH (汎用、プレミアム シリーズ メモリ最適化);BC_Gen5 (ビジネスクリティカル、Standard-Series);BC_G8IM (ビジネス クリティカル、プレミアム シリーズ);BC_G8IH (Business Critical、Premium シリーズのメモリ最適化)。

systemData

systemData

create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。

tags

object

リソース タグ。

type

string

リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

ManagedInstanceDatabaseFormat

SQL エンジンのバージョンに固有のインスタンス データベースの内部形式を指定します。

説明
AlwaysUpToDate

AlwaysToDate

SQLServer2022

SQLServer2022

SQLServer2025

SQLServer2025

ManagedInstanceExternalAdministrator

Active Directory 管理者のプロパティ。

名前 説明
administratorType

AdministratorType

管理者の種類。

azureADOnlyAuthentication

boolean

Azure Active Directoryのみ認証が有効。

login

string

サーバー管理者のログイン名。

principalType

PrincipalType

サーバー管理者のプリンシパルの種類。

sid

string (uuid)

サーバー管理者の SID (オブジェクト ID)。

tenantId

string (uuid)

管理者のテナント ID。

ManagedInstanceLicenseType

ライセンスの種類。 指定できる値は、'LicenseIncluded' (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込む場合の AHB 価格の割引) です。

説明
LicenseIncluded

ライセンス含録

BasePrice

BasePrice

ManagedInstancePecProperty

マネージド インスタンスでのプライベート エンドポイント接続

名前 説明
id

string

リソース ID。

properties

ManagedInstancePrivateEndpointConnectionProperties

プライベート エンドポイント接続のプロパティ

ManagedInstancePrivateEndpointConnectionProperties

プライベート エンドポイント接続のプロパティ。

名前 説明
privateEndpoint

ManagedInstancePrivateEndpointProperty

接続が属するプライベート エンドポイント。

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

プライベート エンドポイント接続の接続状態。

provisioningState

string

プライベート エンドポイント接続の状態。

ManagedInstancePrivateEndpointProperty

名前 説明
id

string

プライベート エンドポイントのリソース ID。

ManagedInstancePrivateLinkServiceConnectionStateProperty

名前 説明
actionsRequired

string

プライベート リンク サービスの接続の説明。

description

string

プライベート リンク サービスの接続の説明。

status

string

プライベート リンク サービスの接続状態。

ManagedInstanceProxyOverride

インスタンスへの接続に使用される接続の種類。

説明
Proxy

Proxy

Redirect

転送

Default

デフォルト

ManagedServerCreateMode

データベースの作成モードを指定します。

既定値: 通常のインスタンスの作成。

復元: 特定の時点に一連のバックアップを復元してインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。

説明
Default

デフォルト

PointInTimeRestore

PointInTimeRestore

PricingModel

Managed Instanceの価格モデル。

説明
Regular

レギュラー

Freemium

フリーミアム

PrincipalType

サーバー管理者のプリンシパルの種類。

説明
User

User

Group

グループ

Application

アプリケーション

ProvisioningState

ジョブ実行の ARM プロビジョニング状態。

説明
Created

作成済み

InProgress

進行中

Succeeded

成功しました

Failed

失敗

Canceled

取り消し済み

ResourceIdentity

Azure Active Directory identity configuration for a resource.

名前 説明
principalId

string (uuid)

The Azure Active Directory principal id.

tenantId

string (uuid)

The Azure Active Directory tenant id.

type

IdentityType

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

userAssignedIdentities

<string,  UserIdentity>

使用するユーザー割り当て ID のリソース ID

ServicePrincipal

リソースのマネージド インスタンスのサービス プリンシパル構成。

名前 説明
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

サービス プリンシパルの種類。

説明
None

なし

SystemAssigned

システム割り当て

Sku

ARM リソース SKU。

名前 説明
capacity

integer (int32)

特定の SKU の容量。

family

string

同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。

name

string

SKU の名前 。通常は、文字 + 番号コード (P3 など)。

size

string

特定の SKU のサイズ

tier

string

特定の SKU のレベルまたはエディション (Basic、Premium など)。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。

UserIdentity

Azure Active Directory identity configuration for a resource.

名前 説明
clientId

string (uuid)

The Azure Active Directory client id.

principalId

string (uuid)

The Azure Active Directory principal id.