ModifyDBInstanceConnectionString操作を呼び出して、ApsaraDB RDSインスタンスのエンドポイントとポート番号を変更できます。
ApsaraDB RDSは、内部およびパブリックエンドポイントを提供します。 ApsaraDB RDSでは、Virtual Private Cloud (VPC) エンドポイントとクラシックネットワークエンドポイントの両方を使用したハイブリッドアクセスも許可されています。
説明
- 変更できるのは、エンドポイントのプレフィックスのみです。
- 読み書き分離エンドポイントは変更できません。
デバッグ
リクエストパラメーター
| 項目 | データ型 | 必須／任意 | 例: | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | ModifyDBInstanceConnectionString | 実行する操作です。 値をModifyDBInstanceConnectionStringに設定します。 |
| DBInstanceId | String | 必須 | rm-uf6wjk5 **** | インスタンスの ID です。 |
| CurrentConnectionString | String | 必須 | rm-uf6wjk5x **** .mysql.rds.aliyuncs.com | インスタンスのエンドポイント。 内部エンドポイント、パブリックエンドポイント、またはハイブリッドアクセスモードのクラシックネットワークエンドポイントにすることができます。 説明 読み書き分離エンドポイントは変更できません。 |
| ConnectionStringPrefix | String | 必須 | rm-**** | 変更後のエンドポイントのプレフィックス。 CurrentConnectionStringパラメーターの値のプレフィックスのみを変更できます。 説明 値の長さは8 ~ 64文字で、英数字、ハイフン (-) を使用できます。 値に次の文字を含めることはできません。~! # % ^ & * = + \ | {} ; : '" , <> / ? |
| ポート | String | 必須 | 3306 | 変更後のポート番号。 |
| BabelfishPort | String | 任意 | 1433 | Babelfishが有効になっているインスタンスのTDSポート。 説明 このパラメーターは、ApsaraDB RDS for PostgreSQLインスタンスにのみ適用されます。 Babelfish For ApsaraDB RDS for PostgreSQLの詳細については、「Babelfishの紹介」をご参照ください。 |
| GeneralGroupName | String | 任意 | rgc-bp1tkv8 **** | インスタンスが属する専用クラスターの名前。 このパラメーターは、インスタンスがRDS Standard EditionでMySQLを実行し、専用クラスターで作成された場合にのみ有効になります。 |
レスポンスパラメーター
| 項目 | データ型 | 例: | 説明 |
|---|---|---|---|
| RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 | リクエストの ID です。 |
例
リクエストの例
http(s)://[Endpoint]/?Action=ModifyDBInstanceConnectionString
&DBInstanceId=rm-uf6wjk5 ****
&CurrentConnectionString=rm-uf6wjk5x **** .mysql.rds.aliyuncs.com
&ConnectionStringPrefix=rm-****
&ポート=3306
&GeneralGroupName=rgc-bp1tkv8 ****
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDBInstanceConnectionStringResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
</ModifyDBInstanceConnectionStringResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "65BDA532-28AF-4122-AA39-B382721EEE64"
}エラーコード
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 400 | DnsConflict | Dnsは他のカスティンと競合しています。 | DNSサーバーが他のクライアントと競合している場合に返されるエラーメッセージ。 |
| 400 | InvalidConnectionString.Malformed | 指定されたパラメーター "ConnectionStringPrefix" は無効です。 | エンドポイントの形式が無効な場合に返されるエラーメッセージ。 有効な値を指定する必要があります。 値の長さは8 ~ 64文字で、英数字、ハイフン (-) を使用できます。 値に次の文字を含めることはできません。~! # % ^ & * = + \ | {} ; : '" , <> / ? |
| 400 | OperationDenied.DBInstanceStatus | インスタンスの状態が原因で操作が許可されていません。 | インスタンスが現在の状態の場合、操作がサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidConnectionString.NotFound | 指定された接続文字列またはネットワークタイプが見つかりません。 | 指定したエンドポイントが見つからない場合に返されるエラーメッセージ。 指定されたエンドポイントが有効かどうかを確認する必要があります。 |
| 400 | InvalidConnectionString.Duplicate | 指定された接続文字列は、現在のネットワークタイプと同じである必要があります。 | エンドポイントまたはポートが現在のネットワークタイプのインスタンスと同じである必要がある場合に返されるエラーメッセージ。 |
| 400 | MissingConnectionString | リクエストにConnectionStringパラメーターがありません。 | 有効期間を延長するクラシックネットワークエンドポイントがリクエストに含まれていない場合に返されるエラーメッセージ。 |
| 400 | OtherEndpoint. 存在する | 他のエンドポイントが存在します。 | 指定されたパブリックエンドポイントのプレフィックスが既に存在する場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。