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

授权和身份验证

提供者

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
  • 更新阵列值时,必须更新整个值字符串。您不能将值附加到阵列—您只能替换现有阵列。

  • 通过组合使用筛选器运算符通配符(` *` )和管道(`` )来避免查询对象。它可能检索的对象数不正确。