查询后端存储列表 - ListBackendTargets

project_id

是

String

参数解释：

项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

share_id

是

String

参数解释：

文件系统ID，用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

limit

否

Integer

参数解释：

查询列表返回的元素个数，用于控制分页大小。

约束限制：

不涉及。

取值范围：

0~2000的整数。

默认取值：

100

marker

否

String

参数解释：

分页查询的起始位置标识，取值为上一次查询响应中最后一条记录的target_id。

首次查询无需指定。不指定时从第一条记录开始返回，指定时从该target_id对应的记录之后开始返回。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token，用于鉴权认证。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

请求消息体MIME类型，用于标识请求正文的数据格式。

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

X-request-id

String

参数解释：

请求ID，用于唯一标识和追踪本次请求。

取值范围：

不涉及。

count

Integer

参数解释：

后端存储列表中返回的目标存储数量。

取值范围：

不涉及。

targets

Array of ShowBackendTargetInfoResponseBody objects

参数解释：

后端存储详细信息列表，每个元素为一个后端存储目标对象。

取值范围：

不涉及。

target_id

String

参数解释：

绑定关系ID，用于唯一标识后端存储与文件系统之间的绑定关系。

取值范围：

不涉及。

creation_time

String

参数解释：

绑定关系的创建时间。

取值范围：

UTC时间格式，例如：2023-11-19T04:02:03。

file_system_path

String

参数解释：

联动目录名称，SFS Turbo在文件系统根目录下创建的子目录名称，用于与OBS后端存储建立数据联动关系。

取值范围：

不涉及。

failure_details

FailureDetailsMessage object

参数解释：

绑定错误信息，即当绑定失败时返回的详细的错误信息。

仅在绑定状态为MISCONFIGURED或FAILED时返回该字段。

取值范围：

不涉及。

lifecycle

String

参数解释：

绑定状态，表示后端存储绑定的当前状态。

取值范围：

• CREATING：创建中，您需要通过获取后端存储详细信息接口去轮询绑定完成状态。

• AVAILABLE：可用，代表绑定后端存储成功。

• MISCONFIGURED：配置错误，代表绑定后端存储失败。

• DELETING：删除中，您可以通过获取后端存储详细信息接口轮询删除完成状态，删除成功后该绑定关系将被删除。

• FAILED：失败。

• ABNORMAL：异常，绑定关系数据不完整。

obs

ObsDataRepository object

参数解释：

OBS类型后端存储配置信息，包含OBS桶名称、区域域名等。

取值范围：

不涉及。

message

String

参数解释：

错误信息，记录后端存储在生命周期中遇到的具体错误详情。

取值范围：

不涉及。

bucket

String

参数解释：

OBS桶名称，用于指定要绑定的OBS存储桶。

取值范围：

长度为3~63个字符，只能包含小写字母、数字、连字符-和英文句号.，必须以字母或数字开头和结尾。

endpoint

String

参数解释：

OBS桶的访问域名，用于指定OBS桶所在区域的终端节点。

取值范围：

不涉及。

policy

ObsDataRepositoryPolicy object

参数解释：

后端存储自动同步策略，用于配置文件系统与OBS桶之间的数据自动同步规则。

取值范围：

不涉及。

attributes

ObsTargetAttributes object

参数解释：

后端存储属性，用于配置从OBS桶导入到文件系统的文件和目录的权限及属主信息。

取值范围：

不涉及。

auto_export_policy

AutoExportPolicy object

参数解释：

后端存储自动导出策略。当文件系统中的数据发生更新时，将自动同步到OBS桶。SFS Turbo以异步方式执行同步。

取值范围：

不涉及。

events

Array of strings

参数解释：

后端存储自动同步到OBS桶的数据更新类型。

取值范围：

• NEW：表示新增数据，SFS Turbo联动目录下创建的文件，及之后对这些文件进行的元数据和数据修改，会被自动同步到OBS桶里。

• CHANGED：表示修改数据，从OBS桶里导入到SFS Turbo联动目录下的文件，在SFS Turbo上对这些文件所进行的数据和元数据的修改，会被自动同步到OBS桶里。

• DELETED：表示删除数据，在SFS Turbo联动目录下删除文件，OBS桶对应的对象也会被删除，只有被SFS Turbo写入的OBS对象才会被删除。

prefix

String

参数解释：

后端存储内对象匹配前缀，用于过滤需要同步的OBS对象。

取值范围：

不涉及。

suffix

String

参数解释：

后端存储内对象匹配后缀，用于过滤需要同步的OBS对象。

取值范围：

不涉及。

file_mode

Integer

参数解释：

导入的文件权限，使用八进制数字表示。第一位表示文件所有者的权限，取值范围是0到7；第二位表示文件所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。文件所有者由uid指定，文件所属用户组由gid指定，不是文件所有者且不在文件所属用户组的用户为其他用户。

数字4、2、1分别表示读、写、执行权限，这些数字相加，即可得到所需的权限组合。例如：750中第一位7代表该文件所有者对该文件具有读、写、执行权限；第二位5代表该文件所属用户组对该文件具有读、执行权限；第三位0代表其他用户对该文件无权限。

取值范围：

000到777的整数。

dir_mode

Integer

参数解释：

导入的目录权限，使用八进制数字表示。第一位表示目录所有者的权限，取值范围是0到7；第二位表示目录所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。

数字4、2、1分别表示读、写、执行权限，这些数字相加，即可得到所需的权限组合。例如：750中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位0代表其他用户对该目录无权限。

取值范围：

000到777的整数。

uid

Integer

参数解释：

导入对象所有者的用户ID。

取值范围：

0到4294967294（即2^32-2）的整数。

gid

Integer

参数解释：

导入对象所属用户组的ID。

取值范围：

0到4294967294（即2^32-2）的整数。

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

200

查询成功，返回后端存储列表。

404

错误响应

500

错误响应