授权和身份验证
提供者
NetApp 服务引擎 REST API 可通过任何可对 HTTP 请求进行问题描述处理的 Web 浏览器或编程平台进行访问。NetApp 服务引擎支持基本的 HTTP 身份验证机制以及 Java Web 令牌( JWT )承载身份验证。在调用 API 之前,您必须对用户进行身份验证。
对于参考API、您可以登录到NetApp服务引擎Web界面、并从*左侧导航窗格>支持> API文档*中查看Swagger界面。
HTTP status codes
在运行 API 或解决问题时,您应了解 NetApp 服务引擎 API 使用的各种 HTTP 状态代码和错误代码。
下表列出了与身份验证相关的错误代码。
HTTP 状态代码 | 状态代码标题 | Description |
---|---|---|
200 |
确定 |
成功执行同步 API 调用时返回。 |
201 |
已创建 |
通过同步调用创建新资源,例如配置 Active Directory 。 |
202 |
已接受 |
成功执行异步调用以执行配置功能(例如创建 LUN 和文件共享)时返回。 |
400 |
请求无效 |
指示输入验证失败。用户必须更正输入,例如,请求正文中的有效密钥。 |
401 |
未授权请求 |
您无权查看此资源 / 未授权。 |
403 |
已禁止请求 |
禁止访问您尝试访问的资源。 |
404 |
未找到资源 |
未找到您尝试访问的资源。 |
405. |
不允许使用此方法 |
不允许使用此方法 |
412 |
前提条件失败 |
未满足一个或多个前提条件。 |
500 |
内部服务器错误 |
内部服务器错误。无法从服务器获取响应。此内部服务器错误可能是永久性的,也可能不是永久性的。例如,如果您运行 GET 或 GET ALL 操作并收到此错误,建议您重复此操作至少五次重试。如果是永久性错误,则返回的状态代码仍为 500 。如果操作成功,则返回的状态代码为 200 。 |
使用 API 的建议
使用 API 时,应遵循某些建议的做法:
-
要有效执行,请确保所有响应内容类型采用以下格式:
application/json
-
更新阵列值时,必须更新整个值字符串。您不能将值附加到阵列—您只能替换现有阵列。
-
通过组合使用筛选器运算符通配符(` *` )和管道(`` )来避免查询对象。它可能检索的对象数不正确。