Modify the Properties of a Direct Connect Gateway

Last updated: 2020-06-04 18:10:11

    Note:

    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new VPC API 3.0 which is standardized and faster.

    1. API Description

    This API (ModifyDirectConnectGateway) is used to modify the attributes of direct connect gateways.
    Domain name for API requests: vpc.api.qcloud.com

    Currently, only changing the name in the attributes of a direct connect gateway is supported.

    2. Input Parameters

    The list below contains only the API request parameters. The common request parameters need to be added when a call is made. For more information, see the Common Request Parameters page. The Action field for this API is ModifyDirectConnectGateway.

    Parameter name Required Type Description
    vpcId Yes String VPC ID assigned by the system, for example: vpc-7t9nf3pu.
    directConnectGatewayId Yes String Direct connect gateway ID assigned by the system, for example: dcg-7t9nf3pu.
    directConnectGatewayName Yes String Direct connect gateway name, which must be a combination of 1-25 uppercase and lowercase letters, numbers, and underscores.

    3. Output Parameters

    Parameter name Type Description
    code Int Error code. 0: Successful; other values: Failed.
    message String Error message
    taskId Int Task ID. You can query the execution result by using the taskId. For more information, see the API for Querying Task Execution Results.

    4. Error Codes

    The following error codes only include business logic error codes for this API. For additional common error codes, see VPC Error Codes.

    Error code Description
    InvalidDirectConnectGatewayName Invalid direct connect gateway name. A valid name should be a combination of 1-60 uppercase and lowercase letters, numbers, and underscores.
    InvalidVpc.NotFound Invalid VPC. This error code indicates that the VPC resource does not exist. In this case, verify whether the resource information that you entered is correct.
    InvalidDirectConnectGateway.NotFound Invalid direct connect gateway. This error code indicates that the direct connect gateway does not exist. In this case, verify whether the resource information that you entered is correct.

    5. Example

    Input

    https://vpc.api.qcloud.com/v2/index.php?Action=ModifyDirectConnectGateway
    &<Common Request Parameters>
    &vpcId=vpc-dfgg190
    &directConnectGatewayId=dcg-ddf14d
    &directConnectGatewayName=Direct connect gateway 1
    

    Output

    {
        "code":"0",
        "message":"",
        "taskId":16284
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help