如何對在 SageMaker AI Studio 中存取 SageMaker AI 專案時的問題進行疑難排解？

解決方法

缺少權限疑難排解

SageMaker AI Projects 使用 AWS Service Catalog 來使用或建立專案範本，並為您的 AWS 帳戶佈建 AWS 資源。只有當您授予 Projects 權限時，您的 SageMaker AI Studio 網域使用者才能存取或檢視這些範本。

如果您的使用者沒有 Projects 權限，則該使用者會收到類似以下範例的錯誤訊息：

「Amazon SageMaker project templates aren't activated for your account.Contact your administrator to activate SageMaker project templates.」

若要解決此問題，請為管理員和網域執行角色使用者授予 Projects 權限。

您也可能因為以下項目遺失、遭刪除、遭修改或手動重新建立而發生權限問題：

• 您啟用 SageMaker AI Project 時，SageMaker AI Studio 建立的服務角色
• Amazon SageMaker AI JumpStart

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

1. 開啟 SageMaker AI console (SageMaker AI 主控台)。
2. 在導覽窗格中，選擇 Domains (網域)。
3. 選取您的網域。
4. 選擇 App Configurations (應用程式組態) 索引標籤。
5. 在 SageMaker Studio Classic (SageMaker Studio 經典版) 下，選擇 Edit (編輯)。
6. 在 SageMaker Projects and JumpStart (SageMaker Projects 與 JumpStart) 下，關閉以下選項：
   為此帳戶啟用 Amazon SageMaker 專案範本和 Amazon SageMaker JumpStart
   為 Studio 使用者啟用 Amazon SageMaker 專案範本與 Amazon SageMaker JumpStart
7. 選擇 Submit (提交)。
8. 刪除所有以 AmazonSageMakerServiceCatalogProduct* 開頭的 AWS Identity and Access Management (IAM) 角色。
9. 使用上述指示開啟切換開關，以啟用 SageMaker AI 專案範本和 JumpStart。此步驟會為您建立幾個新角色。

對僅限 VPC 模式下的網路問題進行疑難排解

**注意：**如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息，請參閱對 AWS CLI 錯誤進行疑難排解。此外，請確定您使用的是最新的 AWS CLI 版本。

使用 virtual private cloud (VPC) only (僅限虛擬私有雲端 (VPC)) 網路存取類型時，網際網路存取不會啟用。只有在符合以下條件時，您才能執行 Studio AI 筆記本：

• 您的 VPC 具有連至 SageMaker AI API 和執行時期的介面端點，或具備可存取網際網路的 NAT 閘道。
• 您的安全群組允許傳出連線。

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

若要確認 Studio 的網路設定允許連線至 SageMaker AI API 和 Service Catalog 端點，請從 SageMaker AI Studio 系統終端執行以下命令。

執行以下命令以檢查 SageMaker AI API 端點的存取權：

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

執行以下命令以檢查所需區域中 Service Catalog 端點的存取權：

curl -v https://servicecatalog.example-region.amazonaws.com

如果您執行前述命令時收到 Connection timed out 錯誤，請確認您已針對 僅限 VPC 模式設定 VPC 網路設定。

若要從系統終端查看可用專案清單，請執行 list-projects AWS CLI 命令：

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

**注意：**如果您無法在 SageMaker AI Studio 介面中看到相同清單，請務必更新 Studio 的網域。

然後，完成以下步驟：

1. 啟動 SageMaker AI Studio 應用程式。
2. 在頂端的功能表上，選擇 View (檢視)。
3. 在功能表列上，選擇 Activate Command Palette (啟用命令選擇區)。或者，按 Ctrl + Shift + C。
4. 在搜尋列中搜尋 Reset Application State (重設應用程式狀態)，然後選擇此選項。