Updated on 2022-08-16 GMT+08:00

Resetting a Password

Function

This API is used to reset the password of cluster administrator.

URI

  • URI format
    POST /v1.0/{project_id}/clusters/{cluster_id}/reset-password
  • Parameter description
    Table 1 URI parameters

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

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

    cluster_id

    Yes

    String

    ID of the cluster whose password is to be reset. For details about how to obtain the ID, see Obtaining the Cluster ID.

Request Message

  • Request example
    POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/reset-password
    {
        "new_password": "NewPassword!"
    }
  • Parameter description
    Table 2 Request parameters

    Parameter

    Mandatory

    Type

    Description

    new_password

    Yes

    String

    New password of the GaussDB(DWS) cluster administrator

    A password must conform to the following rules:

    • Contains 8 to 32 characters.
    • Cannot be the same as the username or the username written in reverse order.
    • Contains at least three types of the following:
      • Lowercase letters
      • Uppercase letters
      • Digits
      • Special characters: ~!?,.:;-_'"(){}[]/<>@#%^&*+|\=
    • Cannot be the same as previous passwords.
    • Cannot be a weak password.

Response Message

Example response

status CODE 200

Status Code

  • Normal

    200

  • Exception
    Table 3 Returned values

    Returned Value

    Description

    400 Bad Request

    Request error.

    401 Unauthorized

    Authorization failed.

    403 Forbidden

    No operation permission.

    404 Not Found

    No resources found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    The service is unavailable.