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á.
# Criar uma conexão com o Bitbucket
Você pode usar o Console de gerenciamento da AWS ou o AWS Command Line Interface (AWS CLI) para criar uma conexão com um repositório hospedado em bitbucket.org.
Antes de começar
+ Você já deve ter criado uma conta com o Bitbucket.
+ Você já deve ter criado um repositório de código no bitbucket.org.
**nota**
Você pode criar conexões para um repositório do Bitbucket Cloud. Não há suporte a tipos de provedores instalados do Bitbucket, como o Bitbucket Server. Consulte [AWS CodeConnections fornecedores e versões compatíveis](supported-versions-connections.md).
**nota**
As conexões fornecem acesso somente a repositórios pertencentes à conta do Bitbucket usada para criar a conexão.
Se a aplicação estiver sendo instalada em um espaço de trabalho do Bitbucket, você precisará de permissões **Administer workspace** (Administrar o espaço de trabalho). Caso contrário, a opção de instalar a aplicação não será exibida.
**Topics**
+ [Criar uma conexão com o Bitbucket (console)](#connections-create-bitbucket-console)
+ [Criar uma conexão com o Bitbucket (CLI)](#connections-create-bitbucket-cli)
## Criar uma conexão com o Bitbucket (console)
Você pode usar o console para criar uma conexão com o Bitbucket.
**nota**
A partir de 1º de julho de 2024, o console cria conexões com o `codeconnections` ARN do recurso. Os recursos com os dois prefixos de serviço continuarão sendo exibidos no console.
**Etapa 1: criar uma conexão**
1. Faça login no e abra Console de gerenciamento da AWS o console do AWS Developer Tools em[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Escolha **Settings > Connections** (Configurações > Conexões) e, em seguida, escolha **Create connection** (Criar conexão).
1. Para criar uma conexão com um repositório do Bitbucket, em **Select a provider** (Selecione um provedor), escolha **Bitbucket**. Em **Connection name** (Nome da conexão), digite o nome da conexão que você deseja criar. Selecione **Connect to Bitbucket** (Conectar ao Bitbucket) e prossiga para a Etapa 2.
![\[Captura de tela do console mostrando a opção de conexão selecionada para Bitbucket.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-bitbucket.png)
**Etapa 2: Conectar ao Bitbucket**
1. Seu nome de conexão é exibido na página de configurações de **Connect to Bitbucket** (Conectar ao Bitbucket).
Em **Bitbucket apps** (Aplicações do Bitbucket), escolha uma instalação de aplicação ou **Install a new app** (Instalar uma nova aplicação) para criar uma.
**nota**
A aplicação é instalada apenas uma vez para cada espaço de trabalho ou conta do Bitbucket. Se você já instalou a aplicação Bitbucket, escolha-a e vá para a última etapa nesta seção.
![\[Captura de tela do console mostrando a caixa de diálogo Connect to Bitbucket (Conectar ao Bitbucket) com o botão de instalação de nova aplicação.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/newreview-source-wizard-bitbucket.png)
1. Se a página de login do Bitbucket for exibida, faça login com suas credenciais e escolha a opção de continuar.
1. Na página de instalação do aplicativo, uma mensagem mostra que o AWS CodeStar aplicativo está tentando se conectar à sua conta do Bitbucket.
Se você estiver usando um espaço de trabalho do Bitbucket, altere a opção **Authorize for** (Autorizar para) do espaço de trabalho. Somente os espaços de trabalho nos quais você tem acesso de administrador serão exibidos.
Escolha **Conceder acesso**.
![\[Captura de tela do console mostrando a solicitação de acesso do conector.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/bitbucket-access-popup.png)
1. Em **Bitbucket apps** (Aplicações do Bitbucket), o ID de conexão para a nova instalação é exibido. Selecione **Conectar**. A conexão criada é exibida na lista de conexões.
![\[Captura de tela do console mostrando a solicitação de acesso do conector.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/create-connection-bitbucket-app-ID.png)
## Criar uma conexão com o Bitbucket (CLI)
Você pode usar o AWS Command Line Interface (AWS CLI) para criar uma conexão.
Para fazer isso, use o comando **create-connection**.
**Importante**
Uma conexão criada por meio do AWS CLI ou AWS CloudFormation está no `PENDING` status por padrão. Depois de criar uma conexão com a CLI ou CloudFormation, use o console para editar a conexão e definir seu status. `AVAILABLE`
**Para criar uma conexão com o Bitbucket**
1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o **create-connection** comando, especificando `--provider-type` e `--connection-name` para sua conexão. Neste exemplo, o nome do provedor de terceiros é `Bitbucket` e o nome da conexão especificada é `MyConnection`.
```
aws codeconnections create-connection --provider-type Bitbucket --connection-name MyConnection
```
Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. Use o console para concluir a conexão. Para obter mais informações, consulte [Atualizar uma conexão pendente](connections-update.md).