All Products
Search
Document Center

PolarDB:DescribeCharacterSetName

Last Updated:Dec 15, 2025

Queries the character sets supported by PolarDB for MySQL.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

Note

Call the DescribeRegions operation to query available regions.

cn-hangzhou

DBClusterId

string

No

The cluster ID.

Note

This operation supports only PolarDB for MySQL clusters. If you specify the ID of a PolarDB for PostgreSQL cluster or a PolarDB for PostgreSQL (Oracle-compatible) cluster, CharacterSetNameItems returns an empty value.

pc-****************

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

34458CD3-33E0-4624-BFEF-840C15******

CharacterSetNameItems

object

CharacterSetName

array

A list of supported character sets.

string

{ "CharacterSetName": [ "utf8mb4", "utf8", "utf32", "utf16le", "utf16", "ujis", "ucs2", "tis620", "swe7", "sjis", "macroman", "macce", "latin7", "latin5", "latin2", "latin1", "koi8u", "koi8r", "keybcs2", "hp8", "hebrew", "greek", "geostd8", "gbk", "gb2312", "euckr", "eucjpms", "dec8", "cp932", "cp866", "cp852", "cp850", "cp1257", "cp1256", "cp1251", "cp1250", "binary", "big5", "ascii", "armscii8" ] }

Engine

string

The database engine of the cluster.

POLARDB

Examples

Success response

JSON format

{
  "RequestId": "34458CD3-33E0-4624-BFEF-840C15******",
  "CharacterSetNameItems": {
    "CharacterSetName": [
      "{ \"CharacterSetName\": [       \"utf8mb4\",       \"utf8\",       \"utf32\",       \"utf16le\",       \"utf16\",       \"ujis\",       \"ucs2\",       \"tis620\",       \"swe7\",       \"sjis\",       \"macroman\",       \"macce\",       \"latin7\",       \"latin5\",       \"latin2\",       \"latin1\",       \"koi8u\",       \"koi8r\",       \"keybcs2\",       \"hp8\",       \"hebrew\",       \"greek\",       \"geostd8\",       \"gbk\",       \"gb2312\",       \"euckr\",       \"eucjpms\",       \"dec8\",       \"cp932\",       \"cp866\",       \"cp852\",       \"cp850\",       \"cp1257\",       \"cp1256\",       \"cp1251\",       \"cp1250\",       \"binary\",       \"big5\",       \"ascii\",       \"armscii8\" ]  }"
    ]
  },
  "Engine": "POLARDB"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidRegionId.Malformed The specified parameter RegionId is not valid. The specified RegionId parameter is invalid.
404 InvalidDBClusterId.NotFound The DBInstanceId provided does not exist in our records. The specified DBClusterId parameter does not exist in the current record.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.