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

# 更新 Amazon OpenSearch 擷取管道
<a name="update-pipeline"></a>

您可以使用 AWS 管理主控台、 AWS CLI或 OpenSearch Ingestion API 更新 Amazon OpenSearch Ingestion 管道。OpenSearch Ingestion 會啟動藍/綠部署。如需詳細資訊，請參閱[管道更新的藍/綠部署](#pipeline-bg)。

**Topics**
+ [考量事項](#update-pipeline-considerations)
+ [必要許可](#update-pipeline-permissions)
+ [更新管道](#update-pipeline-steps)
+ [管道更新的藍/綠部署](#pipeline-bg)

## 考量事項
<a name="update-pipeline-considerations"></a>

當您更新管道時，請考慮下列事項：
+ 您無法更新管道的名稱或網路設定。
+ 如果您的管道寫入 VPC 網域接收器，則在管道建立後，您無法返回並將接收器變更為不同的 VPC 網域。您必須使用新接收器刪除並重新建立管道。您仍然可以將接收器從 VPC 網域切換到公有網域、從公有網域切換到 VPC 網域，或從公有網域切換到另一個公有網域。
+ 您可以隨時在公有 OpenSearch Service 網域和 OpenSearch Serverless 集合之間切換管道接收器。
+ 當您更新管道的來源、處理器或接收器組態時，OpenSearch Ingestion 會啟動藍/綠部署。如需詳細資訊，請參閱[管道更新的藍/綠部署](#pipeline-bg)。
+ 當您更新管道的來源、處理器或接收器組態時，OpenSearch Ingestion 會自動將您的管道升級至管道正在執行之主要 Data Prepper 版本的最新支援次要版本。此程序可讓您的管道隨時掌握最新的錯誤修正和效能改善。
+ 您仍然可以在管道停止時更新管道。

## 必要許可
<a name="update-pipeline-permissions"></a>

OpenSearch Ingestion 使用下列 IAM 許可來更新管道：
+ `osis:UpdatePipeline` – 更新管道。
+ `osis:ValidatePipeline` – 檢查管道組態是否有效。
+ `iam:PassRole` – 將管道角色傳遞至 OpenSearch Ingestion，以便將資料寫入網域。只有在您更新管道組態時，才需要此許可，而不需要修改其他設定，例如日誌發佈或容量限制。

例如，下列政策會授予更新管道的許可：

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Resource": "*",
            "Action": [
                "osis:UpdatePipeline",
                "osis:ValidatePipeline"
            ]
        },
        {
            "Resource": [
                "arn:aws:iam::111122223333:role/pipeline-role"
            ],
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ]
        }
    ]
}
```

------

## 更新管道
<a name="update-pipeline-steps"></a>

您可以使用 AWS 管理主控台、 AWS CLI或 OpenSearch Ingestion API 更新 Amazon OpenSearch Ingestion 管道。

### 主控台
<a name="update-pipeline-console"></a>

**更新管道**

1. 登入 Amazon OpenSearch Service 主控台，網址為 https：//[https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines)。您將進入管道頁面。

1. 選擇管道以開啟其設定。然後，選擇其中一個**編輯**選項。

1. 修改完成後，請選擇 **Save (儲存)**。

### CLI
<a name="update-pipeline-cli"></a>

若要使用 更新管道 AWS CLI，請傳送[更新管道](https://docs.aws.amazon.com/cli/latest/reference/osis/update-pipeline.html)請求。下列範例請求會上傳新的組態檔案，並更新容量值下限和上限：

```
aws osis update-pipeline \
  --pipeline-name "my-pipeline" \
  --pipline-configuration-body "file://new-pipeline-config.yaml" \
  --min-units 11 \
  --max-units 18
```

### OpenSearch 擷取 API
<a name="update-pipeline-api"></a>

若要使用 OpenSearch Ingestion API 更新 OpenSearch Ingestion 管道，請呼叫 [UpdatePipeline](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_osis_UpdatePipeline.html) 操作。

## 管道更新的藍/綠部署
<a name="pipeline-bg"></a>

OpenSearch Ingestion 會啟動*藍/綠*部署程序。

藍/綠是指為管道更新建立新的環境，並在這些更新完成後將流量路由到新環境的做法。實務可在萬一部署到新環境不成功時將停機時間減至最小並維護原始環境。藍/綠部署本身沒有任何效能影響，但如果管道組態以改變效能的方式變更，效能可能會變更。

OpenSearch Ingestion 會在藍/綠部署期間封鎖自動擴展。您只會繼續支付舊管道的流量費用，直到流量重新導向至新管道為止。一旦流量重新導向，您只需支付新管道的費用。您永遠不會同時支付兩個管道的費用。

當您更新管道的來源、處理器或接收器組態時，OpenSearch Ingestion 會自動將您的管道升級至管道執行中主要版本的最新支援次要版本。例如，您可能在管道組態`version: "2"`中具有 ，而 OpenSearch Ingestion 最初使用 2.1.0 版佈建管道。新增對 2.1.1 版的支援，並變更管道組態時，OpenSearch Ingestion 會將管道升級至 2.1.1 版。

此程序可讓您的管道隨時掌握最新的錯誤修正和效能改善。OpenSearch Ingestion 無法更新管道的主要版本，除非您手動變更管道組態中的 `version`選項。