Amazon S3 확장 프로그램

현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

버전: 1.1.1

Amazon S3 버킷의 파일을 관리합니다. 이 확장 프로그램을 사용하면 파일을 나열, 다운로드, 삭제할 수 있습니다. 파일을 다운로드하기 위해 서명된 URL을 생성할 수도 있습니다.

이 확장 프로그램의 구성된 각 인스턴스는 특정 버킷에서 작동합니다. 버킷이 여러 개인 경우 각 버킷에 구성된 이 확장 프로그램의 인스턴스를 사용합니다.

기본 요건

ExtensionCallout 정책을 사용하여 API 프록시에서 확장 프로그램을 사용하려면 먼저 다음을 실행해야 합니다.

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>

요청 매개변수

매개변수 설명 유형 기본값 필수
fileName 삭제할 파일의 이름입니다. 문자열 없음 예.

응답

없음

응답 속성

없음

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>

요청 매개변수

매개변수 설명 유형 기본값 필수
fileName 다운로드할 파일의 이름입니다. 문자열 없음 예.

응답

파일의 콘텐츠가 포함된 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>

요청 매개변수

매개변수 설명 유형 기본값 필수
fileName 다운로드할 파일의 이름입니다. 문자열 없음 예.
expiresIn URL이 만료될 때까지의 시간(초)입니다. 정수 86400 아니요.

응답

생성된 URL이 포함된 url 문자열 속성이 있는 JSON

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

응답 속성

속성 설명 유형 기본값
URL 요청된 파일의 URL입니다. 문자열 없음

listFiles

AWS Lambda 함수의 실행을 호출합니다.

구문

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

원하는 경우 <Output> 요소에 parsed="false"를 지정해야 합니다. 원시 JSON을 포함할 변수입니다. 그렇지 않으면 변수를 사용할 수 없습니다.

예

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>

요청 매개변수

없음

응답

S3 파일 이름의 배열.

["hello_world.txt"]

응답 속성

없음

구성 참조

API 프록시에서 사용하도록 이 확장 프로그램을 구성하고 배포할 때 다음을 사용하세요. Apigee 콘솔을 사용하여 확장 프로그램을 구성하는 단계는 확장 프로그램 추가 및 구성을 참조하세요.

일반적인 확장 속성

모든 확장 프로그램에는 다음과 같은 속성이 있습니다.

속성 설명 기본 필수
name 확장 프로그램의 구성에 지정할 이름입니다. 없음 지원됨
packageName Apigee Edge에서 제공하는 확장 프로그램 패키지 이름입니다. 없음 지원됨
version 확장 프로그램을 구성하는 확장 프로그램 패키지의 버전 번호입니다. 없음 지원됨
configuration 추가하는 확장 프로그램 관련 구성 값입니다. 이 확장 프로그램 속성의 속성을 참조하세요. 없음 지원됨

이 확장 프로그램 패키지의 속성

이 확장 프로그램과 관련된 다음 구성 속성의 값을 지정합니다.

속성 설명 기본값 필수
구성 사용할 Amazon S3 버킷의 이름(예: sample-bucket)을 입력합니다. 없음 예.
구성 사용할 AWS 리전의 이름(예: us-east-2)을 입력합니다. 없음 예.
사용자 인증 정보 Apigee Edge 콘솔에 입력하면 JSON 파일 형식으로 Amazon 액세스 키 ID와 액세스 키가 포함됩니다.

{
"accessKeyId" : access-key-ID,
"secretAccessKey" : secret-access-key
}

관리 API를 통해 전송하면 키 JSON 파일에서 base64로 인코딩된 값입니다.		 없음 예.