As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como usar o Amazon Keyspaces com endpoint da VPC de interface

Os endpoints da VPC de interface permitem a comunicação privada entre a nuvem privada virtual (VPC) em execução no Amazon VPC e no Amazon Keyspaces. Os endpoints VPC de interface são alimentados por AWS PrivateLink, que é um AWS serviço que permite a comunicação privada entre VPCs serviços e. AWS

AWS PrivateLink permite isso usando uma interface de rede elástica com endereços IP privados em sua VPC para que o tráfego de rede não saia da rede Amazon. Os endpoints da VPC de interface não exigem um gateway da Internet, dispositivo NAT, conexão VPN ou conexão do AWS Direct Connect . Para obter mais informações, consulte a Amazon Virtual Private Cloud e os Endpoints da VPC de interface (AWS PrivateLink).

Como usar o endpoint da VPC para o Amazon Keyspaces

Você pode criar uma endpoint da VPC de interface para que o tráfego entre o Amazon Keyspaces e seus recursos do Amazon VPC comece a fluir pelo endpoint da VPC de interface. Para começar, siga as etapas para criar um endpoint de interface. Em seguida, edite o grupo de segurança associado ao endpoint que você criou na etapa anterior e configure uma regra de entrada para a porta 9142. Para obter mais informações consulte Adicionar, remover e atualizar regras.

Para obter um step-by-step tutorial sobre como configurar uma conexão com o Amazon Keyspaces por meio de um VPC endpoint, consulte. Tutorial: Conecte-se ao Amazon Keyspaces usando uma interface VPC endpoint Para saber como configurar o acesso entre contas para recursos do Amazon Keyspaces separados de aplicativos Contas da AWS diferentes em uma VPC, consulte. Configure o acesso entre contas para Amazon Keyspaces e endpoints da VPC

Como preencher entradas da tabela system.peers com informações do endpoint da VPC de interface

Os drivers do Apache Cassandra usam a tabela system.peers para consultar as informações do nó sobre o cluster. Os drivers do Cassandra usam as informações do nó para balancear a carga das conexões e repetir as operações. O Amazon Keyspaces preenche nove entradas na tabela system.peers automaticamente para clientes que se conectam por meio do endpoint público.

Para fornecer aos clientes uma conexão por meio de endpoints da VPC de interface com funcionalidade semelhante, o Amazon Keyspaces preenche a tabela system.peers em sua conta com uma entrada para cada zona de disponibilidade em que um endpoint da VPC está disponível. Para pesquisar e armazenar endpoints da VPC de interface disponíveis na tabela system.peers, o Amazon Keyspaces exige que você conceda à entidade IAM usada para se conectar ao Amazon Keyspaces permissões de acesso para consultar sua VPC para obter informações sobre o endpoint e a interface de rede.

Para conceder à entidade IAM usada para se conectar ao Amazon Keyspaces permissões para pesquisar as informações necessárias do endpoint da VPC de interface, você pode atualizar seu perfil do IAM ou política de usuário existente ou criar uma nova política do IAM, conforme mostrado no exemplo a seguir.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Sid":"ListVPCEndpoints",
         "Effect":"Allow",
         "Action":[
            "ec2:DescribeNetworkInterfaces",
            "ec2:DescribeVpcEndpoints"
         ],
         "Resource":"*"
      }
   ]
}

Para confirmar se a política foi configurada corretamente, consulte a tabela system.peers para ver as informações de rede. Se a tabela system.peers estiver vazia, isso pode indicar que a política não foi configurada com êxito ou que você excedeu a cota de taxa de solicitação para as ações da API DescribeNetworkInterfaces e DescribeVPCEndpoints. DescribeVPCEndpoints se enquadra na categoria Describe* e é considerada uma ação não mutante. DescribeNetworkInterfaces se enquadra no subconjunto de ações não filtradas e não paginadas e não mutantes, e diferentes cotas se aplicam. Para obter mais informações, consulte Solicitar tamanhos de repositórios de tokens e taxas de recarga na Amazon EC2 API Reference.

Se você vir uma tabela vazia, tente novamente alguns minutos depois para descartar problemas de cota de taxa de solicitação. Para verificar se você configurou os endpoints da VPC corretamente, consulte Minha conexão de endpoint da VPC não funciona corretamente. Se sua consulta retornar resultados da tabela, sua política foi configurada corretamente.

Como controlar o acesso aos endpoints da VPC de interface para o Amazon Keyspaces

Com as políticas de endpoint da VPC, você pode controlar o acesso aos recursos de duas maneiras:

Veja a seguir exemplos de políticas de endpoint para acessar os recursos do Amazon Keyspaces.

Disponibilidade

O Amazon Keyspaces oferece suporte ao uso de endpoints VPC de interface em todos os lugares em que o serviço Regiões da AWS está disponível. Para obter mais informações, consulte Endpoints de serviço para Amazon Keyspaces.

Políticas de endpoint de VPC e recuperação do Amazon point-in-time Keyspaces (PITR)

Se você estiver usando políticas do IAM com chaves de condição para restringir o tráfego de entrada, a operação de restauração da tabela poderá falhar. Por exemplo, se você restringir o tráfego de origem a endpoints da VPC específicos usando chaves de condição aws:SourceVpce, a operação de restauração da tabela falhará. Para permitir que o Amazon Keyspaces execute uma operação de restauração em nome de sua entidade principal, você deve adicionar uma chave de condição aws:ViaAWSService à sua política do IAM. A chave de aws:ViaAWSService condição permite o acesso quando qualquer AWS serviço faz uma solicitação usando as credenciais do diretor. Para obter mais informações, consulte Elementos de política JSON do IAM: chave de condição no Guia do usuário do IAM. A política a seguir é um exemplo disso.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Sid":"CassandraAccessForVPCE",
         "Effect":"Allow",
         "Action":"cassandra:*",
         "Resource":"*",
         "Condition":{
            "Bool":{
               "aws:ViaAWSService":"false"
            },
            "StringEquals":{
               "aws:SourceVpce":[
                  "vpce-12345678901234567"
               ]
            }
         }
      },
      {
         "Sid":"CassandraAccessForAwsService",
         "Effect":"Allow",
         "Action":"cassandra:*",
         "Resource":"*",
         "Condition":{
            "Bool":{
               "aws:ViaAWSService":"true"
            }
         }
      }
   ]
}

Erros e avisos comuns

Se você estiver usando a Amazon Virtual Private Cloud e se conectar ao Amazon Keyspaces, talvez veja o seguinte aviso.

Control node cassandra.us-east-1.amazonaws.com/1.111.111.111:9142 has an entry for itself in system.peers: this entry will be ignored. This is likely due to a misconfiguration; 
please verify your rpc_address configuration in cassandra.yaml on all nodes in your cluster. 

Esse aviso ocorre porque a tabela system.peers contém entradas para todos os endpoint da VPC da Amazon que o Amazon Keyspaces tem permissão para visualizar, incluindo o endpoint da VPC da Amazon ao qual você está conectado. Você pode ignorar esse aviso com segurança.

Para outros erros, consulte Minha conexão de endpoint da VPC não funciona corretamente.