# 更新后端存储自动同步策略 - UpdateObsTargetPolicy #### 功能介绍 更新后端存储自动同步策略。 #### 接口约束 - 该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统。 - 该接口仅适用于NFS文件系统共享协议。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=UpdateObsTargetPolicy)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。 #### 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 | 后端存储自动同步策略 | 表4ObsDataRepositoryPolicy | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | auto_export_policy | 否 | [AutoExportPolicy] object | 后端存储自动导出策略。当文件系统发生数据更新时，将自动导出到OBS桶。 | 表5AutoExportPolicy | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | events | 否 | Array of strings | 后端存储自动导出到OBS桶的数据更新类型。 - NEW：表示新增数据，SFS Turbo联动目录下创建的文件，及之后对这些文件进行的元数据和数据修改，会被自动同步到OBS桶里。 - CHANGED：表示修改数据，从OBS桶里导入到SFS Turbo联动目录下的文件，在SFS Turbo上对这些文件所进行的数据和元数据的修改，会被自动同步到OBS桶里。 - DELETED：表示删除数据，在SFS Turbo联动目录下删除文件，OBS桶对应的对象也会被删除，只有被SFS Turbo写入的OBS对象才会被删除。 枚举值： - **NEW** - **CHANGED** - **DELETED** | | prefix | 否 | String | 后端存储内对象匹配前缀 | | suffix | 否 | String | 后端存储内对象匹配后缀 | #### 响应参数 **状态码：200** 表6响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-request-id | String | 请求ID | 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | target_id | String | 绑定关系ID | | policy | [ObsDataRepositoryPolicy] object | 后端存储自动同步策略 | 表8ObsDataRepositoryPolicy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | auto_export_policy | [AutoExportPolicy] object | 后端存储自动导出策略。当文件系统发生数据更新时，将自动导出到OBS桶。 | 表9AutoExportPolicy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | events | Array of strings | 后端存储自动导出到OBS桶的数据更新类型。 - NEW：表示新增数据，SFS Turbo联动目录下创建的文件，及之后对这些文件进行的元数据和数据修改，会被自动同步到OBS桶里。 - CHANGED：表示修改数据，从OBS桶里导入到SFS Turbo联动目录下的文件，在SFS Turbo上对这些文件所进行的数据和元数据的修改，会被自动同步到OBS桶里。 - DELETED：表示删除数据，在SFS Turbo联动目录下删除文件，OBS桶对应的对象也会被删除，只有被SFS Turbo写入的OBS对象才会被删除。 枚举值： - **NEW** - **CHANGED** - **DELETED** | | prefix | String | 后端存储内对象匹配前缀 | | suffix | String | 后端存储内对象匹配后缀 | **状态码：404** 表10响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-request-id | String | 请求ID | 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 错误码 | | errMsg | String | 错误描述 | **状态码：500** 表12响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-request-id | String | 请求ID | 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 错误码 | | errMsg | String | 错误描述 | #### 请求示例 文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"，后端target_id为"11abef67-7ac4-0f46-644d-1d5cfc2424a4"，更新后端存储自动同步策略 ``` PUT HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/targets/11abef67-7ac4-0f46-644d-1d5cfc2424a4/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 | 错误响应 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。