你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Software Update Configuration Machine Runs - Get By Id

服务:

Automation

API 版本:

2023-11-01

获取按 ID 运行的单个软件更新配置计算机。

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

URI 参数

名称	在	必需	类型	说明
automationAccountName	path	True	string	自动化帐户的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Azure 资源组的名称。
softwareUpdateConfigurationMachineRunId	path	True	string (uuid)	软件更新配置计算机的 ID。
subscriptionId	path	True	string	获取唯一标识Microsoft Azure 订阅的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

请求头

名称	必需	类型	说明
clientRequestId		string	标识此特定的客户端请求。

响应

名称	类型	说明
200 OK	softwareUpdateConfigurationMachineRun	单个软件更新配置计算机运行。
Other Status Codes	ErrorResponse	描述作失败原因的自动化错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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"
  }
}

定义

名称	说明
ErrorResponse	作失败的错误响应
jobNavigation	软件更新配置计算机运行作业导航属性。
softwareUpdateConfigurationMachineRun	软件更新配置计算机运行模型。
updateConfigurationNavigation	软件更新配置运行导航模型。

ErrorResponse

Object

作失败的错误响应

名称	类型	说明
code	string	错误代码
message	string	指示作失败的原因的错误消息。

jobNavigation

Object

软件更新配置计算机运行作业导航属性。

名称	类型	说明
id	string	与软件更新配置运行关联的作业的 ID

softwareUpdateConfigurationMachineRun

Object

软件更新配置计算机运行模型。

名称	类型	说明
id	string	软件更新配置计算机运行的资源 ID
name	string	软件更新配置计算机运行的名称
properties.configuredDuration	string	软件更新配置运行的已配置持续时间。
properties.correlationId	string (uuid)	软件更新配置计算机运行的关联 ID
properties.createdBy	string	createdBy 属性，该属性仅在响应中显示。
properties.creationTime	string (date-time)	资源的创建时间，该时间仅在响应中显示。
properties.endTime	string (date-time)	软件更新配置计算机的结束时间。
properties.error	ErrorResponse	预配错误的详细信息
properties.job	jobNavigation	与软件更新配置计算机运行关联的作业
properties.lastModifiedBy	string	lastModifiedBy 属性，仅出现在响应中。
properties.lastModifiedTime	string (date-time)	上次修改资源时，该资源仅在响应中显示。
properties.osType	string	软件更新配置的作系统目标触发了此运行
properties.softwareUpdateConfiguration	updateConfigurationNavigation	软件更新配置触发了此运行
properties.sourceComputerId	string (uuid)	软件更新配置计算机的源计算机 ID 运行
properties.startTime	string (date-time)	软件更新配置计算机的开始时间。
properties.status	string	软件更新配置计算机运行的状态。
properties.targetComputer	string	已更新计算机的名称
properties.targetComputerType	string	更新的计算机的类型。

updateConfigurationNavigation

Object

软件更新配置运行导航模型。

名称	类型	说明
name	string	软件更新配置的名称触发了软件更新配置运行