如何疑難排解在 SageMaker Studio 中存取 Amazon SageMaker 專案時出現的問題？

解決方案

SageMaker 專案可讓您管理和協調端對端 ML 解決方案。當您從 Studio 環境中建立或存取專案時，可能會因下列一點或多點原因而發生問題：

• 缺少許可
• 僅限 VPC 模式下的網路問題
• Studio 使用者介面問題

缺少許可

SageMaker 專案依賴 AWS Service Catalog 來使用或建立專案範本，以及為您的帳戶佈建 AWS 資源。只有在您將專案許可授予您的 Studio 網域使用者時，他們才能存取或檢視這些範本。

如果您的使用者沒有專案許可，則他們會收到類似下列內容的錯誤訊息：

Amazon SageMaker project templates aren't enabled for your account.
Contact your administrator to enable SageMaker project templates.

若要解決此問題，請務必向管理員和網域執行角色使用者授予專案許可。

因為下列其中一個項目已遺失、刪除、修改或手動重新建立，您可能也會遇到許可問題：

• 當您啟動 SageMaker 專案時所建立的服務角色
• Amazon SageMaker JumpStart

若要解決此問題，請完成下列步驟以關閉 SageMaker 專案範本和 JumpStart：

1.    開啟 SageMaker 主控台。

2.    從導覽窗格中，選擇網域。

3.    使用網域名稱旁邊的按鈕來選取您的網域。然後，在網域面板頂端，選擇編輯。

4.    在一般設定頁面上，選擇下一步.。

5.    在 SageMaker 專案和 JumpStart 下，關閉為此帳戶啟用 Amazon SageMaker 專案範本和 Amazon SageMaker JumpStart。同時關閉為 Studio 使用者啟用 Amazon SageMaker 專案範本和 Amazon SageMaker JumpStart 開關。

6.    選擇下一步。

7.    在 RStudio 設定頁面上，選擇下一步。

8.    在 Amazon SageMaker Canvas 設定頁面上，選擇提交。

9.    刪除以 AmazonSageMakerServiceCatalogProduct* 開頭的所有角色。

10.  使用上述指示，開啟切換開關來啟動 SageMaker 專案範本和 JumpStart。此步驟會為您建立數個新角色。若要檢視角色清單：在專案下，選擇應用程式標籤，然後再選擇控制面板。

**注意：**若要擁有存取 AWS Service Catalog 主控台所需的許可，請將受管政策 SageMakerFullAccess 連接至您的 Studio 使用者的執行角色。

僅限 VPC 模式下的網路問題

採用 僅限 VPC 網路存取類型時，網際網路存取無法使用。因此，除非符合下列條件，否則您無法執行 Studio 筆記本：

• 您的 VPC 具有 SageMaker API 和執行時間的介面端點，或者是具備網際網路存取權的 NAT 閘道。
• 您的安全群組允許出站連線。

如果您不需要 SageMaker 專案的 NAT 閘道存取權，則必須建立介面 VPC 端點 (AWS PrivateLink) 以連線到 com.amazonaws.[region].servicecatalog。例如，如果您在 eu-west-1 AWS 區域中使用 Studio，請使用 com.amazonaws.eu-west-1.servicecatalog。如需詳細資訊，請參閱使用僅限 VPC 模式的要求。

若要確認您的 Studio 的網路設定是否允許連線至 SageMaker API 和 Service Catalog 端點，請從 Studio 系統終端機執行下列命令：

檢查對 SageMaker API 端點的存取權：

curl -v https://api.sagemaker.example-region.amazonaws.com

檢查所需區域中 Service Catalog 端點的存取權：

curl -v https://api.sagemaker.example-region.amazonaws.com

如果執行這些命令時出現連線逾時錯誤，請確認您的 VPC 網路設定是否已設定為僅限 VPC 模式。

執行下列命令，從系統終端檢視可用專案的清單：

$ aws sagemaker list-projects --sort-by CreationTime --sort-order Descending

如果您無法在 SageMaker Studio 介面中檢視相同的清單，請務必更新您的 Studio 網域。然後，執行以下操作：

1.    啟動 SageMaker Studio。

2.    在左側欄中，選擇命令。

3.    在搜尋列中搜尋重設應用程式狀態，然後選擇此選項。

注意：在 JupyterLab 3 中，預設情況下，左側欄沒有命令選項板。若要新增命令選項板：在功能表上選擇檢視，然後在功能表列上選擇啟動命令選項板。或者，也可以使用鍵盤快速鍵命令 Ctrl + Shift + C。

---