Obter uma instância de função de VM [SPFSDK][VMROLE]

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

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

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

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

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 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?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: 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

Instâncias de função de VM [SPFSDK][VMROLE]
Obter todos os Máquinas Virtuais [SPFSDK][VMROLE]
Obter uma única máquina virtual [SPFSDK][VMROLE]
Reparar uma função de VM [SPFSDK][VMROLE]
Dimensionar uma função de VM [SPFSDK][VMROLE]

Compartilhar via