本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
UpdateConnector
更新現有連接器的某些參數。ConnectorId
為您要更新的連接器提供,以及要更新之參數的新值。
請求語法
{
"AccessRole": "string
",
"As2Config": {
"BasicAuthSecretId": "string
",
"Compression": "string
",
"EncryptionAlgorithm": "string
",
"LocalProfileId": "string
",
"MdnResponse": "string
",
"MdnSigningAlgorithm": "string
",
"MessageSubject": "string
",
"PartnerProfileId": "string
",
"SigningAlgorithm": "string
"
},
"ConnectorId": "string
",
"LoggingRole": "string
",
"SecurityPolicyName": "string
",
"SftpConfig": {
"TrustedHostKeys": [ "string
" ],
"UserSecretId": "string
"
},
"Url": "string
"
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- 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-]+
必要:否
- SftpConfig
-
包含 SFTP 連接器物件參數的結構。
類型:SftpConnectorConfig 物件
必要:否
- Url
-
合作夥伴的 AS2 或 SFTP 端點的網址。
類型:字串
長度限制:長度下限為 0。長度上限為 255。
必要:否
回應語法
{
"ConnectorId": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- ConnectorId
-
傳回您正在更新之連接器物件的識別碼。
類型:字串
長度約束:固定長度為 19。
模式:
c-([0-9a-f]{17})
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InternalServiceError
-
當在 AWS Transfer Family 服務中發生錯誤時,拋出此異常。
HTTP 狀態碼:500
- InvalidRequestException
-
當客戶端提交格式錯誤的請求時,拋出此異常。
HTTP 狀態碼:400
- ResourceExistsException
-
請求的資源不存在,或者存在於為命令指定的區域以外的區域中。
HTTP 狀態碼:400
- ResourceNotFoundException
-
當 AWS Transfer Family 服務找不到資源時,會擲回此例外狀況。
HTTP 狀態碼:400
- ServiceUnavailableException
-
申請失敗,因為 AWS Transfer Family 服務不可用。
HTTP 狀態碼:500
- ThrottlingException
-
由於請求調節,因此請求遭到拒絕。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: