本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建到 Bitbucket 的连接
<a name="connections-create-bitbucket"></a>

您可以使用 AWS 管理控制台 或 AWS Command Line Interface (AWS CLI) 来创建与 bitbucket.org 上托管的存储库的连接。

开始前的准备工作：
+ 您必须已使用 Bitbucket 创建有账户。
+ 您必须已在 bitbucket.org 上创建了一个代码存储库。
**注意**  
您可以创建到 Bitbucket Cloud 存储库的连接。不支持已安装的 Bitbucket 提供程序类型（如 Bitbucket 服务器）。请参阅[AWS CodeConnections 支持的提供程序和版本](supported-versions-connections.md)。

**注意**  
连接只能访问用于创建连接的账户所拥有的存储库。  
如果要将应用程序安装在 Bitbucket 工作区中，则需要 **Administer workspace**（管理工作区）权限。否则，安装应用程序的选项将不会显示。

**Topics**
+ [创建到 Bitbucket 的连接（控制台）](#connections-create-bitbucket-console)
+ [创建到 Bitbucket 的连接 (CLI)](#connections-create-bitbucket-cli)

## 创建到 Bitbucket 的连接（控制台）
<a name="connections-create-bitbucket-console"></a>

您可以使用控制台创建与 Bitbucket 的连接。

**注意**  
从 2024 年 7 月 1 日起，控制台将在资源 ARN `codeconnections` 中创建与的连接。带有两个服务前缀的资源将继续显示在控制台中。

**步骤 1：创建连接**

1. 登录并打开 AWS 开发者工具控制台，网址为[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。 AWS 管理控制台

1. 选择**设置 > 连接**，然后选择**创建连接**。

1. 要创建到 Bitbucket 存储库的连接，请在 **Select a provider (选择提供商)** 下，选择 **Bitbucket**。在 **Connection name (连接名称)** 中，输入要创建的连接的名称。选择 **Connect to Bitbucket (连接到 Bitbucket)**，然后继续执行步骤 2。  
![\[显示为 Bitbucket 选择的连接选项的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-bitbucket.png)

**步骤 2：连接到 Bitbucket**

1. 在 **Connect to Bitbucket (连接到 Bitbucket)** 设置页面上，将显示您的连接名称。

   在 **Bitbucket 应用程序**下，选择一个应用程序安装，或者选择**安装新应用程序**来创建一个应用程序安装。
**注意**  
您只为每个 Bitbucket 工作区或账户安装一次应用程序。如果您已经安装了 Bitbucket 应用程序，请选择它，然后移至本部分内容中的最后一步。  
![\[显示“Connect to Bitbucket (连接到 Bitbucket)”对话框以及安装新应用程序按钮的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/newreview-source-wizard-bitbucket.png)

1. 如果显示 Bitbucket 的登录页面，请使用您的凭证登录，然后选择继续。

1. 在应用程序安装页面上，一条消息显示该 AWS CodeStar 应用程序正在尝试连接到您的 Bitbucket 帐户。

   如果您使用的是 Bitbucket 工作区，请更改工作区的 **Authorize for**（授权）选项。只有您拥有管理员访问权限的工作区才会显示。

   选择**授予访问权限**。  
![\[显示连接器访问请求的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/bitbucket-access-popup.png)

1. 在 **Bitbucket 应用程序**中，将显示新安装的连接 ID。选择**连接**。创建的连接将显示在连接列表中。  
![\[显示连接器访问请求的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/create-connection-bitbucket-app-ID.png)

## 创建到 Bitbucket 的连接 (CLI)
<a name="connections-create-bitbucket-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 来创建连接。

为此，请使用 **create-connection** 命令。

**重要**  
默认情况下，通过 AWS CLI 或创建的连接 AWS CloudFormation 处于`PENDING`状态。使用 CLI 或创建连接后 CloudFormation，使用控制台编辑连接以使其处于状态`AVAILABLE`。

**要创建到 Bitbucket 的连接**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**create-connection**命令，`--connection-name`为您的连接指定`--provider-type`和。在此示例中，第三方提供方名称为 `Bitbucket`，指定的连接名称为 `MyConnection`。

   ```
   aws codeconnections create-connection --provider-type Bitbucket --connection-name MyConnection
   ```

   如果成功，该命令将返回类似以下内容的连接 ARN 信息。

   ```
   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }
   ```

1. 使用控制台完成连接。有关更多信息，请参阅 [更新挂起的连接](connections-update.md)。