Help Center> Relational Database Service> API Reference> API v3 (Recommended)> Database Security> Changing a Database Port
View PDF

Changing a Database Port

Function

This API is used to change a database port.

Constraints

The database port cannot be changed when a DB instance is being created or rebooted, its specifications are being modified, database users are being created or deleted, or backups are being created for the DB instance.

URI

  • URI format

    PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/port

  • Example

    https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/port

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    For details about how to obtain the project ID, see Obtaining a Project ID.

    instance_id

    Yes

    Specifies the DB instance ID.

Request

  • Parameter description
    Table 2 Parameter description

    Name

    Mandatory

    Type

    Description

    port

    Yes

    Integer

    Specifies the port number.

    The MySQL port number ranges from 1024 to 65535, excluding 12017 and 33071.
  • Request example 
    {
     "port": 8836
}

Response

  • Normal response

    Name

    Description

    workflowId

    Indicates the task ID.
  • Example normal response 
    {
    "workflowId":"83abc7bc-2c70-4534-8565-351187b37715"
}
  • Abnormal response

    For details, see Abnormal Request Results.

Parent topic: Database Security