Software Update Configuration Machine Runs - List

Tjänst:

Automation

API-version:

2023-11-01

Returnera lista över programuppdateringskonfigurationsdatorer som körs

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

Med valfria parametrar:

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}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
automationAccountName	path	True	string	Namnet på Automation-kontot.
resourceGroupName	path	True	string	Namnet på en Azure-resursgrupp. Reguljärt uttrycksmönster: ^[-\w\._]+$
subscriptionId	path	True	string	Hämtar autentiseringsuppgifter för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-version.
$filter	query		string	Filtret som ska tillämpas på åtgärden. Du kan använda följande filter: "properties/osType", "properties/status", "properties/startTime" och "properties/softwareUpdateConfiguration/name"
$skip	query		string	antal poster som du hoppar över innan du returnerar resultat
$top	query		string	Maximalt antal poster som returneras i resultatsamlingen

Begärandehuvud

Name	Obligatorisk	Typ	Description
clientRequestId		string	Identifierar den här specifika klientbegäran.

Svar

Name	Typ	Description
200 OK	softwareUpdateConfigurationMachineRunListResult	Returnera en lista över programuppdateringskonfigurationsdatorer som körs.
Other Status Codes	ErrorResponse	Automation-felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
ErrorResponse	Felsvar på ett åtgärdsfel
jobNavigation	Navigeringsegenskaper för programuppdateringskonfigurationsmaskinens körningsjobb.
softwareUpdateConfigurationMachineRun	Datorkörningsmodell för programuppdateringskonfiguration.
softwareUpdateConfigurationMachineRunListResult	resultatet av att lista alla programuppdateringskonfigurationsdatorkörningar
updateConfigurationNavigation	Programuppdateringskonfiguration Kör navigeringsmodell.

ErrorResponse

Felsvar på ett åtgärdsfel

Name	Typ	Description
code	string	Felkod
message	string	Felmeddelande som anger varför åtgärden misslyckades.

jobNavigation

Navigeringsegenskaper för programuppdateringskonfigurationsmaskinens körningsjobb.

Name	Typ	Description
id	string	ID för jobbet som är associerat med programuppdateringskonfigurationskörningen

softwareUpdateConfigurationMachineRun

Datorkörningsmodell för programuppdateringskonfiguration.

Name	Typ	Description
id	string	Resurs-ID för programuppdateringens konfigurationsdator körs
name	string	Namnet på körningen av programuppdateringskonfigurationsdatorn
properties.configuredDuration	string	konfigurerad varaktighet för körningen av programuppdateringskonfigurationen.
properties.correlationId	string	korrelations-ID för programuppdateringens konfigurationsdator som körs
properties.createdBy	string	createdBy-egenskapen, som bara visas i svaret.
properties.creationTime	string	Skapandetid för resursen, som bara visas i svaret.
properties.endTime	string	Sluttiden för programuppdateringens konfigurationsdator körs.
properties.error	ErrorResponse	Information om etableringsfel
properties.job	jobNavigation	Jobb som är associerat med programuppdateringens konfigurationsdator körs
properties.lastModifiedBy	string	lastModifiedBy-egenskapen, som bara visas i svaret.
properties.lastModifiedTime	string	Senaste gången resursen ändrades, vilket bara visas i svaret.
properties.osType	string	Operativsystemets mål för programuppdateringskonfigurationen utlöste den här körningen
properties.softwareUpdateConfiguration	updateConfigurationNavigation	programuppdateringskonfigurationen utlöste den här körningen
properties.sourceComputerId	string	källdator-ID för programuppdateringens konfigurationsdator som körs
properties.startTime	string	Starttiden för körningen av programuppdateringskonfigurationsdatorn.
properties.status	string	Status för körningen av programuppdateringskonfigurationsdatorn.
properties.targetComputer	string	namnet på den uppdaterade datorn
properties.targetComputerType	string	den uppdaterade datorns typ.

softwareUpdateConfigurationMachineRunListResult

resultatet av att lista alla programuppdateringskonfigurationsdatorkörningar

Name	Typ	Description
nextLink	string	länk till nästa sida med resultat.
value	softwareUpdateConfigurationMachineRun[]	yttre objekt som returneras när alla programuppdateringskonfigurationsdatorer körs

updateConfigurationNavigation

Programuppdateringskonfiguration Kör navigeringsmodell.

Name	Typ	Description
name	string	Namnet på programuppdateringskonfigurationen utlöste körningen av programuppdateringskonfigurationen