Amazon S3

實體、作業和動作

所有 Integration Connectors 都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化存取應用程式的物件。抽象化會以實體、作業和動作的形式向您公開。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義與連接器對連接器不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱連線器工作中的實體作業。 不過，如果連接器不支援任何實體作業，Operations 清單就不會列出這類不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會是空白。

動作

本節列出連接器支援的部分動作。如要瞭解如何設定動作，請參閱動作範例。

CopyObject 動作

這項動作可讓您將物件從一個值區複製到另一個值區，或複製到同一個值區。

CopyObject 動作的輸入參數

CopyObject 動作的輸出參數

如果複製成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 CopyObject 動作，請參閱動作範例。

DownloadObjects 動作

這項動作會從 bucket 取得更多物件。

DownloadObjects 動作的輸入參數

DownloadObjects 動作的輸出參數

如果下載成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 DownloadObjects 動作，請參閱動作範例。

UploadObject 動作

這個動作可讓您將物件上傳至 bucket。

UploadObject 動作的輸入參數

UploadObject 動作的輸出參數

如果物件上傳成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 UploadObject 動作，請參閱動作範例。

DeleteObject 動作

這項操作可讓您從 bucket 刪除物件。

DeleteObject 動作的輸入參數

DeleteObject 動作的輸出參數

如果刪除作業成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 DeleteObject 動作，請參閱動作範例。

MoveObject 動作

這項動作可讓使用者將特定 bucket 的現有物件移至另一個 bucket 或同一個 bucket。

MoveObject 動作的輸入參數

MoveObject 動作的輸出參數

如果移動作業成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 MoveObject 動作，請參閱動作範例。

PutBucketAcl 動作

這項動作可讓您更新 bucket 的存取控制清單 (ACL)。

PutBucketAcl 動作的輸入參數

PutBucketAcl 動作的輸出參數

如果 bucket ACL 更新成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 PutBucketAcl 動作，請參閱動作範例。

PutObjectAcl 動作

這項動作可讓您更新值區中物件的存取控制清單 (ACL)。

PutObjectAcl 動作的輸入參數

PutObjectAcl 動作的輸出參數

如果物件 ACL 更新成功，這項動作會傳回狀態 200 (OK)。

如要瞭解如何設定 PutObjectAcl 動作，請參閱動作範例。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - 複製物件

這個範例會將物件從一個 bucket 複製到另一個 bucket。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「CopyObject」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，CopyObject 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"Status": "Success"
}]

範例 - 下載物件

這個範例會從指定 bucket 下載物件。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「DownloadObjects」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，DownloadObjects 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

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

範例 - 上傳物件

這個範例會將物件上傳至指定 bucket。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「UploadObject」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，UploadObject 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

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

範例 - 刪除物件

這個範例會從指定值區刪除物件。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「DeleteObject」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，DeleteObject 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"Status": "Success"
}]

範例 - 移動物件

這個範例會將物件從一個 bucket 移至另一個 bucket。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「MoveObject」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，MoveObject 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"Status": "Success"
}]

範例 - 更新值區的 ACL

這個範例會更新 bucket 的存取控管權限。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「PutBucketAcl」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，PutBucketAcl 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"Status": "Success"
}]

範例 - 更新物件的 ACL

這個範例會更新值區中物件的存取控管權限。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「PutObjectAcl」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

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

如果動作成功，PutObjectAcl 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"Status": "Success"
}]

實體作業範例

本節說明如何在這個連接器中執行部分實體作業。

範例 - 列出所有物件的中繼資料

這個範例會擷取 Object 實體中所有物件的中繼資料。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Object。
3. 選取 List 作業，然後按一下「完成」。
4. (選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。 請一律在單引號 (') 內指定篩選子句值，例如 Bucket='test-bucket'。您也可以使用邏輯運算子指定多個篩選條件。例如：Bucket='test-bucket' and OwnerId='b1ecc809ad8467088afb'。

範例 - 取得 bucket 的中繼資料

這個範例會從 Bucket 實體取得具有指定 ID 的 bucket 中繼資料。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Bucket。
3. 選取 Get 作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 demo_replication。

   其中 demo_replication 是 Bucket 實體中的專屬 bucket ID。

範例 - 建立 bucket

這個範例會在 Bucket 實體中建立 bucket。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Bucket。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Bucket": "Demo1697528098686"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   [{
   "Bucket": "Demo1697528098686"
   }]

範例 - 刪除值區

這個範例會刪除 Bucket 實體中具有指定 ID 的 bucket。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Bucket。
3. 選取 Delete 作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 demo1697528098686。