Updated on 2025-12-09 GMT+08:00

Querying Distributors

Function

This API is used to query the distributors configured for a DB instance.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.
  • If you are using role/policy-based authorization, see Permissions and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

rds:instance:update

write

-

-

rds:instance:modify

-

URI

  • URI format

    GET /v3/{project_id}/instances/{instance_id}/replication/distribution

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Definition

    Project ID of a tenant in a region.

    To obtain the value, see Obtaining a Project ID.

    Constraints

    The value cannot be empty.

    Range

    N/A

    Default Value

    N/A

    instance_id

    Yes

    Definition

    Instance ID.

    Constraints

    The value cannot be empty.

    Range

    N/A

    Default Value

    N/A

Request

  • Request parameters

    None

  • URI example

    GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/72ee4cc4607347049df9ad50f615bbd8in04/replication/distribution

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    status

    String

    Definition

    Status.

    Range

    • normal
    • abnormal
    • creating
    • createfail

    distributor_instance_id

    String

    Definition

    Distributor instance ID.

    Range

    N/A

    distributor_instance_name

    String

    Definition

    Distributor instance name.

    Range

    N/A

  • Example normal response
    {
        "status": "normal",
        "distributor_instance_id": "e3a974cb31da44d8a67b14a598930c27in04",
        "distributor_instance_name": "rds-9f12-1"
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.