Azure REST API (1) 前言

比眉伴天荒 2021-11-01 23:32 283阅读 0赞

**　　《[Windows Azure Platform 系列文章目录][Windows Azure Platform]》**

**一.服务运行时API简介**

微软的Windows Azure服务总线提供了一整套REST风格的API，其中包括服务运行时API（Service Runtime API）和服务管理API（Service Management API），分别用于运行时操作和管理操作。

那么，什么是REST呢？REST（Representational State Transfer表述性状态转移）是一种针对网络应用的设计和开发方式，它可以降低开发的复杂性，提高系统的可伸缩性。使用REST API，意味着我们可以使用任意的编程语言来开发应用程序，它只有一个前提，我们使用的编程语言必须要能够支持HTTP协议。使用REST API，我们就不再需要客户端的SDK。

**　　二.服务运行时API和服务管理API的区别**

服务运行时API和服务管理API有什么区别呢？

首先，要从两者运行的“位置”进行比较。服务运行时API运行于Windows Azure云的内部，API代码与云交互环境相勾连；而服务管理API运行于Windows Azure云的外部，可以通过调用服务管理API来操纵正在运行的服务。

其次，两者的功能也大不相同。服务运行时API主要用于动态查看服务信息；而服务管理API则用于Azure授权用户能够以编程的方式管理其部署、托管的服务以及存储账户。授权用户可以管理存储服务的生命周期，包括新建存储服务、更新存储服务、删除存储服务等。

服务运行时API有时也被认为是服务托管API

**　三.服务运行时API的作用**

服务运行时API有哪些作用呢？

1.WindowsAzure云上的Adapter服务可以通过调用服务运行时API来动态查询服务信息。比如可以访问应用的服务信息和用户的角色信息。还可以用于访问服务的拓扑信息，比如正在运行哪些角色、每个角色包含了多少个实例等等。

2.可以从配置文件中读取最新的设置。比如访问服务定义和服务配置文件中各项设置的最新的值，即使是服务配置正在更新，服务运行时API也能确保取得的值为最新状态。要注意，对于工作者角色，它与角色的生命周期是紧密绑定在一起的。

3.可以在配置文件更新后获取通知。

**四.服务运行时API的访问方式**

服务运行时API有两种访问方式：

1.对于托管代码，SDK封装了整个Microsoft.WindowsAzure.ServiceRuntime.dll库。只要用Visual Studio创建了一个新的云服务项目后，服务运行时API就可以自动引用。

2.对于本地代码，头文件和库文件都被封装在SDK中，可以使用C语言调用服务运行时API。

要说明一点，本地库和托管库两者的功能是完全相同的，你可以选择任意一种访问方式，而且两者间的代码转换也是很容易的。

**　　五.服务运行时API的命名空间**

Microsoft.WindowsAzure.ServiceRuntime的命名空间详见下表所述。

<table> 
 <tbody> 
 <tr> 
 <td> 类 </td> 
 <td> 描述 </td> 
 </tr> 
 <tr> 
 <td> LocalResource </td> 
 <td> 表示本地存储资源，托管服务所保留。 </td> 
 </tr> 
 <tr> 
 <td> Role </td> 
 <td> 表示定义的角色，作为托管服务的一部分。 </td> 
 </tr> 
 <tr> 
 <td> RoleEntryPoint </td> 
 <td> 在角色实例进行初始化、运行、停止时，提供运行代码的方法。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironment </td> 
 <td> 提供运行角色实例的配置、端点和状态的信息。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentCharge </td> 
 <td> 表示托管服务的配置发生了变化。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentChangedEventArgs </td> 
 <td> 表示已更改事件的参数，当配置修改被应用到角色实例后使用。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentChangingEventArgs </td> 
 <td> 表示待更改事件的参数，当配置修改被应用到角色实例前使用。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentConfigurationSettingChange </td> 
 <td> 表示一个角色配置的修改。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentException </td> 
 <td> 在访问RoleEnvironment类的属性和方法发生错误时所抛出的异常。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentStoppingEventArgs </td> 
 <td> 表示停止事件的参数，当一个角色实例被停止时使用。 </td> 
 </tr> 
 <tr> 
 <td> RoleEnvironmentTopologyChange </td> 
 <td> 表示某个角色的拓扑结构发生变化。 </td> 
 </tr> 
 <tr> 
 <td> RoleInstance </td> 
 <td> 表示一个角色实例。 </td> 
 </tr> 
 <tr> 
 <td> RoleInstanceEndpoint </td> 
 <td> 表示一个角色实例相关联的端点。 </td> 
 </tr> 
 <tr> 
 <td> RoleInstanceStatusCheckEventArgs </td> 
 <td> 表示StatusCheck事件的参数，用于在内部定期时间间隔来指示一个角色实例的状态。 </td> 
 </tr> 
 </tbody> 
</table>

参考资料:http://blog.csdn.net/chszs/article/details/7851794

转载于:https://www.cnblogs.com/threestone/p/4626402.html

[Windows Azure Platform]: http://www.cnblogs.com/threestone/archive/2012/01/06/2382322.html