跳转到内容
API 参考
/
/
重试与完成矩阵
Last updated

Cloud Storage 重试与完成矩阵

Cloud Storage 共 24 个操作的重试、幂等与完成策略，其中 12 个记录了端点专属的业务错误码。

对于会改变状态的操作，HTTP 超时意味着结果未知，并不等于操作失败。重试前请先查询当前状态。

策略定义与其他产品见端点重试矩阵，机器可读版本见操作行为清单。

Cloud Storage Local API

操作重试策略幂等性完成 / 恢复
GET /api/cloudstorage/info
queryCloudStorageInfoLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39001。
POST /api/cloudstorage/file/page
pageCloudStorageFilesLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudstorage/upload/init
batchRequestCloudStoragePresignedUploadUrlsLocal		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。把每个对象上传到它的预签名 URL，然后调用 POST /cloudstorage/upload/complete。 已记录的业务错误码：39001, 39037, 39044, 39045, 39047, 39050, 39051。
POST /api/cloudstorage/upload/complete
confirmCloudStorageUploadCompleteLocal		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39001, 39011, 39014, 39041, 39046, 39047。
POST /api/cloudstorage/file/delete/batch
batchDeleteCloudStorageFilesLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011。
POST /api/cloudstorage/file/tag/set
setCloudStorageFileTagsLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011, 39048, 39049。
POST /api/cloudstorage/file/tag/add
addCloudStorageFileTagsLocal		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011, 39048, 39049。
POST /api/cloudstorage/file/tag/query
queryCloudStorageFileTagsLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
GET /api/cloudstorage/tag/all
queryAllCloudStorageFileTagsLocal		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudstorage/tag/create
createCloudStorageFileTagLocal		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudstorage/tag/edit
editCloudStorageFileTagLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /api/cloudstorage/tag/delete/batch
deleteCloudStorageFileTagsLocal		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。

Cloud Storage Open API

操作重试策略幂等性完成 / 恢复
GET /cloudstorage/info
queryCloudStorageInfo		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39001。
POST /cloudstorage/file/page
pageCloudStorageFiles		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudstorage/upload/init
batchRequestCloudStoragePresignedUploadUrls		除非端点专属文档说明安全，否则不要自动重试。未记录任何公开的幂等保证。把每个对象上传到它的预签名 URL，然后调用 POST /cloudstorage/upload/complete。 已记录的业务错误码：39001, 39037, 39044, 39045, 39047, 39050, 39051。
POST /cloudstorage/upload/complete
confirmCloudStorageUploadComplete		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39001, 39011, 39014, 39041, 39046, 39047。
POST /cloudstorage/file/delete/batch
batchDeleteCloudStorageFiles		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011。
POST /cloudstorage/file/tag/set
setCloudStorageFileTags		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011, 39048, 39049。
POST /cloudstorage/file/tag/add
addCloudStorageFileTags		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 已记录的业务错误码：39011, 39048, 39049。
POST /cloudstorage/file/tag/query
queryCloudStorageFileTags		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
GET /cloudstorage/tag/all
queryAllCloudStorageFileTags		可带上限的指数退避与抖动安全重试。只读；重复请求不应改变资源状态。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudstorage/tag/create
createCloudStorageFileTag		不要自动重试；先查询资源、上传或任务是否已创建。未记录任何公开的幂等键契约。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudstorage/tag/edit
editCloudStorageFileTag		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。
POST /cloudstorage/tag/delete/batch
deleteCloudStorageFileTags		超时或传输失败后，先查询当前状态再重试。结果可能已经生效；重复执行在契约上不保证幂等。响应是唯一已记录的完成信号；未定义异步契约。 未记录端点专属的业务错误；请使用通用错误契约。

删除云存储文件标签

Overview