Partager via

Aide-mémoire d’URL pour les rôles de machine virtuelle [SPFSDK][VMROLE]

  • Article

 

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.

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

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.