Software Update Configuration Machine Runs - Get By Id

服務:

Automation

API 版本:

2023-11-01

取得依標識碼執行的單一軟體更新組態計算機。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns/{softwareUpdateConfigurationMachineRunId}?api-version=2023-11-01

URI 參數

名稱	位於	必要	類型	Description
automationAccountName	path	True	string	自動化帳戶的名稱。
resourceGroupName	path	True	string	Azure 資源群組的名稱。 Regex 模式: ^[-\w\._]+$
softwareUpdateConfigurationMachineRunId	path	True	string uuid	軟體更新組態機器執行的標識碼。
subscriptionId	path	True	string	取得用來唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求標頭

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

回應

名稱	類型	Description
200 OK	softwareUpdateConfigurationMachineRun	單一軟體更新設定電腦執行。
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	模擬您的用戶帳戶

範例

Get software update configuration machine run

範例要求

HTTP

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

範例回覆

狀態碼:

200

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

定義

名稱	Description
ErrorResponse	作業失敗的錯誤回應
jobNavigation	軟體更新設定電腦執行作業導覽屬性。
softwareUpdateConfigurationMachineRun	軟體更新設定計算機執行模型。
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	更新的計算機類型。

updateConfigurationNavigation

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

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