简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

API 响应的解释

11/11/2024 贡献者

每个 API 请求都会生成对客户端的响应。您应检查响应以确定其是否成功，并根据需要检索其他数据。

HTTP 状态代码

下面介绍了 SnapCenter REST API 使用的 HTTP 状态代码。

代码	Description
200	确定表示未创建新对象的调用成功。
201	已成功创建对象。响应中的位置标头包括对象的唯一标识符。
202	已接受已启动后台作业以执行请求，但尚未完成。
400	请求错误无法识别请求输入或请求输入不正确。
401	未授权用户身份验证失败。
403	由于授权（ RBAC ）错误，禁止访问被拒绝。
404	未找到请求中引用的资源不存在。
405.	方法不允许资源不支持请求中的 HTTP 方法。
409	冲突由于必须先创建其他对象或请求的对象已存在，创建对象的尝试失败。
500	内部错误服务器发生一般内部错误。

SnapCenter 生成的 HTTP 响应包含多个标头。

创建对象时，位置标头包含新对象的完整 URL ，包括分配给该对象的唯一标识符。

通常为 application/json 。

API 请求生成的响应正文内容因对象，处理类型以及请求的成功或失败而异。响应始终在 JSON 中呈现。

可以根据请求返回一个对象并显示一组字段。例如，您可以使用 GET 使用唯一标识符检索集群的选定属性。

可以从一个资源收集返回多个对象。在所有情况下，都会使用一致的格式，其中 num_records 表示包含对象实例数组的记录和记录的数量。例如，您可以检索特定集群中定义的节点。

如果异步处理 API 调用，则会返回作业对象，用于将后台任务固定。例如，用于更新集群配置的修补程序请求会异步处理并返回一个作业对象。

如果发生错误，则始终返回 Error 对象。例如，在尝试更改未为集群定义的字段时，您将收到错误消息。

在某些情况下，不会返回任何数据，并且响应正文包含一个空的 JSON 对象。

如果发生错误，响应正文将返回一个错误对象。

错误对象的格式如下：

"error": {
"message": "<string>",
"code": <integer>[,
"target": "<string>"]
}

您可以使用代码值确定常规错误类型或类别，并使用消息确定特定错误。如果可用，目标字段将包含与错误关联的特定用户输入。

下表介绍了常见错误代码。特定 API 调用可能包括其他错误代码。