Virtual Machine Run Commands - List By Virtual Machine
Opération permettant d’obtenir toutes les commandes d’exécution d’une machine virtuelle.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommands?api-version=2024-07-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommands?$expand={$expand}&api-version=2024-07-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources. |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service. |
vm
|
path | True |
string |
Nom de la machine virtuelle contenant la commande d’exécution. |
api-version
|
query | True |
string |
Version de l’API cliente. |
$expand
|
query |
string |
Expression de développement à appliquer à l’opération. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
D’ACCORD Media Types: "application/json", "text/json" |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. Media Types: "application/json", "text/json" |
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 run commands in a Virtual Machine.
Exemple de requête
Exemple de réponse
{
"value": [
{
"name": "myRunCommand",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/runCommands/myRunCommand",
"type": "Microsoft.Compute/virtualMachines/runCommands",
"location": "westus",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"source": {
"script": "Write-Host Hello World!"
},
"parameters": [
{
"name": "param1",
"value": "value1"
},
{
"name": "param2",
"value": "value2"
}
],
"asyncExecution": false,
"treatFailureAsDeploymentFailure": false,
"runAsUser": "user1",
"timeoutInSeconds": 0,
"provisioningState": "Succeeded",
"outputBlobUri": "https://mystorageaccount.blob.core.windows.net/myscriptoutputcontainer/MyScriptoutput.txt",
"errorBlobUri": "https://mystorageaccount.blob.core.windows.net/mycontainer/MyScriptError.txt"
}
}
]
}
Définitions
Nom | Description |
---|---|
Api |
Erreur d’API. |
Api |
Base d’erreurs d’API. |
Cloud |
Réponse d’erreur du service de calcul. |
Execution |
État de l’exécution du script. |
Inner |
Détails de l’erreur interne. |
Instance |
État de l’affichage de l’instance. |
Run |
Décrit les propriétés d’un paramètre de commande d’exécution. |
Run |
Contient clientId ou objectId (utilisez un seul, et non les deux) d’une identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage utilisé dans La commande d’exécution. Utilisez un objet RunCommandManagedIdentity vide en cas d’identité affectée par le système. Vérifiez que l’objet blob de stockage Azure existe en cas de scriptUri et que l’identité managée a été accordée au conteneur de l’objet blob avec l’attribution de rôle « Lecteur de données blob de stockage » avec l’objet blob scriptUri et « Contributeur aux données blob de stockage » pour les objets blob Append (outputBlobUri, errorBlobUri). En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande Exécuter, reportez-vous https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged. |
Status |
Code de niveau. |
Virtual |
Décrit une commande d’exécution de machine virtuelle. |
Virtual |
Vue d’instance d’une commande d’exécution de machine virtuelle. |
Virtual |
Décrit les sources de script pour la commande d’exécution. Utilisez un seul script, scriptUri, commandId. |
Virtual |
Réponse de l’opération d’exécution de liste |
ApiError
Erreur d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur api |
|
innererror |
Erreur interne de l’API |
|
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
ApiErrorBase
Base d’erreurs d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
CloudError
Réponse d’erreur du service de calcul.
Nom | Type | Description |
---|---|---|
error |
Erreur d’API. |
ExecutionState
État de l’exécution du script.
Nom | Type | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
Pending |
string |
|
Running |
string |
|
Succeeded |
string |
|
TimedOut |
string |
|
Unknown |
string |
InnerError
Détails de l’erreur interne.
Nom | Type | Description |
---|---|---|
errordetail |
string |
Message d’erreur interne ou vidage d’exception. |
exceptiontype |
string |
Type d’exception. |
InstanceViewStatus
État de l’affichage de l’instance.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’état. |
displayStatus |
string |
Étiquette localisable courte pour l’état. |
level |
Code de niveau. |
|
message |
string |
Message d’état détaillé, y compris pour les alertes et les messages d’erreur. |
time |
string |
Heure de l’état. |
RunCommandInputParameter
Décrit les propriétés d’un paramètre de commande d’exécution.
Nom | Type | Description |
---|---|---|
name |
string |
Nom du paramètre de commande d’exécution. |
value |
string |
Valeur du paramètre de commande d’exécution. |
RunCommandManagedIdentity
Contient clientId ou objectId (utilisez un seul, et non les deux) d’une identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage utilisé dans La commande d’exécution. Utilisez un objet RunCommandManagedIdentity vide en cas d’identité affectée par le système. Vérifiez que l’objet blob de stockage Azure existe en cas de scriptUri et que l’identité managée a été accordée au conteneur de l’objet blob avec l’attribution de rôle « Lecteur de données blob de stockage » avec l’objet blob scriptUri et « Contributeur aux données blob de stockage » pour les objets blob Append (outputBlobUri, errorBlobUri). En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande Exécuter, reportez-vous https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged.
Nom | Type | Description |
---|---|---|
clientId |
string |
ID client (valeur GUID) de l’identité managée affectée par l’utilisateur. ObjectId ne doit pas être utilisé si cela est fourni. |
objectId |
string |
ID d’objet (valeur GUID) de l’identité managée affectée par l’utilisateur. ClientId ne doit pas être utilisé si cela est fourni. |
StatusLevelTypes
Code de niveau.
Nom | Type | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
VirtualMachineRunCommand
Décrit une commande d’exécution de machine virtuelle.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
id |
string |
ID de ressource |
|
location |
string |
Emplacement des ressources |
|
name |
string |
Nom de la ressource |
|
properties.asyncExecution |
boolean |
False |
Optionnel. Si la valeur est true, l’approvisionnement se termine dès que le script démarre et n’attend pas que le script se termine. |
properties.errorBlobManagedIdentity |
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage errorBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et exécuter la commande, consultez https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged |
||
properties.errorBlobUri |
string |
Spécifie l’objet blob de stockage Azure dans lequel le flux d’erreurs de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre errorBlobManagedIdentity. |
|
properties.instanceView |
La machine virtuelle exécute la vue d’instance de commande. |
||
properties.outputBlobManagedIdentity |
Identité managée affectée par l’utilisateur qui a accès à l’objet blob de stockage outputBlobUri. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’identité managée a reçu l’accès au conteneur de l’objet blob avec l’attribution de rôle « Contributeur aux données blob de stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et exécuter la commande, consultez https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged |
||
properties.outputBlobUri |
string |
Spécifie l’objet blob de stockage Azure dans lequel le flux de sortie de script sera chargé. Utilisez un URI SAP avec lecture, ajout, création, accès en écriture OU utiliser l’identité managée pour fournir à la machine virtuelle l’accès à l’objet blob. Reportez-vous au paramètre outputBlobManagedIdentity. |
|
properties.parameters |
Paramètres utilisés par le script. |
||
properties.protectedParameters |
Paramètres utilisés par le script. |
||
properties.provisioningState |
string |
État d’approvisionnement, qui apparaît uniquement dans la réponse. Si treatFailureAsDeploymentFailure défini sur true, toute défaillance dans le script échoue le déploiement et ProvisioningState est marqué comme ayant échoué. Si treatFailureAsDeploymentFailure défini sur false, ProvisioningState indique uniquement si la commande d’exécution a été exécutée ou non par la plateforme d’extensions, elle n’indique pas si le script a échoué en cas d’échec de script. Consultez la vue d’instance de la commande d’exécution en cas d’échecs de script pour voir executionMessage, sortie, erreur : https://aka.ms/runcommandmanaged#get-execution-status-and-results |
|
properties.runAsPassword |
string |
Spécifie le mot de passe du compte d’utilisateur sur la machine virtuelle lors de l’exécution de la commande d’exécution. |
|
properties.runAsUser |
string |
Spécifie le compte d’utilisateur sur la machine virtuelle lors de l’exécution de la commande d’exécution. |
|
properties.source |
Source du script de commande d’exécution. |
||
properties.timeoutInSeconds |
integer |
Délai d’expiration en secondes pour exécuter la commande d’exécution. |
|
properties.treatFailureAsDeploymentFailure |
boolean |
False |
Optionnel. Si la valeur est true, tout échec dans le script échoue et ProvisioningState est marqué comme ayant échoué. Si la valeur est false, ProvisioningState indique uniquement si la commande d’exécution a été exécutée ou non par la plateforme d’extensions, elle n’indique pas si le script a échoué en cas d’échec de script. Consultez la vue d’instance de la commande d’exécution en cas d’échecs de script pour voir executionMessage, sortie, erreur : https://aka.ms/runcommandmanaged#get-execution-status-and-results |
tags |
object |
Balises de ressource |
|
type |
string |
Type de ressource |
VirtualMachineRunCommandInstanceView
Vue d’instance d’une commande d’exécution de machine virtuelle.
Nom | Type | Description |
---|---|---|
endTime |
string |
Heure de fin du script. |
error |
string |
Flux d’erreurs de script. |
executionMessage |
string |
Communiquez les erreurs de configuration de script ou les messages d’exécution. |
executionState |
État de l’exécution du script. |
|
exitCode |
integer |
Quittez le code retourné par l’exécution du script. |
output |
string |
Flux de sortie de script. |
startTime |
string |
Heure de début du script. |
statuses |
Informations d’état de la ressource. |
VirtualMachineRunCommandScriptSource
Décrit les sources de script pour la commande d’exécution. Utilisez un seul script, scriptUri, commandId.
Nom | Type | Description |
---|---|---|
commandId |
string |
Spécifie un commandId de script intégré prédéfini. |
script |
string |
Spécifie le contenu du script à exécuter sur la machine virtuelle. |
scriptUri |
string |
Spécifie l’emplacement de téléchargement du script. Il peut s’agir de l’URI SAP d’un objet blob de stockage Azure avec accès en lecture ou URI public. |
scriptUriManagedIdentity |
Identité managée affectée par l’utilisateur qui a accès à scriptUri en cas d’objet blob de stockage Azure. Utilisez un objet vide en cas d’identité affectée par le système. Vérifiez que l’objet blob de stockage Azure existe et que l’identité managée a été attribuée au conteneur de l’objet blob avec l’attribution de rôle « Lecteur de données blob du stockage ». En cas d’identité affectée par l’utilisateur, veillez à l’ajouter sous l’identité de la machine virtuelle. Pour plus d’informations sur l’identité managée et la commande Exécuter, reportez-vous https://aka.ms/ManagedIdentity et https://aka.ms/RunCommandManaged. |
VirtualMachineRunCommandsListResult
Réponse de l’opération d’exécution de liste
Nom | Type | Description |
---|---|---|
nextLink |
string |
URI permettant d’extraire la page suivante des commandes d’exécution. |
value |
Liste des commandes d’exécution |