Partilhar via


Obtenha uma VM Role Instance [SPFSDK][VMROLE]

 

Aplica-se a: Windows Azure Pack

Em algum momento, terá de recuperar uma instância de uma função de máquina virtual (função VM). Com referência a uma função VM, pode criar ou eliminar máquinas virtuais e gerir as máquinas virtuais existentes que foram previamente criadas.

Obtenha uma instância de papel de máquina virtual

Uma instância de função VM está localizada no seguinte URI: http:// server-name:servidor-porta/subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name.

Dica

Para obter mais informações sobre os espaços reservados utilizados no URL, consulte url Cheat Sheet for VM Roles [SPFSDK][VMROLE].

Importante

Sempre que aceder a um recurso dentro dos serviços na nuvem, tem de anexar a cadeia de consultas api-versão=2013-03 . A cadeia de consulta começa sempre com o personagem ?

Obtenha uma instância de função de máquina virtual com HTTP

  1. Utilize uma operação GET HTTP.

  2. Descreva o URI da operação HTTP ao formato anteriormente descrito.

  3. Desa estade o cabeçalho x-ms-principal-id para o e-mail do inquilino associado à subscrição atual.

  4. Se quiser usar json como tipo de resposta adicione o cabeçalho Aceitar e definir o valor para aplicação/json

  5. Desacorda quaisquer outros cabeçalhos HTTP padrão, tais como os relacionados com fichas de autenticação, e adicione quaisquer certificados de autenticação que possam ser necessários.

  6. Submeta o pedido.

HTTP GET pedido

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 resposta

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

Consulte também

VM Role Instances [SPFSDK][VMROLE]
Obtenha todas as Máquinas Virtuais [SPFSDK][VMROLE]
Obtenha uma única máquina virtual [SPFSDK][VMROLE]
Reparar uma Função VM [SPFSDK][VMROLE]
Escalar uma função VM [SPFSDK][VMROLE]