このトピックでは、PolarDB-Xでサポートされているリクエスト構造について説明します。 リクエストには、PolarDB-X APIのエンドポイントと、APIリクエストの送信に使用できる構文とプロトコルが含まれます。
エンドポイント
次の表に、PolarDB-X APIのエンドポイントを示します。
| リージョン | Endpoint |
| 中国 (杭州) | polardbx.cn-hangzhou.aliyuncs.com |
| 中国 (北京) | polardbx.cn-beijing.aliyuncs.com |
プロトコル
HTTP または HTTPS プロトコルでリクエストを送信できます。 データの安全性を確保するために、HTTPS経由でリクエストを送信することを推奨します。
リクエスト構文
HTTP GETリクエストを送信することで、PolarDB-X API操作を呼び出すことができます。 HTTP GETリクエストを送信するには、次のリクエストURLにリクエストパラメーターを含めます。
http:// Endpoint/?Action=xx&Parameters説明
- Endpoint: PolarDB-X APIのエンドポイント。 詳細については、「エンドポイント」をご参照ください。
- Action: 呼び出す操作の名前。 たとえば、PolarDB-Xデータベースに作成されたテーブルをクエリする場合は、ActionパラメーターをDescribeTablesに設定する必要があります。
- Version: PolarDB-X APIのバージョン。 値を2020-02-02に設定します。
- Parameters：API のリクエストパラメーターを設定します。 アンパーサンド (&) を使用して複数のパラメーターを区切ります。
リクエストパラメーターは、共通パラメーターと API 固有のパラメーターで構成されます。 共通パラメータには、APIバージョンと認証情報が含まれます。 詳細は、共通パラメータを参照してください。
リクエストパラメーター
呼び出すAPI操作に基づいてActionパラメーターを設定する必要があります。 たとえば、ActionをCreateDatabaseに設定します。 また、操作を呼び出すために必要な他の共通リクエストパラメーターと操作固有のリクエストパラメーターも設定する必要があります。
文字エンコーディング
要求および応答は、UTF-8で符号化される。