Queries character sets that PolarDB for MySQL clusters support.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeCharacterSetName

The operation that you want to perform. Set the value to DescribeCharacterSetName.

RegionId String Yes cn-hangzhou

The region ID of the cluster.

Note You can call the DescribeRegions operation to query available regions.
DBClusterId String No pc-****************

The ID of the cluster.

Note You can only query character sets that PolarDB for MySQL clusters support. If you enter the ID of a PolarDB for PostgreSQL or PolarDB for Oracle cluster, the returned value of CharacterSetNameItems is an empty string.

Response parameters

Parameter Type Example Description
RequestId String 34458CD3-33E0-4624-BFEF-840C15******

The ID of the request.

CharacterSetNameItems Array of 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" ] }

The character sets that are supported.

Engine String POLARDB

The cluster engine.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/?Action=DescribeCharacterSetName
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeCharacterSetNameResponse>
    <RequestId>97942193-2BB9-1FCF-8477-D4632BD166A7</RequestId>
    <CharacterSetNameItems>
        <CharacterSetName>utf8mb4</CharacterSetName>
        <CharacterSetName>utf8</CharacterSetName>
        <CharacterSetName>utf32</CharacterSetName>
        <CharacterSetName>utf16le</CharacterSetName>
        <CharacterSetName>utf16</CharacterSetName>
        <CharacterSetName>ujis</CharacterSetName>
        <CharacterSetName>ucs2</CharacterSetName>
        <CharacterSetName>tis620</CharacterSetName>
        <CharacterSetName>swe7</CharacterSetName>
        <CharacterSetName>sjis</CharacterSetName>
        <CharacterSetName>macroman</CharacterSetName>
        <CharacterSetName>macce</CharacterSetName>
        <CharacterSetName>latin7</CharacterSetName>
        <CharacterSetName>latin5</CharacterSetName>
        <CharacterSetName>latin2</CharacterSetName>
        <CharacterSetName>latin1</CharacterSetName>
        <CharacterSetName>koi8u</CharacterSetName>
        <CharacterSetName>koi8r</CharacterSetName>
        <CharacterSetName>keybcs2</CharacterSetName>
        <CharacterSetName>hp8</CharacterSetName>
        <CharacterSetName>hebrew</CharacterSetName>
        <CharacterSetName>greek</CharacterSetName>
        <CharacterSetName>geostd8</CharacterSetName>
        <CharacterSetName>gbk</CharacterSetName>
        <CharacterSetName>gb2312</CharacterSetName>
        <CharacterSetName>euckr</CharacterSetName>
        <CharacterSetName>eucjpms</CharacterSetName>
        <CharacterSetName>dec8</CharacterSetName>
        <CharacterSetName>cp932</CharacterSetName>
        <CharacterSetName>cp866</CharacterSetName>
        <CharacterSetName>cp852</CharacterSetName>
        <CharacterSetName>cp850</CharacterSetName>
        <CharacterSetName>cp1257</CharacterSetName>
        <CharacterSetName>cp1256</CharacterSetName>
        <CharacterSetName>cp1251</CharacterSetName>
        <CharacterSetName>cp1250</CharacterSetName>
        <CharacterSetName>binary</CharacterSetName>
        <CharacterSetName>big5</CharacterSetName>
        <CharacterSetName>ascii</CharacterSetName>
        <CharacterSetName>armscii8</CharacterSetName>
    </CharacterSetNameItems>
    <Engine>POLARDB</Engine>
</DescribeCharacterSetNameResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "97942193-2BB9-1FCF-8477-D4632BD166A7",
  "CharacterSetNameItems" : {
    "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

For a list of error codes, visit the API Error Center.