Obtenir une instance de rôle de machine virtuelle [SPFSDK][VMROLE]

Article
08/24/2015

S’applique à : Windows Azure Pack

À un moment donné, vous devez récupérer une instance d’un rôle de machine virtuelle (rôle de machine virtuelle). Avec une référence à un rôle de machine virtuelle, vous pouvez créer ou supprimer des machines virtuelles et gérer les machines virtuelles existantes qui ont été créées précédemment.

Obtenir une instance de rôle de machine virtuelle

Une instance de rôle de machine virtuelle se trouve à l’URI suivant : http:// server-name:server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name.

Conseil

Pour plus d’informations sur les espaces réservés utilisés dans l’URL, consultez La feuille de triche d’URL pour les rôles de machine virtuelle [SPFSDK][VMROLE].

Important

Chaque fois que vous accédez à une ressource dans 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.

Obtenir une instance de rôle de machine virtuelle avec HTTP

Utilisez une opération GET HTTP.
Définissez l’URI de l’opération HTTP au format précédemment décrit.
Définissez l’en-tête x-ms-principal-id sur l’e-mail du locataire associé à l’abonnement actuel.
Si vous souhaitez utiliser json comme type de réponse, ajoutez l’en-tête Accept et définissez la valeur sur application/json
Définissez tous les autres en-têtes HTTP standard, tels que ceux liés aux jetons d’authentification, et ajoutez tous les certificats d’authentification qui peuvent être requis.
Envoyez la demande.

Requête HTTP GET

GET https://smapiserver:30005/f86b0bc2-6825-4e5b-961b-10d5901f7572/CloudServices/CloudService1/Resources/MicrosoftCompute/VMRoles/VMRole1?api-version=2013-03 HTTP/1.1
x-ms-principal-id: tenant@contoso.com
Accept: application/json
Host: smapiserver:30005

Réponse HTTP GET

HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 4846
Content-Type: application/json; odata=minimalmetadata; streaming=true; charset=utf-8
Server: Microsoft-IIS/8.5
X-Content-Type-Options: nosniff
request-id: 33c9dafc-df0d-0000-ea83-ca330ddfce01
DataServiceVersion: 3.0;
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ASP.NET
Date: Thu, 14 Nov 2013 02:02:09 GMT

{
    "InstanceView": {
        "InstanceCount": "1",
        "ResolvedResourceDefinition": { ... omitted for brevity ... },
        "VIPs": []
    },
    "Label": "VMRole1",
    "Name": "VMRole1",
    "ProvisioningState": "Provisioned",
    "ResourceConfiguration": { ... omitted for brevity ... },
    "ResourceDefinition": {  ... omitted for brevity ... },
    "Substate": { "VMRoleMessages": [] },
    "odata.metadata": "https://spfserver:8090/SC2012R2/VMM/Microsoft.Management.Odata.svc/$metadata#VMRole/@Element"
}

Voir aussi

Instances de rôle de machine virtuelle [SPFSDK][VMROLE]
Obtenez tous les Machines Virtuelles [SPFSDK][VMROLE]
Obtenir une machine virtuelle unique [SPFSDK][VMROLE]
Réparer un rôle de machine virtuelle [SPFSDK][VMROLE]
Mettre à l’échelle un rôle de machine virtuelle [SPFSDK][VMROLE]

Partager via