在创建极速同步组前,您可以调用ValidateExpressSyncConfig验证极速同步组配置信息是否正确。如果配置信息有误,接口返回配置错误信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ValidateExpressSyncConfig

系统规定参数。取值:ValidateExpressSyncConfig。

BucketName String alex***

Bucket 名称。

BucketRegion String cn-hangzhou

Bucket 所在地域。

Name String sync***

极速同步组名称。

BucketPrefix String test***

Bucket 子目录。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。状态码为200表示请求成功。

IsValid Boolean false

是否验证成功。

Message String successful

请求结果描述。

RequestId String 943856D2-814B-487A-B645-D5F9CCA15929

请求ID。

Success Boolean true

请求是否成功。

ValidateMessage String ConflictExpressSyncConfig

验证失败信息。可能值:

  • 如果isValid为false,返回验证失败信息。
  • 如果isValid为true,返回空。

示例

请求示例

http(s)://[Endpoint]/?Action=ValidateExpressSyncConfig
&BucketName=alex***
&BucketRegion=cn-hangzhou
&Name=sync***
&<公共请求参数>

正常返回示例

XML 格式

<ValidateExpressSyncConfigResponse>
      <Message>successful</Message>
      <RequestId>943856D2-814B-487A-B645-D5F9CCA15929</RequestId>
      <ValidateMessage>ConflictExpressSyncConfig</ValidateMessage>
      <Code>200</Code>
      <Success>true</Success>
      <IsValid>false</IsValid>
</ValidateExpressSyncConfigResponse>

JSON 格式

{
    "Message":"successful",
    "RequestId":"943856D2-814B-487A-B645-D5F9CCA15929",
    "ValidateMessage":"ConflictExpressSyncConfig",
    "Code":"200",
    "Success":true,
    "IsValid":false
}

错误码

HttpCode 错误码 错误信息 描述
400 EmptyExpressSyncName You must enter a valid name for the sync group. 同步组名称不能为空。
400 EmptyBucketName You must enter a valid name for the bucket. Bucket名称不能为空。
400 EmptyBucketRegion You must specify a valid region for the bucket. OSS Bucket区域不能为空。
400 InvalidExpressSyncName The specified name for the sync group is invalid. The name must be 1 to 128 characters in length and can contain letters, digits, periods (.), underscores (_), and hyphens (-). The name must start with a letter. 无效的同步组名称,同步组名称长度限制为1~128个字符,可以包含大小写字母,中文,数字,".","_"或"-",同时必须以大小写字母或者中文开头。
400 DuplicateExpressSyncName The specified name of the sync group already exists. Try again later after you specify a valid parameter. 同步组名称已存在,请确认参数后重试。
400 ConflictExpressSyncConfig The parameter you specified for the sync group is invalid. Try again later after you specify a valid parameter. 极速同步组配置信息冲突,请检查参数后重试。
400 InvalidRegionId The specified RegionId does not exist. You must specify a valid RegionId. 指定的RegionId不存在,请您确认该参数是否正确。
400 InvalidBucketName The specified bucket name is invalid. You must enter a valid bucket name. 无效的Bucket名称,请检查参数后重试。

访问错误中心查看更多错误码。