AllocateDirectConnection - Tair (Redis® OSS-Compatible): Central de Documentação do Alibaba Cloud

Solicita um endpoint de conexão direta para uma instância de cluster de banco de dados ApsaraDB Tair (compatível com Redis® OSS).

Descrição da operação

Os clientes podem usar o endpoint de conexão direta para ignorar o proxy e conectar-se à instância de cluster da mesma forma que se conectam a um cluster Redis nativo. Isso reduz a sobrecarga de link e melhora ainda mais a velocidade de resposta do serviço de banco de dados ApsaraDB Tair (compatível com Redis® OSS).

A instância para a qual você invoca esta operação deve atender às seguintes condições:

A instância usa a arquitetura de cluster.
O padrão de implantação é clássico.
O tipo de rede da instância é VPC. Se a instância estiver conectada à rede clássica, você pode invocar a operação SwitchNetwork para alterar o tipo de rede para VPC.
O recurso de criptografia Secure Sockets Layer (SSL) está desativado para a instância. Se o recurso de criptografia Secure Sockets Layer (SSL) estiver ativado, você pode invocar a operação ModifyInstanceSSL para desativá-lo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

kvstore:AllocateDirectConnection

create

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância. Apenas instâncias de cluster implantadas no modo clássico são suportadas. Para instâncias implantadas no modo clássico, o valor do parâmetro ComputingType é Machine. Você pode chamar a operação DescribeInstances para consultar o parâmetro ComputingType.	r-bp1zxszhcgatnx****
ConnectionString	string	Não	O prefixo do endpoint de conexão direta. O prefixo deve ter de 8 a 40 caracteres e pode conter letras minúsculas e dígitos. Deve começar com uma letra minúscula. Valor padrão: o ID da instância seguido por `-direct`. Por exemplo, se o ID da instância for r-8vbwsicr5d5gse**, o valor padrão será `r-8vbwsicr5d5gse**-direct`.	redisdirect123
Port	string	Não	O número da porta. Valores válidos: 1024 a 65535. Valor padrão: 6379.	6379

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	5D622714-AEDD-4609-9167-F5DDD3D1****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "5D622714-AEDD-4609-9167-F5DDD3D1****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NetTypeExists	Specified net type already existed
400	InvalidConnType	Specified DB instance conn type is not valid.
400	TaskHasExist	The task already exists.
400	ConnectionStringAlreadyExists	Specified connection string already exists in the Aliyun RDS.
400	InvalidConnectionString.Format	Specified connection string is not valid.	A string de conexão é inválida. Especifique uma nova.
400	DirectConnectionAlreadyExists	Specified instance direct connection already exists.
400	InvalidVPCParamGroup	Specified vpc param group is not valid.
400	InvalidConnectionString	ConnectionString is invalid, valid regex: ^\w+$	O prefixo do endpoint é inválido. O prefixo deve começar com uma letra minúscula, conter apenas letras minúsculas e dígitos, e ter de 8 a 40 caracteres de comprimento.
403	UnsupportedEngineVersion	Current engine version does not support operations.
403	IncorrectMinorVersion	Current engine minor version does not support operations.
403	InstanceStatus.NotSupport	Instance status does not support this operation.
404	InvalidDbInstanceId.NotFound	Specified instance does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.