Software Update Configuration Machine Runs - List

Référence

Service:: Automation

Version d'API:: 2023-11-01

Liste de retour des exécutions de l’ordinateur de configuration des mises à jour logicielles

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

Avec des paramètres facultatifs:

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
automationAccountName	path	True	string	Nom du compte Automation.
resourceGroupName	path	True	string	Nom d’un groupe de ressources Azure. Modèle d’expression régulière: `^[-\w\._]+$`
subscriptionId	path	True	string	Obtient les informations d'identification d'abonnement qui identifient l'abonnement Microsoft Azure de manière unique. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.
api-version	query	True	string	Version de l’API cliente.
$filter	query		string	Filtre à appliquer à l’opération. Vous pouvez utiliser les filtres suivants : « properties/osType », « properties/status », « properties/startTime » et « properties/softwareUpdateConfiguration/name »
$skip	query		string	nombre d’entrées que vous ignorez avant de retourner les résultats
$top	query		string	Nombre maximal d’entrées retournées dans la collection de résultats

En-tête de la demande

Nom	Obligatoire	Type	Description
clientRequestId		string	Identifie cette demande cliente spécifique.

Réponses

Nom	Type	Description
200 OK	softwareUpdateConfigurationMachineRunListResult	Retour de la liste des exécutions de l’ordinateur de configuration des mises à jour logicielles.
Other Status Codes	ErrorResponse	Réponse d’erreur Automation décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
ErrorResponse	Réponse d’erreur d’un échec d’opération
jobNavigation	Propriétés de navigation des travaux d’exécution de la machine de mise à jour logicielle.
softwareUpdateConfigurationMachineRun	Modèle d’exécution de machine de configuration de mise à jour logicielle.
softwareUpdateConfigurationMachineRunListResult	résultat de la liste de toutes les exécutions de la machine de configuration des mises à jour logicielles
updateConfigurationNavigation	Configuration des mises à jour logicielles Modèle d’exécution de navigation.

ErrorResponse

Réponse d’erreur d’un échec d’opération

Nom	Type	Description
code	string	Code d'erreur
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.

jobNavigation

Propriétés de navigation des travaux d’exécution de la machine de mise à jour logicielle.

Nom	Type	Description
id	string	ID du travail associé à l’exécution de la configuration des mises à jour logicielles

softwareUpdateConfigurationMachineRun

Modèle d’exécution de machine de configuration de mise à jour logicielle.

Nom	Type	Description
id	string	ID de ressource de l’exécution de la machine de configuration des mises à jour logicielles
name	string	Nom de l’exécution de l’ordinateur de configuration des mises à jour logicielles
properties.configuredDuration	string	durée configurée pour l’exécution de la configuration des mises à jour logicielles.
properties.correlationId	string	ID de corrélation de l’exécution de l’ordinateur de configuration des mises à jour logicielles
properties.createdBy	string	propriété createdBy, qui apparaît uniquement dans la réponse.
properties.creationTime	string	Heure de création de la ressource, qui apparaît uniquement dans la réponse.
properties.endTime	string	Heure de fin de l’exécution de l’ordinateur de configuration des mises à jour logicielles.
properties.error	ErrorResponse	Détails de l’erreur d’approvisionnement
properties.job	jobNavigation	Travail associé à l’exécution de l’ordinateur de configuration des mises à jour logicielles
properties.lastModifiedBy	string	propriété lastModifiedBy, qui apparaît uniquement dans la réponse.
properties.lastModifiedTime	string	Dernière modification de la ressource, qui apparaît uniquement dans la réponse.
properties.osType	string	La cible du système d’exploitation de la configuration des mises à jour logicielles a déclenché cette exécution
properties.softwareUpdateConfiguration	updateConfigurationNavigation	La configuration des mises à jour logicielles a déclenché cette exécution
properties.sourceComputerId	string	ID d’ordinateur source de l’exécution de l’ordinateur de configuration des mises à jour logicielles
properties.startTime	string	Heure de début de l’exécution de l’ordinateur de configuration des mises à jour logicielles.
properties.status	string	État de l’exécution de l’ordinateur de configuration des mises à jour logicielles.
properties.targetComputer	string	nom de l’ordinateur mis à jour
properties.targetComputerType	string	type de l’ordinateur mis à jour.

softwareUpdateConfigurationMachineRunListResult

résultat de la liste de toutes les exécutions de la machine de configuration des mises à jour logicielles

Nom	Type	Description
nextLink	string	lien vers la page suivante des résultats.
value	softwareUpdateConfigurationMachineRun[]	objet externe retourné lors de la liste de toutes les exécutions de l’ordinateur de configuration des mises à jour logicielles

updateConfigurationNavigation

Configuration des mises à jour logicielles Modèle d’exécution de navigation.

Nom	Type	Description
name	string	Le nom de la configuration de mise à jour logicielle a déclenché l’exécution de la configuration des mises à jour logicielles

Partager via

Software Update Configuration Machine Runs - List

Paramètres URI

En-tête de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

List software update configuration machine runs

Exemple de requête

Exemple de réponse

List software update configuration machine runs for a specific software update configuration run

Exemple de requête

Exemple de réponse

Définitions

ErrorResponse

jobNavigation

softwareUpdateConfigurationMachineRun

softwareUpdateConfigurationMachineRunListResult

updateConfigurationNavigation

Ressources supplémentaires