Aide-mémoire d’URL pour les rôles de machine virtuelle [SPFSDK][VMROLE]
S’applique à : Windows Azure Pack
L’API Gestion des services est un service BASÉ sur HTTP REST. Pour utiliser les fonctionnalités relatives aux rôles de machine virtuelle que vous utilisez avec une structure d’URL spécifique. Cette rubrique fournit un guide sur toutes les URL disponibles lors de l’utilisation des rôles de machine virtuelle. Il décrit les types d’objets avec utilisant chaque URL et, le cas échéant, les actions disponibles pour ces objets via l’URL.
Important
Chaque fois que vous utilisez une URL avec la galerie et les services cloud, vous devez ajouter la chaîne de requête api-version=2013-03 . La chaîne de requête commence toujours par le caractère ? après l’URL. Par exemple, pour accéder au service cloud nommé TestService, vous devez utiliser cette URL : https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.
Espaces réservés d’URL courants
Tout au long de ce guide de programmation, les URL sont utilisées qui nécessitent des informations sur votre infrastructure, telles que les noms de serveurs ou les noms d’objets qui ont été créés précédemment. La liste suivante décrit tous les espaces réservés utilisés.
Nom de l’espace réservé |
Description |
---|---|
server-name |
Nom du serveur du serveur d’API Gestion des services. |
server-port |
Port d’authentification du serveur d’API Gestion des services. |
subscription-id |
Nom du service cloud hébergeant le rôle de machine virtuelle. |
cloudservice-name |
Nom du service cloud hébergeant le rôle de machine virtuelle. |
vmrole-name |
Nom du rôle de machine virtuelle. |
vm-id |
Identificateur d’une machine virtuelle. |
disk-id |
Identificateur d’un disque dur virtuel. |
nic-id |
Identificateur d’une carte réseau virtuelle. |
Galerie
subscription-id/Gallery/GalleryItems
Opérations HTTP prises en charge : GET.Fournit l’accès aux éléments de la galerie disponibles pour l’abonnement spécifié. Les éléments retournés ne sont pas limités aux rôles de machine virtuelle, mais tous les éléments de la galerie, quel que soit le type.
subscription-id/Gallery/GalleryItems(publisher,name,version)
Opérations HTTP prises en charge : GET.Fournit l’accès à un élément de galerie spécifique disponible pour l’abonnement spécifié.
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
Opérations HTTP prises en charge : GET.Fournit l’accès aux éléments de la galerie de rôles de machine virtuelle disponibles pour l’abonnement spécifié.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher,name,version)
Opérations HTTP prises en charge : GET.Fournit l’accès à un élément de galerie de rôles de machine virtuelle spécifique disponible pour l’abonnement spécifié.
Pour obtenir des exemples utilisant cette URL, consultez :
Services cloud
subscription-id/CloudServices
Opérations HTTP prises en charge : GET, POST.Fournit l’accès aux services cloud qui ont été créés pour l’abonnement spécifié. Un service cloud peut être créé à l’aide de l’opération POST.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name
Opérations HTTP prises en charge : GET, PUT, PATCH, DELETE.Fournit l’accès à un service cloud spécifique créé par l’abonnement spécifié. Le service cloud identifié par l’URL peut être mis à jour et supprimé.
subscription-id/CloudServices/cloudservice-name/Resources
Opérations HTTP prises en charge : GET.Fournit l’accès aux fournisseurs de ressources disponibles pour le service cloud spécifié.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
Opérations HTTP prises en charge : GET.Fournit l’accès au fournisseur de ressources MicrosoftCompute qui héberge les rôles de machine virtuelle.
Rôles de machine virtuelle
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
Opérations HTTP prises en charge : GET, POST.Fournit l’accès aux instances de rôle de machine virtuelle qui ont été créées. Cette URL est également utilisée pour envoyer une nouvelle instance de rôle de machine virtuelle au serveur.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
Opérations HTTP prises en charge : GET, PUT, PATCH, DELETE.Fournit l’accès à un rôle de machine virtuelle spécifique par nom. Cette URL est utilisée pour supprimer et mettre à jour un rôle de machine virtuelle.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
Opérations HTTP prises en charge : POST.Lance l’action de mise à l’échelle sur le rôle de machine virtuelle spécifié.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
Opérations HTTP prises en charge : POST.Lance l’action de réparation sur le rôle de machine virtuelle spécifié.
Pour obtenir des exemples utilisant cette URL, consultez :
Machines virtuelles
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
Opérations HTTP prises en charge : GET.Fournit l’accès aux machines virtuelles hébergées dans un rôle de machine virtuelle spécifique.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
Opérations HTTP prises en charge : GET, DELETE.Fournit l’accès à la machine virtuelle par identificateur hébergé dans un rôle de machine virtuelle spécifique. Cette URL peut être utilisée pour supprimer une machine virtuelle spécifique d’un rôle de machine virtuelle.
Pour obtenir des exemples utilisant cette URL, consultez :
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
Opérations HTTP prises en charge : POST.Arrête la machine virtuelle identifiée.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
Opérations HTTP prises en charge : POST.Démarre la machine virtuelle identifiée.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
Opérations HTTP prises en charge : POST.Redémarre la machine virtuelle identifiée.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
Opérations HTTP prises en charge : POST.Arrête la machine virtuelle identifiée.
Disques virtuels et cartes réseau virtuelles
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
Opérations HTTP prises en charge : GET, POST.Fournit l’accès aux disques virtuels de la machine virtuelle identifiée. Cette URL peut également être utilisée pour attacher un disque virtuel à la machine virtuelle à l’aide de l’opération POST.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
Opérations HTTP prises en charge : GET, PUT, PATCH, DELETE.Fournit l’accès aux disques virtuels spécifiés.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
Opérations HTTP prises en charge : GET.Fournit l’accès aux cartes réseau virtuelles de la machine virtuelle identifiée.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
Opérations HTTP prises en charge : GET.Fournit l’accès à la carte réseau virtuelle spécifiée.