Software Update Configuration Runs - List

Referencia

Service:: Automation

API Version:: 2023-11-01

Devolver la lista de ejecuciones de configuración de actualizaciones de software

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

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationRuns?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. Regex pattern: `^[-\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	softwareUpdateConfigurationRunListResult	Devuelve la lista de ejecuciones de configuraciones de actualización 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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

List software update configuration machine run with status equal to 'Failed'

List software update configuration machine runs

List software update configuration machine run with status equal to 'Failed'

Sample Request

HTTP

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2023-11-01&$filter=properties/status%20eq%20'Failed'

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/2bd77cfa-2e9c-41b4-a45b-684a77cfeca9",
      "name": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9",
      "properties": {
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Failed",
        "configuredDuration": "PT2H",
        "osType": "Windows",
        "startTime": "2017-10-23T02:30:36.2401233+00:00",
        "endTime": "2017-10-23T02:30:42.8466667+00:00",
        "computerCount": 1,
        "failedCount": 0,
        "tasks": {
          "preTask": {
            "jobId": "be430e9e-2290-462e-8f86-686407c35fab",
            "source": "preRunbook",
            "status": "Completed"
          },
          "postTask": null
        },
        "creationTime": "2017-10-23T02:30:36.2401233+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:31:39.3966667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/5dabff55-9812-4a58-af16-b0cb1d9384e8",
      "name": "5dabff55-9812-4a58-af16-b0cb1d9384e8",
      "properties": {
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Failed",
        "configuredDuration": "PT2H",
        "osType": "Windows",
        "startTime": "2017-10-23T01:33:01.8818952+00:00",
        "endTime": "2017-10-23T01:33:08.1133333+00:00",
        "computerCount": 1,
        "failedCount": 0,
        "tasks": {
          "preTask": {
            "jobId": "be430e9e-2290-462e-8f86-686407c35fab",
            "source": "preRunbook",
            "status": "Completed"
          },
          "postTask": null
        },
        "creationTime": "2017-10-23T01:33:01.8818952+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T01:34:03.94+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/stas-wcus/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

List software update configuration machine runs

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/2bd77cfa-2e9c-41b4-a45b-684a77cfeca9",
      "name": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9",
      "properties": {
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "configuredDuration": "PT2H",
        "osType": "Windows",
        "startTime": "2017-10-23T02:30:36.2401233+00:00",
        "endTime": "2017-10-23T02:30:42.8466667+00:00",
        "computerCount": 1,
        "failedCount": 0,
        "tasks": {
          "preTask": {
            "jobId": "be430e9e-2290-462e-8f86-686407c35fab",
            "source": "preRunbook",
            "status": "Completed"
          },
          "postTask": null
        },
        "creationTime": "2017-10-23T02:30:36.2401233+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:31:39.3966667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/5dabff55-9812-4a58-af16-b0cb1d9384e8",
      "name": "5dabff55-9812-4a58-af16-b0cb1d9384e8",
      "properties": {
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "configuredDuration": "PT2H",
        "osType": "Windows",
        "startTime": "2017-10-23T01:33:01.8818952+00:00",
        "endTime": "2017-10-23T01:33:08.1133333+00:00",
        "computerCount": 1,
        "failedCount": 0,
        "tasks": {
          "preTask": {
            "jobId": "be430e9e-2290-462e-8f86-686407c35fab",
            "source": "preRunbook",
            "status": "Completed"
          },
          "postTask": null
        },
        "creationTime": "2017-10-23T01:33:01.8818952+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T01:34:03.94+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/stas-wcus/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

Definiciones

Nombre	Description
ErrorResponse	Respuesta de error de un error de operación
softwareUpdateConfigurationRun	Configuración de actualización de software Propiedades de ejecución.
softwareUpdateConfigurationRunListResult	resultado de enumerar todas las ejecuciones de configuración de actualizaciones de software
softwareUpdateConfigurationRunTaskProperties	Propiedades de tarea de la configuración de actualización de software.
softwareUpdateConfigurationRunTasks	Modelo de tareas de ejecución de la configuración de actualización 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.

softwareUpdateConfigurationRun

Configuración de actualización de software Propiedades de ejecución.

Nombre	Tipo	Description
id	string	Identificador de recurso de la ejecución de la configuración de actualización de software
name	string	Nombre de la ejecución de la configuración de actualización de software.
properties.computerCount	integer	Número de equipos en la ejecución de la configuración de actualización de software.
properties.configuredDuration	string	Duración configurada para la ejecución de la configuración de actualización 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 de la configuración de actualización de software.
properties.failedCount	integer	Número de equipos con estado de error.
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.startTime	string	Hora de inicio de la ejecución de la configuración de actualización de software.
properties.status	string	Estado de la ejecución de la configuración de actualización de software.
properties.tasks	softwareUpdateConfigurationRunTasks	Tareas de configuración de actualización de software desencadenadas en esta ejecución

softwareUpdateConfigurationRunListResult

resultado de enumerar todas las ejecuciones de configuración de actualizaciones de software

Nombre	Tipo	Description
nextLink	string	vínculo a la página siguiente de resultados.
value	softwareUpdateConfigurationRun[]	objeto externo devuelto al enumerar todas las ejecuciones de configuración de actualización de software

softwareUpdateConfigurationRunTaskProperties

Propiedades de tarea de la configuración de actualización de software.

Nombre	Tipo	Description
jobId	string	Identificador de trabajo de la tarea.
source	string	Nombre del origen de la tarea.
status	string	Estado de la tarea.

softwareUpdateConfigurationRunTasks

Modelo de tareas de ejecución de la configuración de actualización de software.

Nombre	Tipo	Description
postTask	softwareUpdateConfigurationRunTaskProperties	Publicar las propiedades de la tarea.
preTask	softwareUpdateConfigurationRunTaskProperties	Propiedades previas a la tarea.

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

Share via

Software Update Configuration Runs - List

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

azure_auth

Scopes

Ejemplos

List software update configuration machine run with status equal to 'Failed'

Sample Request

Sample Response

List software update configuration machine runs

Sample Request

Sample Response

Definiciones

ErrorResponse

softwareUpdateConfigurationRun

softwareUpdateConfigurationRunListResult

softwareUpdateConfigurationRunTaskProperties

softwareUpdateConfigurationRunTasks

updateConfigurationNavigation

Recursos adicionales