Amazon S3

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca alcune delle azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CopyObject

Questa azione ti consente di copiare un oggetto da un bucket a un altro o all'interno dello stesso bucket.

Parametri di input dell'azione CopyObject

Parametri di output dell'azione CopyObject

Questa azione restituisce lo stato 200 (OK) se la copia è riuscita.

Per capire come configurare l'azione CopyObject, consulta Esempi di azioni.

Azione DownloadObjects

Questa azione recupera un altro oggetto da un bucket.

Parametri di input dell'azione DownloadObjects

Parametri di output dell'azione DownloadObjects

Questa azione restituisce lo stato 200 (OK) se il download è riuscito.

Per capire come configurare l'azione DownloadObjects, consulta Esempi di azioni.

Azione UploadObject

Questa azione consente di caricare un oggetto in un bucket.

Parametri di input dell'azione UploadObject

Parametri di output dell'azione UploadObject

Questa azione restituisce lo stato 200 (OK) se il caricamento dell'oggetto è riuscito.

Per capire come configurare l'azione UploadObject, consulta Esempi di azioni.

Azione DeleteObject

Questa azione consente di eliminare un oggetto da un bucket.

Parametri di input dell'azione Elimina oggetto

Parametri di output dell'azione Elimina oggetto

Questa azione restituisce lo stato 200 (OK) se l'eliminazione ha esito positivo.

Per capire come configurare l'azione DeleteObject, consulta Esempi di azioni.

Azione MoveObject

Questa azione consente agli utenti di spostare un oggetto esistente di un bucket specifico in un altro bucket o nello stesso bucket.

Parametri di input dell'azione MoveObject

Parametri di output dell'azione MoveObject

Questa azione restituisce lo stato 200 (OK) se l'operazione di spostamento ha esito positivo.

Per capire come configurare l'azione MoveObject, consulta Esempi di azioni.

Azione PutBucketAcl

Questa azione consente di aggiornare l'elenco di controllo dell'accesso (ACL) di un bucket.

Parametri di input dell'azione PutBucketAcl

Parametri di output dell'azione PutBucketAcl

Questa azione restituisce lo stato 200 (OK) se l'aggiornamento dell'ACL del bucket è riuscito.

Per capire come configurare l'azione PutBucketAcl, consulta Esempi di azioni.

Azione PutObjectAcl

Questa azione consente di aggiornare l'elenco di controllo dell'accesso (ACL) di un oggetto in un bucket.

Parametri di input dell'azione PutObjectAcl

Parametri di output dell'azione PutObjectAcl

Questa azione restituisce lo stato 200 (OK) se l'aggiornamento dell'ACL dell'oggetto è riuscito.

Per capire come configurare l'azione PutObjectAcl, consulta Esempi di azioni.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: copia di un oggetto

Questo esempio copia un oggetto da un bucket a un altro.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CopyObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ObjectSource": "pic.jpg",
   "BucketDestination": "aws-s3-bucket-destination",
   "ObjectDestination": "new_pic.jpg"
   }

Se l'azione ha esito positivo, il parametro CopyObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: scaricare un oggetto

Questo esempio scarica un oggetto dal bucket specificato.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadObjects, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Bucket": "aws-s3-bucket-source",
   "HasBytes": true
   }

Se l'azione ha esito positivo, il parametro DownloadObjects della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "True",
"RemoteFile": "prefix1%2Faws-s3-bucket-source%2Finventory-test-1%2F2023-09-10T01-00Z%2Fmanifest.json",
"ContentBytes": "ewogICJzb3VyY2VCdWNrZXQiIDogImF3cy1zMy1idWNrZXQtYmNvbmUiLAogICJnOK"
},
{
"Success": "True",
"RemoteFile": "upload1.txt",
"ContentBytes": "VGhpcyBpcyBhIHRlc3RpbmcgZmlsZQ=="
}]

Esempio: caricare un oggetto

Questo esempio carica un oggetto nel bucket specificato.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UploadObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Bucket": "aws-s3-bucket-source",
   "FileName": "upload_1.txt",
   "Content": "This is a testing file",
   "AccessPolicy": "PUBLIC"
   }

Se l'azione ha esito positivo, il parametro UploadObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "success",
"bucket": "aws-s3-bucket-source",
"rss:title": "Object 'upload_1.txt' was created in the bucket: aws-s3-bucket-source",
"object": "upload_1.txt"
}]

Esempio: eliminare un oggetto

Questo esempio elimina un oggetto dal bucket specificato.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Bucket": "aws-s3-bucket-source",
   "Object": "abc.png"
   }

Se l'azione ha esito positivo, il parametro DeleteObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: sposta un oggetto

Questo esempio sposta un oggetto da un bucket a un altro.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione MoveObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ObjectSource": "abc.png",
   "BucketDestination": "aws-s3-bucket-destination",
   "ObjectDestination": "moved.png"
   }

Se l'azione ha esito positivo, il parametro MoveObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: aggiorna l'ACL di un bucket

Questo esempio aggiorna le autorizzazioni di controllo dell'accesso per un bucket.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione PutBucketAcl, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ACL": "public-read"
   }

Se l'azione ha esito positivo, il parametro PutBucketAcl della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: aggiorna l'ACL di un oggetto

Questo esempio aggiorna le autorizzazioni di controllo dell'accesso per un oggetto in un bucket.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione PutObjectAcl, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Bucket": "aws-s3-bucket-source",
   "ACL": "aws-exec-read",
   "Key": "AWS_S3_BusinessCase_V2.xlsx"
   }

Se l'azione ha esito positivo, il parametro PutObjectAcl della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca i metadati di tutti gli oggetti

Questo esempio recupera i metadati di tutti gli oggetti nell'entità Object.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Object dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Specifica sempre il valore della clausola di filtro tra virgolette singole ("'"). Ad esempio, Bucket='test-bucket'. Puoi anche specificare più condizioni di filtro utilizzando gli operatori logici. Ad esempio, Bucket='test-bucket' and OwnerId='b1ecc809ad8467088afb'.

Esempio: recupero dei metadati di un bucket

Questo esempio recupera i metadati del bucket con l'ID specificato dall'entità Bucket.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Bucket dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci demo_replication nel campo Valore predefinito.

   In questo caso, demo_replication è un ID bucket univoco nell'entità Bucket.

Esempio: crea un bucket

Questo esempio crea un bucket nell'entità Bucket.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Bucket dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Bucket": "Demo1697528098686"
   }

   Se l'integrazione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   [{
   "Bucket": "Demo1697528098686"
   }]

Esempio: elimina un bucket

Questo esempio elimina il bucket con l'ID specificato nell'entità Bucket.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Bucket dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci demo1697528098686 nel campo Valore predefinito.