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

# 使用存储库链接
<a name="repositorylinks"></a>

存储库链接会在您的连接和外部 Git 存储库之间创建关联。仓库链接允许 Git sync 监控指定 Git 仓库中文件的更改并将其同步到 CloudFormation 堆栈。

有关仓库链接的更多信息，请参阅 [AWS CodeConnections API 参考](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html)。

**Topics**
+ [创建存储库链接](repositorylinks-create.md)
+ [更新存储库链接](repositorylinks-update.md)
+ [列出存储库链接](repositorylinks-list.md)
+ [删除存储库链接](repositorylinks-delete.md)
+ [查看存储库链接详细信息](repositorylinks-view-details.md)

# 创建存储库链接
<a name="repositorylinks-create"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 中的**create-repository-link**命令在连接和要同步到的外部存储库之间创建链接。

在创建存储库链接之前，您必须已经使用第三方提供商创建了外部存储库，例如 GitHub。

**创建存储库链接**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**create-repository-link**命令。指定关联连接的 ARN、所有者 ID 和存储库名称。

   ```
   aws codeconnections create-repository-link --connection-arn  arn:aws:codeconnections:us-east-1:account_id:connection/001f5be2-a661-46a4-b96b-4d277cac8b6e --owner-id account_id --repository-name MyRepo 
   ```

1. 此命令将返回以下输出。

   ```
   {
       "RepositoryLinkInfo": {
           "ConnectionArn": "arn:aws:codeconnections:us-east-1:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
           "OwnerId": "account_id",
           "ProviderType": "GitHub",
           "RepositoryLinkArn": "arn:aws:codeconnections:us-east-1:account_id:repository-link/be8f2017-b016-4a77-87b4-608054f70e77",
           "RepositoryLinkId": "be8f2017-b016-4a77-87b4-608054f70e77",
           "RepositoryName": "MyRepo",
           "Tags": []
       }
   }
   ```

# 更新存储库链接
<a name="repositorylinks-update"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 中的**update-repository-link**命令来更新指定的存储库链接。

您可以更新存储库链接的以下信息：
+ `--connection-arn`
+ `--owner-id`
+ `--repository-name`

当您想要更改与存储库关联的连接时，可以更新存储库链接。要使用其他连接，您需要指定连接 ARN。有关查看连接 ARN 的步骤，请参阅[查看连接详细信息](connections-view-details.md)。

**更新存储库链接**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。使用运行**update-repository-link**命令，为存储库链接指定要更新的值。 AWS CLI 例如，以下命令将更新与存储库链接 ID 关联的连接。它使用 `--connection` 参数指定新的连接 ARN。

   ```
   aws codestar-connections update-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173 --connection-arn arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-f055-4843-adef-4ceaefcb2167 
   ```

1. 此命令将返回以下输出。

   ```
   {
       "RepositoryLinkInfo": {
           "ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-f055-4843-adef-4ceaefcb2167",
           "OwnerId": "owner_id",
           "ProviderType": "GitHub",
           "RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/6053346f-8a33-4edb-9397-10394b695173",
           "RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
           "RepositoryName": "MyRepo",
           "Tags": []
       }
   }
   ```

# 列出存储库链接
<a name="repositorylinks-list"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 中的**list-repository-links**命令列出您账户的存储库链接。

**列出存储库链接**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**list-repository-links **命令。

   ```
   aws codeconnections list-repository-links
   ```

1. 此命令将返回以下输出。

   ```
   {
       "RepositoryLinks": [
           {
               "ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/001f5be2-a661-46a4-b96b-4d277cac8b6e",
               "OwnerId": "owner_id",
               "ProviderType": "GitHub",
               "RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/6053346f-8a33-4edb-9397-10394b695173",
               "RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
               "RepositoryName": "MyRepo",
               "Tags": []
           }
       ]
   }
   ```

# 删除存储库链接
<a name="repositorylinks-delete"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 中的**delete-repository-link**命令来删除存储库链接。

必须先删除与存储库链接关联的所有同步配置，然后才能删除该存储库链接。

**重要**  
运行该命令后，将删除存储库链接。不显示任何确认对话框。您可以创建新的存储库链接，但无法重复使用 Amazon 资源名称 (ARN)。

**删除存储库链接**
+ 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。使用运行**delete-repository-link**命令，指定 AWS CLI 要删除的存储库链接的 ID。

  ```
  aws codeconnections delete-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173
  ```

  该命令不返回任何内容。

# 查看存储库链接详细信息
<a name="repositorylinks-view-details"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 中的**get-repository-link**命令来查看有关存储库链接的详细信息。

**查看存储库链接详细信息**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**get-repository-link**命令，指定存储库链接 ID。

   ```
   aws codestar-connections get-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173
   ```

1. 此命令将返回以下输出。

   ```
   {
       "RepositoryLinkInfo": {
           "ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
           "OwnerId": "owner_id",
           "ProviderType": "GitHub",
           "RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/be8f2017-b016-4a77-87b4-608054f70e77",
           "RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
           "RepositoryName": "MyRepo",
           "Tags": []
       }
   }
   ```