Virtual Machines - List By Lab
Obtenez toutes les machines virtuelles d’un laboratoire.
Retourne la liste de toutes les machines virtuelles d’un laboratoire.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/virtualMachines?api-version=2023-06-07
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/virtualMachines?api-version=2023-06-07&$filter={$filter}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
lab
|
path | True |
string minLength: 1maxLength: 100 |
Nom du labo qui l’identifie de manière unique dans le plan de laboratoire contenant. Utilisé dans les URI de ressource. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
subscription
|
path | True |
string minLength: 1 |
ID de l’abonnement cible. |
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
$filter
|
query |
string |
Filtre à appliquer à l’opération. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
La demande a réussi ; la réponse contient toutes les machines virtuelles pour le labo donné. |
|
Other Status Codes |
Réponse d’erreur par défaut. |
Exemples
listVirtualMachine
Exemple de requête
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/virtualMachines?api-version=2023-06-07
Exemple de réponse
{
"nextLink": null,
"value": [
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/virtualMachines/template",
"name": "default",
"type": "Microsoft.LabServices/VirtualMachine",
"systemData": {
"createdBy": "identity123",
"createdByType": "User",
"createdAt": "2020-05-01T10:00:00Z",
"lastModifiedBy": "identity123",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-06-01T09:12:28Z"
},
"properties": {
"provisioningState": "Succeeded",
"state": "Running",
"connectionProfile": {
"privateIpAddress": "192.168.2.1",
"sshAuthority": "vm-42.contoso.com:22",
"sshInBrowserUrl": "vm-42.contoso.com",
"rdpAuthority": "vm-42.contoso.com:3389",
"rdpInBrowserUrl": "vm-42.contoso.com",
"adminUsername": "user123"
},
"claimedByUserId": "testuser567",
"vmType": "Template"
}
}
]
}
Définitions
Nom | Description |
---|---|
created |
Type d’identité qui a créé la ressource. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Paged |
Liste paginée des machines virtuelles des services lab. |
Provisioning |
État d’approvisionnement actuel de la machine virtuelle. |
Resource |
Détails de l’erreur de la dernière défaillance de l’opération sur cette ressource |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Virtual |
Ressource de machine virtuelle lab. |
Virtual |
Informations de connexion pour la machine virtuelle |
Virtual |
État d’une machine virtuelle. |
Virtual |
Type de la machine virtuelle lab. |
createdByType
Type d’identité qui a créé la ressource.
Valeur | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires. |
type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
PagedVirtualMachines
Liste paginée des machines virtuelles des services lab.
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien permettant d’obtenir la page suivante des résultats de la machine virtuelle. |
value |
Page tableau des résultats de la machine virtuelle. |
ProvisioningState
État d’approvisionnement actuel de la machine virtuelle.
Valeur | Description |
---|---|
Creating |
La ressource est en cours de création. |
Deleting |
La ressource est en cours de suppression. |
Failed |
L’opération précédente sur la ressource a échoué en laissant la ressource dans un état non sain. |
Locked |
La ressource est verrouillée et les modifications sont actuellement bloquées. Cela peut être dû à la maintenance ou à une opération planifiée. L’état revient à réussir une fois l’opération de verrouillage terminée. |
Succeeded |
La ressource est en état sain après la création ou l’opération de mise à jour. |
Updating |
Les nouvelles valeurs de propriété sont appliquées à la ressource. |
ResourceOperationError
Détails de l’erreur de la dernière défaillance de l’opération sur cette ressource
Nom | Type | Description |
---|---|---|
action |
string |
Action d’opération ayant échoué |
code |
string |
Code qui correspond au type d’échec de l’opération |
message |
string |
Message d’échec de l’opération |
timestamp |
string (date-time) |
Date et heure de la survenue de l’erreur |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
VirtualMachine
Ressource de machine virtuelle lab.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nom de la ressource |
properties.claimedByUserId |
string |
L’ID utilisateur du labo (et non l’ID PUID !) de qui a revendiqué la machine virtuelle. |
properties.connectionProfile |
Profil pour obtenir des informations sur la connexion à la machine virtuelle. |
|
properties.provisioningState |
État d’approvisionnement actuel de la machine virtuelle. |
|
properties.resourceOperationError |
Détails de la dernière opération effectuée sur le plan lab. |
|
properties.state |
État actuel de la machine virtuelle |
|
properties.vmType |
Type de cette ressource de machine virtuelle |
|
systemData |
Données système de la machine virtuelle Lab. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
VirtualMachineConnectionProfile
Informations de connexion pour la machine virtuelle
Nom | Type | Description |
---|---|---|
adminUsername |
string |
Nom d’utilisateur utilisé pour se connecter à la machine virtuelle en tant qu’administrateur. |
nonAdminUsername |
string |
Nom d’utilisateur utilisé pour se connecter à la machine virtuelle en tant que non-administrateur, s’il en existe un. |
privateIpAddress |
string |
Adresse IP privée de la machine virtuelle. |
rdpAuthority |
string |
Port et nom d’hôte séparés par des points-virgules pour la connexion via le protocole RDP à la machine virtuelle. |
rdpInBrowserUrl |
string minLength: 3maxLength: 2000 |
URL de connexion via le protocole RDP à la machine virtuelle dans le navigateur. |
sshAuthority |
string |
Port et nom d’hôte séparés par des points-virgules pour la connexion via le protocole SSH à la machine virtuelle. |
sshInBrowserUrl |
string minLength: 3maxLength: 2000 |
URL de connexion via le protocole SSH à la machine virtuelle dans le navigateur. |
VirtualMachineState
État d’une machine virtuelle.
Valeur | Description |
---|---|
Redeploying |
La machine virtuelle est redéployée. |
Reimaging |
La machine virtuelle est réimageée. |
ResettingPassword |
Le mot de passe de la machine virtuelle est réinitialisé. |
Running |
La machine virtuelle est en cours d’exécution. |
Starting |
La machine virtuelle démarre. |
Stopped |
La machine virtuelle est actuellement arrêtée. |
Stopping |
La machine virtuelle s’arrête. |
VirtualMachineType
Type de la machine virtuelle lab.
Valeur | Description |
---|---|
Template |
Une machine virtuelle de modèle |
User |
Une machine virtuelle utilisateur |