JavaScript is required to for searching.
跳过导航链接
退出打印视图
Oracle® ZFS Storage Appliance REST 风格的应用程序编程接口
Oracle 技术网
文档库
PDF
打印视图
反馈
search filter icon
search icon

文档信息

使用本文档

 1 概述

验证

基本验证

用户验证

会话验证

API 版本

服务版本

REST 风格的常用操作

HTTP 响应正文

HTTP 响应头

查询参数

props

limit

start

错误

 2 使用 API

 3 警报服务命令

 4 Analytics 服务

 5 硬件服务

 6 日志命令

 7 网络命令

 8 问题服务命令

 9 角色服务

 10 SAN 服务

 11 服务命令

 12 存储服务

 13 系统命令

 14 用户服务

 15 工作流命令

 16 REST 风格的客户机

服务版本

每个服务都有一个作为统一资源标识符 (Uniform Resource Identifier, URI) 的一部分、用于访问服务的版本号。版本有主要版本号和次要版本号。请求必须提供主要版本号,但次要版本号是可选的,如果未提供次要版本号,则默认值为 "0"。请求中的主要版本号必须与服务的主要版本号匹配。请求中的次要版本号必须与服务的次要版本号匹配。

示例:客户机针对版本号为 "2.1" 的服务提出了一些请求。

请求版本
允许
v1
False-主要版本号不匹配
v2
True-主要版本号匹配,但次要版本号向后兼容
v2.1
True-主要版本号和次要版本号都匹配
v2.2
False-主要版本号匹配,但次要版本号是新修订版

更改以下属性时,无需更改任何服务 API 版本。必须使用设备版本号和型号来确定哪些属性可用。这些属性发生更改时,也会反映到 CLI 和 BUI 中,这些属性也可作为 ZFSSA 实例功能的指示。

由于新版本的向后兼容命令可以返回其他属性,因此应对客户机进行编码以忽略新属性。如果对服务 API 进行向后兼容的更改,则次要版本号将递增。

如果对服务 API 进行不兼容的更改,则主要版本号将递增。

ZFSSA 软件的主要版本可能包括不兼容的版本更改。执行主要更新期间,给定服务可能有也可能没有较早的版本。每个命令响应都必须包含 HTTP 头和给定模块的 ZFSSA API 的当前版本:

X-Zfssa-Nas-Api:  1.1