调用UpdateVpcGatewayEndpointAttribute接口修改网关终端节点的配置信息。
接口说明
-
UpdateVpcGatewayEndpointAttribute 接口属于异步接口,即系统会先返回一个 RequestId,但该网关终端节点的配置信息并未修改完成,系统后台的修改任务仍在进行。您可以调用 GetVpcGatewayEndpointAttribute 查询网关终端节点的状态。
-
当网关终端节点处于 Updating 状态时,表示正在修改中。
-
当网关终端节点处于 Created 状态时,表示修改完成。
-
-
UpdateVpcGatewayEndpointAttribute 接口不支持并发修改同一个网关终端节点。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EndpointId |
string |
是 |
需要修改信息的网关终端节点的实例 ID。 |
vpce-bp1w1dmdqjpwul0v3**** |
| EndpointName |
string |
否 |
网关终端节点需要被修改的名称。 名称的长度在 1~128 个字符之间。 |
update |
| EndpointDescription |
string |
否 |
网关终端节点需要被修改的描述信息。 描述信息的长度在 1~255 个字符之间。 |
updateendpoint |
| PolicyDocument |
string |
否 |
云服务的访问策略。 关于访问策略的语法和结构,请参见权限策略语法和结构。 |
{ "Version" : "1", "Statement" : [ { "Effect" : "Allow", "Resource" : [ "*" ], "Action" : [ "*" ], "Principal" : [ "*" ] } ] } |
| ClientToken |
string |
否 |
客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。 |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
| DryRun |
boolean |
否 |
是否只预检此次请求,取值:
|
false |
| RegionId |
string |
是 |
需要修改信息的网关终端节点所在的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回信息。 |
||
| RequestId |
string |
请求 ID。 |
E9654534-5A38-5545-813F-0403D49042FB |
示例
正常返回示例
JSON格式
{
"RequestId": "E9654534-5A38-5545-813F-0403D49042FB"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | OperationFailed.ConcurrentOperation | The operation is failed because of concurrent operation. | |
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | |
| 400 | ResourceNotFound.GatewayEndpoint | The specified resource gateway endpoint is not found. | 指定的GatewayEndpoint不存在 |
| 400 | IllegalParam.PolicyDocument | The param of PolicyDocument is illegal. | |
| 400 | IllegalParam.GatewayEndpointName | The param of GatewayEndpointName is illegal. | |
| 400 | IllegalParam.GatewayEndpointDescription | The param of GatewayEndpointDescription is illegal. | |
| 400 | SystemBusy | System is busy, please try again later. | |
| 400 | Forbbiden | User not authorized to operate on the specified resource. | |
| 400 | InvalidRegionId.NotFound | The regionId provided does not exist in our records. | 指定的RegionId不存在。请检查该参数是否正确。 |
| 400 | OperationDenied.PolicyDocument | The gatewayEndpoint does not support policy. | |
| 400 | IncorrectStatus.GatewayEndpoint | The status of GatewayEndpoint [%s] is incorrect. | |
| 400 | InvalidPolicy.WrongFormat | Invalid input policy format. | 输入策略信息格式错误。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。