Amazon S3

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Tindakan

Bagian ini mencantumkan beberapa tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan CopyObject

Tindakan ini memungkinkan Anda menyalin objek dari satu bucket ke bucket lain atau dalam bucket yang sama.

Parameter input tindakan CopyObject

Parameter output tindakan CopyObject

Tindakan ini akan menampilkan status 200 (OK) jika penyalinan berhasil.

Untuk memahami cara mengonfigurasi tindakan CopyObject, lihat Contoh tindakan.

Tindakan DownloadObjects

Tindakan ini mengambil satu objek lagi dari bucket.

Parameter input tindakan DownloadObjects

Parameter output tindakan DownloadObjects

Tindakan ini menampilkan status 200 (OK) jika download berhasil.

Untuk memahami cara mengonfigurasi tindakan DownloadObjects, lihat Contoh tindakan.

Tindakan UploadObject

Tindakan ini memungkinkan Anda mengupload objek ke bucket.

Parameter input tindakan UploadObject

Parameter output tindakan UploadObject

Tindakan ini menampilkan status 200 (OK) jika upload objek berhasil.

Untuk memahami cara mengonfigurasi tindakan UploadObject, lihat Contoh tindakan.

Tindakan DeleteObject

Tindakan ini memungkinkan Anda menghapus objek dari bucket.

Parameter input tindakan DeleteObject

Parameter output tindakan DeleteObject

Tindakan ini menampilkan status 200 (OK) jika penghapusan berhasil.

Untuk memahami cara mengonfigurasi tindakan DeleteObject, lihat Contoh tindakan.

Tindakan MoveObject

Tindakan ini memungkinkan pengguna memindahkan objek yang ada dari bucket tertentu ke bucket lain atau di bucket yang sama.

Parameter input tindakan MoveObject

Parameter output tindakan MoveObject

Tindakan ini menampilkan status 200 (OK) jika operasi pemindahan berhasil.

Untuk memahami cara mengonfigurasi tindakan MoveObject, lihat Contoh tindakan.

Tindakan PutBucketAcl

Tindakan ini memungkinkan Anda memperbarui Daftar Kontrol Akses (ACL) bucket.

Parameter input tindakan PutBucketAcl

Parameter output tindakan PutBucketAcl

Tindakan ini menampilkan status 200 (OK) jika update ACL bucket berhasil.

Untuk memahami cara mengonfigurasi tindakan PutBucketAcl, lihat Contoh tindakan.

Tindakan PutObjectAcl

Tindakan ini memungkinkan Anda memperbarui Daftar Kontrol Akses (ACL) objek dalam bucket.

Parameter input tindakan PutObjectAcl

Parameter output tindakan PutObjectAcl

Tindakan ini menampilkan status 200 (OK) jika pembaruan ACL objek berhasil.

Untuk memahami cara mengonfigurasi tindakan PutObjectAcl, lihat Contoh tindakan.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - Menyalin objek

Contoh ini menyalin objek dari satu bucket ke bucket lain.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CopyObject, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CopyObject akan memiliki nilai yang mirip dengan berikut ini:

[{
"Status": "Success"
}]

Contoh - Mendownload objek

Contoh ini mendownload objek dari bucket yang ditentukan.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan DownloadObjects, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadObjects akan memiliki nilai yang mirip dengan berikut ini:

[{
"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=="
}]

Contoh - Mengupload objek

Contoh ini mengupload objek ke bucket yang ditentukan.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UploadObject, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UploadObject akan memiliki nilai yang mirip dengan berikut ini:

[{
"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"
}]

Contoh - Menghapus objek

Contoh ini menghapus objek dari bucket yang ditentukan.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan DeleteObject, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeleteObject akan memiliki nilai yang mirip dengan berikut ini:

[{
"Status": "Success"
}]

Contoh - Memindahkan objek

Contoh ini memindahkan objek dari satu bucket ke bucket lain.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan MoveObject, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas MoveObject akan memiliki nilai yang mirip dengan berikut ini:

[{
"Status": "Success"
}]

Contoh - Memperbarui ACL bucket

Contoh ini memperbarui izin kontrol akses untuk bucket.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan PutBucketAcl, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas PutBucketAcl akan memiliki nilai yang mirip dengan berikut ini:

[{
"Status": "Success"
}]

Contoh - Memperbarui ACL objek

Contoh ini memperbarui izin kontrol akses untuk objek dalam bucket.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan PutObjectAcl, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

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

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas PutObjectAcl akan memiliki nilai yang mirip dengan berikut ini:

[{
"Status": "Success"
}]

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan metadata semua objek

Contoh ini mengambil metadata semua objek dalam entitas Object.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Object dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Secara opsional, di bagian Input Tugas pada tugas Konektor, Anda dapat memfilter kumpulan hasil dengan menentukan klausa filter. Selalu tentukan nilai klausa filter dalam tanda kutip tunggal ('). Misalnya, Bucket='test-bucket'. Anda juga dapat menentukan beberapa kondisi filter menggunakan operator logika. Sebagai contoh, Bucket='test-bucket' and OwnerId='b1ecc809ad8467088afb'

Contoh - Mendapatkan metadata bucket

Contoh ini mendapatkan metadata bucket dengan ID yang ditentukan dari entitas Bucket.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Bucket dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan demo_replication di kolom Default Value.

   Di sini, demo_replication adalah ID bucket unik dalam entitas Bucket.

Contoh - Membuat bucket

Contoh ini membuat bucket di entitas Bucket.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Bucket dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Bucket": "Demo1697528098686"
   }

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   [{
   "Bucket": "Demo1697528098686"
   }]

Contoh - Menghapus bucket

Contoh ini menghapus bucket dengan ID yang ditentukan dalam entitas Bucket.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Bucket dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan demo1697528098686 di kolom Default Value.