Amazon S3 拡張機能

バージョン: 1.0.0

Amazon S3 バケットのファイルを管理します。この拡張機能を使用すると、ファイルのリスト、ダウンロード、削除ができます。ファイルのダウンロード用に署名付き URL を生成することもできます。

この拡張機能の構成済みの各インスタンスが特定のバケットで動作します。バケットが複数の場合、バケットごとにこの拡張機能の構成済みインスタンスを使用します。

前提条件

ExtensionCallout ポリシーで API プロキシ経由で拡張機能を使用する前に、次のことを行う必要があります。

• 作業対象の Amazon S3 バケット用のアクセスキー ID とシークレット アクセスキーを取得します。

  この拡張機能を構成するには上記の項目とバケット名が必要です。

Amazon S3 について

Amazon Simple Storage Service（Amazon S3）はオブジェクト ストレージ サービスです。

アクション

deleteFile

S3 バケットから指定されたファイルを削除します。

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "name-of-file-to-delete"
}
]]>
</Input>

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "names.tmp"
}
]]>
</Input>

リクエスト パラメータ

レスポンス

なし

レスポンス プロパティ

なし

downloadFile

S3 バケットから指定されたファイルをダウンロードします。

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>

リクエスト パラメータ

レスポンス

ファイルのコンテンツを含む content プロパティを持つ JSON。

{
  "content":"Hello World!"
}

レスポンス プロパティ

generateSignedURL

S3 バケットから指定されたファイルをダウンロードするための署名付き URL を生成します。

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "filename",
  "expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "product-info.pdf",
  "expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>

リクエスト パラメータ

レスポンス

生成された URL を含む url 文字列プロパティを持つ JSON。

{
  "url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}

レスポンス プロパティ

listFiles

AWS Lambda 関数の実行を呼び出します

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

リクエスト パラメータ

なし

レスポンス

S3 ファイル名の配列。

["hello_world.txt"]

レスポンス プロパティ

なし

構成リファレンス

この拡張機能を API プロキシで使用するように構成してデプロイする場合は、以下のプロパティを使用します。Apigee Console で拡張機能を構成する手順については、拡張機能の追加と構成をご覧ください。

拡張機能の共通プロパティ

すべての拡張機能には次のプロパティがあります。

この拡張機能パッケージのプロパティ

この拡張機能に固有の以下の構成プロパティに値を指定します。