Obtención de una instancia de rol de máquina virtual [SPFSDK][VMROLE]

Artículo
08/24/2015

Se aplica a: Windows Azure Pack

En algún momento, deberá recuperar una instancia de un rol de máquina virtual (rol de máquina virtual). Con referencia a un rol de máquina virtual, puede crear o eliminar máquinas virtuales y administrar las máquinas virtuales existentes que se han creado anteriormente.

Obtención de una instancia de rol de máquina virtual

Una instancia de rol de máquina virtual se encuentra en el siguiente URI: http:// server-name:server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name.

Sugerencia

Para obtener más información sobre los marcadores de posición usados en la dirección URL, consulte Hoja de referencia rápida de direcciones URL para roles de máquina virtual [SPFSDK][VMROLE].

Importante

Cada vez que acceda a un recurso dentro de los servicios en la nube, debe anexar la cadena de consulta api-version=2013-03 . La cadena de consulta siempre comienza con el carácter ? después de la dirección URL.

Obtención de una instancia de rol de máquina virtual con HTTP

Use una operación HTTP GET .
Establezca el URI de la operación HTTP en el formato descrito anteriormente.
Establezca el encabezado x-ms-principal-id en el correo electrónico del inquilino asociado a la suscripción actual.
Si desea usar json como tipo de respuesta, agregue el encabezado Accept y establezca el valor en application/json.
Establezca cualquier otro encabezado HTTP estándar, como los relacionados con los tokens de autenticación, y agregue los certificados de autenticación que puedan ser necesarios.
Envíe la solicitud.

Solicitud 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

Respuesta 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 también

Instancias de rol de máquina virtual [SPFSDK][VMROLE]
Obtener todas las Virtual Machines [SPFSDK][VMROLE]
Obtener una sola máquina virtual [SPFSDK][VMROLE]
Reparación de un rol de máquina virtual [SPFSDK][VMROLE]
Escalado de un rol de máquina virtual [SPFSDK][VMROLE]

Compartir a través de