Chame a operação ModifyDBInstanceConnectionString para alterar o endpoint e o número da porta de uma instância do ApsaraDB RDS.
O ApsaraDB RDS fornece endpoints internos e públicos. Ele também permite acesso híbrido usando simultaneamente um endpoint de VPC e um endpoint de rede clássica.
Só é possível alterar o prefixo de um endpoint.
O endpoint de divisão de leitura/gravação não pode ser alterado.
Depuração
Parâmetros de requisição
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | ModifyDBInstanceConnectionString | A operação a ser executada. Defina o valor como ModifyDBInstanceConnectionString. |
| DBInstanceId | String | Yes | rm-uf6wjk5**** | O ID da instância. |
| CurrentConnectionString | String | Yes | rm-uf6wjk5x****.mysql.rds.aliyuncs.com | O endpoint da instância. Pode ser um endpoint interno, um endpoint público ou um endpoint de rede clássica no modo de acesso híbrido. Nota O endpoint de divisão de leitura/gravação não pode ser alterado. |
| ConnectionStringPrefix | String | Yes | rm-**** | O prefixo do endpoint após a alteração. Somente o prefixo do valor do parâmetro CurrentConnectionString pode ser modificado. Nota O valor deve ter entre 8 e 64 caracteres e pode conter letras, dígitos e hifens (-). Não são permitidos os seguintes caracteres: ~ ! # % ^ & * = + \ | {} ; : ' " , <> / ? |
| Port | String | Yes | 3306 | O número da porta após a alteração. |
| BabelfishPort | String | No | 1433 | A porta TDS da instância para a qual o Babelfish está ativado. Nota Este parâmetro se aplica apenas a instâncias do ApsaraDB RDS for PostgreSQL. Para mais informações sobre o Babelfish para ApsaraDB RDS for PostgreSQL, consulte Introdução ao Babelfish. |
| GeneralGroupName | String | No | rgc-bp1tkv8**** | O nome do cluster dedicado ao qual a instância pertence. Este parâmetro só tem efeito quando a instância executa MySQL na RDS Standard Edition e foi criada em um cluster dedicado. |
Parâmetros de resposta
|
Parameter |
Type |
Example |
Description |
|
RequestId |
String |
65BDA532-28AF-4122-AA39-B382721EEE64 |
O ID da requisição. |
Exemplos
Exemplos de requisição
http(s)://[Endpoint]/?Action=ModifyDBInstanceConnectionString
&DBInstanceId=rm-uf6wjk5****
&CurrentConnectionString=rm-uf6wjk5x****.mysql.rds.aliyuncs.com
&ConnectionStringPrefix=rm-****
&Port=3306
&GeneralGroupName=rgc-bp1tkv8****
&<Common request parameters>Exemplos de respostas bem-sucedidas
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDBInstanceConnectionStringResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
</ModifyDBInstanceConnectionStringResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : " 65BDA532-28AF-4122-AA39-B382721EEE64"
}Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
|
400 |
DnsConflict |
Dns is conflict with other custins. |
O DNS está em conflito com outros clientes. |
|
|
400 |
InvalidConnectionString.Malformed |
The specified parameter "ConnectionStringPrefix" is not valid. |
O formato do endpoint é inválido. Especifique um valor válido com entre 8 e 64 caracteres, contendo letras, dígitos e hifens (-). Não são permitidos os seguintes caracteres: ~ ! # % ^ & * = + \ |
{} ; : ' " , <> / ? |
|
400 |
OperationDenied.DBInstanceStatus |
The operation is not permitted due to status of instance. |
A operação não é permitida porque a instância está em um estado incompatível. |
|
|
400 |
InvalidConnectionString.NotFound |
The specified connection string or network type is not found. |
O endpoint especificado não foi encontrado. Verifique se o endpoint informado é válido. |
|
|
400 |
InvalidConnectionString.Duplicate |
The specified connection string needs to be same as current network type. |
O endpoint ou a porta deve ser igual ao da instância do tipo de rede atual. |
|
|
400 |
MissingConnectionString |
The request is missing a ConnectionString parameter. |
A requisição não contém o endpoint de rede clássica cujo prazo de validade você deseja estender. |
|
|
400 |
OtherEndpoint.Exist |
Other endpoint exist. |
O prefixo do endpoint público especificado já existe. |
Para consultar a lista de códigos de erro, acesse o API Error Center.