取得 VM 角色實例 [SPFSDK][VMROLE]

發行項
08/24/2015

適用于：Windows Azure Pack

在某些情況下，您必須擷取虛擬機器角色的實例， (VM 角色) 。您可以使用 VM 角色的參考，建立或刪除虛擬機器，以及管理先前建立的現有虛擬機器。

取得虛擬機器角色實例

VM 角色實例位於下列 URI：HTTP:// server-name：server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name。

提示

如需 URL 中使用的預留位置詳細資訊，請參閱 VM 角色 [SPFSDK][VMROLE] 的 URL 速查表。

重要

每當您在雲端服務記憶體取資源時，都必須附加 api-version=2013-03 查詢字串。查詢字串一律以 URL 之後 的？ 字元開頭。

使用 HTTP 取得虛擬機器角色實例

使用 GET HTTP 作業。
將 HTTP 作業的 URI 設定為先前描述的格式。
將 x-ms-principal-id 標頭設定為與目前訂用帳戶相關聯的租使用者電子郵件。
如果您想要使用 json 作為回應類型，請新增 Accept 標頭，並將值設定為 application/json
設定任何其他標準 HTTP 標頭，例如與驗證權杖相關的標頭，並新增任何可能需要的驗證憑證。
提交要求。

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

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

另請參閱

VM 角色實例 [SPFSDK][VMROLE]
取得所有虛擬機器 [SPFSDK][VMROLE]
取得單一虛擬機器 [SPFSDK][VMROLE]
修復 VM 角色 [SPFSDK][VMROLE]
調整 VM 角色 [SPFSDK][VMROLE]

共用方式為