Een EXEMPLAAR van een VM-rol ophalen [SPFSDK][VMROLE]

Artikel
08/24/2015

Van toepassing op: Windows Azure Pack

Op een bepaald moment moet u een exemplaar van een virtuele-machinerol (VM-rol) ophalen. Met verwijzing naar een VM-rol kunt u virtuele machines maken of verwijderen en de bestaande virtuele machines beheren die eerder zijn gemaakt.

Een exemplaar van een virtuele-machinerol ophalen

Een exemplaar van een VM-rol bevindt zich op de volgende URI: http:// server-name:server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name.

Tip

Voor meer informatie over de tijdelijke aanduidingen die in de URL worden gebruikt, raadpleegt u het cheatsheet voor URL's voor VM-rollen [SPFSDK][VMROLE].

Belangrijk

Wanneer u toegang hebt tot een resource in cloudservices, moet u de queryreeks api-version=2013-03 toevoegen. De querytekenreeks begint altijd met het teken ? na de URL.

Een exemplaar van een virtuele-machinerol ophalen met HTTP

Gebruik een GET HTTP-bewerking.
Stel de URI van de HTTP-bewerking in op de indeling die eerder is beschreven.
Stel de header x-ms-principal-id in op het e-mailadres van de tenant die is gekoppeld aan het huidige abonnement.
Als u json wilt gebruiken als antwoordtype, voegt u de accept-header toe en stelt u de waarde in op application/json
Stel andere standaard HTTP-headers in, zoals die met betrekking tot verificatietokens, en voeg eventuele verificatiecertificaten toe die mogelijk vereist zijn.
Dien de aanvraag in.

HTTP GET-aanvraag

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

HTTP GET-antwoord

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"
}

Zie ook

VM-rolinstanties [SPFSDK][VMROLE]
Haal alle Virtual Machines [SPFSDK][VMROLE]
Eén virtuele machine ophalen [SPFSDK][VMROLE]
Een VM-rol herstellen [SPFSDK][VMROLE]
Een VM-rol schalen [SPFSDK][VMROLE]

Delen via