Amazon S3 オブジェクトの操作

S3 リソースバケットに保存されているファイル、フォルダ、その他のデータは S3 オブジェクトと呼ばれます。

次のセクションでは、AWS Toolkit for Visual Studio Code から Amazon S3 オブジェクトを使用する方法について説明します。AWS Toolkit for Visual Studio Codeからの Amazon S3 リソース（S3 バケットなど）の操作の詳細については、このユーザーガイドの「S3 リソースの使用」トピックを参照してください。

オブジェクトの割りの一覧表示

多数の Amazon S3 オブジェクトとフォルダを操作している場合は、のページ割りを使用してページに表示する項目の数を指定できます。

1. VS Code アクティビティバーに移動し、[拡張機能] を選択します。

2. AWS Toolkit 拡張機能から、設定アイコンを選択し、拡張機能の設定 を選択してください。

3. 設定 ページで、AWS > S3 までスクロールダウンします。ページ 設定ごとの最大項目。

4. 「さらにロード」が表示される前に表示したい S3 アイテムの数にデフォルト値を変更します。

   注記

   有効な値には 3～1000 の数が含まれます。この設定は、一度に表示されるオブジェクトまたはフォルダの数にのみ適用されます。作成したすべてのバケットが一度に表示されます。デフォルトでは、AWS アカウントにつき最大で 100 個のバケットを作成できます。

5. [設定] ページを閉じて、変更を確認します。

JSON 形式のファイルの設定を更新するには、[設定] ページの右上にある [設定を開く (JSON)] を選択します。

Amazon S3 オブジェクトのアップロードとダウンロード

AWS Toolkit for Visual Studio Code から、ローカルに保存されているファイルを Amazon S3 バケットにアップロードしたり、リモートの Amazon S3 オブジェクトをローカル システムにダウンロードしたりできます。

Toolkit を使用して、ファイルをアップロードする

1. Toolkit エクスプローラーから、[Amazon S3] サービスを展開して S3 リソースのリストを表示します。

2. バケットまたはフォルダの横にある ファイルをアップロードアイコンを選択し、ファイルをアップロードダイアログを開きます。または、コンテキスト (右クリック) メニューを開いて、[ファイルをアップロード] を選択することもできます。

   注記

   オブジェクトの親フォルダまたはリソースにファイルをアップロードするには、任意の S3 オブジェクトのコンテキスト (右クリック) メニューを開き、[親にアップロード]を選択します。

3. システムのファイルマネージャを使用してファイルを選択し、[ファイルをアップロード] を選択してダイアログを閉じてファイルをアップロードします。

コマンドパレットを使用してファイルをアップロードする

ツールキットインターフェイスまたはコマンドパレットを使用して、バケットにファイルをアップロードできます。

1. アップロードするファイルを選択するには、VS Codeで、ファイルのタブを選択します。

2. Ctrl+Shift+P を押して コマンドパレットを表示します。

3. コマンドパレットで、 フレーズupload fileを入力して 推奨されたコマンドを表示します。

4. AWS：ファイルをアップロードコマンドを選択し、AWS：ファイルをアップロードダイアログを開きます。

5. プロンプトが表示されたら、アップロードするファイルを選択し、そのファイルをアップロードするバケットを選択します。

6. アップロードを確認してダイアログを閉じ、アップロードプロセスを開始します。アップロードが完了すると、オブジェクトサイズ、最終変更日、パスなどのメタデータとともにオブジェクトがツールキットメニューに表示されます。

Amazon S3 オブジェクトのダウンロード

1. Toolkit Explorer から、S3 サービスを展開します。

2. バケットまたはフォルダから、ダウンロードするオブジェクトのコンテキスト (右クリック) メニューを開きます。次に、[名前をつけてダウンロード] を選択して [名前をつけてダウンロード] ダイアログボックスを開きます。または、オブジェクトの近くにある「名前をつけてダウンロード」アイコンを選択します。

3. システムのファイル マネージャーを使用して、宛先フォルダーを選択し、ファイル名を入力し、[ダウンロード] を選択してダイアログを閉じ、ダウンロードを開始します。

リモートオブジェクトの編集

AWS Toolkit for Visual Studio Codeを使用して、リモート Amazon S3 リソースに保存されている Amazon S3 オブジェクトを編集できます。

1. Toolkit Explorer から、S3 サービスを展開します。

2. 編集するファイルを含む S3 リソースを展開します。

3. ファイルを編集するには、鉛筆アイコン (ファイルの編集) を選択します。

4. 読み取り専用モードで開いているファイルを編集するには、VS Code Editor でファイルを表示し、UI の右上隅にある鉛筆アイコンを選択します。

注記

• VS Code を再起動または終了すると、IDE は S3 リソースから切断されます。接続を切断したときにリモート S3 ファイルが編集されていた場合、編集は停止します。編集を再開するには、VS Code を再起動し、編集タブを再度開く必要があります。

• [ファイルを編集] ボタンは、UI の右上隅にあります。VS Code Editor で読み取り専用ファイルをアクティブに表示している場合にのみ表示されます。

• テキスト以外のファイルは読み取り専用モードでは開くことができません。これらは常に編集モードで開きます。

• 編集専用モードから読み取り専用モードに戻すことはできず、その逆しかできません。

Amazon S3 オブジェクトのパスのコピー

以下の手順では、AWS Toolkit for Visual Studio Codeから Amazon S3 オブジェクトのパスをコピーする方法について説明します。

1. ツールキット エクスプローラーから、S3 サービスを展開します。

2. パスをコピーするオブジェクトを含むリソースバケットを展開します。

3. パスをコピーするオブジェクトのコンテキスト (右クリック) メニューを開き、[パスをコピー] を選択してオブジェクトパスをローカルクリップボードにコピーします。

Amazon S3 オブジェクトの署名付き URL を生成します。

署名付き URL 機能を使用してダウンロードの期限付きのアクセス許可を付与することにより、プライベート Amazon S3 オブジェクトを共有できます。詳細については、「署名付き URL を使用したオブジェクトの共有」を参照してください。

1. Toolkit Explorer から、S3 サービスを展開します。

2. バケットまたはフォルダから、共有するオブジェクトのコンテキスト (右クリック) メニューを開きます。次に、「署名済み URL を生成」を選択してコマンドパレットを開きます。

3. コマンドパレットから、URL を使用してオブジェクトにアクセスできる時間を分単位で入力します。次に Enter キーを押して確認し、ダイアログを閉じます。

4. 署名済み URL が生成されると、ローカルクリップボードにコピーされたオブジェクトの署名済み URL が VS Code ステータスバーに表示されます。

Amazon S3 オブジェクトの削除

オブジェクトがバージョン管理されていないバケット内にある場合は、それを完全に削除できます。バージョニングが有効になっているバケットの場合、削除リクエストによってそのオブジェクトは完全に削除されません。代わりに、Amazon S3 はバケットに削除マーカーを挿入します。詳細については、「オブジェクトのバージョンを削除」を参照してください。

1. Toolkit エクスプローラーから、S3 サービスを展開して S3 リソースのリストを表示します。

2. 削除するオブジェクトのコンテキスト (右クリック) メニューを開き、[削除] を選択して確認ダイアログを開きます。

3. [削除] を選択して、S3 オブジェクトの削除を確認します。次に、ダイアログを閉じます。