次の方法で共有


Virtual Machine Scale Sets - Power Off

VM スケール セット内の 1 つ以上の仮想マシンの電源をオフ (停止) します。 リソースは引き続きアタッチされており、リソースに対して課金されることに注意してください。 代わりに、割り当て解除を使用してリソースを解放し、課金を回避します。 さらに、この操作は、割り当てが解除されているか、既に割り当てが解除されている VM スケール セット内の仮想マシンでは許可されません。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/poweroff?api-version=2024-07-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/poweroff?skipShutdown={skipShutdown}&api-version=2024-07-01

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

vmScaleSetName
path True

string

VM スケール セットの名前。

api-version
query True

string

クライアント API のバージョン。

skipShutdown
query

boolean

非グレースフル VM シャットダウンを要求するパラメーター。 このフラグの True 値は非グレースフル シャットダウンを示し、false はそれ以外の場合を示します。 指定されていない場合、このフラグの既定値は false です

要求本文

名前 説明
instanceIds

string[]

仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。

応答

名前 説明
200 OK

わかりました

202 Accepted

受け入れ られる

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

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

VirtualMachineScaleSet_PowerOff_MaximumSet_Gen
VirtualMachineScaleSet_PowerOff_MinimumSet_Gen

VirtualMachineScaleSet_PowerOff_MaximumSet_Gen

要求のサンプル

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaa/poweroff?skipShutdown=True&api-version=2024-07-01

{
  "instanceIds": [
    "aaaaaaaaaaaaaaaaa"
  ]
}

応答のサンプル

location: https://foo.com/operationstatus

VirtualMachineScaleSet_PowerOff_MinimumSet_Gen

要求のサンプル

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/a/poweroff?api-version=2024-07-01

応答のサンプル

location: https://foo.com/operationstatus

定義

名前 説明
ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

コンピューティング サービスからのエラー応答。

InnerError

内部エラーの詳細。

VirtualMachineScaleSetVMInstanceIDs

VM スケール セットの仮想マシン インスタンス ID の一覧を指定します。

ApiError

API エラー。

名前 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

名前 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

CloudError

コンピューティング サービスからのエラー応答。

名前 説明
error

ApiError

API エラー。

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。

VirtualMachineScaleSetVMInstanceIDs

VM スケール セットの仮想マシン インスタンス ID の一覧を指定します。

名前 説明
instanceIds

string[]

仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。