

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リソースの使用
<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 ファイルの読み取り専用バージョンを表示します。
+ リソースのリソース識別子をコピーします。
+ リソースタイプの目的と、リソースをモデル化するためのスキーマ (JSON および YAML 形式) を説明する AWS ドキュメントを表示します。
+ スキーマに準拠する JSON 形式のテンプレートを編集して保存して、新しいリソースを作成します。**\$1**
+ 既存のリソースを更新または削除します。**\$1**

**重要**  
**\$1** 現在のリリースでは、リソースを作成、編集、削除する AWS Toolkit for Visual Studio Code オプションは*実験的な機能*です。実験的な機能は引き続きテストおよび更新されるため、ユーザビリティに問題がある可能性があります。また、実験的な機能は、予告 AWS Toolkit for Visual Studio Code なしに から削除される場合があります。  
リソースに実験的な機能を使用できるようにするには、VS Code IDE の [**設定**] ペインを開き、[**拡張機能**] を展開して [**AWS ツールキット**] を選択します。  
[**AWS : Toolkit Experiments**] の下から [**JSONResourceModification**] を選択して、リソースを作成、更新、削除できるようにします。  
  
詳細については、「[実験的な機能の使用](experimental-features.md)」を参照してください。

## リソースにアクセスするための IAM アクセス許可
<a name="cloud-api-permissions"></a>

サービスに関連付けられた AWS リソースにアクセスするには、特定のアクセス AWS Identity and Access Management 許可が必要です。例えば、IAM エンティティ (ユーザーまたはロールなど) は、`AWS Toolkit:Lambda::Function` リソースにアクセスするために Lambda アクセス許可を必要とします。

サービスリソースのアクセス許可に加えて、IAM エンティティには、Toolkit for VS Code が代わりに AWS Cloud Control API オペレーションを呼び出すことを許可するアクセス許可が必要です。Cloud Control API オペレーションでは、IAM ユーザーまたはロールがリモートリソースにアクセスして更新できます。

アクセス許可を付与する最も簡単な方法は、 Toolkit インターフェイスを使用してこれらの API オペレーションを呼び出す IAM エンティティに管理 AWS ポリシー **PowerUserAccess** をアタッチすることです。この[マネージドポリシー](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 エクスプローラ** ] をクリックして、**リソース** 右クリックして [**リソースを表示**] を選択します。

   ペインには、選択可能なリソースタイプのリストが表示されます。  
![\[構成するリソースを選択します「」。\]](http://docs.aws.amazon.com/ja_jp/toolkit-for-vscode/latest/userguide/images/show-resources.png)

1. 選択ペインで、[**AWS Explorer**] に追加するリソースタイプを選択し、[**戻る**] をクリックするかまたは [**OK**] を選択して確認します。

   選択したリソースタイプは、[**リソース**] に表示されます
**注記**  
リソースタイプを **[AWS エクスプローラー]** にすでに追加済みの場合は、そのタイプのチェックボックスをオフにすると、**[OK]** をクリックした後 **[リソース]** の下のリストに表示されなくなります。現在選択されているリソースタイプのみが、**[AWS エクスプローラー]** に表示されます。

1. リソースタイプに既に存在するリソースを表示するには、そのタイプのエントリを展開します。

   使用可能なリソースのリストが、リソースタイプの下に表示されます。

1. 特定のリソースを操作するには、リソースの名前を右クリックし、次のいずれかを選択します。
   + **リソース識別子をコピー**: 特定のリソースの識別子をクリップボードにコピーします。(例えば、`AWS Toolkit:DynamoDB::Table` リソースは `TableName` プロパティを使用して識別できます。) 
   + **[Preview]** (プレビュー): リソースを記述する JSON 形式のテンプレートの読み取り専用バージョンを表示します。

     リソーステンプレートが表示されたら、エディタタブの右側にある [**更新**] アイコンを選択して修正できます。リソースを更新するには、[experimental feature](#experimental-feature-warning) を有効にする必要があります。
   + **更新**: VS Code エディタでリソースの 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/ja_jp/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/ja_jp/toolkit-for-vscode/latest/userguide/images/resource-create.png)

1. エディタで、リソーステンプレートを構成するプロパティの定義を開始します。オートコンプリート機能では、テンプレートのスキーマに適合するプロパティ名が提案されます。プロパティタイプにカーソルを合わせると、そのプロパティの使用目的の説明がペインに表示されます。スキーマの詳細については、[**ドキュメントの表示**] を選択してください。

   リソーススキーマに適合しないテキストは、波状の赤い下線で示されます。  
![\[リソースタイプを説明するテンプレートを表示するエディタ。\]](http://docs.aws.amazon.com/ja_jp/toolkit-for-vscode/latest/userguide/images/resource-template.png)

1. リソースの宣言が完了したら、**保存**アイコンを選択してテンプレートを検証し、リソースをリモート AWS クラウドに保存します。

   テンプレートがスキーマに従ってリソースを定義している場合は、リソースが作成されたことを確認するメッセージが表示されます。(リソースが既に存在する場合は、リソースが更新されたことを確認するメッセージが表示されます。)

   リソースが作成されると、リソースタイプの見出しの下のリストに追加されます。

1. ファイルにエラーが含まれている場合は、リソースを作成または更新できなかったことを示すメッセージが表示されます。[**ログを表示する**] を選択して、修正する必要があるテンプレート要素を特定します。