Compartilhar via

Software Update Configuration Machine Runs - List

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

Lista de retorno das execuções do computador 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 de URI

Nome Em Obrigatório Tipo Description
automationAccountName
 path True

string

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

string

Nome de um grupo de recursos do Azure.

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

string

Obtém as credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura 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 ser aplicado na operação. Você pode usar os seguintes filtros: 'properties/osType', 'properties/status', 'properties/startTime' e 'properties/softwareUpdateConfiguration/name'
$skip
 query

string

número de entradas que você ignora antes de retornar os resultados
$top
 query

string

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

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
clientRequestId

string

Identifica essa solicitação de cliente específica.

Respostas

Nome Tipo Description
200 OK

softwareUpdateConfigurationMachineRunListResult

Retorna a lista de execuções do computador de configuração de atualização de software.
Other Status Codes

ErrorResponse

Resposta de erro de automação que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

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

Solicitação de exemplo

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 de exemplo

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

Solicitação de exemplo

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 de exemplo

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

Nome Description
ErrorResponse

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

O computador de configuração de atualização de software executa propriedades de navegação de trabalho.
softwareUpdateConfigurationMachineRun

Modelo de execução do computador de configuração de atualização de software.
softwareUpdateConfigurationMachineRunListResult

resultado da listagem de todas as execuções do computador de configuração de atualização de software
updateConfigurationNavigation

Configuração de atualização de software Modelo de navegação de execução.

ErrorResponse

Resposta de erro de uma falha de operação

Nome Tipo Description
code

string

Código do erro
message

string

Mensagem de erro indicando por que a operação falhou.

jobNavigation

O computador de configuração de atualização de software executa propriedades de navegação de trabalho.

Nome Tipo Description
id

string

ID do trabalho associado à execução da configuração de atualização de software

softwareUpdateConfigurationMachineRun

Modelo de execução do computador de configuração de atualização de software.

Nome Tipo Description
id

string

ID do 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 de 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 aparece apenas na resposta.
properties.creationTime

string

Hora de criação do recurso, que aparece apenas na resposta.
properties.endTime

string

Hora de término da execução do computador de configuração de atualização de software.
properties.error

ErrorResponse

Detalhes do erro de provisionamento
properties.job

jobNavigation

Trabalho associado à execução do computador de configuração de atualização de software
properties.lastModifiedBy

string

Propriedade lastModifiedBy, que aparece apenas na resposta.
properties.lastModifiedTime

string

Última vez em que o recurso foi modificado, que aparece apenas na resposta.
properties.osType

string

O destino do sistema operacional da configuração de atualização de software disparou essa execução
properties.softwareUpdateConfiguration

updateConfigurationNavigation

configuração de atualização de software disparada nesta execução
properties.sourceComputerId

string

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

string

Hora de início da execução do computador de configuração de atualização de software.
properties.status

string

Status 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 do computador de configuração de atualização de software

Nome Tipo Description
nextLink

string

link para a próxima página de resultados.
value

softwareUpdateConfigurationMachineRun[]

objeto externo retornado ao listar todas as execuções do computador de configuração de atualização de software

updateConfigurationNavigation

Configuração de atualização de software Modelo de navegação de execução.

Nome Tipo Description
name

string

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