Software Update Configuration Machine Runs - List

Usługa:

Automation

Wersja interfejsu API:

2023-11-01

Zwracana lista przebiegów maszyny konfiguracji aktualizacji oprogramowania

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

Z parametrami opcjonalnymi:

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}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
automationAccountName	path	True	string	Nazwa konta usługi Automation.
resourceGroupName	path	True	string	Nazwa grupy zasobów platformy Azure. Wzorzec wyrażenia regularnego: ^[-\w\._]+$
subscriptionId	path	True	string	Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.
$filter	query		string	Filtr, który ma być stosowany do operacji. Można użyć następujących filtrów: "properties/osType", "properties/status", "properties/startTime" i "properties/softwareUpdateConfiguration/name"
$skip	query		string	liczba wpisów pomijanych przed zwróceniem wyników
$top	query		string	Maksymalna liczba wpisów zwróconych w kolekcji wyników

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
clientRequestId		string	Identyfikuje to konkretne żądanie klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	softwareUpdateConfigurationMachineRunListResult	Zwraca listę przebiegów maszyny konfiguracji aktualizacji oprogramowania.
Other Status Codes	ErrorResponse	Odpowiedź na błąd automatyzacji opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
ErrorResponse	Odpowiedź na błąd niepowodzenia operacji
jobNavigation	Właściwości nawigacji po zadaniach uruchamiania maszyny konfiguracji aktualizacji oprogramowania.
softwareUpdateConfigurationMachineRun	Model uruchamiania maszyny konfiguracji aktualizacji oprogramowania.
softwareUpdateConfigurationMachineRunListResult	wynik wyświetlania listy wszystkich przebiegów konfiguracji aktualizacji oprogramowania
updateConfigurationNavigation	Konfiguracja aktualizacji oprogramowania Uruchom model nawigacji.

ErrorResponse

Odpowiedź na błąd niepowodzenia operacji

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

jobNavigation

Właściwości nawigacji po zadaniach uruchamiania maszyny konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
id	string	Identyfikator zadania skojarzonego z uruchomieniem konfiguracji aktualizacji oprogramowania

softwareUpdateConfigurationMachineRun

Model uruchamiania maszyny konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu uruchomienia maszyny konfiguracji aktualizacji oprogramowania
name	string	Nazwa uruchomienia maszyny konfiguracji aktualizacji oprogramowania
properties.configuredDuration	string	skonfigurowany czas trwania uruchomienia konfiguracji aktualizacji oprogramowania.
properties.correlationId	string	identyfikator korelacji uruchomienia maszyny konfiguracji aktualizacji oprogramowania
properties.createdBy	string	createdBy, właściwość , która jest wyświetlana tylko w odpowiedzi.
properties.creationTime	string	Czas utworzenia zasobu, który pojawia się tylko w odpowiedzi.
properties.endTime	string	Godzina zakończenia uruchomienia maszyny konfiguracji aktualizacji oprogramowania.
properties.error	ErrorResponse	Szczegóły błędu aprowizacji
properties.job	jobNavigation	Zadanie skojarzone z uruchomioną maszyną konfiguracji aktualizacji oprogramowania
properties.lastModifiedBy	string	lastModifiedBy, właściwość , która jest wyświetlana tylko w odpowiedzi.
properties.lastModifiedTime	string	Czas ostatniej modyfikacji zasobu, który pojawia się tylko w odpowiedzi.
properties.osType	string	Element docelowy systemu operacyjnego konfiguracji aktualizacji oprogramowania wyzwolił ten przebieg
properties.softwareUpdateConfiguration	updateConfigurationNavigation	konfiguracja aktualizacji oprogramowania wyzwoliła ten przebieg
properties.sourceComputerId	string	identyfikator komputera źródłowego uruchomienia maszyny konfiguracji aktualizacji oprogramowania
properties.startTime	string	Godzina rozpoczęcia uruchomienia maszyny konfiguracji aktualizacji oprogramowania.
properties.status	string	Stan uruchomienia maszyny konfiguracji aktualizacji oprogramowania.
properties.targetComputer	string	nazwa zaktualizowanego komputera
properties.targetComputerType	string	typ zaktualizowanego komputera.

softwareUpdateConfigurationMachineRunListResult

wynik wyświetlania listy wszystkich przebiegów konfiguracji aktualizacji oprogramowania

Nazwa	Typ	Opis
nextLink	string	link do następnej strony wyników.
value	softwareUpdateConfigurationMachineRun[]	obiekt zewnętrzny zwracany podczas wyświetlania listy wszystkich przebiegów konfiguracji aktualizacji oprogramowania

updateConfigurationNavigation

Konfiguracja aktualizacji oprogramowania Uruchom model nawigacji.

Nazwa	Typ	Opis
name	string	Nazwa konfiguracji aktualizacji oprogramowania wyzwoliła uruchomienie konfiguracji aktualizacji oprogramowania