DescribedConnector - AWS Transfer Family

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

DescribedConnector

描述連接器的參數,如 所識別ConnectorId

目錄

Arn

連接器的唯一 Amazon Resource Name (ARN)。

類型:字串

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

模式:arn:\S+

必要:是

AccessRole

連接器用於使用 AS2或 SFTP通訊協定傳送檔案。針對存取角色,提供要使用 AWS Identity and Access Management 的角色的 Amazon Resource Name (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

(ARN) 角色的 Amazon Resource Name AWS Identity and Access Management (IAM),允許連接器開啟 Amazon S3 事件 CloudWatch 的記錄。設定時,您可以在 CloudWatch 日誌中檢視連接器活動。

類型:字串

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

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

必要:否

ServiceManagedEgressIpAddresses

此連接器的輸出 IP 地址清單。這些 IP 地址會在您建立連接器時自動指派。

類型:字串陣列

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

必要:否

SftpConfig

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

類型:SftpConnectorConfig 物件

必要:否

Tags

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

類型:Tag 物件陣列

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

必要:否

Url

URL 合作夥伴AS2或SFTP端點的 。

類型:字串

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

必要:否

另請參閱

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