DescribedConnector - AWS Transfer Family

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DescribedConnector

描述連接器的參數 (由識別) ConnectorId

目錄

Arn

連接器的唯一 Amazon 資源名稱 (ARN)。

類型:字串

長度限制︰長度下限為 20。長度上限為 1600。

模式:arn:\S+

必要:是

AccessRole

連接器可用來使用 AS2 或 SFTP 通訊協定來傳送檔案。對於存取角色,請提供要使用之 AWS Identity and Access Management 角色的 Amazon 資源名稱 (ARN)。

適用於 AS2 連接器

使用 AS2,即可透過呼叫 StartFileTransfer,並在請求參數 SendFilePaths 中指定檔案路徑的方式傳送檔案。使用該檔案的父目錄 (例如,--send-file-paths /bucket/dir/file.txt 的父目錄為 /bucket/dir/) 暫時儲存已處理的 AS2 訊息檔案、於接收到合作夥伴的 MDN 時進行儲存,並寫入包含傳輸相關中繼資料的最終 JSON 檔案。因此,AccessRole 需要針對 StartFileTransfer 請求中使用之檔案位置的父目錄提供讀寫權限。此外,還需要針對欲透過 StartFileTransfer 傳送之檔案的父目錄提供讀寫權限。

如果您使用 AS2 連接器的基本驗證,則存取角色需要密碼的secretsmanager:GetSecretValue權限。如果密碼是使用客戶管理的金鑰而非 Secrets Manager 中的 AWS 受管理金鑰加密,則該角色也需要該金鑰的kms:Decrypt權限。

適用於 SFTP 連接器

StartFileTransfer請確定存取角色提供對要求中所使用之檔案位置之父目錄的讀取和寫入存取權。此外,請確定角色提供的secretsmanager:GetSecretValue權限 AWS Secrets Manager。

類型:字串

長度限制︰長度下限為 20。長度上限為 2048。

模式:arn:.*role/\S+

必要:否

As2Config

包含 AS2 連接器物件參數的結構。

類型:As2ConnectorConfig 物件

必要:否

ConnectorId

連接器的唯一識別碼。

類型:字串

長度約束:固定長度為 19。

模式:c-([0-9a-f]{17})

必要:否

LoggingRole

(IAM) 角色的亞馬遜資源名稱 AWS Identity and Access Management (ARN),可讓連接器開啟 Amazon S3 事件的 CloudWatch 記錄功能。設定後,您可以在 CloudWatch 記錄檔中檢視連接器活動。

類型:字串

長度限制︰長度下限為 20。長度上限為 2048。

模式:arn:.*role/\S+

必要:否

SecurityPolicyName

指定之連接器之安全性原則的文字名稱。

類型:字串

長度限制:長度下限為 0。長度上限為 100。

模式:TransferSFTPConnectorSecurityPolicy-[A-Za-z0-9-]+

必要:否

ServiceManagedEgressIpAddresses

此連接器的出口 IP 位址清單。當您建立連接器時,會自動指派這些 IP 位址。

類型:字串陣列

模式:\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}

必要:否

SftpConfig

包含 SFTP 連接器物件參數的結構。

類型:SftpConnectorConfig 物件

必要:否

Tags

金鑰/值對,可用來分組和搜尋連接器。

類型:Tag 物件陣列

陣列成員:項目數下限為 1。項目數上限為 50。

必要:否

Url

合作夥伴的 AS2 或 SFTP 端點的網址。

類型:字串

長度限制:長度下限為 0。長度上限為 255。

必要:否

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: