Partilhar via

Software Update Configuration Machine Runs - List

  • Referência
Serviço:
Automation
Versão da API:
2023-11-01

Lista de devolução de execuções de máquinas de configuração de atualização de software

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

Name Em Necessário Tipo Description
automationAccountName
 path True

string

O nome da conta de automatização.
resourceGroupName
 path True

string

Nome de um grupo de Recursos do Azure.

Padrão Regex: ^[-\w\._]+$
subscriptionId
 path True

string

Obtém credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version
 query True

string

Versão da API do Cliente.
$filter
 query

string

O filtro a aplicar na operação. Pode utilizar os seguintes filtros: "properties/osType", "properties/status", "properties/startTime" e "properties/softwareUpdateConfiguration/name"
$skip
 query

string

número de entradas que ignorar antes de devolver resultados
$top
 query

string

Número máximo de entradas devolvidas na coleção de resultados

Cabeçalho do Pedido

Name Necessário Tipo Description
clientRequestId

string

Identifica este pedido de cliente específico.

Respostas

Name Tipo Description
200 OK

softwareUpdateConfigurationMachineRunListResult

Lista de devolução de execuções de máquinas de configuração de atualização de software.
Other Status Codes

ErrorResponse

Resposta de erro de automatização que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
}

Definições

Name Description
ErrorResponse

Resposta de erro de uma falha de operação
jobNavigation

Propriedades de navegação da tarefa de execução do computador de configuração de atualização de software.
softwareUpdateConfigurationMachineRun

Modelo de execução de máquina de configuração de atualização de software.
softwareUpdateConfigurationMachineRunListResult

resultado da listagem de todas as execuções de máquinas de configuração de atualização de software
updateConfigurationNavigation

Configuração da atualização de software Executar Modelo de navegação.

ErrorResponse

Resposta de erro de uma falha de operação

Name Tipo Description
code

string

Código de erro
message

string

Mensagem de erro a indicar o motivo pela qual a operação falhou.

jobNavigation

Propriedades de navegação da tarefa de execução do computador de configuração de atualização de software.

Name Tipo Description
id

string

ID da tarefa associada à execução da configuração da atualização de software

softwareUpdateConfigurationMachineRun

Modelo de execução de máquina de configuração de atualização de software.

Name Tipo Description
id

string

ID de recurso da execução do computador de configuração de atualização de software
name

string

Nome da execução do computador de configuração de atualização de software
properties.configuredDuration

string

duração configurada para a execução da configuração da atualização de software.
properties.correlationId

string

ID de correlação da execução do computador de configuração de atualização de software
properties.createdBy

string

propriedade createdBy, que só aparece na resposta.
properties.creationTime

string

Tempo de criação do recurso, que só aparece na resposta.
properties.endTime

string

Hora de fim da execução do computador de configuração de atualização de software.
properties.error

ErrorResponse

Detalhes do erro de aprovisionamento
properties.job

jobNavigation

Tarefa associada à execução do computador de configuração de atualização de software
properties.lastModifiedBy

string

propriedade lastModifiedBy, que só aparece na resposta.
properties.lastModifiedTime

string

A última vez que o recurso foi modificado, que só aparece na resposta.
properties.osType

string

Destino do sistema operativo da configuração da atualização de software acionada nesta execução
properties.softwareUpdateConfiguration

updateConfigurationNavigation

configuração de atualização de software acionada esta execução
properties.sourceComputerId

string

ID do computador de origem do computador de configuração de atualização de software executado
properties.startTime

string

Hora de início da execução da máquina de configuração de atualização de software.
properties.status

string

Estado da execução do computador de configuração de atualização de software.
properties.targetComputer

string

nome do computador atualizado
properties.targetComputerType

string

tipo do computador atualizado.

softwareUpdateConfigurationMachineRunListResult

resultado da listagem de todas as execuções de máquinas de configuração de atualização de software

Name Tipo Description
nextLink

string

ligar à página seguinte de resultados.
value

softwareUpdateConfigurationMachineRun[]

objeto externo devolvido ao listar todas as execuções de máquinas de configuração de atualização de software

updateConfigurationNavigation

Configuração da atualização de software Executar Modelo de navegação.

Name Tipo Description
name

string

O nome da configuração da atualização de software acionou a execução da configuração da atualização de software