기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
",
"SftpConfig": {
"TrustedHostKeys": [ "string
" ],
"UserSecretId": "string
"
},
"Url": "string
"
}
요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- AccessRole
-
커넥터는 AS2 또는 SFTP 프로토콜을 사용하여 파일을 전송하는 데 사용됩니다. 액세스 역할에 사용할 AWS Identity and Access Management 역할의 Amazon 리소스 이름(ARN)을 입력합니다.
AS2 커넥터의 경우
를 사용하면 를 호출
StartFileTransfer
하고 요청 파라미터 에서 파일 경로를 지정하여 파일을 보낼 AS2수 있습니다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. 최대 길이는 2,048.
패턴:
arn:.*role/\S+
Required: No
- As2Config
-
AS2 커넥터 객체의 파라미터를 포함하는 구조입니다.
유형: As2ConnectorConfig 객체
필수 여부: 아니요
- ConnectorId
-
커넥터의 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
Pattern:
c-([0-9a-f]{17})
필수 여부: 예
- LoggingRole
-
커넥터가 Amazon S3 이벤트에 대한 CloudWatch 로깅을 켤 수 있도록 허용하는 (ARN) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (IAM)입니다. Amazon S3 설정하면 CloudWatch 로그에서 커넥터 활동을 볼 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 20. 최대 길이는 2,048.
패턴:
arn:.*role/\S+
Required: No
- SftpConfig
-
SFTP 커넥터 객체의 파라미터를 포함하는 구조입니다.
유형: SftpConnectorConfig 객체
필수 여부: 아니요
- Url
-
파트너 AS2 또는 SFTP 엔드포인트URL의 .
유형: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 255입니다.
필수 여부: 아니요
응답 구문
{
"ConnectorId": "string"
}
Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- ConnectorId
-
업데이트 중인 커넥터 객체의 식별자를 반환합니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
c-([0-9a-f]{17})
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- 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
참고
언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.