更新时间:2024-11-12 GMT+08:00
分享

更新后端存储自动同步策略

功能介绍

更新后端存储自动同步策略

接口约束

该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/targets/{target_id}/policy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

share_id

String

文件系统id

target_id

String

绑定关系id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

账号的token

Content-Type

String

MIME类型

表3 请求Body参数

参数

是否必选

参数类型

描述

policy

ObsDataRepositoryPolicy object

后端存储自动同步策略

表4 ObsDataRepositoryPolicy

参数

是否必选

参数类型

描述

auto_export_policy

AutoExportPolicy object

后端存储自动导出策略。当文件系统发生数据更新时,将自动导出到OBS桶。

表5 AutoExportPolicy

参数

是否必选

参数类型

描述

events

Array of strings

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

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

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

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

响应参数

状态码: 200

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表7 响应Body参数

参数

参数类型

描述

target_id

String

绑定关系id

policy

ObsDataRepositoryPolicy object

后端存储自动同步策略

表8 ObsDataRepositoryPolicy

参数

参数类型

描述

auto_export_policy

AutoExportPolicy object

后端存储自动导出策略。当文件系统发生数据更新时,将自动导出到OBS桶。

表9 AutoExportPolicy

参数

参数类型

描述

events

Array of strings

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

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

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

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

状态码: 404

表10 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码: 500

表11 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde",后端target_id为"11abef677ac40f46644d1d5cfc2424a4",更新后端存储自动同步策略

PUT HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/targets/11abef677ac40f46644d1d5cfc2424a4/policy

{
  "policy" : {
    "auto_export_policy" : {
      "events" : [ "NEW", "CHANGED", "DELETED" ]
    }
  }
}

响应示例

状态码: 200

成功

{
  "target_id" : "xxxxxx-xxx-xxxx-xxxxxxx",
  "policy" : {
    "auto_export_policy" : {
      "events" : [ "NEW", "CHANGED", "DELETED" ]
    }
  }
}

状态码: 404

错误响应

{
  "errCode" : "SFS.TURBO.0126",
  "errMsg" : "target not found, not bound yet"
}

状态码: 500

错误响应

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "internal server error"
}

状态码

状态码

描述

200

成功

404

错误响应

500

错误响应

错误码

请参见错误码

相关文档