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

# 使用 資源
<a name="more-resources"></a>

除了存取預設在 AWS Explorer 中列出的 AWS 服務之外，您也可以前往 **資源**，並從數百個資源中選擇要新增至介面的資源。在 中 AWS，**資源**是您可以使用的實體。可以新增的一些資源包括 Amazon AppFlow、Amazon Kinesis Data Streams、 AWS IAM 角色、Amazon VPC 和 Amazon CloudFront 分佈。

完成選擇後，您可以前往**資源**並展開資源類型，列出該類型的可用資源。例如：若您選取 `AWS Toolkit:Lambda::Function` 資源類型，您可以存取定義不同功能、其屬性及其屬性的資源。

將資源類型新增到 **Resources** (資源) 後，您便可使用下列方式來與資源互動：
+ 檢視目前 AWS 區域中可用於此資源類型的現有資源清單。
+ 檢視描述資源的 JSON 檔案的唯讀版本。
+ 複製資源的資源識別符。
+ 檢視說明資源類型用途 AWS 的文件，以及建立資源模型的結構描述 (JSON 和 YAML 格式）。
+ 透過編輯並儲存符合結構描述的 JSON 格式範本來建立新資源。**\$1**
+ 更新或刪除現有的資源。**\$1**

**重要**  
**\$1**在目前版本的建立、編輯和刪除資源 AWS Toolkit for Visual Studio Code 選項中， 是一項*實驗性功能*。實驗功能會持續進行測試和更新，因此可能存在可用性問題。實驗功能可能會從 中移除， AWS Toolkit for Visual Studio Code 恕不另行通知。  
若要允許將實驗性功能用於 資源，請開啟 VS Code IDE 中的**設定**窗格，然後展開**延伸模組**，然後選擇 **AWS Toolkit**。  
在**AWS 工具組實驗**下，選取 **jsonResourceModification**，以允許您建立、更新和刪除資源。  
  
如需詳細資訊，請參閱[使用實驗功能](experimental-features.md)。

## 存取資源的 IAM 許可
<a name="cloud-api-permissions"></a>

您需要特定 AWS Identity and Access Management 許可才能存取與服務 AWS 相關聯的資源。例如：IAM 實體 (諸如使用者或角色) 需要 Lambda 許可才能存取 `AWS Toolkit:Lambda::Function` 資源。

除了服務資源的許可之外，IAM 實體還需要許可，以允許 Toolkit for VS Code 代表其呼叫 AWS Cloud Control API 操作。雲端控制 API 作業允許 IAM 使用者或角色存取和更新遠端資源。

授予許可的最簡單方法是將 AWS 受管政策 **PowerUserAccess** 連接至使用 Toolkit 介面呼叫這些 API 操作的 IAM 實體。這個[受管政策](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_job-functions.html#jf_developer-power-user)會授與一系列許可，以執行應用程式開發任務，包括呼叫 API 作業。

如需定義遠端資源上允許 API 作業的特定許可，請參閱《[AWS 雲端控制 API 使用者指南》。](https://docs.aws.amazon.com//cloudcontrolapi/latest/userguide/security.html)

## 新增並與現有資源互動
<a name="configure-resources"></a>

1. 在 **AWS Explorer** 中，以滑鼠右鍵按一下**資源**，然後選擇**顯示資源**。

   窗格會顯示可供選取的資源類型清單。  
![\[選取要設定的資源。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-vscode/latest/userguide/images/show-resources.png)

1. 在選取窗格中，選取要新增至 **AWS Explorer** 的資源類型，然後按**傳回**或選擇**確定**以確認。

   您選取的資源類型會列在**資源**底下。
**注意**  
如果您已將資源類型新增至 **AWS Explorer**，然後清除了該類型的核取方塊，在您選擇之後**確定**之後，該類型就不會再列於**資源**底下。只有目前選取的資源類型會顯示在 **AWS Explorer** 中。

1. 若要檢視資源類型已存在的資源，請展開該類型的項目。

   可用資源清單會顯示在資源類型下方。

1. 若要與特定資源互動，請在其名稱上按一下滑鼠右鍵，然後選擇以下其中一個選項：
   + **複製資源識別符**：將特定資源的識別符複製到剪貼簿。(例如：`AWS Toolkit:DynamoDB::Table` 資源可以使用 `TableName` 屬性進行識別。) 
   + **Preview** (預覽)：檢視描述資源的 JSON 格式範本的唯讀版本。

     顯示資源範本之後，您可以選擇編輯器索引標籤右側的**更新**圖示來修改它。若要更新資源，您必須[experimental feature](#experimental-feature-warning)啟用必要的 。
   + **更新**：在 VS 程式碼編輯器中編輯資源的 JSON 格式範本。如需詳細資訊，請參閱[建立和編輯資源](#create-resources)。
   + **刪除**：在顯示的對話方塊中確認刪除，以刪除資源。（在此版本的 [experimental feature](#experimental-feature-warning)中，刪除資源目前是 AWS Toolkit for Visual Studio Code。)
**警告**  
如果您刪除資源，使用該資源的任何 AWS CloudFormation 堆疊都將無法更新。若要修正此更新失敗，您需要重新建立資源，或移除堆疊 CloudFormation 範本中對此資源的參考。如需詳細資訊，請參閱這篇[知識中心文章](https://aws.amazon.com/premiumsupport/knowledge-center/failing-stack-updates-deleted/)。  
![\[所選資源的選單選項。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-vscode/latest/userguide/images/resource-menu-options-updated.png)

## 建立和編輯資源
<a name="create-resources"></a>

**重要**  
建立和更新資源的功能目前在此版本的 AWS Toolkit for Visual Studio Code中為[experimental feature](#experimental-feature-warning)。

建立新資源的程序包含將資源類型新增至**資源**清單，然後編輯定義資源、其內容及其屬性的 JSON 格式範本。

例如，屬於資源類型的`AWS Toolkit:SageMaker::UserProfile`資源是以範本定義，該範本會為 Amazon SageMaker AI Studio 建立使用者設定檔。定義此使用者描述檔資源的範本必須符合 `AWS Toolkit:SageMaker::UserProfile` 的資源類型結構描述。例如，如果範本因為缺少或不正確的屬性而不符合結構描述，就無法建立或更新資源。

1. 透過在資源上按一下滑鼠右鍵並選擇**顯示**資源，為您要建立**的資源**新增資源類型。

1. 在資源下新增**資源**類型之後，請選擇加號 ("\$1") 圖示，在新的編輯器中開啟範本檔案。

   或者，您可以在資源類型的名稱上按一下滑鼠右鍵，然後選擇**建立**。您也可以選擇**檢視文件**，以存取如何建立資源模型的相關資訊。  
![\[所選資源類型的選單選項。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-vscode/latest/userguide/images/resource-create.png)

1. 在編輯器中，開始定義組成資源範本的屬性。自動完成功能會建議符合範本結構描述的屬性名稱。當您將滑鼠暫留在屬性類型上時，窗格會顯示其用途的描述。如需結構描述的詳細資訊，請選擇**檢視文件**。

   任何不符合資源結構描述的文字都會以波紋紅色底線表示。  
![\[編輯器顯示描述資源類型的範本。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-vscode/latest/userguide/images/resource-template.png)

1. 完成宣告資源後，請選擇**儲存**圖示以驗證您的範本，並將資源儲存至遠端 AWS 雲端。

   如果您的範本是根據其結構描述定義資源，系統會顯示一則訊息，以確認資源已建立。(如果資源已存在，訊息會確認資源已更新。)

   資源建立完成後，會新增至資源類型標題下的清單中。

1. 如果您的檔案包含錯誤，系統會顯示一則訊息，說明無法建立或更新資源。選擇**檢視日誌**以識別您需要修正的範本元素。