本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 什麼是連線？
您可以使用開發人員工具主控台中的*連線*功能，將 資源 AWS CodePipeline 如 連接到 AWS 外部程式碼儲存庫。此功能有自己的 API，也就是 [AWS CodeConnections API 參考](https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html)。每個連線都是您可以提供給 AWS 服務的資源，以連線至第三方儲存庫，例如 Bitbucket。例如，您可以在 CodePipeline 中新增連線，以便在第三方程式碼儲存庫發生程式碼變更時觸發管道。每個連線都有名稱，且與用來參考連線的唯一 Amazon Resource Name (ARN) 相關聯。
**重要**
服務名稱 AWS CodeStar Connections 已重新命名。仍然支援使用先前命名空間 codestar-connections 建立的資源。
## 我能用連線做什麼？
您可以在開發人員工具中使用連線功能，將第三方供應商資源與您的 AWS 資源整合，包括：
+ 連線至第三方提供者，例如 Bitbucket，並使用第三方連線做為與您的 AWS 資源的來源整合，例如 CodePipeline。
+ 為您的第三方供應商統一管理 CodeBuild 建置專案、CodeDeploy 應用程式和 CodePipeline 中管道的跨資源連線存取權。
+ 針對 CodeBuild 建置專案、CodeDeploy 應用程式和 CodePipeline 中管道，在堆疊範本中使用連線 ARN，而不需要參考存放的機密或參數。
# 我可以為哪些第三方供應商建立連線？
連線可以將 AWS 資源與下列第三方儲存庫建立關聯：
+ Azure DevOps
+ Bitbucket Cloud
+ GitHub.com
+ GitHub Enterprise Cloud
**注意**
目前不支援 GitHub Enterprise Cloud 的自訂網域。
+ GitHub Enterprise Server
+ GitLab.com
**重要**
GitLab 的連線支援包括 15.x 版和更新版本。
+ GitLab 自我管理安裝 (適用於企業版或社群版)。
如需連線工作流程的概觀，請參閱「[建立或更新連線的工作流程](welcome-connections-workflow.md)」。
為雲端供應商類型 (例如 GitHub) 建立連線的步驟，與安裝式供應商類型 (例如 GitHub Enterprise Server) 的步驟不同。如需為各種供應商類型建立連線的高階步驟，請參閱「[使用連線](connections.md)」。
**注意**
若要在歐洲 （米蘭） 使用連線 AWS 區域，您必須：
安裝區域特定的應用程式
啟用區域
此區域特定的應用程式支援歐洲 (米蘭) 區域中的連線。它會在第三方供應商網站上發佈，並且它會與支援其他區域連線的現有應用程式分開。透過安裝此應用程式，您授權第三方提供商僅使用該區域服務來共用您的資料，並且您可以透過解除安裝該應用程式來隨時撤銷許可。
除非您啟用區域，否則服務不會處理或儲存您的資料。啟用此區域，即表示您授予我們服務許可來處理和儲存您的資料。
即使未啟用該區域，如果仍已安裝區域特定的應用程式，第三方供應商仍然可以使用我們的服務來共用您的資料，因此請確保在停用該區域後解除安裝該應用程式。如需詳細資訊，請參閱[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。
## 什麼與連線 AWS 服務 整合？
您可以使用連線整合第三方儲存庫與其他 AWS 服務。若要檢視連線的服務整合，請參閱 [與 AWS CodeConnections 的產品和服務整合](integrations-connections.md)。
# 連線如何運作？
您必須先在第三方帳戶上安裝 AWS 身分驗證應用程式或提供存取權，才能建立連線。安裝連線之後，更新即可使用此安裝。建立連線時，您可以提供第三方帳戶中 AWS 資源的存取權。這可讓連線代表您 AWS 的資源存取第三方帳戶中的內容，例如來源儲存庫。然後，您可以與其他 共用該連線 AWS 服務 ，以在資源之間提供安全的 OAuth 連線。
雲端型連線的設定如下，在使用者帳戶或組織之間稱為差異。
+ **使用者帳戶：**每個雲端第三方使用者帳戶都有一個連接器應用程式安裝。多個連線可以與應用程式安裝相關聯。
+ **組織：**每個雲端第三方組織都有一個連接器應用程式安裝。對於組織中的連線，您的連線映射到組織中的每個組織帳戶是 1：1。多個連線無法與應用程式安裝建立關聯。如需組織如何使用連線的詳細資訊，請參閱 [AWS CodeConnections 中的連線如何與組織搭配使用](welcome-connections-how-it-works-github-organizations.md)。
下圖顯示雲端連線如何與使用者帳戶或組織搭配使用。
![\[圖表顯示應用程式安裝與雲端提供者連線之間的關係。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-flow.png)
連線由建立它們 AWS 帳戶 的 所擁有。連線的識別方式為包含連線 ID 的 ARN。連線 ID 是無法變更或重新映射的 UUID。刪除並重新建立連線會產生新的連線 ID，因此會有新的連線 ARN。這表示連線 ARN 絕不會重複使用。
新建立的連線處於 `Pending` 狀態。需要第三方交握 (OAuth 流程) 程序才能完成連線的設定，也就是從 `Pending` 變為 `Available` 狀態。完成此操作後，連線會`Available`與 CodePipeline 等 AWS 服務搭配使用。
如果您想要建立與已安裝提供者類型的連線 （內部部署），例如 GitHub Enterprise Server 或 GitLab 自我管理，您可以將主機資源與連線搭配使用。
內部部署連線的設定如下，在使用者帳戶或組織之間稱為差異。
+ **使用者帳戶：**每個現場部署第三方使用者帳戶都有一個連接器應用程式安裝。現場部署供應商的多個連線可以與一個主機相關聯。
+ **組織：**每個內部部署第三方組織都有一個連接器應用程式安裝。對於組織中的內部部署連線，例如 GitHub Organizations for GitHub Enterprise Server，您可以為組織中的每個連線建立新的主機，並確保在主機的網路欄位 (VPC、子網路 IDs 和安全群組 IDs) 中輸入相同的資訊。如需組織如何使用連線的詳細資訊，請參閱 [AWS CodeConnections 中的連線如何與組織搭配使用](welcome-connections-how-it-works-github-organizations.md)。
+ **全部：**針對每個內部部署連線，每個 VPC 一次只能與一個主機建立關聯。
在所有情況下，您將需要提供現場部署伺服器的 URL。此外，如果伺服器位於私有 VPC 內 （即無法透過網際網路存取），您將需要提供 VPC 資訊以及選用的 TLS 憑證資訊。這些組態可讓 CodeConnections 與執行個體通訊，並由為此主機建立的所有連線共用。例如，對於單一 GitHub Enterprise Server 執行個體，您可以建立由主機表示的單一應用程式。然後，對於使用者帳戶組態，您可以為該主機建立多個連線，其對應於您的應用程式安裝，如下圖所示。否則，對於組織，您可以為該主機建立單一應用程式安裝和連線。
下圖顯示內部部署連線如何與使用者帳戶或組織搭配使用。
![\[圖表顯示現場部署供應商的應用程式安裝和連線之間的關係。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-flow-host.png)
新建立的主機處於 `Pending` 狀態。需要第三方註冊程序才能完成主機的設定，也就是從 `Pending` 變為 `Available` 狀態。完成此操作之後，主機會變為 `Available`，且可用於與安裝式供應商類型的連線。
如需連線工作流程的概觀，請參閱「[建立或更新連線的工作流程](welcome-connections-workflow.md)」。如需為已安裝供應商建立主機工作流程的概觀，請參閱 [建立或更新主機的工作流程](welcome-hosts-workflow.md)。如需為各種供應商類型建立連線的高階步驟，請參閱「[使用連線](connections.md)」。
# AWS CodeConnections 中的連線如何與組織搭配使用
對於具有 GitHub Organizations 等提供者的組織，您無法在多個 GitHub Organizations 中安裝 GitHub 應用程式。連線透過使用 Github 連接器應用程式與組織進行 1：1 映射。連接器應用程式應針對 GitHub 或 GitHub Enterprise Server 中的每個組織分開，並應具有與其相關聯的連線。
例如，若要在相同的 GitHub 伺服器上使用多個組織，您必須為每個組織建立個別的連線，並為這些組織安裝個別的 GitHub 應用程式。不過，Github 端的目標帳戶可以相同。
# 建立或更新連線的工作流程
建立連線時，您也可以建立或使用現有的連接器應用程式安裝，以便與第三方供應商進行身分驗證交握。
連線可能為下列狀態：
+ `Pending` - `pending` 連線是必須完成 (已變為 `available`) 才能使用的連線。
+ `Available` - 您可以使用 `available` 連線或傳遞給帳戶中的其他資源和使用者。
+ `Error` - 處於 `error` 狀態的連線會自動重試。直到變為 `available` 前都無法使用。
**工作流程：透過 CLI、軟體開發套件或以下項目建立或更新： AWS CloudFormation**
您可以使用 [CreateConnection](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_CreateConnection.html) API，使用 AWS Command Line Interface (AWS CLI)、 SDK 或 建立連線 CloudFormation。連線建立後處於 `pending` 狀態。您可以使用主控台的 **Set up pending connection (設定待定連線)** 選項來完成程序。主控台會提示您建立安裝或使用現有的安裝來進行連線。然後您可以使用主控台完成交握，並在主控台中選擇 **Complete connection (完成連線)**，將連線移至 `available` 狀態。
**工作流程：建立或更新與主控台的連線**
如果要建立連至安裝式供應商類型 (例如 GitHub Enterprise Server) 的連線，需先建立主機。如果您要連線到雲端供應商類型 (例如 Bitbucket)，請略過建立主機的步驟並繼續建立連線。
若要使用主控台建立或更新連線，您可以使用主控台上的 CodePipeline 編輯動作頁面來選擇您的第三方供應商。主控台會提示您為連線建立安裝或使用現有的安裝，然後使用主控台來建立連線。主控台完成交握，並自動將連線從 `pending` 變為 `available` 狀態。
![\[圖表顯示建立連至第三方供應商的連線之工作流程。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/Connections-flowchart.png)
# 建立或更新主機的工作流程
當您為已安裝的提供者 （內部部署） 建立連線時，您可以使用主機資源。
**注意**
對於 GitHub Enterprise Server 或 GitLab 自我管理中的組織，您不會傳遞可用的主機。您為組織中的每個連線建立新的主機，而且務必在主機的網路欄位中輸入相同的資訊 (VPC ID、子網路 IDs 和安全群組 IDs)。如需詳細資訊，請參閱[支援組織的已安裝供應商的連線和主機設定](troubleshooting-connections.md#troubleshooting-organization-host)。
主機可能有以下狀態：
+ `Pending` - `pending` 主機是已建立的主機，必須先設定 (移至 `available`) 才能使用。
+ `Available` - 您可以使用或將 `available` 主機傳遞給連接。
**工作流程：透過 CLI、SDK 或 AWS CloudFormation建立或更新主機：**
您可以使用 [CreateHost](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_CreateHost.html) API，使用 AWS Command Line Interface (AWS CLI)、 SDK 或 建立主機 CloudFormation。建立後，主機處於 `pending` 狀態。您可以使用主控台的 **設定** 選項來完成程序。
**工作流程：用主控台建立或更新主機**
如果您要建立與已安裝提供者類型的連線，例如 GitHub Enterprise Server 或 GitLab 自我管理，您可以建立主機或使用現有的主機。如果您要連線到雲端供應商類型 (例如 Bitbucket)，請略過建立主機的步驟並繼續建立連線。
使用主控台設定主機並將其狀態從 `pending` 變更為 `available`。
![\[圖表顯示建立連至第三方供應商的連線之工作流程。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/Hosts-flowchart.png)
# AWS CodeConnections 中的全域資源
連線是全球資源，這表示會跨所有 AWS 區域複寫資源。
雖然連線 ARN 格式會反映建立時的區域名稱，不過資源不受限於任何區域。建立連線資源的區域是控制連線資源資料更新的區域。控制連線資源資料更新的 API 作業範例包括：建立連線、更新安裝、刪除連線或標記連線。
連線的主機資源不是全球可用的資源。您只能在建立主機資源的區域中使用資源。
+ 您只需建立一次連線，然後就可以在任何 AWS 區域中使用。
+ 如果建立連線的區域發生問題，會影響控制連線資源資料的 API，但您仍可成功在其他各個區域中使用該連線。
+ 當您在主控台或 CLI 中列出連線資源時，清單會顯示所有區域中與您帳戶相關聯的所有連線資源。
+ 當您在主控台或 CLI 中列出主機資源時，清單只會顯示所選區域中與您帳戶相關聯的主機資源。
+ 使用 CLI 列出或檢視與相關主機資源的連線時，無論設定的 CLI 區域為何，輸出都會傳回主機 ARN。
## 如何開始使用連線？
若要開始使用，以下是一些有用的主題可供檢閱：
+ **了解**關於連線的[概念](concepts-connections.md)。
+ **設定**開始使用連線[所需的資源](setting-up-connections.md)。
+ **開始使用**使用您的[第一個連線](getting-started-connections.md)並將它們連線到資源。
# 連線概念
如果您了解概念和術語，設定和使用連線功能會比較容易。以下是使用開發人員工具主控台中的連線時需要了解的一些概念：
安裝
第三方帳戶上的 AWS 應用程式執行個體。安裝 AWS CodeStar Connector 應用程式可讓 AWS 存取第三方帳戶中的資源。只能在第三方供應商的網站上編輯安裝。
連線
用來將第三方來源儲存庫連線至其他 AWS 服務 AWS 的資源。
第三方儲存庫
由服務或公司提供且不屬於 AWS的儲存庫。例如，Bitbucket 儲存庫是第三方儲存庫。
供應商類型
提供您所連線第三方來源儲存庫的服務或公司。您可以將 AWS 資源連線至外部*提供者類型*。在網路和基礎設施上安裝來源儲存庫的供應商類型是安裝式供應商類型。例如，GitHub Enterprise Server 是安裝式供應商類型。
託管
代表安裝第三方供應商之基礎設施的資源。連線會使用主機來代表安裝第三方供應商的伺服器，例如 GitHub Enterprise Server。您可以為該供應商類型的所有連線建立一個主機。
使用主控台建立連至 GitHub Enterprise Server 的連線時，主控台會為您建立主機資源作為程序的一部分。
# AWS CodeConnections 支援的提供者和版本
本章提供有關 AWS CodeConnections 支援的提供者和版本的資訊。
**Topics**
+ [Azure DevOps 支援的提供者類型](#w2aab5c25c22b9)
+ [Bitbucket 支援的供應商類型](#supported-versions-connections-bitbucket)
+ [GitHub 和 GitHub Enterprise Cloud 支援的供應商類型](#supported-versions-connections-github)
+ [GitHub Enterprise Server 支援的供應商類型和版本](#supported-versions-connections-ghes)
+ [GitLab.com 支援的提供者類型](#supported-versions-connections-gitlab)
+ [支援的 GitLab 自我管理供應商類型](#supported-versions-connections-gitlab-managed)
## Azure DevOps 支援的提供者類型
您可以搭配 Azure DevOps 使用連線應用程式。
不支援已安裝 （託管） 提供者類型，例如 Azure Cloud Hosting。
## Bitbucket 支援的供應商類型
您可以搭配 Atlassian Bitbucket Cloud 使用連線應用程式。
不支援安裝式 Bitbucket 供應商類型，例如 Bitbucket 伺服器。
## GitHub 和 GitHub Enterprise Cloud 支援的供應商類型
您可以搭配 GitHub 和 GitHub Enterprise Cloud 使用連線應用程式。
## GitHub Enterprise Server 支援的供應商類型和版本
您可以使用連線應用程式搭配支援的 GitHub Enterprise Server 版本。如需支援的版本的清單，請參閱[https://enterprise.github.com/releases/](https://enterprise.github.com/releases/)。
**重要**
AWS CodeConnections 不支援已取代的 GitHub Enterprise Server 版本。例如，由於版本中的已知問題， AWS CodeConnections 不支援 GitHub Enterprise Server 2.22.0 版。若要連線，請升級至 2.22.1 版或最新的可用版本。
## GitLab.com 支援的提供者類型
您可以搭配 GitLab.com. 如需詳細資訊，請參閱[建立連至 GitLab 的連線](connections-create-gitlab.md)。
**重要**
GitLab 的連線支援包括 15.x 版和更新版本。
## 支援的 GitLab 自我管理供應商類型
您可以使用 GitLab 自我管理安裝的連接 (適用於企業版或社群版)。如需詳細資訊，請參閱[建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)。
# 與 AWS CodeConnections 的產品和服務整合
AWS CodeConnections 已與許多 AWS 服務和合作夥伴產品和服務整合。使用下列各節中的資訊，協助您設定連線以整合您要使用的產品和服務。
以下相關資源可協助您使用此服務。
**Topics**
+ [Amazon CodeGuru Reviewer](#integrations-connections-codeguru)
+ [Amazon Q Developer](#integrations-connections-codewhisperer)
+ [Amazon SageMaker](#integrations-connections-sagemaker)
+ [AWS App Runner](#integrations-connections-apprunner)
+ [AWS CloudFormation](#integrations-connections-cloudformation)
+ [AWS CodeBuild](#integrations-connections-codebuild)
+ [AWS CodePipeline](#integrations-connections-codepipeline)
+ [Service Catalog](#integrations-connections-servicecatalog)
+ [AWS Proton](#integrations-connections-proton)
## Amazon CodeGuru Reviewer
[CodeGuru Reviewer](https://aws.amazon.com/codeguru/) 是用於監控儲存庫程式碼的服務。您可以使用連線與含有您想要審查之程式碼的第三方儲存庫建立關聯。如需瞭解如何設定 CodeGuru Reviewer 以監控 GitHub 儲存庫中原始碼的教學課程，以便建立改善程式碼的建議，請參閱 *Amazon CodeGuru Reviewer 使用者指南*中的[教學課程：監控 GitHub 儲存庫中的原始碼](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/tutorial-github-reviewer.html)。
## Amazon Q Developer
Amazon Q Developer 是採用 AI 技術的生成式對話式助理，可協助您了解、建置、擴展和操作 AWS 應用程式。如需詳細資訊，請參閱《Amazon Q Developer 使用者指南》**中的 [What is Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html) 部分。
## Amazon SageMaker
[Amazon SageMaker](https://aws.amazon.com/sagemaker/) 是一項用於建置、訓練和部署機器學習語言模型的服務。如需設定 GitHub 儲存庫連線的教學課程，請參閱《Amazon SageMaker 開發人員指南》**中的[使用第三方 Git 儲存庫的 SageMaker MLOps 專案逐步解說](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-projects-walkthrough-3rdgit.html)。
## AWS App Runner
[AWS App Runner](https://aws.amazon.com/apprunner/) 這項服務提供快速、簡單且符合成本效益的方式，可在 AWS 雲端中直接將原始碼或容器映像部署到可擴展的安全 Web 應用程式上。您可以使用 App Runner 自動整合和交付管道，從儲存庫部署應用程式的程式碼。您可以使用連線從私有 GitHub 儲存庫將原始碼部署至 App Runner 服務。如需詳細資訊，請參閱在 *AWS App Runner 開發人員指南*中的[原始碼儲存庫提供者](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-code.html)。
## AWS CloudFormation
[AWS CloudFormation](https://aws.amazon.com/cloudformation/) 是一項服務，可協助您建立和設定 AWS 資源的模型，以減少管理這些資源的時間，並有更多時間專注於在 中執行的應用程式 AWS。您可以建立範本來描述您想要的所有 AWS 資源 （例如 Amazon EC2 執行個體或 Amazon RDS 資料庫執行個體），而 CloudFormation 會負責為您佈建和設定這些資源。
您可以使用 CloudFormation 中的 Git 同步連線來建立同步組態，以監控您的 Git 儲存庫。如需使用 Git 同步進行堆疊部署的教學課程，請參閱*CloudFormation 《 使用者指南*》中的[使用 CloudFormation Git 同步](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/git-sync.html)。
如需 CloudFormation 的詳細資訊，請參閱[CloudFormation 命令列界面使用者指南》中的註冊您的帳戶以發佈 CloudFormation 延伸](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html)模組。 *CloudFormation *
## AWS CodeBuild
[AWS CodeBuild](https://aws.amazon.com/codebuild/) 是一項用於建置和測試程式碼的服務。CodeBuild 不需要佈建、管理和擴展您自己的組建伺服器，並為熱門程式設計語言和組建工具提供預先封裝的組建環境。如需搭配 GitLab 連線使用 CodeBuild 的詳細資訊，請參閱*AWS CodeBuild 《 使用者指南*》中的 [GitLab 連線](https://docs.aws.amazon.com/codebuild/latest/userguide/connections-gitlab.html)。
## AWS CodePipeline
[CodePipeline](https://aws.amazon.com/codepipeline/) 是一種持續交付的服務，讓您能夠將發行軟體所需的步驟模型化、視覺化和自動化。您可以使用連線為 CodePipeline 來源動作設定第三方儲存庫。
進一步了解：
+ `SourceConnections` 動作請參閱 CodePipeline 動作組態參考頁面。若要檢視設定參數和範例 JSON/YAML 程式碼片段，請參閱 *AWS CodePipeline 使用者指南*的 [CodeStarSourceConnection](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html)。
+ 若要檢視使用第三方來源儲存庫建立管道的**入門**教學，請參閱 [開始使用連線](getting-started-connections.md)。
## Service Catalog
[Service Catalog](https://aws.amazon.com/servicecatalog/) 可讓組織建立和管理已核准用於 的產品目錄 AWS。
當您授權 AWS 帳戶 GitHub Enterprise 或 Bitbucket 等外部儲存庫提供者之間的連線時，該連線可讓您將 Service Catalog 產品同步至透過第三方儲存庫管理的範本檔案。
如需詳細資訊，請參閱《Service Catalog 使用者指南》**中[將 Service Catalog 產品同步至 GitHub、GitHub Enterprise 或 Bitbucket 中的範本檔案](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/git-synced-sc-products.html)。
## AWS Proton
[AWS Proton](https://aws.amazon.com/proton/) 是用於部署到雲端基礎架構的雲端服務。您可以使用連線為 AWS Proton範本中的資源建立第三方儲存庫的連結。如需詳細資訊，請參閱 *AWS Proton 使用者指南*中的[建立儲存庫的連結](https://docs.aws.amazon.com/proton/latest/userguide/ag-create-repo.html)。
# 設定連線
完成本節中的任務，進行設定以建立和使用開發人員工具主控台中的連線功能。
**Topics**
+ [註冊 AWS](#setting-up-aws-sign-up)
+ [建立並套用具有建立連線許可的策略](#setting-up-connections-iamuser)
## 註冊 AWS
### 註冊 AWS 帳戶
如果您沒有 AWS 帳戶，請完成下列步驟來建立一個。
**註冊 AWS 帳戶**
1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。
1. 請遵循線上指示進行。
部分註冊程序需接收來電或簡訊，並在電話鍵盤輸入驗證碼。
當您註冊 時 AWS 帳戶，*AWS 帳戶根使用者*會建立 。根使用者有權存取該帳戶中的所有 AWS 服務 和資源。作為安全最佳實務，請將管理存取權指派給使用者，並且僅使用根使用者來執行[需要根使用者存取權的任務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。
AWS 會在註冊程序完成後傳送確認電子郵件給您。您可以隨時登錄 [https://aws.amazon.com/](https://aws.amazon.com/) 並選擇**我的帳戶**，以檢視您目前的帳戶活動並管理帳戶。
### 建立具有管理存取權的使用者
註冊 後 AWS 帳戶，請保護 AWS 帳戶根使用者、啟用 AWS IAM Identity Center和建立管理使用者，以免將根使用者用於日常任務。
**保護您的 AWS 帳戶根使用者**
1. 選擇**根使用者**並輸入 AWS 帳戶 您的電子郵件地址，以帳戶擁有者[AWS 管理主控台](https://console.aws.amazon.com/)身分登入 。在下一頁中，輸入您的密碼。
如需使用根使用者登入的說明，請參閱 *AWS 登入 使用者指南*中的[以根使用者身分登入](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)。
1. 若要在您的根使用者帳戶上啟用多重要素驗證 (MFA)。
如需說明，請參閱《*IAM 使用者指南*》中的[為您的 AWS 帳戶 根使用者 （主控台） 啟用虛擬 MFA 裝置](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html)。
**建立具有管理存取權的使用者**
1. 啟用 IAM Identity Center。
如需指示，請參閱《AWS IAM Identity Center 使用者指南》**中的[啟用 AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html)。
1. 在 IAM Identity Center 中，將管理存取權授予使用者。
如需使用 IAM Identity Center 目錄 做為身分來源的教學課程，請參閱*AWS IAM Identity Center 《 使用者指南*》中的[使用預設值設定使用者存取 IAM Identity Center 目錄](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html)。
**以具有管理存取權的使用者身分登入**
+ 若要使用您的 IAM Identity Center 使用者簽署，請使用建立 IAM Identity Center 使用者時傳送至您電子郵件地址的簽署 URL。
如需使用 IAM Identity Center 使用者登入的說明，請參閱*AWS 登入 《 使用者指南*》中的[登入 AWS 存取入口網站](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)。
**指派存取權給其他使用者**
1. 在 IAM Identity Center 中，建立一個許可集來遵循套用最低權限的最佳實務。
如需指示，請參閱《AWS IAM Identity Center 使用者指南》**中的[建立許可集](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html)。
1. 將使用者指派至群組，然後對該群組指派單一登入存取權。
如需指示，請參閱《AWS IAM Identity Center 使用者指南》**中的[新增群組](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html)。
## 建立並套用具有建立連線許可的策略
**若要使用 JSON 政策編輯器來建立政策**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。
1. 在左側的導覽窗格中，選擇 **Policies (政策)**。
如果這是您第一次選擇 **Policies (政策)**，將會顯示 **Welcome to Managed Policies (歡迎使用受管政策)** 頁面。選擇 **Get Started (開始使用)**。
1. 在頁面頂端，選擇 **Create policy (建立政策)**。
1. 在**政策編輯器**中，選擇 **JSON** 選項。
1. 輸入下列 JSON 政策文件：
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codeconnections:CreateConnection",
"codeconnections:DeleteConnection",
"codeconnections:GetConnection",
"codeconnections:ListConnections",
"codeconnections:GetInstallationUrl",
"codeconnections:GetIndividualAccessToken",
"codeconnections:ListInstallationTargets",
"codeconnections:StartOAuthHandshake",
"codeconnections:UpdateConnectionInstallation",
"codeconnections:UseConnection"
],
"Resource": [
"*"
]
}
]
}
```
1. 選擇**下一步**。
**注意**
您可以隨時切換**視覺化**與 **JSON** 編輯器選項。不過，如果您進行變更或在**視覺化**編輯器中選擇**下一步**，IAM 就可能會調整您的政策結構，以便針對視覺化編輯器進行最佳化。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[調整政策結構](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure)。
1. 在**檢視與建立**頁面上，為您正在建立的政策輸入**政策名稱**與**描述** (選用)。檢視**此政策中定義的許可**，來查看您的政策所授予的許可。
1. 選擇 **Create policy** (建立政策) 儲存您的新政策。
# 開始使用連線
開始使用連線的最簡單方法是設定連線，將您的第三方來源儲存庫與您的 AWS 資源建立關聯。如果您想要將管道連線至 AWS 來源，例如 CodeCommit，您可以將管道做為來源動作連接到該管道。但是如果您有外部儲存庫，則必須建立連線來為儲存庫與管道建立關聯。在本教學課程中，您將設定與您的 Bitbucket 儲存庫和管道間的連線。
在本節中，您會透過下列項目使用連線：
+ AWS CodePipeline：在這些步驟中，您可以使用 Bitbucket 儲存庫做為管道來源建立管道。
+ [Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/welcome.html)：接下來，您可以將 Bitbucket 儲存庫與 CodeGuru Reviewer 中的意見回饋和分析工具建立關聯。
**Topics**
+ [先決條件](#getting-started-connections-prerequisites)
+ [步驟 1：編輯來源檔案](#getting-started-connections-edit)
+ [步驟 2：建立管道](#getting-started-connections-pipeline)
+ [步驟 3：為儲存庫與 CodeGuru Reviewer 建立關聯](#getting-started-connections-analysis)
## 先決條件
開始之前，請完成 [設定](setting-up.md) 中的步驟。您也需要要連線至 AWS 服務的第三方來源儲存庫，並允許連線為您管理身分驗證。例如，您可能想要將 Bitbucket 儲存庫連接到與來源儲存庫整合的 AWS 服務。
+ 使用您的 Bitbucket 帳戶建立一個 Bitbucket 儲存庫。
+ 準備好您的 Bitbucket 憑證。當您使用 AWS 管理主控台 設定連線時，系統會要求您使用 Bitbucket 登入資料登入。
## 步驟 1：編輯來源檔案
建立 Bitbucket 儲存庫時會內含一個預設的 `README.md` 檔案，您需編輯這個檔案。
1. 登入您的 Bitbucket 儲存庫並選擇 **Source (來源)**。
1. 選擇 `README.md` 檔案並選擇頁面頂端的 **Edit (編輯)**。刪除現有的文字，並新增下列文字。
```
This is a Bitbucket repository!
```
1. 選擇 **Commit** (遞交)。
確定 `README.md` 檔案位於儲存庫的根層級。
## 步驟 2：建立管道
在本節中，您可以採取下列動作建立管道：
+ 使用連至 Bitbucket 儲存庫和動作的連線之來源階段。
+ 具有建置動作的 AWS CodeBuild 建置階段。
**使用精靈建立管道**
1. 前往 [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/) 登入 CodePipeline 主控台。
1. 在 **Welcome (歡迎)** 頁面、**Getting started (入門)** 頁面、或者 **Pipelines (管道)** 頁面上，選擇 **Create pipeline (建立管道)**。
1. 在 **Step 1: Choose pipeline settings (步驟 1：選擇管道設定)** 的 **Pipeline name (管道名稱)** 中，輸入 **MyBitbucketPipeline**。
1. 在 **Service role (服務角色)** 中，選擇 **New service role (新服務角色)**。
**注意**
如果您選擇改用現有的 CodePipeline 服務角色，請確定您已將 `codeconnections:UseConnection` IAM 許可新增至您的服務角色政策。如需 CodePipeline 服務角色的說明，請參閱[為 CodePipeline 服務角色新增許可](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services)。
1. 在**進階設定**底下，請保留預設值。在**Artifact store (成品存放區)** 中，針對您為管道所選取區域中的管道，選擇 **Default location (預設位置)**，即可使用預設成品存放區 (例如指定為預設值的 Amazon S3 成品儲存貯體)。
**注意**
這不是原始碼的來源儲存貯體。這是管道的成品存放區。每個管道都需要有個別成品存放區，例如 S3 儲存貯體。
選擇 **Next (下一步)**。
1. 在 **Step 2: Add source stage (步驟 2：新增來源階段)** 頁面上，新增來源階段：
1. 在 **Source provider (來源供應商)** 中，選擇 **Bitbucket**。
1. 在 **Connection (連線)** 底下，選擇 **Connect to Bitbucket (連線至 Bitbucket)**。
1. 在 **Connect to Bitbucket (連線至 Bitbucket)** 頁面的 **Connection name (連線名稱)** 中，輸入您要建立的連線名稱。此名稱可協助您稍後識別此連線。
在 **Bitbucket apps (Bitbucket 應用程式)** 底下中，選擇 **Install a new app (安裝新應用程式)**。
1. 在應用程式安裝頁面上，訊息顯示 AWS CodeStar 應用程式正在嘗試連線到您的 Bitbucket 帳戶。選擇 **Grant access (授與存取權)**。授權連線之後，就會偵測到 Bitbucket 上的儲存庫，您可以選擇將儲存庫與 AWS 資源建立關聯。
1. 隨即顯示新安裝的連線 ID。選擇 **Complete connection (完成連線)**。您將返回 CodePipeline 主控台。
1. 在 **Repository name (儲存庫名稱)** 中，選擇 Bitbucket 儲存庫的名稱。
1. 在 **Branch name (分支名稱)** 中，選擇儲存庫的分支。
1. 請確認已選取**在原始程式碼變更時啟動管道**選項。
1. 在**輸出成品格式**底下，選擇下列其中一項：**CodePipeline 預設**。
+ 選擇 **CodePipeline 預設**，以針對管道中的成品使用預設 zip 格式。
+ 選擇**完整複製**，以包含與管道中成品的儲存庫相關的 Git 中繼資料。只有 CodeBuild 動作支援此項。
選擇**下一步**。
1. 在 **Add build stage (新增建置階段)** 中，新增建置階段：
1. 在 **Build provider (建置供應商)** 中，選擇 **AWS CodeBuild**。允許 **Region (區域)** 預設為管道區域。
1. 選擇**建立專案**。
1. 在 **Project name (專案名稱)** 中，輸入此建置專案的名稱。
1. 在 **Environment image (環境映像)** 中，選擇 **Managed image (受管映像)**。針對 **Operating system (作業系統)**，選擇 **Ubuntu**。
1. 針對 **Runtime (執行時間)**，選擇 **Standard (標準)**。針對**映像**，選擇 **aws/codebuild/standard:5.0**。
1. 對於 **Service role (服務角色)**，選擇 **New service role (新服務角色)**。
1. 在 **BuildSpec** 底下，針對 **Build specifications (建置規格)** 選擇 **Insert build commands (插入建置命令)**。選擇 **Switch to editor (切換到編輯器)**，並將下方內容貼到 **Build commands (建置命令)** 底下：
```
version: 0.2
phases:
install:
#If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
#If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
runtime-versions:
nodejs: 12
# name: version
#commands:
# - command
# - command
pre_build:
commands:
- ls -lt
- cat README.md
# build:
#commands:
# - command
# - command
#post_build:
#commands:
# - command
# - command
#artifacts:
#files:
# - location
# - location
#name: $(date +%Y-%m-%d)
#discard-paths: yes
#base-directory: location
#cache:
#paths:
# - paths
```
1. 選擇 **Continue to CodePipeline (繼續 CodePipeline)**。這會傳回 CodePipeline 主控台，並建立使用您的建置命令進行設定的 CodeBuild 專案。建置專案使用服務角色來管理 AWS 服務許可。此步驟可能需要數分鐘。
1. 選擇**下一步**。
1. 在 **Step 4: Add deploy stage (步驟 4：新增部署階段)** 頁面上，選擇 **Skip deploy stage (跳過部署階段)**，然後再次選擇 **Skip (跳過)** 來接受警告訊息。選擇**下一步**。
1. 在 **Step 5: Review (步驟 5：檢閱)** 上，選擇 **Create pipeline (建立管道)**。
1. 成功建立管道後，管道就會開始執行。
![\[顯示透過 Bitbucket 來源成功完成之管道的主控台螢幕擷取畫面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/pipeline-wizard-bitbucket.png)
1. 在成功的建置階段上，選擇 **Details (詳細資訊)**。
在 **Execution details (執行詳細資訊)** 底下，檢視 CodeBuild 建置輸出。這些命令會輸出 `README.md` 檔案內容，如下所示：
```
This is a Bitbucket repository!
```
![\[顯示成功完成建置輸出範例的主控台螢幕擷取畫面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/pipeline-wizard-bitbucket-output.png)
## 步驟 3：為儲存庫與 CodeGuru Reviewer 建立關聯
建立連線後，您可以將該連線用於相同帳戶中的所有 AWS 資源。例如，您可以針對管道中的 CodePipeline 來源動作使用相同的 Bitbucket 連線，並在 CodeGuru Reviewer 中執行儲存庫遞交分析。
1. 登入 CodeGuru Reviewer 主控台。
1. 在 **CodeGuru Reviewer** 底下，選擇**Associate repository (為儲存庫建立關聯)**。
隨即會開啟單頁式精靈。
1. 在 **Select source provider (選取來源提供程式)** 底下，選擇 **Bitbucket**。
1. 在**連線至 Bitbucket (with AWS CodeConnections)** 下，選擇您為管道建立的連線。
1. 在 **Repository location (儲存庫位置)** 底下，選擇 Bitbucket 儲存庫的名稱，然後選擇 **Associate (建立關聯)**。
您可以繼續設定程式碼檢閱。如需詳細資訊，請參閱 [Amazon CodeGuru Reviewer 使用者指南](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-bitbucket-association.html)中的*連線至 Bitbucket 並為儲存庫與 CodeGuru Reviewer 建立關聯*。
# 使用連線
*連線*是用於將 AWS 資源連線到外部程式碼儲存庫的組態。每個連線都是可以提供給 等 服務的資源 AWS CodePipeline ，以連線至 Bitbucket 等第三方儲存庫。例如，您可以在 CodePipeline 中新增連線，以便在第三方程式碼儲存庫發生程式碼變更時觸發管道。您也可以將 AWS 資源連線至已安裝的提供者類型，例如 GitHub Enterprise Server。
**注意**
對於 GitHub 或 GitHub Enterprise Server 中的組織，您無法在多個 GitHub Organizations 中安裝 GitHub 應用程式。GitHub Organization 映射的應用程式是 1：1 映射。一個組織一次只能有一個應用程式；不過，您可以有多個連線指向相同的應用程式。如需詳細資訊，請參閱[AWS CodeConnections 中的連線如何與組織搭配使用](welcome-connections-how-it-works-github-organizations.md)。
如果您想要建立連至安裝式供應商類型 (例如 GitHub Enterprise Server) 的連線，主控台會為您建立主機。主機是您建立的資源，用來代表安裝供應商的伺服器。如需詳細資訊，請參閱[使用主機](connections-hosts.md)。
當您建立連線時，您可以使用主控台中的精靈，將連線應用程式與您的第三方供應商一起安裝，並將其與新的連線建立關聯。如果您已安裝 應用程式，則可以直接使用。
**注意**
若要在歐洲 （米蘭） 使用連線 AWS 區域，您必須：
安裝區域特定的應用程式
啟用區域
此區域特定的應用程式支援歐洲 (米蘭) 區域中的連線。它會在第三方供應商網站上發佈，並且它會與支援其他區域連線的現有應用程式分開。透過安裝此應用程式，您授權第三方提供商僅使用該區域服務來共用您的資料，並且您可以透過解除安裝該應用程式來隨時撤銷許可。
除非您啟用區域，否則服務不會處理或儲存您的資料。啟用此區域，即表示您授予我們服務許可來處理和儲存您的資料。
即使未啟用該區域，如果仍已安裝區域特定的應用程式，第三方供應商仍然可以使用我們的服務來共用您的資料，因此請確保在停用該區域後解除安裝該應用程式。如需詳細資訊，請參閱[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。
如需連線的詳細資訊，請參閱 [AWS CodeConnections API 參考](https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html)。如需適用於 Bitbucket 的 CodePipeline 來源動作詳細資訊，請參閱*《AWS CodePipeline 使用者指南》*中的 [CodestarConnectionSource](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html)。
若要建立政策或將政策連接至具有使用連線所需許可的 AWS Identity and Access Management (IAM) 使用者或角色，請參閱 [AWS CodeConnections 許可參考](security-iam.md#permissions-reference-connections)。根據 CodePipeline 服務角色的建立時間，您可能需要更新其許可來支援 AWS CodeConnections。如需說明，請參閱《*AWS CodePipeline 使用者指南*》中的[更新服務角色](https://docs.aws.amazon.com/codepipeline/latest/userguide/how-to-update-role-new-services.html)。
**Topics**
+ [建立連線](connections-create.md)
+ [建立與 Azure DevOps 的連線](connections-create-azure.md)
+ [建立連至 Bitbucket 的連線](connections-create-bitbucket.md)
+ [建立連至 GitHub 的連線](connections-create-github.md)
+ [建立連至 GitHub Enterprise Server 的連線](connections-create-gheserver.md)
+ [建立連至 GitLab 的連線](connections-create-gitlab.md)
+ [建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)
+ [更新待定連線](connections-update.md)
+ [列出連線](connections-list.md)
+ [刪除一個連線](connections-delete.md)
+ [標記連線資源](connections-tag.md)
+ [檢視連線詳細資訊](connections-view-details.md)
+ [與 共用連線 AWS 帳戶](connections-share.md)
# 建立連線
您可以建立連至下列第三方供應商類型的連線：
+ 若要建立連至 Bitbucket 的連線，請參閱「[建立連至 Bitbucket 的連線](connections-create-bitbucket.md)」。
+ 若要建立連至 GitHub 或 GitHub Enterprise Cloud 的連線，請參閱「[建立連至 GitHub 的連線](connections-create-github.md)」。
+ 若要建立連至 GitHub Enterprise Server 的連線，包括建立主機資源，請參閱「[建立連至 GitHub Enterprise Server 的連線](connections-create-gheserver.md)」。
+ 若要建立連至 GitLab 的連線，請參閱 [建立連至 GitLab 的連線](connections-create-gitlab.md)。
+ 若要建立與 Azure DevOps 的連線，請參閱[建立與 Azure DevOps 的連線](connections-create-azure.md)。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
# 建立與 Azure DevOps 的連線
您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 來建立與 Azure DevOps 上託管之儲存庫的連線。
開始之前：
+ 您必須已使用 Azure DevOps 建立 帳戶。
+ 您必須已在 Azure DevOps 入口網站上建立專案和 Azure 儲存庫。您的帳戶必須具有儲存庫的管理員存取權。
**注意**
您可以建立與 Azure DevOps 儲存庫的連線。不支援已安裝 （在主機上） Azure 提供者類型，例如 Azure Cloud Hosting。請參閱 [AWS CodeConnections 支援的提供者和版本](supported-versions-connections.md)。
**注意**
連線只能存取用於建立連線之帳戶擁有的儲存庫。
**Topics**
+ [建立與 Azure DevOps 的連線 （主控台）](#connections-create-azure-console)
+ [建立 Azure DevOps (CLI) 的連線](#connections-create-azure-cli)
## 建立與 Azure DevOps 的連線 （主控台）
您可以使用 主控台來建立與 Azure DevOps 的連線。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**步驟 1：建立連線**
1. 登入 AWS 管理主控台，並在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Create connection (建立連線)**。
1. 若要建立與 Azure DevOps 儲存庫的連線，請在**選取提供者**下選擇 **Azure DevOps**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇**連線至 Azure DevOps**，然後繼續進行步驟 2。
![\[主控台螢幕擷取畫面，顯示針對 Azure DevOps 選取的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-azure-updated.png)
**步驟 2：連線至 Azure DevOps**
1. 在**連線至 Azure DevOps** 設定頁面上，會顯示您的連線名稱。
1. 如果顯示 Microsoft 的登入頁面，請使用您的登入資料登入，然後選擇繼續。
如果這是您第一次從中建立與 Azure DevOps 的連線，您可能需要授予許可 AWS 管理主控台。
![\[建立 Azure DevOps 連線時，第一次使用者的 Microsoft 許可請求螢幕擷取畫面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/permissions_request_azure.png)
1. 選擇 **Accept (接受)**。
1. 在連線頁面上，會顯示新安裝的連線 ID。
1. 選擇**連線**以建立連線。建立的連線會顯示在連線清單中，現在處於可用狀態且可供使用。
## 建立 Azure DevOps (CLI) 的連線
您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。
若要這麼做，請使用 **create-connection** 命令。
**重要**
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。
**建立與 Azure DevOps 的連線**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--provider-type`和 。在此範例中，第三方供應商名稱為 `AzureDevOps`，而指定的連線名稱為 `MyConnection`。
```
aws codeconnections create-connection --provider-type AzureDevOps --connection-name MyConnection
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. 使用主控台完成連線。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
# 建立連至 Bitbucket 的連線
您可以使用 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 的連線 (主控台)
您可以使用 主控台來建立 Bitbucket 的連線。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**步驟 1：建立連線**
1. 登入 AWS 管理主控台，並在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Create connection (建立連線)**。
1. 若要建立連至 Bitbucket 儲存庫的連線，請在 **Select a provider (選取供應商)** 底下選擇 **Bitbucket**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇 **Connect to Bitbucket (連線至 Bitbucket)**，然後繼續進行步驟 2。
![\[主控台螢幕擷取畫面顯示為 Bitbucket 選擇的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-bitbucket.png)
**步驟 2：連線至 Bitbucket**
1. **Connect to Bitbucket (連線至 Bitbucket)** 設定頁面上會顯示您的連線名稱。
在 **Bitbucket apps (Bitbucket 應用程式)** 底下，選擇應用程式安裝，或選擇 **Install a new app (安裝新應用程式)** 以建立安裝。
**注意**
您只能為每個 Bitbucket 工作區或帳戶安裝一次應用程式。如果您已安裝 Bitbucket 應用程式，請選擇該應用程式並移至本節的最後一個步驟。
![\[主控台螢幕擷取畫面顯示「Connect to Bitbucket (連線至 Bitbucket)」對話方塊，包含安裝新應用程式的按鈕。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/newreview-source-wizard-bitbucket.png)
1. 如果顯示 Bitbucket 的登入頁面，請使用您的憑證登入，然後選擇繼續進行。
1. 在應用程式安裝頁面上，訊息顯示 AWS CodeStar 應用程式正在嘗試連線到您的 Bitbucket 帳戶。
若您使用的是 Bitbucket 工作區，請將 **Authorize for** (授權) 選項變更為工作區。僅會顯示您具有管理員存取權的工作區。
選擇 **Grant access (授與存取權)**。
![\[主控台螢幕擷取畫面，顯示連接器存取請求。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/bitbucket-access-popup.png)
1. 在 **Bitbucket apps (Bitbucket 應用程式)** 中，會顯示新安裝的連線 ID。選擇 **Connect (連線)**。建立的連線會顯示在連線清單中。
![\[主控台螢幕擷取畫面，顯示連接器存取請求。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/create-connection-bitbucket-app-ID.png)
## 建立連至 Bitbucket 的連線 (CLI)
您可以使用 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)。
# 建立連至 GitHub 的連線
您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 建立 GitHub 的連線。
開始之前：
+ 您必須已建立 GitHub 帳戶。
+ 您必須已建立第三方程式碼儲存庫。
**注意**
如要建立連線，您必須是 GitHub 組織擁有者。對於不在組織下的儲存庫，您必須是儲存庫擁有者。
**Topics**
+ [建立連至 GitHub 的連線 (主控台)](#connections-create-github-console)
+ [建立連至 GitHub 的連線 (CLI)](#connections-create-github-cli)
## 建立連至 GitHub 的連線 (主控台)
您可以使用 主控台建立與 GitHub 的連線。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
1. 登入 AWS 管理主控台，然後開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Create connection (建立連線)**。
1. 若要建立連至 GitHub 或 GitHub Enterprise Cloud 儲存庫的連線，請在 **Select a provider (選取供應商)** 底下選擇 **GitHub**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇 **Connect to GitHub (連線至 GitHub)**，然後繼續進行步驟 2。
![\[主控台螢幕擷取畫面顯示為 Bitbucket 選擇的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn.png)
**建立連至 GitHub 的連線**
1. 在 **GitHub connection settings** (GitHub 連線設定) 之下，您的連線名稱會顯示於 **Connection name** (連線名稱) 中。選擇**連線到 GitHub**。隨即會顯示存取請求頁面。
![\[主控台螢幕擷取畫面顯示 GitHub 帳戶存取頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access.png)
1. 選擇**授權 AWS GitHub 連接器**。連線頁面會出現，並顯示 **GitHub Apps (GitHub 應用程式)** 欄位。
![\[主控台螢幕擷取畫面顯示包含 GitHub 應用程式欄位的初始 GitHub 連線頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app.png)
1. 在 **GitHub Apps (GitHub 應用程式)** 底下，選擇應用程式安裝，或選擇 **Install a new app (安裝新應用程式)** 以建立安裝。
**注意**
您可以為您連至特定供應商的所有連線安裝一個應用程式。如果您已安裝 AWS Connector for GitHub 應用程式，請選擇它並略過此步驟。
1. 在**安裝適用於 GitHub 的AWS Connector** 頁面上，選擇要安裝應用程式的帳戶。
![\[主控台螢幕擷取畫面，顯示 AWS Connector for GitHub 安裝頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app-install1.png)
**注意**
您只能為每個 GitHub 帳戶安裝一次應用程式。如果您先前已安裝應用程式，可以選擇 **Configure (設定)**，繼續前往應用程式安裝的修改頁面，或者您可以使用上一步按鈕返回主控台。
1. 在**安裝 GitHub AWS 連接器**頁面上，保留預設值，然後選擇**安裝**。
![\[主控台螢幕擷取畫面，顯示第二個 AWS Connector for GitHub 安裝頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app-install2.png)
完成此步驟後，更新的許可頁面可能會顯示在 GitHub 中。
1. 如果顯示的頁面顯示適用於 GitHub 應用程式的 AWS 連接器已更新許可，請選擇 **Accept new permissions** (接受新許可)。
![\[主控台螢幕擷取畫面顯示 AWS Connector for GitHub 已更新許可頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/accept-new-permissions.png)
1. 您會返回 **Connect to GitHub** (連線至 GitHub) 頁面。新安裝的連線 ID 會顯示在 **GitHub Apps** (GitHub 應用程式) 中。選擇**連線**。
### 檢視您建立的連線
+ 建立的連線會顯示在連線清單中。
![\[主控台螢幕擷取畫面顯示成功建立連線的連線列表。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghe-complete.png)
## 建立連至 GitHub 的連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 建立 GitHub 的連線。
若要這麼做，請使用 **create-connection** 命令。
**重要**
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。
**建立連至 GitHub 的連線**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--provider-type`和 。在此範例中，第三方供應商名稱為 `GitHub`，而指定的連線名稱為 `MyConnection`。
```
aws codeconnections create-connection --provider-type GitHub --connection-name MyConnection
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. 使用主控台完成連線。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
# 建立連至 GitHub Enterprise Server 的連線
您可以使用連線將您的 AWS 資源與第三方儲存庫建立關聯。您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 建立 GitHub Enterprise Server 的連線。
連線僅可存取 GitHub Enterprise Server 帳戶所擁有的儲存庫，該帳戶在連線建立過程中用於授權 GitHub 應用程式的安裝。
開始之前：
+ 您必須已有一個 GitHub Enterprise Server 執行個體且其中包含一個儲存庫。
+ 您需為 GitHub Enterprise Server 執行個體的管理員，才能建立 GitHub 應用程式並建立主機資源，如本節所示。
**重要**
您為 GitHub Enterprise Server 設定主機時，系統會為您建立 Webhook 事件資料的 VPC 端點。如果您是在 2020 年 11 月 24 日之前建立主機，且想要使用 VPC PrivateLink Webhook 端點，您必須先[刪除](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html)主機，然後[建立](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html)新主機。
**注意**
對於 GitHub Enterprise Server 或 GitLab 自我管理中的組織，您不會傳遞可用的主機。您為組織中的每個連線建立新的主機，而且務必在主機的網路欄位中輸入相同的資訊 (VPC ID、子網路 IDs 和安全群組 IDs)。如需詳細資訊，請參閱[支援組織的已安裝供應商的連線和主機設定](troubleshooting-connections.md#troubleshooting-organization-host)。
**Topics**
+ [建立連至 GitHub Enterprise Server 的連線 (主控台)](connections-create-gheserver-console.md)
+ [建立連至 GitHub Enterprise Server 的連線 (CLI)](connections-create-gheserver-cli.md)
# 建立連至 GitHub Enterprise Server 的連線 (主控台)
若要建立 GitHub Enterprise Server 連線，您可以提供 GitHub Enterprise Server 安裝位置的資訊，並授權使用您的 GitHub Enterprise 憑證連線建立。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**Topics**
+ [建立 GitHub Enterprise Server 連線 (主控台)](#connections-create-gheserver-connection)
## 建立 GitHub Enterprise Server 連線 (主控台)
若要建立連至 GitHub Enterprise Server 的連線，請準備好您的伺服器 URL 和 GitHub Enterprise 憑證。
**建立主機**
1. 登入 AWS 管理主控台，並在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 在 **Hosts (主機)** 索引標籤中，選擇 **Create host (建立主機)**。
1. 在 **Host name (主機名稱)** 中，輸入您想要使用的主機名稱。
1. 在**選取提供者**中，選擇下列其中一項：
+ **GitHub Enterprise Server**
+ **GitLab 自我管理**
1. 在 **URL** 中，輸入安裝供應商之基礎設施的端點。
1. 如果您的伺服器是在 Amazon VPC 內設定的，而您想要與 VPC 連線，請選擇 **Use a VPC (使用 VPC)**。否則，請選擇 **No VPC (無 VPC)**。
1. 如果您已將執行個體啟動到 Amazon VPC 中，且想與 VPC 連線，請選擇 **Use a VPC (使用 VPC)**，然後完成以下操作。
1. 在 **VPC ID** 底下，選擇您的 VPC ID。請務必選擇安裝執行個體的基礎設施之 VPC，或是可透過 VPN 或 Direct Connect 存取執行個體的 VPC。
1. 如果您已設定私有 VPC，且已將執行個體設定為使用非公有憑證授權機構執行 TLS 驗證，請在 **TLS certificate (TLS 憑證)** 中輸入您的憑證 ID。TLS 憑證值應該是憑證的公有金鑰。
1. 選擇 **Create host (建立主機)**。
1. 主機詳細資訊頁面顯示後，主機狀態會隨主機建立而變更。
**注意**
如果您的主機設定包含 VPC 組態，需花幾分鐘的時間來佈建主機網路元件。
等待您的主機到達 **Pending (待定)** 狀態，然後完成設定。如需詳細資訊，請參閱[設定待定主機](connections-host-setup.md)。
![\[主控台螢幕擷取畫面顯示主機的詳細資訊，主機處於待定狀態。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-host-pending.png)
**步驟 2：建立 GitHub Enterprise Server 連線 (主控台)**
1. 登入 AWS 管理主控台 並開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Create connection (建立連線)**。
1. 若要建立連至已安裝 GitHub Enterprise Server 儲存庫的連線，請選擇 **GitHub Enterprise Server**。
**連線至 GitHub Enterprise Server**
1. 針對 **Connection name (連線名稱**)，請輸入連線的名稱。
![\[主控台螢幕擷取畫面顯示沒有 VPC 的「Create host settings (建立主機設定)」頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-screen.png)
1. 在 **URL** 中，輸入伺服器的端點。
**注意**
如果提供的 URL 已經用於為連線設定 GitHub Enterprise Server，系統將提示您選擇先前為該端點建立的主機資源 ARN。
1. （選用）如果您已將伺服器啟動到 Amazon VPC 中，且想與 VPC 連線，請選擇 **Use a VPC (使用 VPC)**，然後完成以下操作。
**注意**
對於 GitHub Enterprise Server 或 GitLab 自我管理中的組織，您不會傳遞可用的主機。您為組織中的每個連線建立新的主機，而且務必在主機的網路欄位中輸入相同的資訊 (VPC ID、子網路 IDs 和安全群組 IDs)。如需詳細資訊，請參閱[支援組織的已安裝供應商的連線和主機設定](troubleshooting-connections.md#troubleshooting-organization-host)。
1. 在 **VPC ID** 底下，選擇您的 VPC ID。請務必選擇安裝 GitHub Enterprise Server 執行個體的基礎設施之 VPC，或是可透過 VPN 或 Direct Connect 存取 GitHub Enterprise Server 執行個體的 VPC。
1. 在 **Subnet ID (子網路 ID)** 底下，選擇 **Add (新增)**。在欄位中，選擇您要用於主機的子網路 ID。您最多可選擇 10 個子網路。
請務必選擇安裝 GitHub Enterprise Server 執行個體的基礎設施之子網路，或是可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的子網路。
1. 在 **Security group IDs (安全群組 ID)** 底下，選擇 **Add (新增)**。在欄位中，選擇您要用於主機的安全群組。您最多可以選擇 10 個安全群組。
請務必選擇安裝 GitHub Enterprise Server 執行個體的基礎設施之安全群組，或是可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的安全群組。
1. 如果您已設定私有 VPC，且已將 GitHub Enterprise Server 執行個體設定為使用非公有憑證授權機構執行 TLS 驗證，請在 **TLS certificate (TLS 憑證)** 中輸入您的憑證 ID。TLS 憑證值應該是憑證的公有金鑰。
![\[主控台螢幕擷取畫面顯示設定 VPC 選項的建立 GitHub Enterprise Server 連線頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-screen-vpc.png)
1. 選擇 **Connect to GitHub Enterprise Server (連線至 GitHub Enterprise Server)**。建立的連線會顯示 **Pending (待定)** 狀態。系統會利用您提供的伺服器資訊為連線建立主機資源。主機名稱會使用 URL。
1. 選擇 **Update pending connection (更新待定連線)**。
![\[主控台螢幕擷取畫面顯示待定 GitHub Enterprise Server 連線頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-pending.png)
1. 如果出現提示，請在 GitHub Enterprise 登入頁面上使用您的 GitHub Enterprise 憑證登入。
1. 在 **Create GitHub App (建立 GitHub 應用程式)** 頁面上，為應用程式選擇名稱。
![\[主控台螢幕擷取畫面顯示應用程式建立頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-app-name.png)
1. 在 GitHub 授權頁面上，選擇**Authorize (授權 <應用程式名稱>)**。
![\[主控台螢幕擷取畫面顯示應用程式授權頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-app-authorize.png)
1. 在應用程式安裝頁面上，訊息顯示連接器應用程式已準備好進行安裝。如果您有多個組織，系統可能會提示您選擇要安裝應用程式的組織。
選擇您要安裝應用程式的儲存庫設定。選擇 **Install (安裝)**。
![\[主控台螢幕擷取畫面顯示應用程式授權頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghes-app-install.png)
1. 連線頁面會顯示建立的連線處於 **Available (可用)** 狀態。
# 建立連至 GitHub Enterprise Server 的連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。
若要這麼做，請使用 **create-host** 與 **create-connection** 命令。
**重要**
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。
**步驟 1：建立用於 GitHub Enterprise Server 的主機 (CLI)**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 來執行 **create-host**命令，`--provider-endpoint`為您的連線指定 `--name`、 `--provider-type`和 。在此範例中，第三方供應商名稱為 `GitHubEnterpriseServer`，而端點為 `my-instance.dev`。
```
aws codeconnections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"
```
如果成功，此命令會傳回類似下列內容的主機 Amazon Resource Name (ARN) 資訊。
```
{
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
完成此步驟後，主機會處於 `PENDING` 狀態。
1. 使用主控台完成主機設定，並將主機變為 `Available` 狀態。如需詳細資訊，請參閱[設定待定主機](connections-host-setup.md)。
**步驟 2：在主控台中設定待處理主機**
1. 登入 AWS 管理主控台 並開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 使用主控台完成主機設定，並將主機變為 `Available` 狀態。請參閱 [設定待定主機](connections-host-setup.md)。
**步驟 3：建立 GitHub Enterprise Server 的連線 (CLI)**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--host-arn`和 。
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}
```
1. 使用主控台來設定待定連線。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
**步驟 4：在主控台中完成 GitHub Enterprise Server 的連線**
1. 登入 AWS 管理主控台 並開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 使用主控台來設定待處理連線，並將連線移動到 `Available` 狀態。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
# 建立連至 GitLab 的連線
您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 來建立與 gitlab.com 上託管之儲存庫的連線。
**注意**
在 GitLab 中授權此連線安裝，即表示您授權我們的服務處理您的資料，您隨時可以解除安裝應用程式以撤銷許可。
開始之前：
+ 您必須已在 GitLab 建立帳戶。
**注意**
連線只能存取用於建立和授權連線之帳戶。
**注意**
您可以對在 GitLab 中具有**擁有者**的角色建立連線，然後該連線可以與具有 CodePipeline 等資源的儲存庫搭配使用。如果是群組中的儲存庫，您不需要為群組擁有者。
**Topics**
+ [建立連至 GitLab 的連線 (主控台)](#connections-create-gitlab-console)
+ [建立連至 GitLab 的連線 (CLI)](#connections-create-gitlab-cli)
## 建立連至 GitLab 的連線 (主控台)
您可以使用 主控台來建立連線。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**步驟 1：建立連線**
1. 登入 AWS 管理主控台，然後在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇**設定**，然後選擇**連線**。選擇**建立連線**。
1. 若要建立連至 GitLab 儲存庫的連線，請在**選取供應商**底下選擇 **GitLab**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇**連線至 GitLab**。
![\[主控台螢幕擷取畫面中顯示針對 GitLab 選擇的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-gitlab.png)
1. GitLab 的登入頁面顯示時，使用您的憑證登入，然後選擇**登入**。
1. 此時會顯示授權頁面，當中包含請求連線授權以存取您的 GitLab 帳戶的訊息。
選擇 **Authorize** (授權)。
![\[螢幕擷取畫面中顯示授權您的 GitLab 帳戶連線的訊息。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/gitlab-authorization.png)
1. 瀏覽器會返回連線主控台頁面。新連線會出現在**建立 GitLab 連線**底下的**連線名稱**中。
1. 選擇**連線至 GitLab**。
成功建立連線後，會顯示成功橫幅。連線詳細資訊會在**連線設定**頁面上顯示。
## 建立連至 GitLab 的連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。
若要這麼做，請使用 **create-connection** 命令。
**重要**
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。
**建立連至 GitLab 的連線**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--provider-type`和 。在此範例中，第三方供應商名稱為 `GitLab`，而指定的連線名稱為 `MyConnection`。
```
aws codeconnections create-connection --provider-type GitLab --connection-name MyConnection
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. 使用主控台完成連線。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
# 建立連至 GitLab 自我管理的連線
您可以使用 GitLab 自我管理安裝來為 GitLab 企業版或社群版建立連線。
您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 為 GitLab 自我管理建立連線和主機。
**注意**
在 GitLab 自我管理中授權此連線應用程式，即表示您授權我們的服務處理您的資料，您隨時可以解除安裝應用程式以撤銷許可。
建立 GitLab 自我管理連線之前，需先建立用於該連線的主機，詳情請見下列步驟。如需為已安裝供應商建立主機工作流程的概觀，請參閱 [建立或更新主機的工作流程](welcome-hosts-workflow.md)。
您可以選擇性地使用 VPC 來設定主機。如需主機資源網路與 VPC 組態的詳細資訊，請參閱 [(選用) 先決條件：連線的網路或 Amazon VPC 組態](connections-host-create.md#connections-create-host-prereq) 和 [針對主機的 VPC 組態進行疑難排解](troubleshooting-connections.md#troubleshooting-connections-host-vpc) 中的 VPC 先決條件。
開始之前：
+ 您必須先在 GitLab 建立帳戶，並擁有具自我管理安裝的 GitLab 企業版或 GitLab 社群版。如需詳細資訊，請參閱 [https://docs.gitlab.com/ee/subscriptions/self\$1managed/](https://docs.gitlab.com/ee/subscriptions/self_managed/)。
**注意**
連線只能存取用於建立和授權連線之帳戶。
**注意**
您可以對在 GitLab 中具有**擁有者**角色的儲存庫建立連線，然後該連線可以與具有 CodePipeline 等資源搭配使用。如果是群組中的儲存庫，您不需要為群組擁有者。
+ 您必須已使用下列縮小範圍許可建立 GitLab 個人存取字符 (PAT)：`api`、`admin_mode`。如需詳細資訊，請參閱 [https://docs.gitlab.com/ee/user/profile/personal\$1access\$1tokens.html](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)。您必須是管理員，才能建立和使用 PAT。
**注意**
您的 PAT 會用於授權主機，不會以其他方式儲存或由連線使用。若要設置主體，您可以建立臨時 PAT，然後在設置主體後刪除 PAT。
**注意**
對於 GitHub Enterprise Server 或 GitLab 自我管理中的組織，您不會傳遞可用的主機。您為組織中的每個連線建立新的主機，而且務必在主機的網路欄位中輸入相同的資訊 (VPC ID、子網路 IDs 和安全群組 IDs)。如需詳細資訊，請參閱[支援組織的已安裝供應商的連線和主機設定](troubleshooting-connections.md#troubleshooting-organization-host)。
**Topics**
+ [建立 GitLab 自我管理的連線 (主控台)](#connections-create-gitlab-managed-console)
+ [建立連至 GitLab 自我管理的連線 (CLI)](#connections-create-gitlab-managed-cli)
## 建立 GitLab 自我管理的連線 (主控台)
在主控台中用這些步驟建立主機與連至 GitHub 自我管理的連線。針對在 VPC 中設定主機的考量事項，請參閱 [(選用) 先決條件：連線的網路或 Amazon VPC 組態](connections-host-create.md#connections-create-host-prereq)。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**注意**
您為單個 GitLab 自我管理安裝建立主機，然後可以管理與該主機的一個或多個 GitLab 自我管理連線。
**步驟 1：建立您的主機**
1. 登入 AWS 管理主控台，然後在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 在 **Hosts (主機)** 索引標籤中，選擇 **Create host (建立主機)**。
1. 在 **Host name (主機名稱)** 中，輸入您想要使用的主機名稱。
1. 在**選取提供者**中，選擇 **GitLab 自我管理**。
1. 在 **URL** 中，輸入安裝供應商之基礎設施的端點。
1. 如果您的伺服器是在 Amazon VPC 內設定的，而您想要與 VPC 連線，請選擇 **Use a VPC (使用 VPC)**。否則，請選擇 **No VPC (無 VPC)**。
1. （選用）如果您已將主機啟動到 Amazon VPC 中，且想與 VPC 連線，請選擇 **使用 VPC**，然後完成以下操作。
**注意**
對於 GitHub Enterprise Server 或 GitLab 自我管理中的組織，您不會傳遞可用的主機。您為組織中的每個連線建立新的主機，而且務必在主機的網路欄位中輸入相同的資訊 (VPC ID、子網路 IDs 和安全群組 IDs)。如需詳細資訊，請參閱[支援組織的已安裝供應商的連線和主機設定](troubleshooting-connections.md#troubleshooting-organization-host)。
1. 在 **VPC ID** 底下，選擇您的 VPC ID。請務必選擇安裝主機的基礎設施之 VPC，或是可透過 VPN 或 Direct Connect 存取執行個體的 VPC。
1. 如果您已設定私有 VPC，且已將主機設定為使用非公有憑證授權機構執行 TLS 驗證，請在 **TLS 憑證)** 中輸入您的憑證 ID。TLS 憑證值應該是憑證的公有金鑰。
1. 選擇 **Create host (建立主機)**。
1. 主機詳細資訊頁面顯示後，主機狀態會隨主機建立而變更。
**注意**
如果您的主機設定包含 VPC 組態，需花幾分鐘的時間來佈建主機網路元件。
等待您的主機到達 **Pending (待定)** 狀態，然後完成設定。如需詳細資訊，請參閱[設定待定主機](connections-host-setup.md)。
![\[主控台螢幕擷取畫面顯示 GitLab 自我管理主機的詳細資訊，主機處於待定狀態。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-glsm-host.png)
**步驟 2：設定待處理主機**
1. 選擇**設定主機**。
1. 將顯示**設定 *host\$1name*** 頁面。在**提供個人存取字符**中，僅提供 GitLab PAT 以下縮小範圍的許可： `api`和 `admin_mode`。
**注意**
只有管理員可以建立和使用 PAT。
![\[顯示新主機的 GitLab 個人存取權杖條目之主控台螢幕截圖\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-glsm-pat.png)
1. 主機成功註冊後，會出現主機詳細資訊頁面，並顯示主機狀態為 **Available (可用)**。
![\[顯示新主機可用狀態的主控台螢幕截圖\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-glsm-host-available.png)
**步驟 3：建立連線**
1. 登入 AWS 管理主控台，然後在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇**設定**，然後選擇**連線**。選擇**建立連線**。
1. 若要建立連至 GitLab 儲存庫的連線，請在**選取提供者**下選擇 **GitLab 自我管理**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。
![\[主控台螢幕截圖中顯示針對 GitLab 自我管理的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-glsm.png)
1. 在 **URL** 中，輸入伺服器的端點。
1. 如果您已將伺服器啟動到 Amazon VPC 中，且想與 VPC 連線，請選擇 **Use a VPC (使用 VPC)**，然後完成以下操作。
1. 在 **VPC ID** 底下，選擇您的 VPC ID。請務必選擇安裝主機的基礎設施之 VPC，或是可透過 VPN 或 Direct Connect 存取主機的 VPC。
1. 在 **Subnet ID (子網路 ID)** 底下，選擇 **Add (新增)**。在欄位中，選擇您要用於主機的子網路 ID。您最多可選擇 10 個子網路。
請務必選擇安裝主機的基礎設施之子網路，或是可透過 VPN 或 Direct Connect 存取已安裝主機的子網路。
1. 在 **Security group IDs (安全群組 ID)** 底下，選擇 **Add (新增)**。在欄位中，選擇您要用於主機的安全群組。您最多可以選擇 10 個安全群組。
請務必選擇安裝主機的基礎設施之安全群組，或是可透過 VPN 或 Direct Connect 存取已安裝主機的安全群組。
1. 如果您已設定私有 VPC，且已將主機設定為使用非公有憑證授權機構執行 TLS 驗證，請在 **TLS 憑證)** 中輸入您的憑證 ID。TLS 憑證值應該是憑證的公有金鑰。
1. 選擇**連線 GitLab 自我管理**。建立的連線會顯示 **Pending (待定)** 狀態。系統會利用您提供的伺服器資訊為連線建立主機資源。主機名稱會使用 URL。
1. 選擇 **Update pending connection (更新待定連線)**。
1. GitLab 的登入頁面顯示時，使用您的憑證登入，然後選擇**登入**。
1. 此時會顯示授權頁面，當中包含請求連線授權以存取您的 GitLab 帳戶的訊息。
選擇 **Authorize** (授權)。
1. 瀏覽器會返回連線主控台頁面。新連線會出現在**建立 GitLab 連線**底下的**連線名稱**中。
1. 選擇**連線 GitLab 自我管理**。
成功建立連線後，會顯示成功橫幅。連線詳細資訊會在**連線設定**頁面上顯示。
## 建立連至 GitLab 自我管理的連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 為 GitLab 自我管理建立主機和連線。
若要這麼做，請使用 **create-host** 與 **create-connection** 命令。
**重要**
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。
**步驟 1：為 GitLab 自我管理建立主機 (CLI)**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 來執行 **create-host**命令，`--provider-endpoint`為您的連線指定 `--name`、 `--provider-type`和 。在此範例中，第三方供應商名稱為 `GitLabSelfManaged`，而端點為 `my-instance.dev`。
```
aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"
```
如果成功，此命令會傳回類似下列內容的主機 Amazon Resource Name (ARN) 資訊。
```
{
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
完成此步驟後，主機會處於 `PENDING` 狀態。
1. 使用主控台完成主機設定，並依下列步驟將主機變為 `Available` 狀態。
**步驟 2：在主控台中設定待處理主機**
1. 登入 AWS 管理主控台 並開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 使用主控台完成主機設定，並將主機變為 `Available` 狀態。請參閱 [設定待定主機](connections-host-setup.md)。
**步驟 3：為 GitLab 自我管理建立連線 (CLI)**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--host-arn`和 。
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}
```
1. 在下列步驟使用主控台來設定待處理連線。
**步驟 4：在主控台中完成 GitLab 自我管理的連線**
1. 登入 AWS 管理主控台 並開啟位於 的開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 使用主控台來設定待處理連線，並將連線移動到 `Available` 狀態。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
# 更新待定連線
根據預設，透過 AWS Command Line Interface (AWS CLI) 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 AWS CLI 或 的連線後 CloudFormation，請使用 主控台來更新連線，使其成為狀態 `AVAILABLE`。
**注意**
您必須使用主控台更新待定連線。您無法使用 AWS CLI更新待定連線。
第一次使用主控台將新連線新增至第三方供應商時，您必須使用與連線相關聯的安裝來完成與第三方供應商的 OAuth 交握。
您可以使用開發人員工具主控台來完成待定連線。
**完成連線**
1. 開啟位於 的 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。
1. 選擇 **Settings > Connections (設定 > 連線)**。
與 AWS 您的帳戶相關聯的所有連線名稱都會顯示。
1. 在 **Name (名稱)** 中，選擇您要更新的待定連線名稱。
選擇處於 **Pending (待定)** 狀態的連線時，會啟用 **Update a pending connection (更新待定連線)**。
1. 選擇 **Update pending connection (更新待定連線)**。
1. 在 **Connect to Bitbucket (連線至 Bitbucket)** 頁面的 **Connection name (連線名稱)** 中，確認連線的名稱。
在 **Bitbucket apps (Bitbucket 應用程式)** 底下，選擇應用程式安裝，或選擇 **Install a new app (安裝新應用程式)** 以建立安裝。
![\[主控台螢幕擷取畫面顯示「Connect to Bitbucket (連線至 Bitbucket)」對話方塊，包含安裝新應用程式的按鈕。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/newreview-source-wizard-bitbucket.png)
1. 在應用程式安裝頁面上，訊息顯示 AWS CodeStar 應用程式正在嘗試連線到您的 Bitbucket 帳戶。選擇 **Grant access (授與存取權)**。
![\[主控台螢幕擷取畫面顯示 AWS CodeStar 請求存取。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/bitbucket-access-popup.png)
1. 隨即顯示新安裝的連線 ID。選擇 **Complete connection (完成連線)**。
# 列出連線
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **list-connections** 命令來檢視帳戶中的連線清單。
## 列出連線 (主控台)
**列出連線**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Settings > Connections (設定 > 連線)**。
1. 檢視連線的名稱、狀態和 ARN。
## 列出連線 (CLI)
您可以使用 AWS CLI 列出與第三方程式碼儲存庫的連線。針對與主機資源相關聯的連線 (例如連至 GitHub Enteprise Server 的連線)，輸出會額外傳回主機 ARN。
若要這麼做，請使用 **list-connections** 命令。
**列出連線**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示字元 (Windows)，然後使用 AWS CLI 執行**list-connections**命令。
```
aws codeconnections list-connections --provider-type Bitbucket
--max-results 5 --next-token: next-token
```
此命令會傳回下列輸出。
```
{
"Connections": [
{
"ConnectionName": "my-connection",
"ProviderType": "Bitbucket",
"Status": "PENDING",
"ARN": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
"OwnerAccountId": "account_id"
},
{
"ConnectionName": "my-other-connection",
"ProviderType": "Bitbucket",
"Status": "AVAILABLE",
"ARN": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
"OwnerAccountId": "account_id"
},
],
"NextToken": "next-token"
}
```
# 刪除一個連線
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **delete-connection** 命令來刪除連線。
**Topics**
+ [刪除連線 (主控台)](#connections-delete-console)
+ [刪除連線 (CLI)](#connections-delete-cli)
## 刪除連線 (主控台)
**刪除連線**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Settings > Connections (設定 > 連線)**。
1. 在 **Connection name (連線名稱)** 中，選擇您要刪除的連線名稱。
1. 選擇 **刪除**。
1. 在欄位中輸入 **delete** 以確認，然後選擇 **Delete (刪除)**。
**重要**
這個操作無法復原。
## 刪除連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 來刪除連線。
若要這麼做，請使用 **delete-connection** 命令。
**重要**
執行命令之後，就會刪除連線。不會顯示確認對話方塊。您可以建立新連線，但是 Amazon Resource Name (ARN) 永遠不會重複使用。
**刪除連線**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **delete-connection**命令，指定您要刪除之連線的 ARN。
```
aws codeconnections delete-connection --connection-arn arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
此命令不會傳回任何結果。
# 標記連線資源
*標籤*是您或 AWS 指派給 AWS 資源的自訂屬性標籤。每個 AWS 標籤有兩個部分：
+ *標籤鍵* (例如，`CostCenter`、`Environment` 或 `Project`)。標籤金鑰會區分大小寫。
+ 一個名為*標籤值* (例如，`111122223333`、`Production` 或團隊名稱) 的選用欄位。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。
這些合稱為*鍵值組*。
您可以使用主控台或 CLI 以標記資源。
您可以在 AWS CodeConnections 中標記下列資源類型：
+ 連線
+ 主機
這些步驟假設您已安裝最新版本的 AWS CLI 或已更新至目前版本。如需詳細資訊，請參閱「AWS Command Line Interface 使用者指南」**中的[安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。
除了使用標籤來識別、組織和追蹤資源之外，您還可以使用 AWS Identity and Access Management (IAM) 政策中的標籤來協助控制誰可以檢視資源並與之互動。如需以標籤為基礎的存取政策範例，請參閱[使用標籤控制對 AWS CodeConnections 資源的存取](connections-tag-based-access-control.md)。
**Topics**
+ [標記資源 (主控台)](#connections-tag-console)
+ [標記資源 ( CLI)](#connections-tag-cli)
## 標記資源 (主控台)
您可以使用主控台來新增、更新或移除連線資源的標籤。
**Topics**
+ [將標籤新增至連線資源 (主控台)](#connections-tag-console-add)
+ [檢視連線資源的標籤 (主控台)](#connections-tag-console-view)
+ [編輯連線資源的標籤 (主控台)](#connections-tag-console-edit)
+ [移除連線資源的標籤 (主控台)](#connections-tag-console-remove)
### 將標籤新增至連線資源 (主控台)
您可以使用主控台將標籤新增到現有連線或主機。
**注意**
當您為安裝式供應商 (例如 GitHub Enterprise Server) 建立連線，而且系統也為您建立了主機資源時，建立期間的標籤只會新增至連線。如果您想要將標籤重複用於新連線，這可讓您分別標記主機。如果您想要將標籤新增到主機，請使用這裡說明的步驟。
****為連線新增標籤****
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Edit Connection tags (編輯連線標籤)** 頁面。
1. 在 **Key (索引鍵)** 和Value**Value (值)** 欄中，在你想新增的各組標籤中輸入金鑰對。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Project**。在 **Value (值)** 中輸入 **ProjectA**。
![\[Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-tags.png)
1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後輸入更多標籤。
1. 選擇**提交**。標籤會列在連線設定之下。
****為主機新增標籤****
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在 **Key (索引鍵)** 和Value**Value (值)** 欄中，在你想新增的各組標籤中輸入金鑰對。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Project**。在 **Value (值)** 中輸入 **ProjectA**。
![\[Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/hosts-tag.png)
1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後為主機輸入更多標籤。
1. 選擇**提交**。標籤列在主機設定之下。
### 檢視連線資源的標籤 (主控台)
您可以使用主控台檢視現有資源的標籤。
**檢視連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要檢視的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，檢視 **Key (索引鍵)** 和 **Value (值)** 欄下方的連線標籤。
**檢視主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要檢視的主機。
1. 在 **Host tags (主機標籤)** 底下，檢視 **Key (索引鍵)** 和 **Value (值)** 欄下方的主機標籤。
### 編輯連線資源的標籤 (主控台)
您可以使用主控台來編輯已新增到連線資源的標籤。
**編輯連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Connection tags (連線標籤)** 頁面。
1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Project** 索引鍵，在 **Value (值)** 中將 **ProjectA** 變為 **ProjectB**。
1. 選擇**提交**。
**編輯主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Project** 索引鍵，在 **Value (值)** 中將 **ProjectA** 變為 **ProjectB**。
1. 選擇**提交**。
### 移除連線資源的標籤 (主控台)
您可以使用主控台或移除連線資源的標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。
**移除連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Connection tags (連線標籤)** 頁面。
1. 在您要刪除的金鑰和值的每個標籤旁邊，選擇 **移除標籤 (Remove tag)**。
1. 選擇**提交**。
**移除主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在您要刪除的金鑰和值的每個標籤旁邊，選擇 **移除標籤 (Remove tag)**。
1. 選擇**提交**。
## 標記資源 ( CLI)
您可以使用 CLI 來檢視、新增、更新或移除連線資源的標籤。
**Topics**
+ [將標籤新增至連線資源 (CLI)](#connections-tag-add)
+ [檢視連線資源的標籤 (CLI)](#connections-tag-view)
+ [編輯連線資源的標籤 (CLI)](#connections-tag-edit)
+ [移除連線資源的標籤 (CLI)](#connections-tag-delete)
### 將標籤新增至連線資源 (CLI)
您可以使用 AWS CLI 來標記連線中的資源。
在終端機或命令列，執行 **tag-resource** 命令，為您要新增標籤的資源指定 Amazon Resource Name (ARN)，以及您想新增之標籤的索引鍵和數值。您可以新增一個以上的標籤。
****為連線新增標籤****
1. 為您的資源取得 ARN。使用 [列出連線](connections-list.md) 中顯示的 **list-connections** 命令來取得連線 ARN。
1. 在終端機或命令列上執行 **tag-resource** 命令。
例如，使用下列命令來標記具有兩個標籤的連線，一個名為 *Project* 的標籤鍵且標籤值為 *Project*，以及一個名為 *ReadOnly* 的標籤鍵且標籤值為 *true*。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
若成功，此命令不會傳回任何內容。
****為主機新增標籤****
1. 為您的資源取得 ARN。使用 [列出主機](connections-host-list.md) 中顯示的 **list-hosts** 命令來取得主機 ARN。
1. 在終端機或命令列上執行 **tag-resource** 命令。
例如，使用下列命令來標記具有兩個標籤的主機，一個名為 *Project* 的標籤鍵且標籤值為 *ProjectA*，以及一個名為 *IscontainerBased* 的標籤鍵且標籤值為 *true*。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
若成功，此命令不會傳回任何內容。
### 檢視連線資源的標籤 (CLI)
您可以使用 AWS CLI 檢視連線資源的 AWS 標籤。若未新增標籤，傳回的清單空白。使用 **list-tags-for-resource** 命令檢視已新增至連線或主機的標籤。
****檢視連線的標籤****
1. 為您的資源取得 ARN。使用 [列出連線](connections-list.md) 中顯示的 **list-connections** 命令來取得連線 ARN。
1. 在終端機或命令列上執行 **list-tags-for-resource** 命令。例如，使用下列命令來檢視連線的標籤索引鍵和標籤值清單。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
這個命令會傳回與資源相關聯的標籤。這個範例會顯示針對連線傳回的兩個索引鍵值組。
```
{
"Tags": [
{
"Key": "Project",
"Value": "ProjectA"
},
{
"Key": "ReadOnly",
"Value": "true"
}
]
}
```
****檢視主機的標籤****
1. 為您的資源取得 ARN。使用 [列出主機](connections-host-list.md) 中顯示的 **list-hosts** 命令來取得主機 ARN。
1. 在終端機或命令列上執行 **list-tags-for-resource** 命令。例如，使用下列命令來檢視主機的標籤索引鍵和標籤值清單。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605
```
這個命令會傳回與資源相關聯的標籤。此範例顯示針對主機傳回的兩個索引鍵值組。
```
{
"Tags": [
{
"Key": "IscontainerBased",
"Value": "true"
},
{
"Key": "Project",
"Value": "ProjectA"
}
]
}
```
### 編輯連線資源的標籤 (CLI)
您可以使用 AWS CLI 編輯資源的標籤。您可以變更現有索引鍵的值或新增其他索引鍵。
在終端機或命令列，執行 **tag-resource** 命令，指定您要更新標籤的資源 ARN，並指定要更新的標籤索引鍵和標籤值。
編輯標籤時，任何未指定的標籤索引鍵都會保留，任何項目的索引鍵都相同，但會以新值更新。使用 edit 命令新增的索引鍵會新增為一對新的鍵值組。
****編輯連線的標籤****
1. 為您的資源取得 ARN。使用 [列出連線](connections-list.md) 中顯示的 **list-connections** 命令來取得連線 ARN。
1. 在終端機或命令列上執行 **tag-resource** 命令。
在這個範例中，索引鍵 `Project` 的數值會變更為 `ProjectB`。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
若成功，此命令不會傳回任何內容。若要驗證與連線相關聯的標籤，請執行 **list-tags-for-resource** 命令。
****編輯主機的標籤****
1. 為您的資源取得 ARN。使用 [列出主機](connections-host-list.md) 中顯示的 **list-hosts** 命令來取得主機 ARN。
1. 在終端機或命令列上執行 **tag-resource** 命令。
在這個範例中，索引鍵 `Project` 的數值會變更為 `ProjectB`。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
若成功，此命令不會傳回任何內容。若要驗證與主機相關聯的標籤，請執行 **list-tags-for-resource** 命令。
### 移除連線資源的標籤 (CLI)
請依照下列步驟，使用 從資源 AWS CLI 中移除標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。
**注意**
如果您刪除連線資源，則會從刪除的資源中移除所有標籤關聯。刪除連線資源之前，您不需要移除標籤。
在終端機或命令列，執行 **untag-resource** 命令，指定您想移除標籤的資源 ARN，和您想移除的標籤的標籤金鑰。例如，若要在具有標籤鍵 *Project* 和 *ReadOnly* 的連線上移除多個標籤，請使用下列命令。
```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly
```
若成功，此命令不會傳回任何內容。若要驗證與管道相關的標籤，請執行 **list-tags-for-resource** 命令。輸出顯示所有標籤皆已移除。
```
{
"Tags": []
}
```
# 檢視連線詳細資訊
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **get-connection** 命令來檢視連線的詳細資訊。若要使用 AWS CLI，您必須已安裝最新版本的 AWS CLI 或更新至目前版本。如需詳細資訊，請參閱《*AWS Command Line Interface 使用者指南*》中的[安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。
**檢視連線 (主控台)**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Settings > Connections (設定 > 連線)**。
1. 選擇您要檢視的連線旁邊的按鈕，然後選擇 **View details (檢視詳細資訊)**。
1. 隨即會顯示連線的下列資訊：
+ 連線名稱。
+ 連線的供應商類型。
+ VPN 連線狀態。
+ 連線 ARN。
+ 如果連線是針對安裝式供應商 (例如 GitHub Enterprise Server) 建立的，則會顯示與連線相關聯的主機資訊。
+ 如果連線是針對安裝式供應商 (例如 GitHub Enterprise Server) 建立的，則會顯示與連線的主機相關聯的端點資訊。
1. 如果連線處於 **Pending (待定)** 狀態，若要完成連線，請選擇 **Update pending connection (更新待定連線)**。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。
**檢視連線 (CLI)**
+ 在終端機或命令列上執行 **get-connection** 命令。例如，使用下列命令來檢視具有 `arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f` ARN 值之連線的詳細資訊。
```
aws codeconnections get-connection --connection-arn arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
如果成功，此命令會傳回連線詳細資訊。
Bitbucket 連線的輸出範例：
```
{
"Connection": {
"ConnectionName": "MyConnection",
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/cdacd948-EXAMPLE",
"ProviderType": "Bitbucket",
"OwnerAccountId": "account_id",
"ConnectionStatus": "AVAILABLE"
}
}
```
GitHub 連線的輸出範例：
```
{
"Connection": {
"ConnectionName": "MyGitHubConnection",
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/ebcd4a13-EXAMPLE",
"ProviderType": "GitHub",
"OwnerAccountId": "account_id",
"ConnectionStatus": "AVAILABLE"
}
}
```
GitHub Enterprise Server 連線的輸出範例：
```
{
"Connection": {
"ConnectionName": "MyConnection",
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/2d178fb9-EXAMPLE",
"ProviderType": "GitHubEnterpriseServer",
"OwnerAccountId": "account_id",
"ConnectionStatus": "PENDING",
"HostArn": "arn:aws:ccodeconnections:us-west-2:account_id:host/sdfsdf-EXAMPLE"
}
}
```
# 與 共用連線 AWS 帳戶
您可以使用 資源共用與 AWS RAM 共用，與另一個 AWS 帳戶 或組織中的帳戶共用現有連線。您可以將共用連線與針對第三方來源連線 AWS 所管理的 中的資源搭配使用，例如 CodePipeline。
**重要**
`codestar-connections `資源不支援連線共用。這僅支援 `codeconnections` 資源。
開始之前：
+ 您必須已建立與 的連線 AWS 帳戶。
+ 您必須啟用資源共用。
+ 您必須設定必要的許可。如需詳細資訊，請參閱[支援連線共用的許可](security-iam.md#permissions-reference-connections-sharing)。
**注意**
若要共用連線，如果不是在組織下，您必須是組織擁有者或儲存庫擁有者。您要共用的帳戶也需要儲存庫的許可。
**Topics**
+ [共用連線 （主控台）](#connections-share-console)
+ [共用連線 (CLI)](#connections-share-cli)
+ [檢視共用連線 （主控台）](#connections-view-console)
+ [檢視共用連線 (CLI)](#connections-view-cli)
## 共用連線 （主控台）
您可以使用 主控台來建立共用連線資源。
1. 登入 AWS 管理主控台。
在 主控台的**[「由我共用」：「共用資源」頁面上，選擇](https://console.aws.amazon.com/ram/home#OwnedResources:)****「建立資源共用**」。 AWS RAM
1. 由於 AWS RAM 資源共用存在於特定 AWS 區域中，請從主控台右上角的下拉式清單中選擇適當的 AWS 區域。若要建立包含全域資源的資源共用，您必須將 AWS 區域設定為美國東部 （維吉尼亞北部），
如需共用全域資源的詳細資訊，請參閱[與全域資源相比共用區域資源](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html)。
1. 在建立頁面上的名稱中****，輸入資源共享的名稱。在**資源**下，選擇**程式碼連線**。
![\[\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-share-create.png)
1. 選擇您的連線資源，並指派您要與其共用的委託人。
1. 選擇**建立**。
## 共用連線 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 與其他帳戶共用現有的連線，並檢視您擁有或已與您共用的連線。
若要這樣做，請使用 的 **create-resource-share**和 `accept-resource-share-invitation `命令 AWS RAM。
**共用連線**
1. 使用將共用連線的帳戶登入。
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-resource-share**命令，`--principals`為您的連線共用指定 `--name`、 `--resource-arns`和 。在此範例中，名稱為 ，`my-shared-resource`且指定的連線名稱位於資源 ARN `MyConnection`中。在 中`principals`，提供您要共用的目的地帳戶。
```
aws ram create-resource-share --name my-shared-resource --resource-arns connection_ARN --principals destination_account
```
如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。
```
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
"name": "MyNewResourceShare",
"owningAccountId": "111111111111",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"creationTime": 1634586271.302,
"lastUpdatedTime": 1634586271.302
}
}
```
1. 可以接受共用的請求，如下一個程序中詳述。
**驗證並接受與目的地帳戶的連線共用**
對於屬於相同組織的目的地帳戶，以及在 Organizations 中啟用資源共用，下列程序是選用的。
1. 使用將收到邀請的目的地帳戶登入。
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **get-resource-share-invitations**命令。
```
aws ram get-resource-share-invitations
```
擷取下一個步驟的資源共享邀請 ARN。
1. 執行 **accept-resource-share-invitation**命令，指定 `--resource-share-invitation-arn`。
```
aws ram accept-resource-share-invitation --resource-share-invitation-arn invitation_ARN
```
如果成功，此命令會傳回下列輸出。
```
{
"resourceShareInvitation": {
"resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
"resourceShareName": "MyResourceShare",
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
"senderAccountId": "111111111111",
"receiverAccountId": "222222222222",
"invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
"status": "ACCEPTED"
}
}
```
## 檢視共用連線 （主控台）
您可以使用 主控台來檢視共用連線資源。
1. 登入 AWS 管理主控台。
在 AWS RAM 主控台中開啟**[由我共用：共用資源](https://console.aws.amazon.com/ram/home#OwnedResources:)**頁面。
1. 由於 AWS RAM 資源共用存在於特定 AWS 區域中，請從主控台右上角的下拉式清單中選擇適當的 AWS 區域。若要查看包含全域資源的資源共用，您必須將 AWS 區域設定為美國東部 （維吉尼亞北部），
如需共用全域資源的詳細資訊，請參閱[與全域資源相比共用區域資源](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html)。
1. 針對每項共用的資源，下列資訊可供使用：
+ **資源 ID** – 資源的 ID。選擇資源的 ID 以開啟新的瀏覽器索引標籤，以檢視其原生服務主控台中的資源。
+ **資源類型** – 資源的類型。
+ **上次共用日期** – 資源上次共用的日期。
+ **資源共用** – 包含資源的資源共用數目。若要查看資源共用的清單，請選擇號碼。
+ **主體** – 可存取資源的主體數量。選擇值以檢視委託人。
## 檢視共用連線 (CLI)
您可以使用 AWS CLI 來檢視您擁有或已與您共用的連線。
若要這麼做，請使用 **get-resource-shares** 命令。
**檢視共用連線**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **get-resource-shares**命令。
```
aws ram get-resource-shares
```
輸出會傳回您帳戶的資源共享清單。
# 使用主機
若要建立連至安裝式供應商類型 (例如 GitHub Enterprise Server) 的連線，請先使用 AWS 管理主控台建立一個主機。主機是您建立的資源，用來表示安裝供應商的基礎設施。然後使用該主機建立連線。如需詳細資訊，請參閱[使用連線](connections.md)。
例如，您可以為連線建立主機，讓供應商的第三方應用程式能註冊並代表您的基礎設施。為某個供應商類型建立一個主機，然後使用這個主機建立連至該供應商類型的所有連線。
使用主控台來建立連至安裝式供應商類型 (例如 GitHub Enterprise Server) 的連線時，主控台會為您建立主機資源。
**Topics**
+ [建立主機](connections-host-create.md)
+ [設定待定主機](connections-host-setup.md)
+ [列出主機](connections-host-list.md)
+ [編輯主機](connections-host-edit.md)
+ [刪除主機](connections-host-delete.md)
+ [檢視主機詳細資訊](connections-host-view.md)
# 建立主機
您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 來建立與安裝在基礎設施上之第三方程式碼儲存庫的連線。例如，您可能在 Amazon EC2 執行個體上將 GitHub Enterprise Server 做為虛擬機器執行。建立連至 GitHub Enterprise Server 的連線之前，需先建立用於該連線的主機。
如需為已安裝供應商建立主機工作流程的概觀，請參閱 [建立或更新主機的工作流程](welcome-hosts-workflow.md)。
開始之前：
+ (選用) 如果要使用 VPC 建立主機，您必須先建立好網路或虛擬私有雲端 (VPC)。
+ 您必須先建立好執行個體，且如果打算與 VPC 連線，須先將主機啟動到 VPC 中。
**注意**
每個 VPC 一次只能與一個主機相關聯。
您可以選擇性地使用 VPC 來設定主機。如需主機資源網路與 VPC 組態的詳細資訊，請參閱 [(選用) 先決條件：連線的網路或 Amazon VPC 組態](#connections-create-host-prereq) 和 [針對主機的 VPC 組態進行疑難排解](troubleshooting-connections.md#troubleshooting-connections-host-vpc) 中的 VPC 先決條件。
若要使用主控台建立主機與連至 GitHub Enterprise Server 的連線，請參閱 [建立 GitHub Enterprise Server 連線 (主控台)](connections-create-gheserver-console.md#connections-create-gheserver-connection)。主控台會為您建立一個主機。
若要使用主控台建立主機與連至 GitHub 自我管理的連線，請參閱 [建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)。主控台會為您建立一個主機。
## (選用) 先決條件：連線的網路或 Amazon VPC 組態
如果您的基礎設施已設定網路連線，您可以略過本節。
如果您的主機只能在 VPC 中存取，請遵循這些 VPC 要求再繼續進行。
### VPC 要求
您可以選擇性地使用 VPC 建立主機。以下是一般 VPC 要求，具體取決於您為安裝設定的 VPC。
+ 您可以透過公有和私有子網路設定*公有* VPC。如果您沒有慣用的 CIDR 區塊或子網路，您可以使用 AWS 帳戶 的預設 VPC。
+ 如果您已設定*私有* VPC，且已將 GitHub Enterprise Server 執行個體設定為使用非公有憑證授權機構執行 TLS 驗證，則需要為您的主機資源提供 TLS 憑證。
+ 連線建立主機時，會為您建立 Webhook 的 VPC 端點 (PrivateLink)。如需詳細資訊，請參閱[AWS CodeConnections 和介面 VPC 端點 (AWS PrivateLink)](vpc-interface-endpoints.md)。
+ 安全群組組態：
+ 主機建立期間使用的安全群組需要傳入和傳出規則，以允許網路介面連線到您的 GitHub Enterprise Server 執行個體
+ 連接到 GitHub Enterprise Server 執行個體 (不是主機設定的一部分) 的安全群組需要從連線所建立的網路介面進行傳入和傳出的權限。
+ VPC 子網路必須位於您區域中的不同可用區域。可用區域是不同的位置，與其他可用區域的故障隔離。各個子網必須完全位於某一可用區域內，不得跨越多個區域。
如需使用 VPC 和子網路的詳細資訊，請參閱《Amazon VPC 使用者指南》**中的 [IPv4 的 VPC 和子網路規模調整](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4)。
**您為主機設定提供的 VPC 資訊**
在下一個步驟中為連線建立主機資源時，您需要提供下列項目：
+ **VPC ID：**安裝 GitHub Enterprise Server 執行個體的伺服器之 VPC ID，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的 VPC。
+ **子網路 ID 或 ID：**安裝 GitHub Enterprise Server 執行個體的伺服器之子網路 ID，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的子網路。
+ **安全群組或群組：**安裝 GitHub Enterprise Server 執行個體的伺服器之安全群組，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的安全群組。
+ **端點：**準備好您的伺服器端點，繼續執行下一個步驟。
如需包含 VPC 或主機連線疑難排解在內的詳細資訊，請參閱「[針對主機的 VPC 組態進行疑難排解](troubleshooting-connections.md#troubleshooting-connections-host-vpc)」。
### 許可要求
在主機建立程序中， 會代表您 AWS CodeConnections 建立網路資源，以促進 VPC 連線。這包括 AWS CodeConnections 讓 從主機查詢資料的網路界面，以及讓主機透過 Webhook 將事件資料傳送至連線的 VPC 端點或 *PrivateLink*。若要建立這些網路資源，請確定建立主機所使用的角色具有下列許可：
```
ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints
```
如需針對 VPC 中許可或主機連線進行疑難排解的詳細資訊，請參閱「[針對主機的 VPC 組態進行疑難排解](troubleshooting-connections.md#troubleshooting-connections-host-vpc)」。
如需 Webhook VPC 端點的詳細資訊，請參閱「[AWS CodeConnections 和介面 VPC 端點 (AWS PrivateLink)](vpc-interface-endpoints.md)」。
**Topics**
+ [(選用) 先決條件：連線的網路或 Amazon VPC 組態](#connections-create-host-prereq)
+ [為連線建立主機 (主控台)](#connections-host-create-console)
+ [為連線建立主機 (CLI)](#connections-host-create-cli)
## 為連線建立主機 (主控台)
針對安裝連線 (如 GitHub Enterprise Server 或 GitLab 自我管理)，您可以使用主機來代表安裝第三方供應商的基礎設施之端點。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
若要了解在 VPC 中設定主機的考量事項，請參閱「[建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)」。
若要使用主控台建立主機與連至 GitHub Enterprise Server 的連線，請參閱 [建立 GitHub Enterprise Server 連線 (主控台)](connections-create-gheserver-console.md#connections-create-gheserver-connection)。主控台會為您建立一個主機。
若要使用主控台建立主機與連至 GitHub 自我管理的連線，請參閱 [建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)。主控台會為您建立一個主機。
**注意**
一個 GitHub Enterprise Server 或 GitLab 自我管理帳戶一次只能建立一個主機。所有連至特定 GitHub Enterprise Server 或 GitLab 自我管理帳戶的連線都會使用相同的主機。
## 為連線建立主機 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 為已安裝的連線建立主機。
**注意**
一個 GitHub Enterprise Server 帳戶只能建立一個主機。所有連至特定 GitHub Enterprise Server 帳戶的連線都會使用相同的主機。
您可以使用主機來代表安裝第三方供應商的基礎設施之端點。若要使用 CLI 建立主機，請使用 **create-host** 命令。主機建立完成後，該主機會處於 **Pending (待定)** 狀態。接著需*設定*主機，以將其變為 **Available (可用)** 狀態。主機變為可用後，便可完成建立連線的步驟。
**重要**
根據預設，透過 建立的主機 AWS CLI 處於 `Pending` 狀態。使用 CLI 建立主機後，需使用主控台將主機狀態設為 `Available`。
若要使用主控台建立主機與連至 GitHub Enterprise Server 的連線，請參閱 [建立 GitHub Enterprise Server 連線 (主控台)](connections-create-gheserver-console.md#connections-create-gheserver-connection)。主控台會為您建立一個主機。
若要使用主控台建立主機與連至 GitHub 自我管理的連線，請參閱 [建立連至 GitLab 自我管理的連線](connections-create-gitlab-managed.md)。主控台會為您建立一個主機。
# 設定待定主機
透過 AWS Command Line Interface (AWS CLI) 或 SDK 建立的主機預設處於 `Pending` 狀態。建立與 主控台 AWS CLI或 SDK 的連線後，請使用 主控台來設定主機使其狀態為 `Available`。
您必須已建立主機。如需詳細資訊，請參閱[建立主機](connections-host-create.md)。
**設定待定主機**
主機建立後會處於 **Pending (待定)** 狀態。若要讓主機從 **Pending (待定)** 變為 **Available (可用)**，請完成以下步驟。此程序會與第三方供應商執行交握，以在主機上註冊 AWS 連線應用程式。
1. 在 AWS 開發人員工具主控台上主機達到**待**定狀態後，請選擇**設定主機**。
1. 如果要為 GitLab 自我管理建立主機，則會顯示 **設置** 頁面。在**提供個人存取字符**中，僅向您的 GitLab PAT 提供下列範圍縮小許可：api。
1. 在第三方安裝式供應商登入頁面上 (例如 **GitHub Enterprise Server** 登入頁面)，如果出現提示，請使用您的帳戶憑證登入。
1. 在應用程式安裝頁面上，於 **GitHub App name (GitHub 應用程式名稱)** 中，輸入您要為主機安裝的應用程式名稱。選擇 **Create GitHub App (建立 GitHub 應用程式)**。
1. 主機成功註冊後，會出現主機詳細資訊頁面，並顯示主機狀態為 **Available (可用)**。
![\[主控台螢幕擷取畫面顯示主機設定完成且處於可用狀態。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-host-register-complete.png)
1. 主機變為可用後，您可以繼續建立連線。在成功橫幅上，選擇 **Create connection (建立連線)**。完成 [Create connection (建立連線)](connections-create-gheserver-console.md) 中的步驟。
# 列出主機
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **list-connections** 命令來檢視帳戶中的連線清單。
## 列出主機 (主控台)
**列出主機**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Hosts (主機)** 索引標籤。檢視主機的名稱、狀態和 ARN。
## 列出主機 (CLI)
您可以使用 AWS CLI 來列出主機，以進行已安裝的第三方供應商連線。
若要這麼做，請使用 **list-hosts** 命令。
**列出主機**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示字元 (Windows)，然後使用 AWS CLI 執行**list-hosts**命令。
```
aws codeconnections list-hosts
```
此命令會傳回下列輸出。
```
{
"Hosts": [
{
"Name": "My-Host",
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://my-instance.test.dev",
"Status": "AVAILABLE"
}
]
}
```
# 編輯主機
您可以為處於 `Pending` 狀態的主機編輯主機設定。您可以編輯主機名稱、URL 或 VPC 組態。
您不能為多個主機使用相同的 URL。
**注意**
若要了解在 VPC 中設定主機的考量事項，請參閱「[(選用) 先決條件：連線的網路或 Amazon VPC 組態](connections-host-create.md#connections-create-host-prereq)」。
**編輯主機**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Settings > Connections (設定 > 連線)**。
1. 選擇 **Hosts (主機)** 索引標籤。
隨即顯示與 AWS 您的帳戶相關聯的主機，以及在所選 AWS 區域中建立的主機。
1. 若要編輯主機名稱，請在 **Name (名稱)** 中輸入新值。
1. 若要編輯主機端點，請在 **URL** 中輸入新值。
1. 若要編輯主機 VPC 組態，請在 **VPC ID** 中輸入新值。
1. 選擇 **Edit host (編輯主機)**。
1. 隨即會顯示更新的設定。選擇 **Set up Pending host (設定待定主機)**。
# 刪除主機
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **delete-host** 命令來刪除主機。
**Topics**
+ [刪除主機 (主控台)](#connections-host-delete-console)
+ [刪除主機 (CLI)](#connections-host-delete-cli)
## 刪除主機 (主控台)
**刪除主機**
1. 開啟位於 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections) 的開發人員工具主控台。
1. 選擇 **Hosts (主機)** 索引標籤。在 **Name (名稱)** 中，選擇您想刪除的主機名稱。
1. 選擇 **刪除** 。
1. 在欄位中輸入 **delete** 以確認，然後選擇 **Delete (刪除)**。
**重要**
這個操作無法復原。
## 刪除主機 (CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 來刪除主機。
若要這麼做，請使用 **delete-host** 命令。
**重要**
您必須先刪除與主機相關聯的所有連線，才能刪除該主機。
執行命令之後，就會刪除主機。不會顯示確認對話方塊。
**刪除主機**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **delete-host**命令，指定您要刪除之主機的 Amazon Resource Name (ARN)。
```
aws codeconnections delete-host --host-arn "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
```
此命令不會傳回任何結果。
# 檢視主機詳細資訊
您可以使用開發人員工具主控台或 AWS Command Line Interface (AWS CLI) 中的 **get-host** 命令來檢視主機的詳細資訊。
**檢視主機詳細資訊 (主控台)**
1. 前往 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)，登入 AWS 管理主控台 並開啟開發人員工具主控台。
1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要檢視的主機旁邊的按鈕，然後選擇 **View details (檢視詳細資訊)**。
1. 隨即會顯示主機的下列資訊：
+ 主機名稱。
+ 連線的供應商類型。
+ 安裝供應商的基礎設施之端點。
+ 主機的設定狀態。準備用於連線的主機處於 **Available (可用)** 狀態。如果您的主機已建立但未完成安裝，該主機可能處於不同的狀態。
可使用的狀態如下：
+ PENDING - 主機已完成建立，並準備好在主機上註冊提供商應用程式以啟動設定。
+ AVAILABLE - 主機已完成建立和設定，可與連線搭配使用。
+ ERROR - 主機建立或註冊期間發生錯誤。
+ VPC\$1CONFIG\$1VPC\$1INITIALIZING - 正在建立主機的 VPC 組態。
+ VPC\$1CONFIG\$1VPC\$1FAILED\$1INITIALIZATION - 主機的 VPC 組態發生錯誤並失敗。
+ VPC\$1CONFIG\$1VPC\$1AVAILABLE - 主機的 VPC 組態已完成設定且可使用。
+ VPC\$1CONFIG\$1VPC\$1DELETING - 正在刪除主機的 VPC 組態。
![\[主控台螢幕擷取畫面顯示主機的詳細資訊，主機處於可用狀態。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-view-host-screen.png)
1. 選擇 **Delete (刪除)** 即可刪除主機。
1. 如果主機處於 **Pending (待定)** 狀態，若要完成設定，請選擇 **Set up host (設定主機)**。如需詳細資訊，請參閱[設定待定主機](connections-host-setup.md)。
**檢視主機詳細資訊 (CLI)**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示字元 (Windows)，然後使用 AWS CLI 執行 **get-host**命令，指定您要檢視其詳細資訊的主機 Amazon Resource Name (ARN)。
```
aws codeconnections get-host --host-arn arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605
```
此命令會傳回下列輸出。
```
{
"Name": "MyHost",
"Status": "AVAILABLE",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://test-instance-1.dev/"
}
```
# 使用連結儲存庫的同步組態
在 AWS CodeConnections 中，您可以使用連線將 AWS 資源關聯至第三方儲存庫，例如 GitHub、Bitbucket Cloud、GitHub Enterprise Server 和 GitLab。使用 `CFN_STACK_SYNC` 同步類型，您可以建立同步組態，允許 AWS 從 Git 儲存庫同步內容以更新指定的 AWS 資源。 會與連線 CloudFormation 整合，因此您可以使用 Git 同步來管理您同步之連結儲存庫中的範本和參數檔案。
建立連線後，您可以使用連線 CLI 或 CloudFormation 主控台來建立儲存庫連結和同步組態。
+ 儲存庫連結：儲存庫連結會在連線和外部 Git 儲存庫之間建立關聯。儲存庫連結可讓 Git 同步監控並同步指定 Git 儲存庫中檔案的變更。
+ 同步組態：使用同步組態從 Git 儲存庫同步內容以更新指定的 AWS 資源。
如需詳細資訊，請參閱 [https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html)。
如需使用 CloudFormation 主控台建立 CloudFormation 堆疊同步組態的教學課程，請參閱 *CloudFormation 使用者指南*中的[使用 CloudFormation Git 同步](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/git-sync.html)。
**Topics**
+ [使用儲存庫連結](repositorylinks.md)
+ [使用同步組態](syncconfigurations.md)
# 使用儲存庫連結
儲存庫連結會在連線和外部 Git 儲存庫之間建立關聯。儲存庫連結可讓 Git 同步監控指定 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)
# 建立儲存庫連結
您可以使用 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": []
}
}
```
# 更新儲存庫連結
您可以使用 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)。使用 AWS CLI 執行 **update-repository-link**命令，指定儲存庫連結要更新的值。例如，下列命令會更新與儲存庫連結 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": []
}
}
```
# 列出儲存庫連結
您可以使用 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": []
}
]
}
```
# 刪除儲存庫連結
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **delete-repository-link**命令來刪除儲存庫連結。
刪除儲存庫連結之前，您必須先刪除與儲存庫連結相關聯的所有同步組態。
**重要**
執行命令之後，就會刪除儲存庫連結。不會顯示確認對話方塊。您可以建立新儲存庫連結，但是 Amazon Resource Name (ARN) 不會重複使用。
**刪除儲存庫連結**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **delete-repository-link**命令，指定要刪除的儲存庫連結 ID。
```
aws codeconnections delete-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173
```
此命令不會傳回任何結果。
# 檢視儲存庫連結詳細資訊
您可以使用 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": []
}
}
```
# 使用同步組態
同步組態會在指定的儲存庫和連線之間建立關聯。使用同步組態來同步 Git 儲存庫中的內容，以更新指定的 AWS 資源。
如需連線的詳細資訊，請參閱 [AWS CodeConnections API 參考](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html)。
**Topics**
+ [建立同步組態](syncconfigurations-create.md)
+ [更新同步組態](syncconfigurations-update.md)
+ [列出同步組態](syncconfigurations-list.md)
+ [刪除同步組態](syncconfigurations-delete.md)
+ [檢視同步組態詳細資訊](syncconfigurations-view-details.md)
# 建立同步組態
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **create-repository-link**命令，在連線與要同步的外部儲存庫之間建立連結。
建立同步組態之前，您必須先在連線和第三方儲存庫之間建立儲存庫連結。
**建立同步組態**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-repository-link**命令。指定關聯連線的 ARN、擁有者 ID 和儲存庫名稱。下列命令會為 CloudFormation中的資源建立具有同步類型的同步組態。這也會指定儲存庫中的儲存庫分支和組態檔案。在此範例中，資源是命名為 **`mystack`** 的堆疊。
```
aws codeconnections create-sync-configuration --branch main --config-file filename --repository-link-id be8f2017-b016-4a77-87b4-608054f70e77 --resource-name mystack --role-arn arn:aws:iam::account_id:role/myrole --sync-type CFN_STACK_SYNC
```
1. 此命令會傳回下列輸出。
```
{
"SyncConfiguration": {
"Branch": "main",
"ConfigFile": "filename",
"OwnerId": "account_id",
"ProviderType": "GitHub",
"RepositoryLinkId": "be8f2017-b016-4a77-87b4-608054f70e77",
"RepositoryName": "MyRepo",
"ResourceName": "mystack",
"RoleArn": "arn:aws:iam::account_id:role/myrole",
"SyncType": "CFN_STACK_SYNC"
}
```
# 更新同步組態
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **update-sync-configuration** 命令來更新指定的同步組態。
您可以更新同步組態的下列資訊：
+ `--branch`
+ `--config-file`
+ `--repository-link-id`
+ `--resource-name`
+ `--role-arn`
**更新同步組態**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **update-sync-configuration**命令，指定您要更新的值，以及資源名稱和同步類型。例如，下列命令會使用 `--branch` 參數更新與同步組態相關聯的分支名稱。
```
aws codeconnections update-sync-configuration --sync-type CFN_STACK_SYNC --resource-name mystack --branch feature-branch
```
1. 此命令會傳回下列輸出。
```
{
"SyncConfiguration": {
"Branch": "feature-branch",
"ConfigFile": "filename.yaml",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"RepositoryName": "MyRepo",
"ResourceName": "mystack",
"RoleArn": "arn:aws:iam::account_id:role/myrole",
"SyncType": "CFN_STACK_SYNC"
}
```
# 列出同步組態
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **list-sync-configurations** 命令列出您帳戶的儲存庫連結。
**列出儲存庫連結**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **list-sync-configurations**命令，指定同步類型和儲存庫連結 ID。
```
aws codeconnections list-sync-configurations --repository-link-id 6053346f-8a33-4edb-9397-10394b695173 --sync-type CFN_STACK_SYNC
```
1. 此命令會傳回下列輸出。
```
{
"SyncConfigurations": [
{
"Branch": "main",
"ConfigFile": "filename.yaml",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"RepositoryName": "MyRepo",
"ResourceName": "mystack",
"RoleArn": "arn:aws:iam::account_id:role/myrole",
"SyncType": "CFN_STACK_SYNC"
}
]
}
```
# 刪除同步組態
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **delete-sync-configuration** 命令來刪除同步組態。
**重要**
執行命令之後，就會刪除同步組態。不會顯示確認對話方塊。您可以建立新同步組態，但是 Amazon Resource Name (ARN) 不會重複使用。
**刪除同步組態**
+ 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **delete-sync-configuration**命令，指定您要刪除之同步組態的同步類型和資源名稱。
```
aws codeconnections delete-sync-configuration --sync-type CFN_STACK_SYNC --resource-name mystack
```
此命令不會傳回任何結果。
# 檢視同步組態詳細資訊
您可以使用 AWS Command Line Interface (AWS CLI) 中的 **get-sync-configuration**命令來檢視同步組態的詳細資訊。
**檢視同步組態的詳細資訊**
1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **get-sync-configuration**命令，指定儲存庫連結 ID。
```
aws codeconnections get-sync-configuration --sync-type CFN_STACK_SYNC --resource-name mystack
```
1. 此命令會傳回下列輸出。
```
{
"SyncConfiguration": {
"Branch": "main",
"ConfigFile": "filename",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkId": "be8f2017-b016-4a77-87b4-608054f70e77",
"RepositoryName": "MyRepo",
"ResourceName": "mystack",
"RoleArn": "arn:aws:iam::account_id:role/myrole",
"SyncType": "CFN_STACK_SYNC"
}
}
```
# 使用 記錄 AWS CodeConnections API 呼叫 AWS CloudTrail
AWS CodeConnections 已與 服務整合 AWS CloudTrail，此服務可提供使用者、角色或服務所採取動作的記錄 AWS 。CloudTrail 會擷取通知的 API 呼叫當作事件。擷取的呼叫包括從開發人員工具主控台進行的呼叫，以及對 AWS CodeConnections API 操作的程式碼呼叫。
如果您建立追蹤記錄，就可以將 CloudTrail 事件持續交付到 Amazon Simple Storage Service (Amazon S3) 儲存貯體，包括通知的事件。即使您未設定追蹤，仍可透過 CloudTrail 主控台中的 **Event history (事件歷史記錄)** 檢視最新事件。您可利用 CloudTrail 所收集的資訊來判斷向 AWS CodeConnections發出的請求，以及發出請求的 IP 地址、人員、時間和其他詳細資訊。
如需詳細資訊，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
## AWS CodeConnections CloudTrail 中的資訊
當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當活動在 中發生時 AWS CodeConnections，該活動會與**事件歷史記錄**中的其他 AWS 服務事件一起記錄在 CloudTrail 事件中。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱 *AWS CloudTrail 使用者指南*中的 [使用 CloudTrail 事件歷史記錄檢視事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
若要持續記錄您 AWS 帳戶中的事件，包括 的事件 AWS CodeConnections，請建立追蹤。*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。依預設，當您在主控台中建立追蹤時，該追蹤會套用至所有的 AWS 區域。線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案傳送到您指定的 Amazon S3 儲存貯體。此外，您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。
如需詳細資訊，請參閱 *AWS CloudTrail 使用者指南*中的以下主題：
+ [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [設定 CloudTrail 的 Amazon SNS 通知](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [從多個區域接收 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [從多個帳戶接收 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
CloudTrail 會記錄所有 AWS CodeConnections 動作，並記錄在 [AWS CodeConnections API 參考](https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html)中。例如，對 `CreateConnection`、`DeleteConnection` 和 `GetConnection` 動作發出的呼叫會在 CloudTrail 記錄檔案中產生專案。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是否使用根或其他 IAM 憑證提出。
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。
+ 請求是否由其他 AWS 服務提出。
如需詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 了解 日誌檔案項目
*追蹤*是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個*事件*為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔並非依公有 API 呼叫的堆疊追蹤排序，因此不會以任何特定順序出現。
## `CreateConnection` 範例
以下範例顯示的是展示 `CreateConnection` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "b4374fde-c544-4d43-b511-7d899568e55a",
"EventName": "CreateConnection",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-09T15:13:46-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:user/Mary_Major",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-09T23:03:08Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-09T23:13:46Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "CreateConnection",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.create-connection",
"requestParameters": {
"providerType": "GitHub",
"connectionName": "my-connection"
},
"responseElements": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/df03df74-8e05-45cf-b420-b39e389dd264"
},
"requestID": "57640a88-97b7-481d-9665-cfd79a681379",
"eventID": "b4374fde-c544-4d43-b511-7d899568e55a",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `CreateHost` 範例
以下範例顯示的是展示 `CreateHost` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "af4ce349-9f21-43fb-8003-267fbf9b1a93",
"EventName": "CreateHost",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:43:06-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:43:06Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "CreateHost",
"awsRegion": "us-east-1",
"sourceIPAddress": "52.94.133.137",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.create-host",
"requestParameters": {
"name": "Demo1",
"providerType": "GitHubEnterpriseServer",
"providerEndpoint": "IP"
},
"responseElements": {
"hostArn": "arn:aws:codeconnections:us-east-1:123456789012:host/Demo1-EXAMPLE"
},
"requestID": "974459b3-8a04-4cff-9c8f-0c88647831cc",
"eventID": "af4ce349-9f21-43fb-8003-267fbf9b1a93",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `CreateSyncConfiguration` 範例
以下範例顯示的是展示 `CreateSyncConfiguration` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "be1397e1-eefb-49f0-b4ee-2708c45e94e7",
"EventName": "CreateSyncConfiguration",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T17:38:30+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T17:34:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T17:38:30Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "CreateSyncConfiguration",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.create-sync-configuration",
"requestParameters": {
"branch": "master",
"configFile": "filename",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"resourceName": "mystack",
"roleArn": "arn:aws:iam::123456789012:role/my-role",
"syncType": "CFN_STACK_SYNC"
},
"responseElements": {
"syncConfiguration": {
"branch": "main",
"configFile": "filename",
"ownerId": "owner_ID",
"providerType": "GitHub",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo",
"resourceName": "mystack",
"roleArn": "arn:aws:iam::123456789012:role/my-role",
"syncType": "CFN_STACK_SYNC"
}
},
"requestID": "bad2f662-3f2a-42c0-b638-6115384896f6",
"eventID": "be1397e1-eefb-49f0-b4ee-2708c45e94e7",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `DeleteConnection` 範例
以下範例顯示的是展示 `DeleteConnection` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "672837cd-f977-4fe2-95c7-14280b2af76c",
"EventName": "DeleteConnection",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-10T13:00:50-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::001919387613:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-10T20:41:16Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-10T21:00:50Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "DeleteConnection",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.delete-connection",
"requestParameters": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/df03df74-8e05-45cf-b420-b39e389dd264"
},
"responseElements": null,
"requestID": "4f26ceab-d665-41df-9e15-5ed0fbb4eca6",
"eventID": "672837cd-f977-4fe2-95c7-14280b2af76c",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `DeleteHost` 範例
以下範例顯示的是展示 `DeleteHost` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "6018ba5c-6f24-4a30-b201-16ec19a1687a",
"EventName": "DeleteHost",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:56:47-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:56:47Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "DeleteHost",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.delete-host",
"requestParameters": {
"hostArn": "arn:aws:codeconnections:us-east-1:123456789012:host/Demo1-EXAMPLE"
},
"responseElements": null,
"requestID": "1b244528-143a-4028-b9a4-9479e342bce5",
"eventID": "6018ba5c-6f24-4a30-b201-16ec19a1687a",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `DeleteSyncConfiguration` 範例
以下範例顯示的是展示 `DeleteSyncConfiguration` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "588660c7-3202-4998-a906-7bb72bcf4438",
"EventName": "DeleteSyncConfiguration",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T17:41:59+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T17:34:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T17:41:59Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "DeleteSyncConfiguration",
"awsRegion": "us-east-1",
"sourceIPAddress": "52.94.133.142",
"userAgent": "aws-cli/2.15.11Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.delete-sync-configuration",
"requestParameters": {
"syncType": "CFN_STACK_SYNC",
"resourceName": "mystack"
},
"responseElements": null,
"requestID": "221e0b1c-a50e-4cf0-ab7d-780154e29c94",
"eventID": "588660c7-3202-4998-a906-7bb72bcf4438",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetConnection` 範例
以下範例顯示的是展示 `GetConnection` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "672837cd-f977-4fe2-95c7-14280b2af76c",
"EventName": "DeleteConnection",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-10T13:00:50-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-10T20:41:16Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-10T21:00:50Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "DeleteConnection",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.delete-connection",
"requestParameters": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/df03df74-8e05-45cf-b420-b39e389dd264"
},
"responseElements": null,
"requestID": "4f26ceab-d665-41df-9e15-5ed0fbb4eca6",
"eventID": "672837cd-f977-4fe2-95c7-14280b2af76c",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "001919387613",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetHost` 範例
以下範例顯示的是展示 `GetHost` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "faa147e7-fe7c-4ab9-a11b-2568a2883c01",
"EventName": "GetHost",
"ReadOnly": "true",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:44:34-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:44:34Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetHost",
"awsRegion": "us-east-1",
"sourceIPAddress": "52.94.133.137",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.get-host",
"requestParameters": {
"hostArn": "arn:aws:codeconnections:us-east-1:123456789012:host/Demo1-EXAMPLE"
},
"responseElements": null,
"requestID": "0ad61bb6-f88f-4f96-92fe-997f017ec2bb",
"eventID": "faa147e7-fe7c-4ab9-a11b-2568a2883c01",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetRepositoryLink` 範例
以下範例顯示的是展示 `GetRepositoryLink` 動作的 CloudTrail 日誌項目。
```
{
"EventId": "b46acb67-3612-41c7-8987-adb6c9ed4ad4",
"EventName": "GetRepositoryLink",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T02:59:28+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T02:58:52Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T02:59:28Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetRepositoryLink",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.get-repository-link",
"requestParameters": {
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173"
},
"responseElements": {
"repositoryLinkInfo": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/7df263cc-f055-4843-adef-4ceaefcb2167",
"ownerId": "123456789012",
"providerType": "GitHub",
"repositoryLinkArn": "arn:aws:codeconnections:us-east-1:123456789012:repository-link/6053346f-8a33-4edb-9397-10394b695173",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo"
}
},
"requestID": "d46704dd-dbe9-462f-96a6-022a8d319fd1",
"eventID": "b46acb67-3612-41c7-8987-adb6c9ed4ad4",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-ea-1.codeconnections.aws.dev"
}
}
}
```
## `GetRepositorySyncStatus` 範例
下列範例顯示示範 [GetRepositorySyncStatus](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_GetRepositorySyncStatus.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "3e183b74-d8c4-4ad3-9de3-6b5721c522e9",
"EventName": "GetRepositorySyncStatus",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T03:41:44+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T02:56:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T03:41:44Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetRepositorySyncStatus",
"awsRegion": "us-east-1",
"sourceIPAddress": "52.94.133.138",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.get-repository-sync-status",
"errorCode": "ResourceNotFoundException",
"errorMessage": "Could not find a sync status for repository link:6053346f-8a33-4edb-9397-10394b695173",
"requestParameters": {
"branch": "feature-branch",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"syncType": "CFN_STACK_SYNC"
},
"responseElements": null,
"requestID": "e0cee3ee-31e8-4ef5-b749-96cdcabbe36f",
"eventID": "3e183b74-d8c4-4ad3-9de3-6b5721c522e9",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetResourceSyncStatus` 範例
下列範例顯示示範 [GetResourceSyncStatus](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_GetResourceSyncStatus.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "9c47054e-f6f6-4345-96d0-9a5af3954a8d",
"EventName": "GetResourceSyncStatus",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T03:44:11+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T02:56:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T03:44:11Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetResourceSyncStatus",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.get-resource-sync-status",
"requestParameters": {
"resourceName": "mystack",
"syncType": "CFN_STACK_SYNC"
},
"responseElements": null,
"requestID": "e74b5503-d651-4920-9fd2-0f40fb5681e0",
"eventID": "9c47054e-f6f6-4345-96d0-9a5af3954a8d",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetSyncBlockerSummary` 範例
下列範例顯示示範 [GetSyncBlockerSummary](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_GetSyncBlockerSummary.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "c16699ba-a788-476d-8c6c-47511d76309e",
"EventName": "GetSyncBlockerSummary",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T03:03:02+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T02:56:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T03:03:02Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetSyncBlockerSummary",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.get-sync-blocker-summary",
"requestParameters": {
"syncType": "CFN_STACK_SYNC",
"resourceName": "mystack"
},
"responseElements": {
"syncBlockerSummary": {
"resourceName": "mystack",
"latestBlockers": []
}
},
"requestID": "04240091-eb25-4138-840d-776f8e5375b4",
"eventID": "c16699ba-a788-476d-8c6c-47511d76309e",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `GetSyncConfiguration` 範例
下列範例顯示示範 [GetSyncConfiguration](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_GetSyncConfiguration.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "bab9aa16-4553-4206-a1ea-88219233dd25",
"EventName": "GetSyncConfiguration",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T17:40:40+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T17:34:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T17:40:40Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "GetSyncConfiguration",
"awsRegion": "us-east-1",
"sourceIPAddress": "52.94.133.142",
"userAgent": "aws-cli/2.15.11Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.get-sync-configuration",
"requestParameters": {
"syncType": "CFN_STACK_SYNC",
"resourceName": "mystack"
},
"responseElements": {
"syncConfiguration": {
"branch": "main",
"configFile": "filename",
"ownerId": "123456789012",
"providerType": "GitHub",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo",
"resourceName": "mystack",
"roleArn": "arn:aws:iam::123456789012:role/my-role",
"syncType": "CFN_STACK_SYNC"
}
},
"requestID": "0aa8e43a-6e34-4d8f-89fb-5c2d01964b35",
"eventID": "bab9aa16-4553-4206-a1ea-88219233dd25",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `ListConnections` 範例
下列範例顯示示範 [ListConnections](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListConnections.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "3f8d80fe-fbe1-4755-903c-4f58fc8262fa",
"EventName": "ListConnections",
"ReadOnly": "true",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-08T14:11:23-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-08T22:11:02Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-08T22:11:23Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListConnections",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.201-168.748.amzn2int.x86_64 botocore/1.18.6",
"requestParameters": {
"maxResults": 50
},
"responseElements": null,
"requestID": "5d456d59-3e92-44be-b941-a429df59e90b",
"eventID": "3f8d80fe-fbe1-4755-903c-4f58fc8262fa",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `ListHosts` 範例
下列範例顯示示範 [ListHosts](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListHosts.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "f6e9e831-feaf-4ad1-ac47-51681109c401",
"EventName": "ListHosts",
"ReadOnly": "true",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T13:00:55-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T21:00:55Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListHosts",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.list-hosts",
"requestParameters": {
"maxResults": 50
},
"responseElements": null,
"requestID": "ea87e2cf-6bf1-4cc7-9666-f3fad85d6d83",
"eventID": "f6e9e831-feaf-4ad1-ac47-51681109c401",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `ListRepositoryLinks` 範例
下列範例顯示示範 [ListRepositoryLinks](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListRepositoryLinks.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "4f714bbb-0716-4f6e-9868-9b379b30757f",
"EventName": "ListRepositoryLinks",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T01:57:29+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T01:43:49Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T01:57:29Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListRepositoryLinks",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.list-repository-links",
"requestParameters": {
"maxResults": 50
},
"responseElements": {
"repositoryLinks": [
{
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/001f5be2-a661-46a4-b96b-4d277cac8b6e",
"ownerId": "123456789012",
"providerType": "GitHub",
"repositoryLinkArn": "arn:aws:codeconnections:us-east-1:123456789012:repository-link/be8f2017-b016-4a77-87b4-608054f70e77",
"repositoryLinkId": "be8f2017-b016-4a77-87b4-608054f70e77",
"repositoryName": "MyGitHubRepo"
},
{
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/7df263cc-f055-4843-adef-4ceaefcb2167",
"ownerId": "owner",
"providerType": "GitHub",
"repositoryLinkArn": "arn:aws:codeconnections:us-east-1:123456789012:repository-link/6053346f-8a33-4edb-9397-10394b695173",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo"
}
]
},
"requestID": "7c8967a9-ec15-42e9-876b-0ef58681ec55",
"eventID": "4f714bbb-0716-4f6e-9868-9b379b30757f",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `ListRepositorySyncDefinitions` 範例
下列範例顯示示範 [ListRepositorySyncDefinitions](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListRepositorySyncDefinitions.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "12e52dbb-b00d-49ad-875a-3efec36e5aa1",
"EventName": "ListRepositorySyncDefinitions",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T16:56:19+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T16:43:03Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T16:56:19Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListRepositorySyncDefinitions",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.list-repository-sync-definitions",
"requestParameters": {
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"syncType": "CFN_STACK_SYNC",
"maxResults": 50
},
"responseElements": {
"repositorySyncDefinitions": []
},
"requestID": "df31d11d-5dc7-459b-9a8f-396b4769cdd9",
"eventID": "12e52dbb-b00d-49ad-875a-3efec36e5aa1",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
```
## `ListSyncConfigurations` 範例
下列範例顯示示範 [ListSyncConfigurations](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListSyncConfigurations.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "aa4ae557-ec31-4151-8d21-9e74dd01344c",
"EventName": "ListSyncConfigurations",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T17:42:06+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T17:34:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T17:42:06Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListSyncConfigurations",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.804.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/offcommand/codeconnections.list-sync-configurations",
"requestParameters": {
"maxResults": 50,
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"syncType": "CFN_STACK_SYNC"
},
"responseElements": {
"syncConfigurations": [
{
"branch": "feature-branch",
"configFile": "filename.yaml",
"ownerId": "owner",
"providerType": "GitHub",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo",
"resourceName": "dkstacksync",
"roleArn": "arn:aws:iam::123456789012:role/my-role",
"syncType": "CFN_STACK_SYNC"
}
]
},
"requestID": "7dd220b5-fc0f-4023-aaa0-9555cfe759df",
"eventID": "aa4ae557-ec31-4151-8d21-9e74dd01344c",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `ListTagsForResource` 範例
下列範例顯示示範 [ListTagsForResource](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_ListTagsForResource.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "fc501054-d68a-4325-824c-0e34062ef040",
"EventName": "ListTagsForResource",
"ReadOnly": "true",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T17:16:56+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "dMary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T16:43:03Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T17:16:56Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "ListTagsForResource",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.list-tags-for-resource",
"requestParameters": {
"resourceArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/9703702f-bebe-41b7-8fc4-8e6d2430a330"
},
"responseElements": null,
"requestID": "994584a3-4807-47f2-bb1b-a64f0af6c250",
"eventID": "fc501054-d68a-4325-824c-0e34062ef040",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `TagResource` 範例
下列範例顯示示範 [TagResource](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_TagResource.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "b7fbc943-2dd1-4c5b-a5ad-fc6d60a011f1",
"EventName": "TagResource",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:22:11-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:22:11Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "TagResource",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.tag-resource",
"requestParameters": {
"resourceArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/8dcf69d1-3316-4392-ae09-71e038adb6ed",
"tags": [
{
"key": "Demo1",
"value": "hhvh1"
}
]
},
"responseElements": null,
"requestID": "ba382c33-7124-48c8-a23a-25816ce27604",
"eventID": "b7fbc943-2dd1-4c5b-a5ad-fc6d60a011f1",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `UnTagResource` 範例
下列範例顯示示範 [UntagResource](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_UntagResource.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "8a85cdee-2586-4679-be18-eec34204bc7e",
"EventName": "UntagResource",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:31:14-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:31:14Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "UntagResource",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.untag-resource",
"requestParameters": {
"resourceArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/8dcf69d1-3316-4392-ae09-71e038adb6ed",
"tagKeys": [
"Project",
"ReadOnly"
]
},
"responseElements": null,
"requestID": "05ef26a4-8c39-4f72-89bf-0c056c51b8d7",
"eventID": "8a85cdee-2586-4679-be18-eec34204bc7e",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `UpdateHost` 範例
下列範例顯示示範 [UpdateHost](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_UpdateHost.html) 動作的 CloudTrail 日誌項目。
```
"Events": [{
"EventId": "4307cf7d-6d1c-40d9-a659-1bb41b31a2b6",
"EventName": "UpdateHost",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-11T12:54:32-08:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": "eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-11T20:09:35Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-11T20:54:32Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "UpdateHost",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.13.30 Python/3.11.6 Darwin/23.2.0 exe/x86_64 prompt/off command/codeconnections.update-host",
"requestParameters": {
"hostArn": "arn:aws:codeconnections:us-east-1:123456789012:host/Demo1-34e70ecb",
"providerEndpoint": "https://54.218.245.167"
},
"responseElements": null,
"requestID": "b17f46ac-1acb-44ab-a9f5-c35c20233441",
"eventID": "4307cf7d-6d1c-40d9-a659-1bb41b31a2b6",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
```
## `UpdateRepositoryLink` 範例
下列範例顯示示範 [UpdateRepositoryLink](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_UpdateRepositoryLink.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "be358c9a-5a8f-467e-8585-2860070be4fe",
"EventName": "UpdateRepositoryLink",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T02:03:24+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T01:43:49Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T02:03:24Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "UpdateRepositoryLink",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.update-repository-link",
"requestParameters": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/7df263cc-f055-4843-adef-4ceaefcb2167",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173"
},
"responseElements": {
"repositoryLinkInfo": {
"connectionArn": "arn:aws:codeconnections:us-east-1:123456789012:connection/7df263cc-f055-4843-adef-4ceaefcb2167",
"ownerId": "owner",
"providerType": "GitHub",
"repositoryLinkArn": "arn:aws:codeconnections:us-east-1:123456789012:repository-link/6053346f-8a33-4edb-9397-10394b695173",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo"
}
},
"additionalEventData": {
"providerAction": "UpdateRepositoryLink"
},
"requestID": "e01eee49-9393-4983-89e4-d1b3353a70d9",
"eventID": "be358c9a-5a8f-467e-8585-2860070be4fe",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `UpdateSyncBlocker` 範例
下列範例顯示示範 [UpdateSyncBlocker](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_UpdateSyncBlocker.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "211d19db-9f71-4d93-bf90-10f9ddefed88",
"EventName": "UpdateSyncBlocker",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-25T03:01:05+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-25T02:56:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-25T03:01:05Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "UpdateSyncBlocker",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6 Linux/5.10.205-172.807.amzn2int.x86_64 exe/x86_64.amzn.2 prompt/off command/codeconnections.update-sync-blocker",
"requestParameters": {
"id": "ID",
"syncType": "CFN_STACK_SYNC",
"resourceName": "mystack",
"resolvedReason": "Reason"
},
"responseElements": null,
"requestID": "eea03b39-b299-4099-ba55-608480f8d96d",
"eventID": "211d19db-9f71-4d93-bf90-10f9ddefed88",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
## `UpdateSyncConfiguration` 範例
下列範例顯示示範 [UpdateSyncConfiguration](https://docs.aws.amazon.com/codeconnections/latest/APIReference/API_UpdateSyncConfiguration.html) 動作的 CloudTrail 日誌項目。
```
{
"EventId": "d961c94f-1881-4fe8-83bf-d04cb9f22577",
"EventName": "UpdateSyncConfiguration",
"ReadOnly": "false",
"AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
"EventTime": "2024-01-24T17:40:55+00:00",
"EventSource": "codeconnections.amazonaws.com",
"Username": "Mary_Major",
"Resources": [],
"CloudTrailEvent": {
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:sts::123456789012:assumed-role/Admin/Mary_Major",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "Admin"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2024-01-24T17:34:55Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-01-24T17:40:55Z",
"eventSource": "codeconnections.amazonaws.com",
"eventName": "UpdateSyncConfiguration",
"awsRegion": "us-east-1",
"sourceIPAddress": "IP",
"userAgent": "aws-cli/2.15.11 Python/3.11.6Linux/5.10.205-172.804.amzn2int.x86_64exe/x86_64.amzn.2prompt/offcommand/codeconnections.update-sync-configuration",
"requestParameters": {
"branch": "feature-branch",
"resourceName": "mystack",
"syncType": "CFN_STACK_SYNC"
},
"responseElements": {
"syncConfiguration": {
"branch": "feature-branch",
"configFile": "filename",
"ownerId": "owner",
"providerType": "GitHub",
"repositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"repositoryName": "MyGitHubRepo",
"resourceName": "mystack",
"roleArn": "arn:aws:iam::123456789012:role/my-role",
"syncType": "CFN_STACK_SYNC"
}
},
"requestID": "2ca545ef-4395-4e1f-b14a-2750481161d6",
"eventID": "d961c94f-1881-4fe8-83bf-d04cb9f22577",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "api.us-east-1.codeconnections.aws.dev"
}
}
}
```
# AWS CodeConnections 和介面 VPC 端點 (AWS PrivateLink)
您可以在 VPC 和 之間建立私有連線， AWS CodeConnections 方法是建立*界面 VPC 端點*。介面端點採用 [AWS PrivateLink](https://aws.amazon.com/privatelink)技術，可讓您在沒有網際網路閘道、NAT 裝置、VPN 連接或 AWS Direct Connect 連接的情況下私下存取 AWS CodeConnections APIs。VPC 中的執行個體不需要公有 IP 地址即可與 AWS CodeConnections APIs通訊，因為 VPC 和 之間的流量 AWS CodeConnections 不會離開 Amazon 網路。
每個介面端點都是由您子網路中的一或多個[彈性網路介面](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html)表示。
如需詳細資訊，請參閱《*Amazon* [VPC 使用者指南》中的界面 VPC 端點 (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html)。
## AWS CodeConnections VPC 端點的考量事項
設定介面 VPC 端點之前 AWS CodeConnections，請務必檢閱《*Amazon VPC 使用者指南*》中的[介面端點](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-interface-endpoints.html#vpc-endpoints-actions)。
AWS CodeConnections 支援從您的 VPC 呼叫其所有 API 動作。
所有 AWS CodeConnections 區域都支援 VPC 端點。
## VPC 端點概念
以下是 VPC 端點的重要概念：
VPC 端點
VPC 中的進入點，可讓您以私密方式連線至服務。以下是不同類型的 VPC 端點。您可以建立受支援服務所需的 VPC 端點類型。
+ [AWS CodeConnections 動作的 VPC 端點](https://docs.aws.amazon.com/dtconsole/latest/userguide/vpc-interface-endpoints.html#vpc-endpoints-actions)
+ [AWS CodeConnections Webhook 的 VPC 端點](https://docs.aws.amazon.com/dtconsole/latest/userguide/vpc-interface-endpoints.html#vpc-endpoints-webhooks)
AWS PrivateLink
提供 VPC 和服務之間私有連線的技術。
## AWS CodeConnections 動作的 VPC 端點
您可以管理 AWS CodeConnections 服務的 VPC 端點。
### 建立 AWS CodeConnections 動作的介面 VPC 端點
您可以使用 Amazon VPC 主控台或 AWS Command Line Interface () 來建立 AWS CodeConnections 服務的 VPC 端點AWS CLI。如需詳細資訊，請參閱《Amazon VPC 使用者指南》**中的[建立介面端點](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint)。
若要開始搭配 VPC 使用連線，請為 建立介面 VPC 端點 AWS CodeConnections。當您為 建立 VPC 端點時 AWS CodeConnections，請選擇**AWS 服務**，然後在**服務名稱**中選擇：
+ **com.amazonaws.*region*.codestar-connections.api**：此選項會建立 AWS CodeConnections API 操作的 VPC 端點。例如，如果您的使用者使用 AWS CLI、 AWS CodeConnections API 或 AWS SDKs 來與 互動 AWS CodeConnections ，例如 `CreateConnection`、 和 等操作`ListConnections`，請選擇此選項`CreateHost`。
對於**啟用 DNS 名稱**選項，如果您選取端點的私有 DNS，您可以使用 AWS CodeConnections 區域的預設 DNS 名稱向 提出 API 請求，例如 `codestar-connections.us-east-1.amazonaws.com`。
**重要**
預設會針對為 AWS 服務和 AWS Marketplace 合作夥伴服務建立的端點啟用私有 DNS。
如需詳細資訊，請參閱《Amazon VPC 使用者指南》**中的[透過介面端點存取服務](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint)。
### 為 AWS CodeConnections 動作建立 VPC 端點政策
您可以將端點政策連接至控制 AWS CodeConnections存取權限的 VPC 端點。此政策會指定下列資訊：
+ 可執行動作的主體。
+ 可執行的動作。
+ 可供執行動作的資源。
如需詳細資訊，請參閱 *Amazon VPC 使用者指南*中的[使用 VPC 端點控制對服務的存取](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html)。
**注意**
com.amazonaws.*region*.codestar-connections.webhooks 端點不支援政策。
**範例： AWS CodeConnections 動作的 VPC 端點政策**
以下是 端點政策的範例 AWS CodeConnections。連接到端點時，此政策會授予所有資源上所有委託人所列出 AWS CodeConnections 動作的存取權。
```
{
"Statement": [
{
"Sid": "GetConnectionOnly",
"Principal": "*",
"Action": [
"codestar-connections:GetConnection"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
## AWS CodeConnections Webhook 的 VPC 端點
AWS CodeConnections 當您使用 VPC 組態建立或刪除主機時， 會為您建立 Webhook 端點。端點名稱為 **com.amazonaws.*region*.codestar-connections.webhooks**。
透過 GitHub Webhook 的 VPC 端點，主機可以透過 Webhook 透過 Amazon 網路將事件資料傳送到您的整合 AWS 服務。
**重要**
當您為 GitHub Enterprise Server 設定主機時， AWS CodeConnections 會為您建立 Webhook 事件資料的 VPC 端點。如果您是在 2020 年 11 月 24 日之前建立主機，且想要使用 VPC PrivateLink Webhook 端點，您必須先[刪除](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html)主機，然後[建立](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html)新主機。
AWS CodeConnections 會管理這些端點的生命週期。若要刪除端點，您必須刪除對應的主機資源。
### 如何使用 AWS CodeConnections 主機的 Webhook 端點
Webhook 端點會傳送來自第三方儲存庫的 Webhook 進行處理 AWS CodeConnections 。一個 Webhook 描述一個客戶動作。執行 `git push` 時，Webhook 端點會收到來自供應商的 Webhook 詳細解析該推送。例如， AWS CodeConnections 可以通知 CodePipeline 啟動您的管道。
對於不使用 VPC 的雲端提供者，例如 Bitbucket 或 GitHub Enterprise Server 主機，Webhook VPC 端點不適用，因為提供者正在將 Webhook 傳送到未使用 Amazon 網路 AWS CodeConnections 的位置。
# 對連線進行疑難排解
下列資訊可協助您針對 AWS CodeBuild AWS CodeDeploy、 和 中資源連線的常見問題進行疑難排解 AWS CodePipeline。
**Topics**
+ [我無法建立連線](#troubleshooting-connections-cannot-create)
+ [嘗試建立或完成連線時收到許可錯誤](#troubleshooting-connections-permissions-error-console)
+ [嘗試使用連線時收到許可錯誤](#troubleshooting-connections-permissions-error-useconnection)
+ [連線並非處於可用狀態或已脫離待定狀態](#troubleshooting-connections-error-notpending)
+ [新增 GitClone 的連線許可](#troubleshooting-connections-gitclone-permissions)
+ [主機並非處於可用狀態](#troubleshooting-connections-host-pending)
+ [針對發生連線錯誤的主機進行疑難排解](#troubleshooting-connections-host-errors)
+ [我無法為主機建立連線](#troubleshooting-connections-host-cannot-create)
+ [針對主機的 VPC 組態進行疑難排解](#troubleshooting-connections-host-vpc)
+ [針對 GitHub Enterprise Server 連線的 Webhook VPC 端點 (PrivateLink) 進行疑難排解](#troubleshooting-connections-host-vpc-webhook)
+ [針對 2020 年 11 月 24 日之前建立的主機進行疑難排解](#troubleshooting-connections-host-vpc-webhook-host)
+ [無法為 GitHub 儲存庫建立連線](#troubleshooting-connections-GitHub-admin)
+ [編輯 GitHub Enterprise Server 連線應用程式許可](#troubleshooting-GHES-app-permissions)
+ [連線至 GitHub 時發生連線錯誤：「發生問題，請確定您的瀏覽器已啟用 Cookie」或「組織擁有者必須安裝 GitHub 應用程式」](#troubleshooting-GitHub-organization-owner)
+ [資源中的連線服務字首可能需要更新 IAM 政策](#troubleshoot-service-prefix)
+ [使用主控台建立之資源中的服務字首導致許可錯誤](#troubleshoot-service-prefix-console-permissions)
+ [支援組織的已安裝供應商的連線和主機設定](#troubleshooting-organization-host)
+ [我想提高連線的限額](#troubleshooting-connections-limit-increase)
## 我無法建立連線
您可能沒有建立連線的許可。如需詳細資訊，請參閱[的許可和範例 AWS CodeConnections](security_iam_id-based-policy-examples-connections.md)。
## 嘗試建立或完成連線時收到許可錯誤
嘗試在 CodePipeline 主控台中建立或檢視連線時，可能會傳回下列錯誤訊息。
使用者：*使用者名稱*未獲授權在資源：*連線 ARN*上執行*許可*
如果顯示這則訊息，請確定您有足夠的許可。
在 AWS Command Line Interface (AWS CLI) 或 AWS 管理主控台 中建立和檢視連線的許可，只是您在主控台上建立和完成連線所需的許可的一部分。單純檢視、編輯或建立連線，然後完成待定連線所需的許可，範圍應該限制為只需要執行特定任務的使用者。如需詳細資訊，請參閱[的許可和範例 AWS CodeConnections](security_iam_id-based-policy-examples-connections.md)。
## 嘗試使用連線時收到許可錯誤
如果您嘗試在 CodePipeline 主控台中使用連線，即使您具有列出、取得和建立許可，可能仍會傳回下列其中一個或兩個錯誤訊息。
無法驗證您的帳戶。
使用者：*使用者名稱*未獲授權在資源：*連線 ARN 上執行*：codestar-connections:UseConnection
如果出現此訊息，請確定您有足夠的許可。
請確定您擁有使用連線的許可，包括列出位於供應商位置的可用儲存庫。如需詳細資訊，請參閱[的許可和範例 AWS CodeConnections](security_iam_id-based-policy-examples-connections.md)。
## 連線並非處於可用狀態或已脫離待定狀態
如果主控台顯示連線並非處於可用狀態的訊息，請選擇 **Complete connection (完成連線)**。
如果您選擇完成連線，且出現連線不處於待定狀態的訊息，您可以取消請求，因為連線已處於可用狀態。
## 新增 GitClone 的連線許可
當您在來源動作和 CodeBuild 動作中使用 AWS CodeStar 連線時，有兩種方式可以將輸入成品傳遞至組建：
+ 預設值：來源動作會產生 zip 檔，其中包含 CodeBuild 下載項目的程式碼。
+ Git 複製：來源程式碼可以直接下載到建置環境。
Git 複製模式可讓您將原始程式碼當成工作中 Git 儲存庫來互動。若要使用此模式，您必須准許 CodeBuild 環境使用連線。
若要將許可新增至 CodeBuild 服務角色政策，請建立客戶受管政策以連接至 CodeBuild 服務角色。下列步驟建立政策，其中，`action` 欄位中指定 `UseConnection` 許可，而 `Resource` 欄位中指定連線的 Amazon Resource Name (ARN)。
**使用主控台新增 UseConnection 許可**
1. 若要尋找管道的連線 ARN，請開啟管道，然後選擇來源動作上的 (**i**) 圖示。「Configuration (組態)」窗格隨即會開啟，而連線 ARN 會顯示在 **ConnectionArn** 旁邊。您可以將連線 ARN 新增至 CodeBuild 服務角色政策。
1. 若要尋找 CodeBuild 服務角色，請開啟管道中使用的建置專案，然後瀏覽至 **Build details (建置詳細資訊)** 索引標籤。
1. 在「Environment (環境)」區段中，選擇 **Service role (服務角色)** 連結。這會開啟 AWS Identity and Access Management (IAM) 主控台，您可以在其中新增授予連線存取權的新政策。
1. 在 IAM 主控台，選擇 **Attach policies (連接政策)**，然後選擇 **Create policy (建立政策)**。
使用下列政策範本範例。在 `Resource` 欄位中新增連線 ARN，如下列範例所示。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "codestar-connections:UseConnection",
"Resource": "arn:aws:iam::*:role/Service*"
}
]
}
```
------
在 **JSON** 索引標籤上，貼上您的政策。
1. 選擇**檢閱政策**。輸入政策的名稱 (例如 **connection-permissions**)，然後選擇 **Create policy (建立政策)**。
1. 返回服務角色的 **Attach Permissions (連接許可)** 頁面，重新整理政策清單，然後選取您剛建立的政策。選擇**連接政策**。
## 主機並非處於可用狀態
如果主控台顯示訊息，指出主機並非處於 `Available` 狀態，請選擇 **Set up host (設定主機)**。
建立主機的第一個步驟會導致建立的主機現在處於 `Pending` 狀態。若要讓主機變為 `Available` 狀態，您必須選擇在主控台中設定主機。如需詳細資訊，請參閱[設定待定主機](connections-host-setup.md)。
**注意**
您無法使用 AWS CLI 來設定`Pending`主機。
## 針對發生連線錯誤的主機進行疑難排解
如果刪除或修改基礎 GitHub 應用程式，連線和主機可能會變為錯誤狀態。處於錯誤狀態的主機和連線無法復原，且必須重新建立主機。
+ 更改應用程式 pem 金鑰、更改應用程式名稱 (初始建立後) 等動作，會導致主機和所有相關聯的連線進入錯誤狀態。
如果主控台或 CLI 傳回處於 `Error` 狀態的主機或與主機相關的連線，您可能需要執行下列步驟：
+ 刪除並重新建立主機資源，然後重新安裝主機註冊應用程式。如需詳細資訊，請參閱[建立主機](connections-host-create.md)。
## 我無法為主機建立連線
若要建立連線或主機，必須符合以下條件。
+ 您的主機必須處於 **AVAILABLE (可用)** 狀態。如需詳細資訊，請參閱
+ 必須在與主機相同的區域建立連線。
## 針對主機的 VPC 組態進行疑難排解
建立主機資源時，您必須提供安裝 GitHub Enterprise Server 執行個體的基礎設施之網路連線或 VPC 資訊。若要對主機的 VPC 或子網路組態進行疑難排解，請使用此處顯示的範例 VPC 資訊做為參考。
**注意**
使用本節內容，對 Amazon VPC 內 GitHub Enterprise Server 主機組態相關問題進行疑難排解。如需針對設為使用 VPC 的 Webhook 端點 (PrivateLink) 之連線相關問題進行疑難排解，請參閱「[針對 GitHub Enterprise Server 連線的 Webhook VPC 端點 (PrivateLink) 進行疑難排解](#troubleshooting-connections-host-vpc-webhook)」。
在此範例中，您可以使用下列程序來設定 VPC 和伺服器 (GitHub Enterprise Server 執行個體的安裝位置)：
1. 建立 VPC。如需詳細資訊，請參閱[https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#Create-VPC](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#Create-VPC)。
1. 在 VPC 中建立子網路。如需詳細資訊，請參閱[https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet)。
1. 將執行個體啟動至 VPC 中。如需詳細資訊，請參閱[https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#VPC_Launch_Instance](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#VPC_Launch_Instance)。
**注意**
每個 VPC 一次只能與一個主機相關聯 (GitHub 企業伺服器執行個體) 相關聯。
下圖顯示使用 GitHub Enterprise AMI 啟動的 EC2 執行個體。
![\[主控台螢幕擷取畫面顯示執行個體描述\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/instance-vpc.png)
使用 VPC 進行 GitHub Enterprise Server 連線時，您必須在設定主機時為基礎設施提供下列資訊：
+ **VPC ID：**安裝 GitHub Enterprise Server 執行個體的伺服器之 VPC，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的 VPC。
+ **子網路 ID 或 ID：**安裝 GitHub Enterprise Server 執行個體的伺服器之子網路，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的子網路。
+ **安全群組或群組：**安裝 GitHub Enterprise Server 執行個體的伺服器之安全群組，或可透過 VPN 或 Direct Connect 存取已安裝 GitHub Enterprise Server 執行個體的安全群組。
+ **端點：**準備好您的伺服器端點，繼續執行下一個步驟。
如需使用 VPC 和子網路的詳細資訊，請參閱 *Amazon VPC 使用者指南*中的 [IPv4 的 VPC 和子網路規模調整](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4)。
**Topics**
+ [我無法讓主機進入待定狀態](#troubleshooting-connections-host-vpc-failed)
+ [我無法讓主機進入可用狀態](#troubleshooting-connections-host-vpc-app)
+ [我的連線/主機本來正常運作，現在卻停止運作](#troubleshooting-connections-host-vpc-stopped)
+ [我無法刪除網路介面](#troubleshooting-connections-host-vpc-delete)
### 我無法讓主機進入待定狀態
如果您的主機進入了 VPC\$1CONFIG\$1FAILED\$1INITIALIZATION 狀態，可能是因為您為主機選取的 VPC、子網路或安全群組出現問題。
+ VPC、子網路和安全群組都必須屬於建立主機的帳戶。
+ 子網路和安全群組必須屬於選取的 VPC。
+ 提供的每個子網路都必須位於不同的可用區域中。
+ 建立主機的使用者必須具有下列 IAM 權限：
```
ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptionsec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints
```
### 我無法讓主機進入可用狀態
如果您無法完成主機的 CodeConnections 應用程式設定，可能是因為 VPC 組態或 GitHub Enterprise Server 執行個體發生問題。
+ 如果您不是使用公有憑證授權機構，則需要為 GitHub Enterprise 執行個體所使用的主機提供 TLS 憑證。TLS 憑證值應該是憑證的公有金鑰。
+ 您需為 GitHub Enterprise Server 執行個體的管理員才能建立 GitHub 應用程式。
### 我的連線/主機本來正常運作，現在卻停止運作
如果連線/主機之前正常工作，現在卻無法正常運作，可能是因為 VPC 中的組態變更或 GitHub 應用程式經過修改。請檢查以下內容：
+ 連接至您為連線所建立主機資源的安全群組現在有所變更，或無法再存取 GitHub Enterprise Server。CodeConnections 需要可連線至 GitHub Enterprise Server 執行個體的安全群組。
+ DNS 伺服器 IP 最近有所變更。檢查連接至您為連線所建立主機資源中指定的 VPC 的 DHCP 選項，即可確認是否有變更。請注意，如果您最近從 AmazonProviedDNS 移轉至自訂 DNS 伺服器，或是開始使用新的自訂 DNS 伺服器，則主機/連線會停止運作。若要解決這個問題，請刪除您現有的主機並重新建立，這麼做會將最新的 DNS 設定存放在我的資料庫中。
+ 網路 ACL 設定已變更，不再允許 HTTP 連線到您的 GitHub Enterprise Server 基礎設施所在的子網路。
+ GitHub Enterprise Server 上 CodeConnections 應用程式的任何組態都已變更。修改任何組態，例如 URLs或應用程式秘密，可能會中斷已安裝的 GitHub Enterprise Server 執行個體與 CodeConnections 之間的連線。
### 我無法刪除網路介面
如果您無法偵測到您的網路介面，請檢查下列項目：
+ CodeConnections 建立的網路界面只能透過刪除主機來刪除。使用者無法手動刪除這些網路介面。
+ 您必須具備下列許可：
```
ec2:DescribeNetworkInterfaces
ec2:DeleteNetworkInterface
```
## 針對 GitHub Enterprise Server 連線的 Webhook VPC 端點 (PrivateLink) 進行疑難排解
使用 VPC 組態建立主機時，系統會為您建立 Webhook VPC 端點。
**注意**
使用本節內容，針對設為使用 VPC 的 Webhook 端點 (PrivateLink) 之連線相關問題進行疑難排解。如需對 Amazon VPC 內 GitHub Enterprise Server 主機組態相關問題進行疑難排解，請參閱「[針對主機的 VPC 組態進行疑難排解](#troubleshooting-connections-host-vpc)」。
當您建立與已安裝提供者類型的連線，且您已指定伺服器是在 VPC 內設定時， AWS CodeConnections 會建立您的主機，並為您建立 Webhook 的 VPC 端點 (PrivateLink)。這可讓主機透過 Webhook 透過 Amazon 網路將事件資料傳送至您的整合 AWS 服務。如需詳細資訊，請參閱[AWS CodeConnections 和介面 VPC 端點 (AWS PrivateLink)](vpc-interface-endpoints.md)。
**Topics**
+ [我無法刪除 Webhook VPC 端點](#troubleshooting-connections-host-vpc-webhook-delete)
### 我無法刪除 Webhook VPC 端點
AWS CodeConnections 會管理主機的 Webhook VPC 端點生命週期。若要刪除端點，您必須刪除對應的主機資源。
+ CodeConnections 建立的 Webhook VPC 端點 (PrivateLink) 只能透過刪除主機來[刪除](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html)。這些端點無法手動刪除。
+ 您必須具備下列許可：
```
ec2:DescribeNetworkInterfaces
ec2:DeleteNetworkInterface
```
## 針對 2020 年 11 月 24 日之前建立的主機進行疑難排解
截至 2020 年 11 月 24 日， AWS CodeConnections 設定您的主機時，會為您設定額外的 VPC 端點 (PrivateLink) 支援。對於在此更新之前建立的主機，請使用本節疑難排解內容。
如需詳細資訊，請參閱[AWS CodeConnections 和介面 VPC 端點 (AWS PrivateLink)](vpc-interface-endpoints.md)。
**Topics**
+ [我有一個 2020 年 11 月 24 日之前建立的主機，而且想將 VPC 端點 (PrivateLink) 用於 Webhook](#troubleshooting-connections-host-vpc-webhook-create)
+ [我無法讓主機進入可用狀態 (VPC 錯誤)](#troubleshooting-connections-host-vpc-error-pre-webhook)
### 我有一個 2020 年 11 月 24 日之前建立的主機，而且想將 VPC 端點 (PrivateLink) 用於 Webhook
您為 GitHub Enterprise Server 設定主機時，系統會為您建立 Webhook 端點。連線現在使用 VPC PrivateLink Webhook 端點。如果您是在 2020 年 11 月 24 日之前建立主機，且想要使用 VPC PrivateLink Webhook 端點，您必須先[刪除](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html)主機，然後[建立](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html)新主機。
### 我無法讓主機進入可用狀態 (VPC 錯誤)
如果您的主機是在 2020 年 11 月 24 日之前建立的，而且您無法完成主機的 CodeConnections 應用程式設定，可能是因為 VPC 組態或 GitHub Enterprise Server 執行個體發生問題。
您的 VPC 需要一個 NAT 閘道 (或傳出網際網路存取權)，才能讓您的 GitHub Enterprise Server 執行個體傳送 GitHub Webhook 的輸出網路流量。
## 無法為 GitHub 儲存庫建立連線
**問題：**
由於 GitHub 儲存庫的連線使用 AWS Connector for GitHub，因此您需要儲存庫的組織擁有者許可或管理員許可，才能建立連線。
**可能的修正方式：**如需 GitHub 儲存庫許可層級的詳細資訊，請參閱 [https://docs.github.com/en/free-pro-team@latest/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization](https://docs.github.com/en/free-pro-team@latest/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)。
## 編輯 GitHub Enterprise Server 連線應用程式許可
如果您在 2020 年 12 月 23 日或之前安裝 GitHub Enterprise Server 的應用程式，您可能需要將應用程式的唯讀存取權提供給組織成員。如果您是 GitHub 應用程式擁有者，請依照下列步驟編輯建立主機時所安裝應用程式的許可。
**注意**
您必須在 GitHub Enterprise Server 執行個體上完成這些步驟，而且您必須是 GitHub 應用程式擁有者。
1. 在 GitHub Enterprise Server 中，從您個人檔案照片上的下拉式選項中，選擇 **Settings (設定)**。
1. 選擇 **Developer settings (開發人員設定)**，然後選擇 **GitHub Apps (GitHub 應用程式)**。
1. 在應用程式清單中，為連線選擇應用程式名稱，然後在設定畫面中選擇 **Permissions and events (許可與事件)**。
1. 在 **Organization permissions** (組織許可) 下，對於 **Members** (成員)，從 **Access** (存取權) 下拉式清單中選擇 **Read-only** (唯讀)。
![\[Organization permissions interface showing Members access set to Read-only from dropdown menu.\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/ghes-app-permissions.png)
1. 在 **Add a note to users (為使用者新增附註)** 底下，新增更新原因說明。選擇**儲存變更**。
## 連線至 GitHub 時發生連線錯誤：「發生問題，請確定您的瀏覽器已啟用 Cookie」或「組織擁有者必須安裝 GitHub 應用程式」
**問題：**
如要建立 GitHub 儲存庫的連線，您必須是 GitHub 組織擁有者。對於不在組織下的儲存庫，您必須是儲存庫擁有者。由組織擁有者以外的其他人員建立連線時，會針對組織擁有者建立請求，並顯示下列其中一個錯誤：
發生問題，請確保您的瀏覽器已啟用 cookie
或
組織擁有者必須安裝 GitHub 應用程式
**可能修正：**對於 GitHub 組織中的儲存庫，組織擁有者必須建立與 GitHub 儲存庫的連線。對於不在組織下的儲存庫，您必須是儲存庫擁有者。
## 資源中的連線服務字首可能需要更新 IAM 政策
服務已於 2024 年 3 月 29 日從 AWS CodeStar Connections 重新命名為 AWS CodeConnections。從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。使用主控台建立之資源的服務字首為 `codeconnections`。在資源 ARN `codeconnections`中使用 建立新的 SDK/CLI 資源。建立的資源會自動具有新的服務字首。
以下是在 AWS CodeConnections 中建立的資源：
+ 連線
+ 主機
**問題：**
在 ARN `codestar-connections`中使用 建立的資源不會自動重新命名為資源 ARN 中的新服務字首。建立新資源會建立具有連線服務字首的資源。不過，具有`codestar-connections`服務字首的 IAM 政策不適用於具有新服務字首的資源。
**可能的修正：**為了避免資源的存取或許可問題，請完成下列動作：
+ 更新新服務字首的 IAM 政策。否則，重新命名或建立的資源將無法使用 IAM 政策。
+ 使用主控台或 CLI/CDK/CFN 建立新服務字首，以更新資源。
視需要更新政策中的動作、資源和條件。在下列範例中，這兩個服務字首的 `Resource` 欄位已更新。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Action": [
"codeconnections:UseConnection"
],
"Resource": [
"arn:aws:codestar-connections:*:*:connection/*",
"arn:aws:codeconnections:*:*:connection/*"
]
}
}
```
------
## 使用主控台建立之資源中的服務字首導致許可錯誤
目前，使用主控台建立的連線資源只會有 `codestar-connections`服務字首。對於使用主控台建立的資源，政策陳述式動作必須包含 `codestar-connections`做為服務字首。
**注意**
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。
**問題：**
使用 主控台建立連線資源時，必須在政策中使用 `codestar-connections`服務字首。在政策中使用具有`codeconnections`服務字首的政策時，使用主控台建立的連線資源會收到下列錯誤訊息：
```
User: user_ARN is not authorized to perform: codestar-connections:action on resource: resource_ARN because no identity-based policy allows the codestar-connections:action action
```
**可能的修正：**對於使用主控台建立的資源，政策陳述式動作必須包含 `codestar-connections`做為服務字首，如 中的政策範例所示[範例： AWS CodeConnections 使用主控台建立 的政策](security_iam_id-based-policy-examples-connections.md#security_iam_id-based-policy-examples-connections-console)。
## 支援組織的已安裝供應商的連線和主機設定
對於支援組織，例如 GitHub Organizations 的已安裝供應商，您不會傳遞可用的主機。您可以為組織中的每個連線建立新的主機，並務必在下列網路欄位中輸入相同的資訊：
+ **VPC ID**
+ **子網路 ID**
+ **安全群組 IDs**
請參閱建立 [GHES 連線](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gheserver.html)或 [GitLab 自我管理連線](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gitlab-managed.html)的相關步驟。
## 我想提高連線的限額
您可以在 CodeConnections 中請求提高特定限制的限制。如需詳細資訊，請參閱[連線的配額](limits-connections.md)。
# 連線的配額
下表列出開發人員工具主控台中連線的配額 (也稱為*限額*)。
此資料表中的配額適用於每個 AWS 區域 ，並且可以增加。若要取得 AWS 區域 資訊和可變更的配額，請參閱 [AWS 服務配額](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)。
**注意**
您必須啟用歐洲 （米蘭）， AWS 區域 才能使用它。如需詳細資訊，請參閱[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。
| 資源 | 預設值限制 |
| --- | --- |
| 每個 的連線數上限 AWS 帳戶 | 250 |
此表中的配額是固定的，而且無法變更。
| 資源 | 預設值限制 |
| --- | --- |
| 連線名稱字元上限 | 32 個字元 |
| 每個 的主機數量上限 AWS 帳戶 | 50 |
| 儲存庫連結的數目上限 | 100 |
| CloudFormation 堆疊同步組態的數目上限 | 100 |
| 每個儲存庫連結的同步組態數目上限 | 100 |
| 每個分支的同步組態數目上限 | 50 |
# 要新增至允許清單的 IP 地址
如果您在 Amazon EC2 執行個體上實作 IP 篩選或允許特定 IP 地址，請將以下 IP 地址新增到允許清單中。這樣做就可以連線到提供者，例如 GitHub 和 Bitbucket。
下表按 AWS 區域 列出在開發人員工具主控台中連線的 IP 地址。
**注意**
對於歐洲 (米蘭) 區域，您必須先啟用此區域，才能加以使用。如需詳細資訊，請參閱[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。
| 區域 | IP 地址 |
| --- | --- |
| 美國西部 (奧勒岡) (us-west-2) | 35.160.210.199、54.71.206.108、54.71.36.205 |
| 美國東部 (維吉尼亞北部) (us-east-1) | 3.216.216.90、3.216.243.220、3.217.241.85 |
| 歐洲 (愛爾蘭) (eu-west-1) | 34.242.64.82、52.18.37.201、54.77.75.62 |
| 美國東部 (俄亥俄) (us-east-2) | 18.217.188.190、18.218.158.91、18.220.4.80 |
| 亞太區域 (新加坡) (ap-southeast-1) | 18.138.171.151、18.139.22.70、3.1.157.176 |
| 亞太區域 (雪梨) (ap-southeast-2) | 13.236.59.253、52.64.166.86、54.206.1.112 |
| 亞太區域 (東京) (ap-northeast-1) | 52.196.132.231、54.95.133.227、18.181.13.91 |
| 歐洲 (法蘭克福) (eu-central-1) | 18.196.145.1640、3.121.252.59、52.59.104.195 |
| 亞太區域 (首爾) (ap-northeast-2) | 13.125.8.239、13.209.223.177、3.37.200.23 |
| 亞太區域 (孟買) (ap-south-1) | 13.234.199.1520、13.235.29.220、35.00 154.230.124 13.00、13.00 和 35.00、200 13.0、200 |
| 南美洲 (聖保羅) (sa-east-1) | 18.229.77.260、54.233.226.520、54.00 233.207.69 18.00、18.00 和 18.00、200、200、2000 |
| 加拿大 (中部) (ca-central-1) | 15.222.219.210、35.182.166.138、99.79.111.198 |
| 歐洲 (倫敦) (eu-west-2) | 3.9.97.205、35.177.150.185、35.177.200.225 |
| 美國西部 (加利佛尼亞北部) (us-west-1) | 52.52.16.175、52.8.63.87 |
| 歐洲 (巴黎) (eu-west-3) | 35.181.127.138、35.181.145.22、35.181.20.200 |
| 歐洲 (斯德哥爾摩) (eu-north-1) | 13.48.66.148、13.48.8.79、13.53.78.182 |
| 歐洲 (米蘭) (eu-south-1) | 18.102.28.105、18.102.35.130、18.102.8.116 |
| AWS GovCloud （美國東部） | 18.252.168.1570、18.252.207.77、18.00、18.253.185.119 |