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

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	自动化帐户的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Azure 资源组的名称。
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 Flow

类型: oauth2
流向: implicit
授权 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

示例请求

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

定义

名称	说明
ErrorResponse	作失败的错误响应
jobNavigation	软件更新配置计算机运行作业导航属性。
softwareUpdateConfigurationMachineRun	软件更新配置计算机运行模型。
softwareUpdateConfigurationMachineRunListResult	列出所有软件更新配置计算机运行的结果
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	更新的计算机的类型。

softwareUpdateConfigurationMachineRunListResult

Object

列出所有软件更新配置计算机运行的结果

名称	类型	说明
nextLink	string	链接到下一页的结果。
value	softwareUpdateConfigurationMachineRun[]	列出所有软件更新配置计算机运行时返回的外部对象

updateConfigurationNavigation

Object

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

名称	类型	说明
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

其他资源