이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Amazon S3 확장 프로그램

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동 정보

버전: 1.0.0

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

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

기본 요건

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

작업할 Amazon S3 버킷의 액세스 키 ID 및 보안 비밀 액세스 키를 가져옵니다.

이 확장 프로그램을 구성하려면 AWS 버킷 이름 및 AWS 리전과 함께 이러한 정보가 필요합니다.

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>

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

예

<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 콘솔에 입력하면 다음과 같은 형식의 Amazon 액세스 키 ID 및 액세스 키가 포함된 JSON 파일이 됩니다. `{` `"accessKeyId" : access-key-ID,` `"secretAccessKey" : secret-access-key` `}` 관리 API를 통해 전송되면 해당 키 JSON 파일에서 생성된 base64로 인코딩된 값입니다.	없음	예.