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

# 使用來源修訂覆寫啟動管道
<a name="pipelines-trigger-source-overrides"></a>

您可以使用覆寫來啟動具有您為管道執行提供的特定來源修訂 ID 的管道。例如，如果您想要啟動將處理 CodeCommit 來源中特定遞交 ID 的管道，您可以在啟動管道時新增遞交 ID 做為覆寫。

**注意**  
您也可以使用輸入轉換項目建立來源覆寫，以針對管道事件在 EventBridge `revisionValue`中使用 ，其中 `revisionValue` 衍生自物件金鑰、遞交或影像 ID 的來源事件變數。如需詳細資訊，請參閱 [Amazon ECR 來源動作和 EventBridge 資源](create-cwe-ecr-source.md)、 [連線至已啟用事件來源的 Amazon S3 來源動作](create-S3-source-events.md)或 下程序中包含的輸入轉換項目選用步驟[CodeCommit 來源動作和 EventBridge](triggering.md)。

有四種類型的來源修訂`revisionType`：
+ `COMMIT_ID`
+ `IMAGE_DIGEST`
+ `S3_OBJECT_VERSION_ID`
+ `S3_OBJECT_KEY`

**注意**  
對於來源修訂的 `COMMIT_ID`和 `IMAGE_DIGEST`類型，來源修訂 ID 會套用至儲存庫中所有分支的所有內容。

**注意**  
對於來源修訂的 `S3_OBJECT_VERSION_ID`和 `S3_OBJECT_KEY` 類型，其中一種類型可以獨立使用，也可以一起使用，以特定 ObjectKey 和 VersionID 覆寫來源。對於 `S3_OBJECT_KEY`，組態參數`AllowOverrideForS3ObjectKey`需要設定為 `true`。如需 S3 來源組態參數的詳細資訊，請參閱 [組態參數](action-reference-S3.md#action-reference-S3-config)。

**Topics**
+ [使用來源修訂覆寫啟動管道 （主控台）](#pipelines-trigger-source-overrides-console)
+ [使用來源修訂覆寫 (CLI) 啟動管道](#pipelines-trigger-source-overrides-cli)

## 使用來源修訂覆寫啟動管道 （主控台）
<a name="pipelines-trigger-source-overrides-console"></a>

**手動啟動管道，並透過管道執行最新的修訂版本**

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Name (名稱)** 中，選擇您想啟動的管道名稱。

1. 在管道詳細資訊頁面上，選擇**發行變更**。選擇**版本變更**會開啟**版本變更**視窗。針對**來源修訂覆寫**，選擇箭頭以展開欄位。在**來源**中，輸入來源修訂 ID。例如，如果您的管道有 CodeCommit 來源，請從您要使用的 欄位選擇遞交 ID。  
![CodePipeline 中的覆寫畫面範例。](http://docs.aws.amazon.com/zh_tw/codepipeline/latest/userguide/images/overrides.png)

## 使用來源修訂覆寫 (CLI) 啟動管道
<a name="pipelines-trigger-source-overrides-cli"></a>

**手動啟動管道，並透過管道執行成品的指定來源修訂 ID**

1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示字元 AWS CLI (Windows)，然後使用 執行**start-pipeline-execution**命令，指定您要啟動的管道名稱。您也可以使用 **--source-revisions**引數來提供來源修訂版 ID。來源修訂由 actionName、revisionType 和 revisionValue 組成。有效的 revisionType 值為 `COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY`。

   在下列範例中，若要開始透過名為 的管道執行指定的變更**codecommit-pipeline**，下列命令會分類來源動作名稱、修訂類型 `COMMIT_ID`和遞交 ID 為 `78a25c18755ccac3f2a9eec099dEXAMPLE`。

   ```
   aws codepipeline start-pipeline-execution --name codecommit-pipeline --source-revisions actionName=Source,revisionType=COMMIT_ID,revisionValue=78a25c18755ccac3f2a9eec099dEXAMPLE --region us-west-1
   ```

1. 請檢視回傳的物件以驗證是否成功。此命令會傳回如下的執行 ID：

   ```
   {
       "pipelineExecutionId": {{"c53dbd42-This-Is-An-Example"}}
   }
   ```
**注意**  
啟動管道之後，您可以在 CodePipeline 主控台中或透過執行 **get-pipeline-state**命令來監控其進度。如需詳細資訊，請參閱[檢視管道 （主控台）](pipelines-view-console.md)及[檢視管道詳細資訊與歷程記錄 (CLI)](pipelines-view-cli.md)。