Queries character sets that ApsaraDB PolarDB MySQL-compatible edition databases 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 No DescribeCharacterSetName

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

RegionId String Yes cn-hangzhou

The ID of the region.

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

The ID of the cluster.

Note You can only query character sets that ApsaraDB PolarDB MySQL-compatible edition clusters support. If you enter the ID of a ApsaraDB PolarDB PostgreSQL-compatible edition or ApsaraDB PolarDB O Edition cluster, the returned value of CharacterSetNameItems is an empty string.

Response parameters

Parameter Type Example Description
CharacterSetNameItems List "CharacterSetName": [ "utf8mb4", "utf8", "armscii8" ]

The character sets that ApsaraDB PolarDB MySQL-compatible edition databases support.

Engine String POLARDB

The engine of the cluster.

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

The ID of the request.

Examples

Sample requests

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

Sample success responses

XML format

<DescribeCharacterSetNameResponse>
  <RequestId>34458CD3-33E0-4624-BFEF-840C15******</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

{
  "RequestId": "34458CD3-33E0-4624-BFEF-840C15******",
  "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.