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

API 响应的解释

09/29/2025

每个 API 请求都会生成一个响应返回给客户端。您应该检查响应以确定它是否成功并根据需要检索其他数据。

HTTP 状态代码

SnapCenter REST API 使用的 HTTP 状态代码如下所述。

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

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

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

这通常是 application/json。

API 请求产生的响应主体的内容根据对象、处理类型以及请求的成功或失败而有所不同。响应始终以 JSON 形式呈现。

根据请求，可以返回带有一组字段的单个对象。例如，您可以使用 GET 操作，通过唯一标识符检索集群的选定属性。

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

如果异步处理 API 调用，则会返回一个 Job 对象来锚定后台任务。例如，用于更新集群配置的PATCH请求是异步处理的，并返回一个Job对象。

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

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

如果发生错误，则会在响应主体中返回错误对象。

错误对象具有以下格式：

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

您可以使用代码值来确定一般错误类型或类别，并使用消息来确定具体错误。当可用时，目标字段包括与错误相关的特定用户输入。

常见错误代码如下表所示。特定的 API 调用可能包含额外的错误代码。