使用REST API创建虚拟机之前,首先要确保Azure订阅中已经建好了"云服务"和"存储账号"。如果没有的话,可以使用Azure管理页面,或Powershell命令行工具,或REST API来创建云服务和存储账号。

https://msdn.microsoft.com/library/gg441304.aspx

https://azure.microsoft.com/zh-cn/documentation/articles/storage-create-storage-account/

 

另外需要注意的是,由于国内的Azure是独立运营的,因此调用API时,需要将MSDN代码中的https://management.core.windows.net

替换成:

https://management.core.chinacloudapi.cn/

 

随后需要在调用API的客户端主机上安装证书并上传到Azure Portal。

安装并上传证书。

步骤如下:

1 使用Visual Studio 2013的命令行,输入以下命令:(需要将命令中的<CertificateName>替换成自己的证书名称)

makecert -sky exchange -r -n "CN=<CertificateName>" -pe -a sha1 -len 2048 -ss My "<CertificateName>.cer"

 

2 在客户端主机上运行certmgr.msc,并在证书管理器中找到"个人"证书,并找到刚才创建的证书。右键点击该证书,选择导出,在之后的导出证书向导中,选择"不要导出私钥",证书格式选择DER X.509。

 

azure api management 原始API在哪_操作系统

 

3 打开Azure管理portal网页,在左边的导航菜单中找到"设置",在设置菜单中点击"管理证书",并选择上载刚才导出的不含私钥的证书。上传成功后会在portal上看到这个证书,并且还列出了订阅ID和指纹。订阅ID和指纹在后面的代码中会用到。

 

 

azure api management 原始API在哪_操作系统_02

 

 

证书上传的工作已经完成,下面就可以进行调用REST API的代码开发工作。

这里使用VS2013新建一个控制台应用程序来做演示。需要配合附件《CreateVM_API.rar》中的代码来阅读此文档。

 

 

 

调用API

在VS2013中打开项目"CreateVM_API",主要会用到三个文件:

Program.cs 这是项目的主要程序文件,其中已包含了读取本地的证书,需要将刚才在Azure Portal上看到的指纹字符串替换掉代码中的"certificateThumbprint"。还需要替换URI字符串中的一些参数,后面会说明。

RequestBody.xml 这是用于新建部署的请求正文

AddVM.xml 这是用于在已有部署中增加虚拟机的请求正文

 

这里需要补充说明一下,在使用REST API创建虚拟机的时候需要遵守以下步骤:

创建云服务和存储账户

在云服务下创建一个部署槽

在部署槽中添加一台虚拟机

 

代码中用了两个例子来演示以上步骤,这里对这两个例子做一下解释。

 

 

示例1

 

在未部署虚拟机的云服务中创建部署槽并建立虚拟机

需要调用以下REST API

 

"https://management.core.chinacloudapi.cn/{0}/services/hostedservices/{1}/deployments
这里也就是Program.cs的Main函数中定义的URI。

用订阅ID替换{0}

用云服务的名称替换{1}

 

再将刚才在Azure Portal上看到的指纹字符串替换掉代码中的"certificateThumbprint"

 

随后我们需要对示例代码中的RequestBody.xml进行相应的修改。

<Name>部署槽的名称</Name> 之后向部署中添加虚拟机时会用到 对应下图中红框所示部分

<Label>部署槽标签</Label> 用于标识该部署槽,对应下图蓝框部分

 

 

 

azure api management 原始API在哪_API_03

 

<RoleName>角色名称</RoleName>也就是在Azure Portal中看到的虚拟机的名称

<ComputerName>计算机名称</ComputerName>虚拟机内的操作系统的计算机名称

<AdminPassword>管理员密码</AdminPassword>虚拟机的操作系统的管理员密码,需要遵守所创建的操作系统的默认密码复杂性规则。管理员名称默认为administrator。

 

然后需要处理一下虚拟机的端口映射,以便远程桌面之类的工具可以访问我们的虚拟机。

<LocalPort>虚拟机的端口</LocalPort>也就是内网端口

<Name>端口映射规则的名称</Name>每个虚拟机端口映射条目都要指定一个名称

<Port>云服务端口</Port>也就是外网端口

<Protocol>协议类型</Protocol>只能输入TCP或UDP

 

然后需要选择虚拟机的操作系统映像

<SourceImageName>55bc2b193643443bb879a78bda516fc8__Windows-Server-2012-R2-201502.01-zh.cn-127GB.vhd</SourceImageName>

这里的值是由Azure提供的,可以通过REST API或者Powershell命令来获取当前Azure提供的操作系统镜像。

https://msdn.microsoft.com/zh-cn/library/azure/jj157191.aspx

 

 

 

最后选择保存该镜像的路径,需要保存到已存在的存储账户中

<MediaLink>https://{0}.blob.core.chinacloudapi.cn/vhds/{1}.vhd</MediaLink>将{0}替换成存储账户名称,将{1}替换成想要保存的文件名称,尽量只使用小写字幕和数字来设置文件名。

 

随后即可运行代码。

 

 

 

示例2

 

在已部署了虚拟机的云服务中建立虚拟机

 

需要调用以下API:

https://management.core.chinacloudapi.cn/{0}/services/hostedservices/{1}/deployments/{2}/roles

这里也就是Program.cs的Main函数中定义的第二个URI。

用订阅ID替换{0}

用云服务的名称替换{1}

用部署名称替换{2}。部署名称就是RequestBody.xml中的<Name>部署槽的名称</Name>,也可以通过Azure Portal,在云服务的仪表板中找到部署名称。

 

再将刚才在Azure Portal上看到的指纹字符串替换掉代码中的"certificateThumbprint"

 

随后我们需要对示例代码中的addVM.xml进行相应的修改就可运行代码。需要修改的内容和RequestBody.xml基本一致,只是不能有<Name>和 <Label> 这两个属性。