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

# 更新模型的核准狀態
<a name="model-registry-approve"></a>

建立模型版本之後，通常需要先評估其效能，然後再將其部署到生產端點。如果模型版本符合需求，您可以將其核准狀態更新為 `Approved`。將狀態設定為 `Approved` 可啟動模型的 CI/CD 部署。如果模型版本不符合需求，您可以將核准狀態更新為 `Rejected`。

您可以在註冊模型版本後手動更新模型版本的核准狀態，也可以在建立 SageMaker AI 管道時建立條件步驟來對模型進行評估。如需在 SageMaker AI 管道中建立條件步驟的相關資訊，請參閱[Pipelines 步驟](build-and-manage-steps.md)。

當您使用 SageMaker AI 提供的其中一個專案範本，且模型版本的核准狀況變更時，會發生下列動作。只顯示有效的轉變。
+ `PendingManualApproval` 至 `Approved` - 針對已核准的模型版本啟動 CI/CD 部署
+ `PendingManualApproval` 至 `Rejected` - 不採取任何動作
+ `Rejected` 至 `Approved` - 針對已核准的模型版本啟動 CI/CD 部署
+ `Approved` 至 `Rejected` - 啟動 CI/CD 以部署具有 `Approved` 狀態的最新模型版本

您可以使用 適用於 Python (Boto3) 的 AWS SDK 或使用 Amazon SageMaker Studio 主控台來更新模型版本的核准狀態。您也可以作為 SageMaker AI 管道中條件步驟的一部分來更新模型版本的核准狀態。如需在 SageMaker AI 管道中使用模型核准步驟的相關資訊，請參閱[管道概觀](pipelines-overview.md)。

## 更新模型的核准狀態 (Boto3)
<a name="model-registry-approve-api"></a>

在 [註冊模型版本](model-registry-version.md) 中建立模型版本時，可將 `ModelApprovalStatus` 設定為 `PendingManualApproval`。您可以透過調用 `update_model_package` 來更新模型的核准狀態。請注意，您可以撰寫程式碼來自動執行此程序，例如，根據對模型效能的某些評估結果來設定模型的核准狀態。您也可以在管道中建立一個步驟，從而在核准時自動部署新模型版本。下列程式碼片段展示如何將核准狀態手動變更為 `Approved`。

```
model_package_update_input_dict = {
    "ModelPackageArn" : model_package_arn,
    "ModelApprovalStatus" : "Approved"
}
model_package_update_response = sm_client.update_model_package(**model_package_update_input_dict)
```

## 更新模型的核准狀態 (Studio 或 Studio Classic)
<a name="model-registry-approve-studio"></a>

若要在 Amazon SageMaker Studio 主控台中手動變更核准狀態，請根據您是使用 Studio 還是 Studio Classic 完成以下步驟。

------
#### [ Studio ]

1. 請遵循[啟動 Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html) 中的指示來開啟 SageMaker Studio 主控台。

1. 在左側導覽窗格中，選擇**模型**以顯示模型群組的清單。

1. 如果尚未選取，請選擇**已註冊模型**索引標籤。

1. 如果尚未選取，請在**已註冊模型**索引標籤的正下方選擇**模型群組**。

1. 從模型群組清單中，選擇您要檢視之模型群組左側的角度括號。

1. 模型群組中模型版本的清單即會出現。如果您沒有看到要刪除的模型版本，請選擇**檢視全部**，以在模型群組詳細資訊頁面中顯示模型版本的完整清單。

1. 選取要更新的模型版本名稱。

1. **部署**索引標籤會顯示目前的核准狀態。選擇目前核准狀態旁邊的下拉式選單，然後選取更新的核准狀態。

------
#### [ Studio Classic ]

1. 登入 Amazon SageMaker Studio Classic。如需詳細資訊，請參閱[啟動 Amazon SageMaker Studio Classic](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-launch.html)。

1. 在左側的導覽窗格中，選擇**首頁**圖示 (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/zh_tw/sagemaker/latest/dg/images/studio/icons/house.png))。

1. 選擇**模型**，然後選擇**模型註冊表**。

1. 從模型群組清單中，選取要檢視的模型群組名稱。系統會開啟一個新標籤，其中包含模型群組中模型版本的清單。

1. 在模型版本清單中，選取您要更新的模型版本名稱。

1. 在**動作**下拉式功能表下，您可以選擇兩個可能的功能表選項之一來更新模型版本狀態。
   + 使用**更新狀態** 選項

     1. 在**動作**下拉式功能表下，選擇**更新狀態**下拉式功能表，然後選擇新的模型版本狀態。

     1. (可選) 在**評論**欄位中，新增其他詳細資訊。

     1. 選擇**儲存並更新**。
   + 使用**編輯**選項

     1. 在**動作**下拉式功能表下，選擇**編輯**。

     1. (可選) 在**評論**欄位中，新增其他詳細資訊。

     1. 選擇**儲存變更**。

1. 確認模型版本狀態已在模型版本頁面中更新為正確的值。

------

對於 `us-east-1`、`ap-northeast-1`、 `us-west-2`和 `eu-west-1`區域，您可以使用下列指示來存取已記錄和已註冊模型版本的歷程詳細資訊：

1. 請遵循[啟動 Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html) 中的指示來開啟 SageMaker Studio 主控台。

1. 從主要導覽窗格中選擇**模型**。

1. 選擇已記錄**的模型**索引標籤，如果尚未選取，請選取**已註冊的模型**。

1. 選取模型，然後選擇**檢視最新版本**。

1. 選擇**控管**索引標籤。

1. **控管概觀**下的**部署**區段會顯示目前的核准狀態。從下拉式選單中選取更新的核准狀態。