在有些场景下，客户期望通过使用 REST 接口来统计某个订阅下的虚拟机信息，比如：获取订阅下某个 Size 虚拟机的总数量。实际上这是一个按属性进行分组统计的典型场景，对于这种需求，我们更建议使用 Powershell 或 SDK 来实现，因为实现起来较为简单方便。
无论哪种方式，我们均需要注意，虚拟机存在两种部署模型：ASM（经典模式）和 ARM（资源管理器模式），不同的部署模型也对应着不同的 REST 协议，SDK、Powershell 命令亦如此。
本文我们将重点介绍使用 REST 接口来达成这个需求的基本思路，一般来说这个过程需要通过程序调用 REST 接口，然后通过分组统计来实现具体的业务逻辑。
关于虚拟机 REST 接口的认证
无论是哪种部署模型的虚拟机，目前其 REST 接口都支持基于 AAD 的认证方式，早期的 ASM 虚拟机同样支持 x509 证书认证，出于一致性考虑，这里我们介绍两种都支持的 AAD 认证方式。
在调用接口时，我们需要提供一个基于 AAD 的认证 Token，总体来说有两种方式获取这个 Token:
方式一：浏览器从门户获取临时 Token
通过 Chrome 浏览器登录Azure 门户。
按 F12 弹出开发者工具界面，选择 “Network” 选项卡，此时刷新登录页面，在 “Network” 中找到 “Select” 项，找到 “authorization”，该值即可用于认证我们调用的 REST 请求。
方式二：代码方式获取认证授权 Token
通过 PowerShell 获取认证凭据
PowerShell复制
# 1.在 PowerShell 中，登录 Azure 账户Login-AzureRmAccount-EnvironmentNameAzureChinaCloud# 2.选择当前订阅 IDSet-AzureRmContext-SubscriptionId"订阅 ID"# 3.创建 AD Application$azureAdApplication=New-AzureRmADApplication-DisplayName"georgeapp"-HomePage"https://www.georgeapp.org"-IdentifierUris"https://www.georgeapp.org/example"-Password"1QAZxsw2"$azureAdApplication# 4.为你的 AD 应用创建服务凭证New-AzureRmADServicePrincipal-ApplicationId$azureAdApplication.ApplicationId# 5.为服务凭证授权。如果想了解更多内容，请参考：https://azure.microsoft.com/zh-cn/documentation/articles/role-based-access-control-what-is/New-AzureRmRoleAssignment-RoleDefinitionNameContributor-ServicePrincipalName$azureAdApplication.ApplicationId
执行上述操作后，就可以获取可用的认证凭据信息：
tentantId：第二步执行完成后返回
subId：第二步指定的订阅 ID
clientId：第三步执行完成后返回
clientSecret：第三步中设置的 Password
通过代码获取认证 Token
Java 示例
Java复制
privateStringgetAccessToken(){ AuthenticationContext context =null; AuthenticationResult result =null; ExecutorService service =null; service = Executors.newFixedThreadPool(1);try{ context =newAuthenticationContext( String.format("%s/%s","https://login.chinacloudapi.cn", tentantId),true, service); ClientCredential cred =newClientCredential( clientId, clientSecret); Future future = context.acquireToken("https://management.chinacloudapi.cn/", cred,null); result = future.get(); }catch(MalformedURLException e) { e.printStackTrace(); }catch(InterruptedException e) { e.printStackTrace(); }catch(ExecutionException e) { e.printStackTrace(); }finally{ service.shutdown(); }returnresult.getAccessToken();}
Python 示例
Python复制
frommsrestazure.azure_active_directoryimportAADTokenCredentials, ServicePrincipalCredentialsclient_id ='16a94c84-c6ba-4f19-aa48-3353f8ffe1dd'client_secret ='123456'tenant_id ='b388b808-0ec9-4a09-a414-a7cbbd8b7edd'subscription_id ='e0fbea86-6cf2-4b2d-81e2-9c59f4f96bdd'credentials = ServicePrincipalCredentials(client_id,client_secret,tenant=tenant_id,china='true')print(credentials.token)
C# 示例
C#复制
publicstaticasyncTaskGetAccessTokenAsync(){ AuthenticationContext context =newAuthenticationContext(string.Format("https://login.chinacloudapi.cn/{0}", tenantId),false);varcredential =newUserPasswordCredential("订阅账号","订阅密码"); AuthenticationResult authenticationResult =awaitcontext.AcquireTokenAsync("https://management.chinacloudapi.cn/", clientId, credential);stringtoken = authenticationResult.AccessToken;returntoken;}
调用示例
ARM API（资源管理器模式）:
实现原理：
先获取一个订阅下的所有资源组。
获取每个资源组下面的虚拟机信息。
根据每个虚拟机信息的 vmSize 进行分组统计（这个逻辑，比较适合用程序实现）。
参考接口:
List the virtual machines in a resource group
测试准备：
Endpoint: 上述 API 连接中的 API 终结点是指向 Global Azure 服务，我们需要修改为 China Azure 终结点，即将https://management.azure.com换成https://management.chinacloudapi.cn。
Authorization: 参考《关于虚拟机 REST 接口的认证》部分。
接口测试：
测试请求：https://management.chinacloudapi.cn/subscriptions//resourcegroups?api-version=2017-05-10
参数设置：
Authorization：上一步中浏览器中拿到的 Authorization 值
Content-Type：application/json
Postman 测试：
List the virtual machines in a resource group
测试请求：https://management.chinacloudapi.cn/subscriptions//resourceGroups//providers/Microsoft.Compute/virtualmachines?api-version=2016-04-30-preview
参数设置：
Authorization：上一步中浏览器中拿到的 Authorization 值
Content-Type：application/json
Postman 测试：
ASM API（经典模式）:
实现原理：
先获取一个订阅下的所有云服务
获取每个云服务下的部署
获取每个部署下的角色
根据角色 RoleSize 进行分组统计
参考接口:
测试准备：
Endpoint: 上述 API 连接中的 API 终结点是指向 Global Azure 服务，我们需要修改为 China Azure 终结点，即将https://management.core.windows.net换成https://management.core.chinacloudapi.cn
同样可以基于 AAD 方式认证，参考前面《关于虚拟机 REST 接口的认证》部分。
接口测试：
测试请求：https://management.core.chinacloudapi.cn/subscriptions//services/
参数设置：
Authorization：Chrome 浏览器拿到的那个认证 Token
x-ms-version：2016-06-01
Postman 测试：
关于Get Deployment、Get Role的调用也非常简单，与List Cloud Services类似，不在赘述。
最后说明
通过 REST 接口，我们能获取到某个虚拟机的各种属性信息，但最终的业务达成还需要通过程序来实现，比如分组统计的逻辑。期望这篇文档对您有所帮助。
立即访问http://market.azure.cn
