Help Center/ GaussDB/ API Reference/ APIs (Recommended)/ Parameter Configuration/ Checking Whether the Parameter Template Name Exists
Updated on 2024-08-20 GMT+08:00

Checking Whether the Parameter Template Name Exists

Function

This API is used to check whether the parameter template name exists. Before calling this API:

URI

GET https://{Endpoint}/v3/{project_id}/configurations/name-validation?name={name}

Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Explanation:

Project ID of a tenant in a region.

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

Restrictions:

None

Value range:

The value can contain 32 characters. Only letters and digits are allowed.

Default value:

None

name

Yes

String

Parameter template name. The template name can contain 1 to 64 characters. It can contain only letters (case-sensitive), digits, hyphens (-), underscores (_), and periods (.).

Request Parameters

None

Response Parameters

Table 2 Parameter description

Parameter

Type

Description

exist

Boolean

Verification result.

  • true: The name already exists.
  • false: The name does not exist.

Example Request

Checking whether the parameter template name exists

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/configurations/name-validation?name=paramTemplate-a9f3

Example Response

Check result returned.
{ 
  "exist" : false 
}

Status Code

Error Code

For details, see Error Codes.