Compartir a través de

Software Update Configuration Machine Runs - List

  • Referencia
Servicio:
Automation
Versión de la API:
2023-11-01

Devolver la lista de ejecuciones de la máquina de configuración de actualizaciones de software

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01
Con parámetros opcionales: 
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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
automationAccountName
 path True

string

Nombre de la cuenta de Automation.
resourceGroupName
 path True

string

Nombre de un grupo de recursos de Azure.

Patrón de Regex: ^[-\w\._]+$
subscriptionId
 path True

string

Obtiene las credenciales de suscripción que identifican a la suscripción de Microsoft Azure de forma única. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version
 query True

string

Versión de api de cliente.
$filter
 query

string

Filtro que se va a aplicar en la operación. Puede usar los siguientes filtros: "properties/osType", "properties/status", "properties/startTime" y "properties/softwareUpdateConfiguration/name".
$skip
 query

string

número de entradas que se omiten antes de devolver los resultados
$top
 query

string

Número máximo de entradas devueltas en la colección de resultados

Encabezado de la solicitud

Nombre Requerido Tipo Description
clientRequestId

string

Identifica esta solicitud de cliente específica.

Respuestas

Nombre Tipo Description
200 OK

softwareUpdateConfigurationMachineRunListResult

Devuelve la lista de ejecuciones de la máquina de configuración de actualizaciones de software.
Other Status Codes

ErrorResponse

Respuesta de error de Automatización que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

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

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
ErrorResponse

Respuesta de error de un error de operación
jobNavigation

La máquina de configuración de actualizaciones de software ejecuta las propiedades de navegación del trabajo.
softwareUpdateConfigurationMachineRun

Modelo de ejecución de la máquina de configuración de actualizaciones de software.
softwareUpdateConfigurationMachineRunListResult

resultado de enumerar todas las ejecuciones de la máquina de configuración de actualizaciones de software
updateConfigurationNavigation

Configuración de actualización de software Ejecutar modelo de navegación.

ErrorResponse

Respuesta de error de un error de operación

Nombre Tipo Description
code

string

Código de error
message

string

Mensaje de error que indica por qué se produjo un error en la operación.

jobNavigation

La máquina de configuración de actualizaciones de software ejecuta las propiedades de navegación del trabajo.

Nombre Tipo Description
id

string

Identificador del trabajo asociado a la ejecución de la configuración de actualización de software

softwareUpdateConfigurationMachineRun

Modelo de ejecución de la máquina de configuración de actualizaciones de software.

Nombre Tipo Description
id

string

Identificador de recurso de la ejecución de la máquina de configuración de actualizaciones de software
name

string

Nombre de la ejecución de la máquina de configuración de actualizaciones de software
properties.configuredDuration

string

duración configurada para la ejecución de la configuración de actualización de software.
properties.correlationId

string

id. de correlación de la ejecución de la máquina de configuración de actualizaciones de software
properties.createdBy

string

propiedad createdBy, que solo aparece en la respuesta.
properties.creationTime

string

Hora de creación del recurso, que solo aparece en la respuesta.
properties.endTime

string

Hora de finalización de la ejecución del equipo de configuración de actualización de software.
properties.error

ErrorResponse

Detalles del error de aprovisionamiento
properties.job

jobNavigation

Trabajo asociado a la ejecución del equipo de configuración de actualizaciones de software
properties.lastModifiedBy

string

Propiedad lastModifiedBy, que solo aparece en la respuesta.
properties.lastModifiedTime

string

Última vez que se modificó el recurso, que solo aparece en la respuesta.
properties.osType

string

El destino del sistema operativo de la configuración de actualización de software desencadenó esta ejecución
properties.softwareUpdateConfiguration

updateConfigurationNavigation

configuración de actualización de software desencadenada esta ejecución
properties.sourceComputerId

string

id. de equipo de origen de la ejecución de la máquina de configuración de actualizaciones de software
properties.startTime

string

Hora de inicio de la ejecución del equipo de configuración de actualización de software.
properties.status

string

Estado de la ejecución de la máquina de configuración de actualizaciones de software.
properties.targetComputer

string

nombre del equipo actualizado
properties.targetComputerType

string

tipo del equipo actualizado.

softwareUpdateConfigurationMachineRunListResult

resultado de enumerar todas las ejecuciones de la máquina de configuración de actualizaciones de software

Nombre Tipo Description
nextLink

string

vínculo a la página siguiente de resultados.
value

softwareUpdateConfigurationMachineRun[]

objeto externo devuelto al enumerar todas las ejecuciones de la máquina de configuración de actualizaciones de software

updateConfigurationNavigation

Configuración de actualización de software Ejecutar modelo de navegación.

Nombre Tipo Description
name

string

Nombre de la configuración de actualización de software desencadenada la ejecución de la configuración de actualización de software