本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 的來源版本範例 AWS CodeBuild
<a name="sample-source-version"></a>

 此範例示範如何使用遞交 ID 以外的格式 (也稱為遞交 SHA) 來指定來源的版本。您可以透過下列方式指定來源的版本：
+  對於 Amazon S3 來源供應商，請使用代表建置輸入 ZIP 檔案之物件的版本 ID。
+  對於 CodeCommit、Bitbucket、GitHub 和 GitHub Enterprise Server，請使用下列其中一項：
  +  提取請求做為提取請求參考 (例如，`refs/pull/1/head`)。
  +  分支做為分支名稱。
  +  遞交 ID。
  +  標籤。
  +  參考和遞交 ID。參考可為下列其中之一：
    +  標籤 (例如，`refs/tags/mytagv1.0^{full-commit-SHA}`)。
    +  分支 (例如，`refs/heads/mydevbranch^{full-commit-SHA}`)。
    +  提取請求 (例如，`refs/pull/1/head^{full-commit-SHA}`)。
+  對於 GitLab 和 GitLab 自我管理，請使用下列其中一項：
  +  分支做為分支名稱。
  +  遞交 ID。
  +  標籤。

**注意**  
 只有當您的儲存庫是 GitHub 或 GitHub Enterprise Server 時，才可以指定提取請求來源的版本。

 如果您使用參考和遞交 ID 來指定版本，建置的 `DOWNLOAD_SOURCE` 階段會比您僅提供版本來得更快速。這是因為當您新增參考時，CodeBuild 不需要下載整個儲存庫來尋找遞交。
+ 您可以指定僅具有遞交 ID 的來源版本，例如 `12345678901234567890123467890123456789`。如果您這樣做，CodeBuild 必須下載整個儲存庫才能尋找版本。
+ 您可以指定具有參考和遞交 ID 的來源版本，以此格式：`{{refs}}/{{heads}}/{{branchname}}^{{{full-commit-SHA}}}` (例如，`refs/heads/main^{12345678901234567890123467890123456789}`)。如果您這樣做，CodeBuild 只會下載指定的分支來尋找版本。

**注意**  
若要加速建置的`DOWNLOAD_SOURCE`階段，您也可以將 **Git 複製深度**設定為低數量。CodeBuild 會下載較少版本的儲存庫。

**Topics**
+ [使用遞交 ID 指定 GitHub 儲存庫版本](sample-source-version-github.md)
+ [使用參考和遞交 ID 指定 GitHub 儲存庫版本](sample-source-version-github-ref.md)