调用ValidateGatewayName可以校验所在的网关集群中网关名称是否重名。

调试

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

请求参数

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

系统规定参数。取值：ValidateGatewayName。
Name String 是 alex***

网关名称。网关名称长度限制1~60个字符，可以包含大小写字母，中文，数字，"."，"_"或"-"，同时必须以大小写字母或者中文开头。
StorageBundleId String 是 sb-0001b2otnkdxrigeq***

网关集群ID。

返回数据

名称 类型 示例值 描述
RequestId String CB300009-3850-4107-B291-59BDB4EDA183

请求ID。
Success Boolean true

请求是否成功。
Code String 200

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

请求结果描述。
IsValid Boolean true

网关名称是否重名。可能值：

  • true：所属网关集群中网关名称不存在。
  • false：所属网关集群中网关名称已存在。

示例

请求示例

http(s)://[Endpoint]/?Action=ValidateGatewayName
&Name=alex***
&StorageBundleId=sb-0001b2otnkdxrigeq***
&<公共请求参数>

正常返回示例

XML 格式 

<ValidateGatewayNameResponse>
  <IsValid>true</IsValid>
  <Message>successful</Message>
  <RequestId>CB300009-3850-4107-B291-59BDB4EDA183</RequestId>
  <Code>200</Code>
  <Success>true</Success>
</ValidateGatewayNameResponse>

JSON 格式 

{
    "IsValid":"true",
    "Message":"successful",
    "RequestId":"CB300009-3850-4107-B291-59BDB4EDA183",
    "Code":"200",
    "Success":true
}

错误码

HttpCode 错误码 错误信息 描述
400 EmptyStorageBundleId You must enter a valid ID for the gateway cluster. 网关集群ID不能为空。
400 EmptyGatewayName You must enter a valid name for the gateway. 网关名称不能为空。
400 InvalidGatewayName The specified name of the gateway is invalid. The name must be 1 to 60 characters in length and can contain letters, digits, periods (.), underscores (_), and hyphens (-). The name must start with a letter. 无效的网关名称，网关名称长度限制1~60个字符，可以包含大小写字母，中文，数字，"."，"_"或"-"，同时必须以大小写字母或者中文开头。
404 StorageBundleNotExist The name you specified for the gateway cluster does not exist. You must specify a valid parameter. 网关集群不存在，请确认输入参数是否正确。

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