Software Update Configuration Machine Runs - List

  • リファレンス
サービス:
Automation
API バージョン:
2023-11-01

ソフトウェア更新プログラム構成マシンの実行の一覧を返す

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01
省略可能なパラメーターを含む: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01&$filter={$filter}&$skip={$skip}&$top={$top}

URI パラメーター

名前 / 必須 型 説明
automationAccountName
 path True

string

Automation アカウントの名前。
resourceGroupName
 path True

string

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

正規表現パターン: ^[-\w\._]+$
subscriptionId
 path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報を取得します。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。
api-version
 query True

string

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

string

操作に適用するフィルター。 次のフィルターを使用できます: 'properties/osType'、'properties/status'、'properties/startTime'、および 'properties/softwareUpdateConfiguration/name'
$skip
 query

string

結果を返す前にスキップしたエントリの数
$top
 query

string

結果コレクションに返されるエントリの最大数

要求ヘッダー

名前 必須 型 説明
clientRequestId

string

この特定のクライアント要求を識別します。

応答

名前 型 説明
200 OK

softwareUpdateConfigurationMachineRunListResult

ソフトウェア更新プログラム構成マシンの実行の一覧を返します。
Other Status Codes

ErrorResponse

操作が失敗した理由を説明するオートメーション エラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

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

例

List software update configuration machine runs
List software update configuration machine runs for a specific software update configuration run

List software update configuration machine runs

要求のサンプル

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01

応答のサンプル

状態コード:
200 
{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7788f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7789f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

List software update configuration machine runs for a specific software update configuration run

要求のサンプル

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01&$filter=$filter=properties/correlationId%20eq%200b943e57-44d3-4f05-898c-6e92aa617e59

応答のサンプル

状態コード:
200 
{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7788f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7789f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

定義

名前 説明
ErrorResponse

操作エラーのエラー応答
jobNavigation

ソフトウェア更新プログラム構成マシンの実行ジョブ ナビゲーション プロパティ。
softwareUpdateConfigurationMachineRun

ソフトウェア更新プログラム構成マシンの実行モデル。
softwareUpdateConfigurationMachineRunListResult

すべてのソフトウェア更新プログラム構成マシンの実行を一覧表示した結果
updateConfigurationNavigation

ソフトウェア更新プログラムの構成ナビゲーション モデルの実行。

ErrorResponse

操作エラーのエラー応答

名前 型 説明
code

string

エラー コード
message

string

操作が失敗した理由を示すエラー メッセージ。

jobNavigation

ソフトウェア更新プログラム構成マシンの実行ジョブ ナビゲーション プロパティ。

名前 型 説明
id

string

ソフトウェア更新構成の実行に関連付けられているジョブの ID

softwareUpdateConfigurationMachineRun

ソフトウェア更新プログラム構成マシンの実行モデル。

名前 型 説明
id

string

ソフトウェア更新構成マシンの実行のリソース ID
name

string

ソフトウェア更新プログラム構成マシンの実行の名前
properties.configuredDuration

string

ソフトウェア更新プログラムの構成の実行に対して構成された期間。
properties.correlationId

string

ソフトウェア更新構成マシンの実行の関連付け ID
properties.createdBy

string

createdBy プロパティ。応答にのみ表示されます。
properties.creationTime

string

応答にのみ表示されるリソースの作成時間。
properties.endTime

string

ソフトウェア更新プログラム構成マシンの実行の終了時刻。
properties.error

ErrorResponse

プロビジョニング エラーの詳細
properties.job

jobNavigation

ソフトウェア更新構成マシンの実行に関連付けられているジョブ
properties.lastModifiedBy

string

lastModifiedBy プロパティ。応答にのみ表示されます。
properties.lastModifiedTime

string

前回リソースが変更されました。これは応答にのみ表示されます。
properties.osType

string

この実行をトリガーしたソフトウェア更新プログラム構成のオペレーティング システム ターゲット
properties.softwareUpdateConfiguration

updateConfigurationNavigation

この実行をトリガーしたソフトウェア更新プログラムの構成
properties.sourceComputerId

string

ソフトウェア更新構成マシンの実行のソース コンピューター ID
properties.startTime

string

ソフトウェア更新プログラム構成マシンの実行の開始時刻。
properties.status

string

ソフトウェア更新プログラム構成マシンの実行の状態。
properties.targetComputer

string

更新されたコンピューターの名前
properties.targetComputerType

string

更新されたコンピューターの種類。

softwareUpdateConfigurationMachineRunListResult

すべてのソフトウェア更新プログラム構成マシンの実行を一覧表示した結果

名前 型 説明
nextLink

string

結果の次のページへのリンク。
value

softwareUpdateConfigurationMachineRun[]

すべてのソフトウェア更新プログラム構成マシンの実行を一覧表示するときに返される外部オブジェクト

updateConfigurationNavigation

ソフトウェア更新プログラムの構成ナビゲーション モデルの実行。

名前 型 説明
name

string

ソフトウェア更新プログラム構成の実行をトリガーしたソフトウェア更新構成の名前