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