使用 Web 服务进行管理 › REST Web 服务中的基本操作

REST Web 服务中的基本操作

REST 规范为某些灵活处理留出了空间。 因此，RESTful Web 服务可以使用基本 HTTP 语法来执行不同任务。

在该实施中，按如下所示使用基本的 REST 命令：

• GET－登录或从服务器数据库检索信息。 仅需要浏览器会话。
• POST－创建对象。 通常需要 XML 输入来提供参数。
• PUT－编辑现有对象。 偶尔也用于创建对象。 通常不需要 XML 输入来提供参数。
• DELETE－删除现有对象。

下面是一个简单的操作示例：

http://[server IP address]:8181/pc/center/webservice/tenants/
tenantName/{tenantName}/description/{NewDescription}

此操作是一个 PUT 操作，用于更新承租方的描述参数。

您应将要求的参数替换为大括号 {} 内的期望值：

{tenantName}

您要编辑的承租方的名称。

{tenantDescription}

表示此承租方的新描述。

“获得 ID 名称”方法将会获得受支持的 ID 名称的列表。 例如，您将为承租方 Web 服务输入以下命令：

http://[server IP address]:8181/pc/center/webservice/
tenants/idNames

将返回以下列表：

[tenantAccountId, tenantItemId, tenantName]

每个请求都会收到一个回复，其中包括指明了问题类型的 HTTP 状态代码以及描述了该问题的 HTTP 状态响应文本。 以下 HTTP 响应代码范围用于反馈：

• 200－命令状态为“正常”。
• 400－用户错误已经发生。 此范围内的错误指示带有输入文本 (400) 或用户凭证 (403) 的问题，而且此问题通常可以轻松纠正。
• 500－出现系统错误。 此范围内的错误通常表示出现系统故障。 此类错误可以要求 CA 技术支持协助解决。

有关 HTTP 状态代码的更多信息，请参阅下列的 IETF 网站：

http://www.ietf.org/rfc/rfc2616.txt