Obter uma única máquina virtual [SPFSDK][VMROLE]

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

As máquinas virtuais hospedadas por uma instância de função de VM (função de máquina virtual) fazem parte do recurso de VMs de uma função de VM específica. Para obter uma única instância de máquina virtual, você deve conhecer seu identificador.

Obter uma única máquina virtual de uma instância de função de máquina virtual

Dica

Para saber como obter uma instância de função de máquina virtual, consulte Obter uma instância de função de VM [SPFSDK][VMROLE].

Uma máquina virtual específica é referenciada por sua propriedade ID (que é um GUID) e está localizada em http:// server-name:server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/. Use uma solicitação HTTP GET para recuperar a máquina virtual.

Dica

Para obter mais informações sobre os espaços reservados usados na URL, consulte a Planilha de Fraude de URL para Funções de VM [SPFSDK][VMROLE].

Importante

Sempre que você acessar um recurso nos serviços de nuvem, deverá acrescentar a cadeia de caracteres de consulta api-version=2013-03 . A cadeia de caracteres de consulta sempre começa com o caractere ? após a URL.

Obter uma única máquina virtual de uma instância de função de máquina virtual com HTTP

Use uma operação GET HTTP.
Defina o URI da operação HTTP para o formato descrito anteriormente.
Defina o cabeçalho x-ms-principal-id para o email do locatário associado à assinatura atual.
Se você quiser usar json como o tipo de resposta, adicione o cabeçalho Aceitar e defina o valor como application/json
Defina quaisquer outros cabeçalhos HTTP padrão, como aqueles relacionados a tokens de autenticação, e adicione quaisquer certificados de autenticação que possam ser necessários.
Envie a solicitação.

Solicitação HTTP GET

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

Resposta HTTP GET

HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 303
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-0001-3242-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 20:10:02 GMT

{
    "ComputerName": "LAMP001.mydns1",
    "ConnectToAddresses": [{
        "IPAddress": "10.0.0.2",
        "NetworkName": "Network1",
        "Port": 3389
    }],
    "Id": "73b04c76-ad83-45bf-ba8a-90b07e4029d8",
    "RuntimeState": "Running",
    "odata.metadata": "https://spfserver:8090/SC2012R2/VMM/Microsoft.Management.Odata.svc/$metadata#VM/@Element"
}

Consulte Também

Instâncias de função de VM [SPFSDK][VMROLE]
Obter uma instância de função de VM [SPFSDK][VMROLE]
Obter todos os Máquinas Virtuais [SPFSDK][VMROLE]
Reparar uma função de VM [SPFSDK][VMROLE]
Dimensionar uma função de VM [SPFSDK][VMROLE]

Compartilhar via