<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동 정보
<ph type="x-smartling-placeholder">
버전: 1.1.0
Amazon S3 버킷의 파일을 관리합니다. 이 확장 프로그램을 사용하면 파일을 나열, 다운로드, 삭제할 수 있습니다. 파일을 다운로드하기 위한 서명된 URL을 생성할 수도 있습니다.
이 확장 프로그램의 구성된 각 인스턴스는 특정 버킷과 함께 작동합니다. 버킷이 여러 개인 경우 각 버킷에 구성된 이 확장 프로그램의 인스턴스를 사용합니다.
기본 요건
ExtensionCallout 정책을 사용하여 API 프록시에서 확장 프로그램을 사용하려면 먼저 다음을 실행해야 합니다.
작업할 Amazon S3 버킷의 액세스 키 ID 및 보안 비밀 액세스 키를 가져옵니다.
이 확장 프로그램을 구성하려면 AWS 버킷 이름, AWS 리전과 함께 이 정보가 필요합니다.
Amazon S3 정보
Amazon Simple Storage Service(Amazon S3)는 객체 스토리지 서비스입니다.
작업
<ph type="x-smartling-placeholder">
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 콘솔에 입력하면 JSON 파일 형식으로 Amazon 액세스 키 ID와 액세스 키가 포함됩니다.{"accessKeyId" : access-key-ID,"secretAccessKey" : secret-access-key}관리 API를 통해 전송하면 키 JSON 파일에서 base64로 인코딩된 값입니다. |
없음 | 예. |