Dedicated Hosts - Create Or Update
専用ホスト を作成または更新します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
host
|
path | True |
string |
専用ホスト グループの名前。 |
host
|
path | True |
string |
専用ホスト の名前。 |
resource
|
path | True |
string |
リソース グループの名前。 |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。 |
api-version
|
query | True |
string |
クライアント API のバージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
location | True |
string |
リソースの場所 |
sku | True |
ハードウェア生成と VM ファミリ用の専用ホストの SKU。 名前のみを設定する必要があります。 使用可能な値の一覧については、Microsoft.Compute SKU を一覧表示します。 |
|
properties.autoReplaceOnFailure |
boolean |
障害が発生した場合に専用ホストを自動的に置き換えるかどうかを指定します。 この値は、指定されていない場合、既定値は 'true' に設定されます。 |
|
properties.licenseType |
専用ホストにデプロイされた VM に適用されるソフトウェア ライセンスの種類を指定します。 使用可能な値は 、なし、Windows_Server_Hybrid、Windows_Server_Perpetualです。 既定値は None です。 |
||
properties.platformFaultDomain |
integer |
専用ホスト グループ内の専用ホストの障害ドメイン。 |
|
tags |
object |
リソース タグ |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
201 Created |
作成済み |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
Create or update a dedicated host .
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myDedicatedHostGroup/hosts/myDedicatedHost?api-version=2024-03-01
{
"location": "westus",
"tags": {
"department": "HR"
},
"properties": {
"platformFaultDomain": 1
},
"sku": {
"name": "DSv3-Type1"
}
}
Sample Response
{
"name": "myDedicatedHost",
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"tags": {
"department": "HR"
},
"sku": {
"name": "DSv3-Type1"
},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}"
}
}
{
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": false,
"licenseType": "Windows_Server_Hybrid",
"hostId": "{GUID}"
},
"location": "westus",
"tags": {
"department": "HR"
},
"name": "myDedicatedHost",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"sku": {
"name": "DSv3-Type1"
}
}
定義
名前 | 説明 |
---|---|
Api |
API エラー。 |
Api |
API エラーベース。 |
Cloud |
コンピューティング サービスからのエラー応答。 |
Dedicated |
専用ホストに関する情報を指定します。 |
Dedicated |
特定の VM サイズの観点から、専用ホストの未使用容量を表します。 |
Dedicated |
専用ホストの未使用容量。 |
Dedicated |
専用ホストのインスタンス ビュー。 |
Dedicated |
専用ホストにデプロイされた VM に適用されるソフトウェア ライセンスの種類を指定します。 使用可能な値は 、なし、Windows_Server_Hybrid、Windows_Server_Perpetualです。 既定値は None です。 |
Inner |
内部エラーの詳細。 |
Instance |
インスタンス ビューの状態。 |
Sku |
仮想マシン スケール セット SKU について説明します。 注: スケール セットが現在オンになっているハードウェアで新しい VM SKU がサポートされていない場合は、SKU 名を変更する前に、スケール セット内の VM の割り当てを解除する必要があります。 |
Status |
レベル コード。 |
Sub |
ApiError
API エラー。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
details |
Api エラーの詳細 |
|
innererror |
Api の内部エラー |
|
message |
string |
エラー メッセージ。 |
target |
string |
特定のエラーのターゲット。 |
ApiErrorBase
API エラーベース。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
message |
string |
エラー メッセージ。 |
target |
string |
特定のエラーのターゲット。 |
CloudError
コンピューティング サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
API エラー。 |
DedicatedHost
専用ホストに関する情報を指定します。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソース ID |
location |
string |
リソースの場所 |
name |
string |
リソース名 |
properties.autoReplaceOnFailure |
boolean |
障害が発生した場合に専用ホストを自動的に置き換えるかどうかを指定します。 この値は、指定されていない場合、既定値は 'true' に設定されます。 |
properties.hostId |
string |
プラットフォームによって生成され、専用ホストに割り当てられた一意の ID。 ホストの有効期間中は変更されません。 |
properties.instanceView |
専用ホスト インスタンス ビュー。 |
|
properties.licenseType |
専用ホストにデプロイされた VM に適用されるソフトウェア ライセンスの種類を指定します。 使用可能な値は 、なし、Windows_Server_Hybrid、Windows_Server_Perpetualです。 既定値は None です。 |
|
properties.platformFaultDomain |
integer |
専用ホスト グループ内の専用ホストの障害ドメイン。 |
properties.provisioningState |
string |
プロビジョニング状態。これは応答にのみ表示されます。 |
properties.provisioningTime |
string |
ホストが最初にプロビジョニングされた日付。 |
properties.timeCreated |
string |
専用ホスト リソースが作成された時刻を指定します。 最小 api-version: 2021-11-01。 |
properties.virtualMachines |
専用ホスト内のすべての仮想マシンへの参照の一覧。 |
|
sku |
ハードウェア生成と VM ファミリ用の専用ホストの SKU。 名前のみを設定する必要があります。 使用可能な値の一覧については、Microsoft.Compute SKU を一覧表示します。 |
|
tags |
object |
リソース タグ |
type |
string |
リソースの種類 |
DedicatedHostAllocatableVM
特定の VM サイズの観点から、専用ホストの未使用容量を表します。
名前 | 型 | 説明 |
---|---|---|
count |
number |
専用ホストの残りの容量に収めることができる vmSize サイズの VM の最大数。 |
vmSize |
string |
未使用の容量を表す VM サイズ。 |
DedicatedHostAvailableCapacity
専用ホストの未使用容量。
名前 | 型 | 説明 |
---|---|---|
allocatableVMs |
専用ホストへのデプロイが許可されている各 VM サイズの観点から表される専用ホストの未使用容量。 |
DedicatedHostInstanceView
専用ホストのインスタンス ビュー。
名前 | 型 | 説明 |
---|---|---|
assetId |
string |
専用ホストが存在する専用物理マシンの一意の ID を指定します。 |
availableCapacity |
専用ホストの未使用容量。 |
|
statuses |
リソースの状態情報。 |
DedicatedHostLicenseTypes
専用ホストにデプロイされた VM に適用されるソフトウェア ライセンスの種類を指定します。 使用可能な値は 、なし、Windows_Server_Hybrid、Windows_Server_Perpetualです。 既定値は None です。
名前 | 型 | 説明 |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
内部エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
errordetail |
string |
内部エラー メッセージまたは例外ダンプ。 |
exceptiontype |
string |
例外の種類。 |
InstanceViewStatus
インスタンス ビューの状態。
名前 | 型 | 説明 |
---|---|---|
code |
string |
ステータス コード。 |
displayStatus |
string |
状態の短いローカライズ可能なラベル。 |
level |
レベル コード。 |
|
message |
string |
アラートとエラー メッセージを含む詳細なステータス メッセージ。 |
time |
string |
状態の時刻。 |
Sku
仮想マシン スケール セット SKU について説明します。 注: スケール セットが現在オンになっているハードウェアで新しい VM SKU がサポートされていない場合は、SKU 名を変更する前に、スケール セット内の VM の割り当てを解除する必要があります。
名前 | 型 | 説明 |
---|---|---|
capacity |
integer |
スケール セット内の仮想マシンの数を指定します。 |
name |
string |
SKU 名。 |
tier |
string |
スケール セット内の仮想マシンの層を指定します。 |
StatusLevelTypes
レベル コード。
名前 | 型 | 説明 |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソース ID |