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 參數

名稱	位於	必要	類型	Description
automationAccountName	path	True	string	自動化帳戶的名稱。
resourceGroupName	path	True	string	Azure 資源群組的名稱。 Regex 模式: `^[-\w\._]+$`
subscriptionId	path	True	string	取得用來唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶識別碼會構成每個服務呼叫 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	結果集合中傳回的項目數目上限

要求標頭

名稱	必要	類型	Description
clientRequestId		string	識別這個特定的用戶端要求。

回應

名稱	類型	Description
200 OK	softwareUpdateConfigurationMachineRunListResult	傳回軟體更新設定電腦執行的清單。
Other Status Codes	ErrorResponse	描述作業失敗原因的自動化錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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

範例要求

HTTP

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

範例要求

HTTP

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"
}

定義

名稱	Description
ErrorResponse	作業失敗的錯誤回應
jobNavigation	軟體更新設定電腦執行作業導覽屬性。
softwareUpdateConfigurationMachineRun	軟體更新設定計算機執行模型。
softwareUpdateConfigurationMachineRunListResult	列出所有軟體更新組態機器執行的結果
updateConfigurationNavigation	軟體更新組態執行導覽模型。

ErrorResponse

作業失敗的錯誤回應

名稱	類型	Description
code	string	錯誤碼
message	string	錯誤訊息，指出作業失敗的原因。

jobNavigation

軟體更新設定電腦執行作業導覽屬性。

名稱	類型	Description
id	string	與軟體更新組態執行相關聯的作業標識碼

softwareUpdateConfigurationMachineRun

軟體更新設定計算機執行模型。

名稱	類型	Description
id	string	軟體更新組態電腦執行的資源識別碼
name	string	軟體更新組態電腦執行的名稱
properties.configuredDuration	string	已設定軟體更新組態執行的持續時間。
properties.correlationId	string	軟體更新組態機器執行的相互關聯標識碼
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	軟體更新組態電腦執行的來源計算機標識碼
properties.startTime	string	軟體更新組態機器執行的開始時間。
properties.status	string	軟體更新組態電腦執行的狀態。
properties.targetComputer	string	已更新電腦的名稱
properties.targetComputerType	string	更新的計算機類型。

softwareUpdateConfigurationMachineRunListResult

列出所有軟體更新組態機器執行的結果

名稱	類型	Description
nextLink	string	連結至結果的下一頁。
value	softwareUpdateConfigurationMachineRun[]	列出所有軟體更新組態機器執行時傳回的外部物件

updateConfigurationNavigation

軟體更新組態執行導覽模型。

名稱	類型	Description
name	string	觸發軟體更新組態執行的軟體更新組態名稱

共用方式為

Software Update Configuration Machine Runs - List

URI 參數

要求標頭

回應

安全性

azure_auth

範圍

範例

List software update configuration machine runs

範例要求

範例回覆

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

範例要求

範例回覆

定義

ErrorResponse

jobNavigation

softwareUpdateConfigurationMachineRun

softwareUpdateConfigurationMachineRunListResult

updateConfigurationNavigation

其他資源