PolarDB on ENS クラスターのカスタムクラスターエンドポイントを作成します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
polardb:CreateDBClusterEndpointZonal |
create |
*すべてのリソース。
|
なし | なし |
リクエスト構文
GET HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| DBClusterId |
string |
必須 |
クラスターの ID。 |
pc-*************** |
| EndpointType |
string |
必須 |
カスタムクラスターエンドポイントのタイプ。値を Custom に設定します。 |
Custom |
| Nodes |
string |
任意 |
エンドポイントに追加する読み取りロードノード。複数のノードはコンマ (,) で区切ります。デフォルトでは、すべてのノードが含まれます。 |
pi-**************,pi-************* |
| ReadWriteMode |
string |
任意 |
読み取り/書き込みモード。有効な値:
|
ReadOnly |
| AutoAddNewNodes |
string |
任意 |
新しいノードをこのエンドポイントに自動的に追加するかどうかを指定します。有効な値:
列挙値:
|
Disable |
| EndpointConfig |
string |
任意 |
JSON フォーマットのクラスターエンドポイントの詳細設定。整合性レベル、トランザクション分割、プライマリノードからの読み取りのオフロード、および接続プールの設定を構成できます。
説明
|
{"ConsistLevel": "1","DistributedTransaction": "on"} |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保し、重複送信を防ぐために使用されるクライアントトークン。トークンはクライアントによって生成され、リクエスト間で一意である必要があり、大文字と小文字が区別され、長さは 64 ASCII 文字を超えることはできません。 |
6000170000591aed949d0f****************** |
| DBEndpointDescription |
string |
任意 |
カスタムクラスターエンドポイントの名前。 |
test |
| SccMode |
string |
任意 |
ノードのグローバル整合性 (高性能モード) を有効にするかどうかを指定します。有効な値:
列挙値:
|
on |
| PolarSccWaitTimeout |
string |
任意 |
グローバル整合性のタイムアウト期間。 |
100 |
| PolarSccTimeoutAction |
string |
任意 |
グローバル整合性のタイムアウトポリシー。有効な値:
|
0 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
string |
リクエストの ID。 |
CD35F3-F3-44CA-AFFF-BAF869****** |
例
成功レスポンス
JSONJSON
{
"RequestId": "CD35F3-F3-44CA-AFFF-BAF869******"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | ClusterEndpoint.StatusNotValid | Cluster endpoint status is not valid. | クラスターエンドポイントのステータスが無効です。 |
| 400 | EndpointNum.Error | Endpoint number error. | エンドポイントの数が上限を超えています。 |
| 400 | LockTimeout | The request processing has failed due to lock timeout. | ロックのタイムアウトにより、リクエストの処理に失敗しました。 |
| 403 | OperationDenied.InstanceType | The operation is not permitted due to instance type. | インスタンスタイプにより、この操作は許可されていません。 |
| 404 | EndpointConfig.Invalid | Endpoint config is invalid. | クラスターエンドポイントの詳細設定パラメーターが無効です。 |
| 404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 指定された DBClusterId が現在のレコードに存在しません。 |
| 404 | EndpointConfig.Conflict | Endpoint config is invalid, CausalConsistRead should be session since node SCC mode enabled. | エンドポイントの構成が無効です。ノードに対してグローバル整合性 (高パフォーマンスモード) が有効になっているため、CausalConsistRead はセッションに設定する必要があります。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。