Modifique configurações de criptografia SSL de uma instância ApsaraDB RDS - : Central de Documentação do Alibaba Cloud

Esta operação configure a criptografia SSL para uma instância. Para obter mais informações, consulte Secure Sockets Layer.

Nota

Antes de chamar esta operação, verifique se sua instância atende a um dos seguintes critérios:
- Instâncias do ApsaraDB RDS for MySQL que não execute o RDS Basic Edition
- Instâncias do ApsaraDB RDS for SQL Server
- Instâncias do ApsaraDB RDS for PostgreSQL que utilizam SSDs padrão ou SSDs aprimorados (ESSDs)
A criptografia SSL não é suportada nas conexões com o endpoint de divisão de leitura e escrita de uma instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDBInstanceSSL	A operação que você deseja execute. Defina o valor como ModifyDBInstanceSSL.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	O ID da instância.
ConnectionString	String	Sim	rm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com	O endpoint interno ou público para o qual o certificado do servidor precisa ser criado ou atualizado.
SSLEnabled	Integer	Não	1	Especifica se deve ative ou desative a criptografia SSL. Valores válidos: 1: ative a criptografia SSL 0: desative a criptografia SSL
CAType	String	Não	aliyun	O tipo do certificado do servidor. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Se você defina o parâmetro SSLEnabled como 1, o valor padrão deste parâmetro será aliyun. Valores válidos: aliyun: um certificado em nuvem custom: um certificado personalizado
ServerCert	String	Não	-----BEGIN CERTIFICATE-----MIID*****QqEP-----END CERTIFICATE-----	O conteúdo do certificado do servidor. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Caso defina o parâmetro CAType como custom, especifique também este parâmetro.
ServerKey	String	Não	-----BEGIN PRIVATE KEY-----MIIE****ihfg==-----END PRIVATE KEY-----	A chave privada do certificado do servidor. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Caso defina o parâmetro CAType como custom, especifique também este parâmetro.
ClientCAEnabled	Integer	Não	1	Especifica se deve ative a chave pública da CA que emite certificados de cliente. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Valores válidos: 1: ative a chave pública 0: desative a chave pública
ClientCACert	String	Não	-----BEGIN CERTIFICATE-----MIID*****viXk=-----END CERTIFICATE-----	A chave pública da CA que emite certificados de cliente. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Caso defina o parâmetro ClientCAEbabled como 1, especifique também este parâmetro.
ClientCrlEnabled	Integer	Não	1	Especifica se deve ative uma lista de revogação de certificados (CRL) contendo certificados de cliente revogados. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou aprimorados. Além disso, este parâmetro está disponível somente quando a chave pública da CA que emite certificados de cliente estiver ativada. Valores válidos: 1: ative a CRL 0: desative a CRL
ClientCertRevocationList	String	Não	-----BEGIN X509 CRL-----MIIB****19mg==-----END X509 CRL-----	A CRL que contém certificados de cliente revogados. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Caso defina o parâmetro ClientCrlEnabled como 1, especifique também este parâmetro.
ACL	String	Não	cert	O método usado para verifique as identidades dos clientes. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Além disso, este parâmetro está disponível somente quando a chave pública da CA que emite certificados de cliente estiver ativada. Valores válidos: cert perfer verify-ca verify-full (suportado apenas quando a instância execute PostgreSQL 12 ou posterior)
ReplicationACL	String	Não	cert	O método usado para verifique a permissão de replicação. Este parâmetro é suportado apenas quando a instância execute PostgreSQL com SSDs padrão ou ESSDs. Além disso, este parâmetro está disponível somente quando a chave pública da CA que emite certificados de cliente estiver ativada. Valores válidos: cert perfer verify-ca verify-full (suportado apenas quando a instância execute PostgreSQL 12 ou posterior)

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	777C4593-8053-427B-99E2-105593277CAB	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSSL
&ConnectionString=rm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>777C4593-8053-427B-99E2-105593277CAB</RequestId>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "777C4593-8053-427B-99E2-105593277CAB"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidServerCertOrPrivateKey	Specify server certificate or private key is invalid.	A mensagem de erro retornada porque o certificado do servidor ou a chave privada especificada é inválida.
400	InvalidClientCACert	Specify client ca certificate is invalid.	A mensagem de erro retornada porque o valor do parâmetro ClientCACert é inválido.
400	InvalidClientCrl	Specify client certificate revocation list is invalid.	A mensagem de erro retornada porque a CRL especificada é inválida.
400	InvalidCAType.NotFound	Specify ca type is not found.	A mensagem de erro retornada porque o tipo especificado do certificado do servidor é inválido.
400	InvalidACL.NotFound	Specify acl is not found.	A mensagem de erro retornada porque o valor do parâmetro ACL é inválido.
400	InvalidSSLStatus	Specify ssl status is invalid.	A mensagem de erro retornada porque o valor do parâmetro SSLEnabled é inválido.
403	InvalidClientCrl.Permission	Client ca certificate is set first if need to set client certificate revocation list.	A mensagem de erro retornada porque você não tem autorização para execute esta operação. Configure um certificado de CA de cliente antes de execute esta operação.
403	InvalidACL.Permission	Client ca certificate is set first if need to set acl.	A mensagem de erro retornada porque o certificado de CA de cliente não foi especificado.

Para obter uma lista de códigos de erro, visite o Error Center.