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

# 更新 AWS Glue 中的藍圖
<a name="updating_blueprints"></a>

如果您有修訂配置指令碼、已修訂的藍圖參數集或已修訂的支援檔案，則可以更新藍圖。更新藍圖會建立新的版本。

更新藍圖不會影響從藍圖建立的現有工作流程。

您可以使用 AWS Glue 主控台、AWS Glue API 或 AWS Command Line Interface (AWS CLI) 更新藍圖。

下列處理程序假設 AWS Glue 開發人員已建立並上傳更新的藍圖 ZIP 封存到 Amazon S3。

**更新藍圖 (主控台)**

1. 確保您對 Amazon S3 中的藍圖 ZIP 封存具有讀取許可 (`s3:GetObject`)。

1. 前往 [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) 開啟 AWS Glue 主控台。

   以具有更新藍圖的使用者身分登入。切換到與 Amazon S3 儲存貯體相同的 AWS 區域，其中包含藍圖 ZIP 封存。

1. 在導覽窗格中，選擇 **blueprints** (藍圖)。

1. 在 **Blueprints** (藍圖) 頁面上，選取藍圖，然後在 **Actions** (動作) 選單，選擇 **Edit** (編輯)。

1. 在 **Edit a blueprint (編輯藍圖)** 頁面上，更新藍圖 **Description (描述)** 或 **ZIP archive location (S3) (ZIP 封存位置 (S3))**。務必在路徑中包含封存名稱。

1. 選擇**儲存**。

   **blueprints** (藍圖) 頁面會傳回，並顯示藍圖狀態為 `UPDATING`。選擇重新整理按鈕，直到狀態變更為 `ACTIVE` 或 `FAILED`。

1. 如果狀態為 `FAILED`，請選取藍圖，然後在 **Actions (動作)** 選單，選擇 **View (檢視)**。

   詳細資訊頁面會顯示失敗的原因。如果錯誤訊息為「無法存取以下位置的物件...」或「以下位置的物件存取被拒絕...」，請檢閱下列需求：
   + 您登入的使用者身分必須具有 Amazon S3 中藍圖 ZIP 封存的讀取許可。
   + 包含 ZIP 封存檔的 Amazon S3 儲存貯體必須具有儲存貯體政策，將物件的讀取許可授予 AWS 您的帳戶 ID。如需詳細資訊，請參閱[發佈藍圖](developing-blueprints-publishing.md)。
   + 您使用的 Amazon S3 儲存貯體必須與您在主控台上登入的區域位在同一區域。
**注意**  
如果更新失敗，則下一次執行藍圖會使用已成功註冊或更新的最新版本藍圖。

**更新藍圖 (AWS CLI)**

1. 輸入以下命令。

   ```
   aws glue update-blueprint --name <blueprint-name> [--description <description>] --blueprint-location s3://<s3-path>/<archive-filename>
   ```

1. 如要檢查藍圖狀態，請輸入以下命令。重複此指令，直到狀態變為 `ACTIVE` 或 `FAILED`。

   ```
   aws glue get-blueprint --name <blueprint-name>
   ```

   如果狀態為 `FAILED` 並且錯誤訊息為「無法存取以下位置的物件...」或「以下位置的物件存取被拒絕...」中，請檢閱下列需求：
   + 您登入的使用者身分必須具有 Amazon S3 中藍圖 ZIP 封存的讀取許可。
   + 包含 ZIP 封存檔的 Amazon S3 儲存貯體必須具有儲存貯體政策，將物件的讀取許可授予 AWS 您的帳戶 ID。如需詳細資訊，請參閱[發佈藍圖](developing-blueprints-publishing.md)。
   + 您使用的 Amazon S3 儲存貯體必須與您在主控台上登入的區域位在同一區域。

**另請參閱**  
[AWS Glue 中的藍圖概觀](blueprints-overview.md)