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á.
# Conectando-se a AWS
As seções a seguir descrevem como começar a usar o AWS Toolkit for Visual Studio com o Amazon Q. Na primeira vez que você inicia o Visual Studio depois de instalar a extensão, **uma Introdução é** exibida na janela do editor. Você pode concluir as seguintes ações na guia **Conceitos básicos**.
+ Ative ou desative o Amazon Q e o AWS Toolkit.
+ Adicionar e se autenticar com novas credenciais.
+ Autenticar-se com as credenciais existentes.
+ Acessar a documentação e os tutoriais para ajudar você a começar a usar o Amazon Q e o kit de ferramentas da AWS .
## Pré-requisitos
Para começar a trabalhar com o Amazon Q e o AWS Toolkit, você precisa se autenticar com AWS credenciais. Se você já configurou uma AWS conta e autenticação por meio de outra AWS ferramenta ou serviço (como o AWS Command Line Interface), o AWS Toolkit detecta automaticamente suas credenciais. Se você é novo AWS ou não criou uma conta, então você pode se inscrever para uma AWS conta no [portal de AWS inscrição]( https://portal.aws.amazon.com/billing/signup). Para obter informações detalhadas sobre como configurar uma nova AWS conta, consulte o tópico [Visão geral](https://docs.aws.amazon.com//SetUp/latest/UserGuide/setup-overview.html) no *Guia do usuário de AWS configuração*.
## Conectando-se a AWS partir do kit de ferramentas
Para se conectar às suas AWS contas a partir do AWS Kit de ferramentas, abra a guia **Introdução a** qualquer momento preenchendo o seguinte.
**Abrir a guia **Conceitos básicos** no Visual Studio**
1. No Visual Studio, expanda **Extensões** no menu principal e, em seguida, expanda o submenu **AWS Toolkit**.
1. Escolha **Conceitos básicos**.
1. A guia **Introdução** é aberta na janela do editor do Visual Studio.
Na guia **Conceitos básicos**, há duas seções principais:
+ **Funcionalidades:** Nesta seção, você pode ativar ou desativar recursos como o Amazon Q e o AWS Toolkit.
+ **Documentação e tutoriais:** uma coleção de referências sobre os recursos habilitados.
**nota**
A seção Documentação e tutoriais fica visível somente quando um ou mais recursos estão habilitados.
## Amazon Q Developer
Na seção Amazon Q da guia **Conceitos básicos**, você pode habilitar ou desabilitar o Amazon Q, adicionar uma nova conexão ou mudar para outra conexão da AWS . Antes que você possa visualizar ou acessar qualquer uma dessas ações, o Amazon Q deve ser habilitado. Para habilitar o Amazon Q, clique no botão **Habilitar**.
Quando o Amazon Q é desabilitado, todos os recursos e funções do Amazon Q são completamente removidos do Visual Studio. A habilitação do Amazon Q abre automaticamente a tela **Configurar autenticação para o Amazon Q** na guia **Conceitos básicos**. Para continuar, você deve se autenticar com suas Centro de Identidade do AWS IAM credenciais para acessar o **Nível Profissional** ou seu ID do AWS Construtor para acessar o Nível **Gratuito**. Para saber mais detalhes sobre cada uma das opções de nível, consulte o tópico [Noções básicas dos níveis de serviço do Amazon Q Developer](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/q-tiers.html) no Guia do usuário do *Amazon Q Developer*.
Para continuar, execute um dos procedimentos a seguir.
**Autenticação no nível profissional com o Centro de Identidade do IAM**
**nota**
Os campos **Nome do perfil**, **URL inicial**, **Região do perfil** ou **Região do SSO** necessários para autenticação no nível profissional geralmente são informados por um administrador da sua empresa ou organização. Para obter informações detalhadas sobre as credenciais do Centro de Identidade do IAM, consulte o tópico [O que é o Centro de Identidade do IAM?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) no Guia do usuário do *Centro de Identidade do AWS IAM*.
1. Na tela **Getting Started: AWS Toolkit with Amazon Q**, escolha o botão **Sign in** no quadro Amazon Q para navegar até a tela **Configurar autenticação para Amazon Q.**
1. Na tela **Configurar autenticação para o Amazon Q**, acesse a seção **Nível profissional**, preencha os campos obrigatórios e clique no botão **Conectar**.
1. Confirme que você deseja abrir o portal AWS de solicitação de autorização em seu navegador padrão.
1. Conclua as etapas exigidas pelo portal de solicitação de AWS autorização, você será notificado quando for seguro fechar o navegador e retornar ao Visual Studio
1. Na guia **Conceitos básicos**, o Amazon Q é atualizado para mostrar que você se conectou com o Centro de Identidade do IAM quando o processo é concluído.
**Autenticação de nível gratuito com AWS Builder ID**
**nota**
Para obter detalhes adicionais sobre o AWS Builder ID, consulte o tópico [Entrar com o AWS Builder ID](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html) no Guia do usuário *AWS de login*.
1. Na tela **Getting Started: AWS Toolkit with Amazon Q**, escolha o botão **Sign in** no quadro Amazon Q para navegar até a tela **Configurar autenticação para Amazon Q.**
1. Na tela **Configurar autenticação para o Amazon Q**, acesse a seção **Nível gratuito** e clique no botão **Inscrever-se ou iniciar sessão**.
1. Confirme que você deseja abrir o portal AWS de solicitação de autorização em seu navegador padrão.
1. Conclua as etapas exigidas pelo portal de solicitação de AWS autorização, você será notificado quando for seguro fechar o navegador e retornar ao Visual Studio.
1. Na guia **Getting Started**, o Amazon Q é atualizado para mostrar que você está conectado ao seu AWS Builder ID quando o processo é concluído.
Depois de se autenticar com suas credenciais do IAM Identity Center ou AWS Builder ID, você pode acessar o Amazon Q no Visual Studio. Além disso, você pode realizar as seguintes ações na guia **Conceitos básicos**:
+ **Sair**: encerra sua conexão de credenciais atual de todas as funções do Amazon Q. O Amazon Q continua habilitado, mas a maioria dos recursos não funciona.
+ **Desabilitar o Amazon Q**: desabilita completamente todos os recursos do Amazon Q no Visual Studio.
## AWS Kit de ferramentas
Na seção AWS Kit de ferramentas na guia **Introdução ao AWS kit de ferramentas**, você pode ativar ou desativar o AWS kit de ferramentas, adicionar uma nova conexão ou alternar para uma conexão diferente. AWS Antes que você possa visualizar ou acessar qualquer uma dessas ações, o AWS Toolkit deve estar ativado. Para ativar o AWS kit de ferramentas, clique no botão **Ativar**.
Quando o AWS kit de ferramentas está ativado, a **autenticação de configuração do AWS kit de ferramentas** é carregada automaticamente na guia **Introdução ao kit de AWS ferramentas**. Para continuar, você deve se autenticar usando as credenciais do **Centro de Identidade do AWS IAM** ou as credenciais do **Perfil de usuário do IAM**.
**nota**
Para obter informações detalhadas sobre as credenciais do Centro de Identidade do IAM, consulte o tópico [O que é o Centro de Identidade do IAM?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) no Guia do usuário do *Centro de Identidade do AWS IAM*. Para obter informações detalhadas sobre as credenciais da função de usuário do IAM, consulte o tópico [Chaves de AWS acesso: credenciais de longo prazo](https://docs.aws.amazon.com//sdkref/latest/guide/access-iam-users.html) no guia de referência de *ferramentas AWS SDKs e ferramentas*.
**Fazer a autenticação e conectar-se com o Centro de Identidade do IAM**
1. Na tela **Getting Started: AWS Toolkit with Amazon Q**, escolha o botão **Sign in no** quadro AWS Toolkit para navegar até a tela **Configurar autenticação para o AWS Toolkit**.
1. Na tela **Configurar autenticação para o AWS kit de ferramentas**, escolha **IAM Identity Center (sucessor do Single Sign-on) no menu suspenso** Tipo de **perfil**.
1. No menu suspenso **Escolher um perfil existente ou adicionar novo**, escolha um perfil existente ou selecione **Adicionar novo perfil** para adicionar as informações do novo perfil.
**nota**
Se escolher um perfil existente, vá para a etapa 7.
1. No campo **Nome do perfil**, insira o **profile name** associado à conta do Centro de Identidade do IAM com a qual você deseja se autenticar.
1. No campo de texto **URL inicial**, insira o **Start URL** que está anexado às suas credenciais do Centro de Identidade IAM.
1. No menu suspenso **Região do perfil (o padrão é us-east-1)**, escolha a **região do perfil definida pelo perfil de usuário** do IAM Identity Center com o qual você está se autenticando.
1. No menu suspenso **Região do SSO (padrão: us-east-1)**, escolha a **Região do SSO** definida pelas suas credenciais do Centro de Identidade do IAM.
1. Clique no botão **Conectar** para abrir o site de **Solicitação de autorização da AWS ** em seu navegador da web padrão.
1. Siga as instruções no navegador da web padrão. Você receberá a notificação de que é seguro fechar o navegador e retornar ao Visual Studio quando o processo for concluído.
1. Na guia **Conceitos básicos**, a seção Kit de ferramentas da AWS é atualizada para mostrar que você se conectou com o Centro de Identidade do IAM quando o processo é concluído.
**Autenticar-se e conectar-se com credenciais do perfil de usuário do IAM**
1. Na tela **Getting Started: AWS Toolkit with Amazon Q**, escolha o botão **Sign in no** quadro AWS Toolkit para navegar até a tela **Configurar autenticação para o AWS Toolkit**.
1. Na tela **Configurar autenticação para o AWS kit de ferramentas**, escolha **Função de usuário do IAM** no menu suspenso **Tipo de perfil**.
1. No menu suspenso **Escolher um perfil existente ou adicionar novo**, escolha **Add new profile**.
**nota**
Se escolher um nome de perfil existente na lista, vá para a **Etapa 8**.
1. No campo de texto **Nome do perfil**, insira um nome para o novo perfil.
1. No campo de texto **ID da chave de acesso**, insira o **Access Key ID** do perfil com o qual deseja se autenticar.
1. No campo de texto **Chave secreta**, insira o **Secret Key** do perfil com o qual deseja se autenticar.
1. No menu suspenso **Local de armazenamento (padrão: arquivo de credenciais compartilhadas)**, especifique se deseja armazenar as credenciais em um arquivo de **Credenciais compartilhadas** ou no **Armazenamento criptografado .NET**.
1. Nos menus suspensos **Região do perfil (padrão: us-east-1)**, escolha a **Partição** e a **Região do perfil** que estão anexadas ao perfil com o qual deseja se autenticar.
1. Escolha o botão **Conectar** para adicionar esse perfil ao seu local de AWS armazenamento com AWS o qual and/or se autenticar.
1. Na guia **Conceitos básicos**, a seção Kit de ferramentas da AWS é atualizada para mostrar que você se conectou com suas credenciais do perfil de usuário do IAM quando o processo é concluído.
Depois de se autenticar com suas credenciais do IAM Identity Center ou do IAM User Role, você pode acessar o AWS Explorer no Toolkit for Visual Studio. Além disso, você pode **Sair** e **Desabilitar o kit de ferramentas da AWS para Visual Studio com Amazon Q** na guia **Conceitos básicos**.
## Documentação e tutoriais
A seção de documentação e tutoriais é atualizada automaticamente com sugestões de documentação e tutoriais com base em suas preferências AWS de serviços e recursos. Essas referências são visíveis somente quando pelo menos um recurso foi habilitado.