Rozszerzenie Amazon S3

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Wersja: 1.0.0

Zarządzanie plikami w zasobniku Amazon S3. Za pomocą tego rozszerzenia możesz wyświetlać, pobierać i usuwać pliki. Możesz też wygenerować podpisany adres URL do pobrania pliku.

Każda skonfigurowana instancja tego rozszerzenia współpracuje z określonym zasobnikiem. W przypadku wielu puli użyj skonfigurowanej instancji tego rozszerzenia dla każdej z nich.

Wymagania wstępne

Zanim użyjesz rozszerzenia z serwera proxy interfejsu API za pomocą zasady ExtensionCallout, musisz:

• Uzyskaj identyfikator klucza dostępu i tajny klucz dostępu do zasobnika Amazon S3, z którym będziesz pracować.

  Te informacje, wraz z nazwą zasobnika AWS i regionem AWS, będą potrzebne do skonfigurowania tego rozszerzenia.

Informacje o Amazon S3

Amazon Simple Storage Service (Amazon S3) to usługa obiektowej pamięci masowej.

Działania

deleteFile

Usuwa określony plik z zasobnika S3.

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

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

Parametry żądania

Odpowiedź

Brak.

Właściwości odpowiedzi

Brak.

downloadFile

Pobiera określony plik z zasobnika 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>

Parametry żądania

Odpowiedź

JSON z właściwością content zawierającą treść pliku.

{
  "content":"Hello World!"
}

Właściwości odpowiedzi

generateSignedURL

Generuje podpisany adres URL do pobrania określonego pliku z zasobnika S3.

<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>

Parametry żądania

Odpowiedź

Dane JSON z wartością ciągu znaków url zawierającą wygenerowany adres URL.

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

Właściwości odpowiedzi

listFiles

Wywołuje wykonanie funkcji AWS Lambda.

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

Jeśli chcesz, musisz określić parsed="false" w elemencie <Output> do umieszczenia nieprzetworzonego kodu JSON. W przeciwnym razie zmienna jest bezużyteczna.

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

Parametry żądania

Brak.

Odpowiedź

Tablica nazw plików w S3.

["hello_world.txt"]

Właściwości odpowiedzi

Brak.

Odniesienie do konfiguracji

Podczas konfigurowania i wdrażania tego rozszerzenia na potrzeby serwerów proxy interfejsów API użyj poniższych wskazówek. Instrukcje konfigurowania rozszerzenia za pomocą konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.

Właściwości wspólne rozszerzeń

Dla każdego rozszerzenia dostępne są poniższe właściwości.

Właściwości tego pakietu rozszerzeń

Określ wartości następujących właściwości konfiguracji specyficznych dla tego rozszerzenia.