Virtual Machine Scale Sets - Get OS Upgrade History

VM スケール セット インスタンスの OS アップグレードの一覧を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-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 のバージョン。

応答

名前 説明
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

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

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "value": [
    {
      "properties": {
        "runningStatus": {
          "code": "RollingForward",
          "startTime": "2021-11-30T13:05:40.442Z",
          "endTime": "2021-11-30T13:05:40.443Z"
        },
        "progress": {
          "successfulInstanceCount": 6,
          "failedInstanceCount": 25,
          "inProgressInstanceCount": 20,
          "pendingInstanceCount": 27
        },
        "error": {
          "details": [
            {
              "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
              "target": "aaaa",
              "message": "aa"
            }
          ],
          "innererror": {
            "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
          },
          "code": "aaaaaaa",
          "target": "aaaaaaa",
          "message": "aaaaaaaaa"
        },
        "startedBy": "Unknown",
        "targetImageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer",
          "exactVersion": "aaaaaaa",
          "sharedGalleryImageId": "aaaaaa",
          "id": "aaaaaaaaaaaaaaaaaaa"
        },
        "rollbackInfo": {
          "successfullyRolledbackInstanceCount": 12,
          "failedRolledbackInstanceCount": 2,
          "rollbackError": {
            "details": [
              {
                "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
                "target": "aaaa",
                "message": "aa"
              }
            ],
            "innererror": {
              "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
            },
            "code": "aaaaaaa",
            "target": "aaaaaaa",
            "message": "aaaaaaaaa"
          }
        }
      },
      "type": "aaaaaaaaaaaaaaaaaaa",
      "location": "aaaaaaaaaaaaa"
    }
  ],
  "nextLink": "aaaaaaaaa"
}

VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "value": [
    {}
  ]
}

定義

名前 説明
ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

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

ImageReference

使用するイメージに関する情報を指定します。 プラットフォーム イメージ、マーケットプレース イメージ、または仮想マシン イメージに関する情報を指定できます。 この要素は、プラットフォーム イメージ、マーケットプレース イメージ、または仮想マシン イメージを使用する場合に必要ですが、他の作成操作では使用されません。 注: イメージ参照パブリッシャーとオファーは、スケール セットを作成する場合にのみ設定できます。

InnerError

内部エラーの詳細。

RollbackStatusInfo

OS アップグレード操作後に失敗した VM インスタンスのロールバックに関する情報。

RollingUpgradeProgressInfo

各アップグレード状態の仮想マシン インスタンスの数に関する情報。

UpgradeOperationHistoricalStatusInfo

仮想マシン スケール セット OS アップグレード履歴操作応答。

UpgradeOperationHistoricalStatusInfoProperties

仮想マシン スケール セットでの各 OS アップグレードについて説明します。

UpgradeOperationHistoryStatus

アップグレード全体の現在の実行状態に関する情報。

UpgradeOperationInvoker

アップグレード操作の呼び出し側

UpgradeState

アップグレードの現在の状態を示すコード。

VirtualMachineScaleSetListOSUpgradeHistory

仮想マシン スケール セット OS のアップグレード履歴操作応答の一覧。

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 エラー。

ImageReference

使用するイメージに関する情報を指定します。 プラットフォーム イメージ、マーケットプレース イメージ、または仮想マシン イメージに関する情報を指定できます。 この要素は、プラットフォーム イメージ、マーケットプレース イメージ、または仮想マシン イメージを使用する場合に必要ですが、他の作成操作では使用されません。 注: イメージ参照パブリッシャーとオファーは、スケール セットを作成する場合にのみ設定できます。

名前 説明
communityGalleryImageId

string

VM デプロイのコミュニティ ギャラリー イメージの一意の ID を指定しました。 これは、コミュニティ ギャラリー イメージの GET 呼び出しからフェッチできます。

exactVersion

string

仮想マシンの作成に使用されるプラットフォーム イメージまたはマーケットプレース イメージのバージョンを 10 進数で指定します。 この読み取り専用フィールドは、'version' フィールドで指定された値が 'latest' の場合にのみ、'version' と異なります。

id

string

リソース ID

offer

string

仮想マシンの作成に使用するプラットフォーム イメージまたはマーケットプレース イメージのオファーを指定します。

publisher

string

イメージの発行元。

sharedGalleryImageId

string

VM デプロイの共有ギャラリー イメージの一意の ID を指定しました。 これは、共有ギャラリー イメージの GET 呼び出しからフェッチできます。

sku

string

イメージ SKU。

version

string

仮想マシンの作成に使用するプラットフォーム イメージまたはマーケットプレース イメージのバージョンを指定します。 使用できる形式は Major.Minor.Build または 'latest' です。 メジャー、マイナー、ビルドは 10 進数です。 デプロイ時に使用可能な最新バージョンのイメージを使用するには、'latest' を指定します。 'latest' を使用している場合でも、新しいバージョンが使用可能になった場合でも、デプロイ後に VM イメージは自動的に更新されません。 ギャラリー イメージのデプロイにはフィールド 'version' を使用しないでください。ギャラリー イメージでは常に 'id' フィールドを使用し、ギャラリー イメージの '最新' バージョンを使用するには、バージョン入力なしで '/subscriptions/{subscriptionId}/resourceGroupName}/providers/Microsoft.Compute/galleryName}/images/{imageName}' を 'id' フィールドに設定してください。

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

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

exceptiontype

string

例外の種類。

RollbackStatusInfo

OS アップグレード操作後に失敗した VM インスタンスのロールバックに関する情報。

名前 説明
failedRolledbackInstanceCount

integer

ロールバックに失敗したインスタンスの数。

rollbackError

ApiError

OS ロールバックに失敗した場合のエラーの詳細。

successfullyRolledbackInstanceCount

integer

正常にロールバックされたインスタンスの数。

RollingUpgradeProgressInfo

各アップグレード状態の仮想マシン インスタンスの数に関する情報。

名前 説明
failedInstanceCount

integer

正常にアップグレードできなかったインスタンスの数。

inProgressInstanceCount

integer

現在アップグレード中のインスタンスの数。

pendingInstanceCount

integer

まだアップグレードを開始していないインスタンスの数。

successfulInstanceCount

integer

正常にアップグレードされたインスタンスの数。

UpgradeOperationHistoricalStatusInfo

仮想マシン スケール セット OS アップグレード履歴操作応答。

名前 説明
location

string

リソースの場所

properties

UpgradeOperationHistoricalStatusInfoProperties

アップグレード操作のプロパティに関する情報。

type

string

リソースの種類

UpgradeOperationHistoricalStatusInfoProperties

仮想マシン スケール セットでの各 OS アップグレードについて説明します。

名前 説明
error

ApiError

このアップグレードのエラーの詳細 (存在する場合)。

progress

RollingUpgradeProgressInfo

各状態の VM の数。

rollbackInfo

RollbackStatusInfo

実行された場合の OS ロールバックに関する情報

runningStatus

UpgradeOperationHistoryStatus

アップグレード操作の全体的な状態に関する情報。

startedBy

UpgradeOperationInvoker

アップグレード操作の呼び出し側

targetImageReference

ImageReference

画像リファレンスの詳細

UpgradeOperationHistoryStatus

アップグレード全体の現在の実行状態に関する情報。

名前 説明
code

UpgradeState

アップグレードの現在の状態を示すコード。

endTime

string

アップグレードの終了時刻。

startTime

string

アップグレードの開始時刻。

UpgradeOperationInvoker

アップグレード操作の呼び出し側

名前 説明
Platform

string

Unknown

string

User

string

UpgradeState

アップグレードの現在の状態を示すコード。

名前 説明
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

仮想マシン スケール セット OS のアップグレード履歴操作応答の一覧。

名前 説明
nextLink

string

OS アップグレード履歴の次のページをフェッチする URI。 ListNext() を呼び出して、アップグレードの履歴の次のページをフェッチします。

value

UpgradeOperationHistoricalStatusInfo[]

仮想マシン スケール セットで実行された OS アップグレードの一覧。