연결 유형 API

• DescribeConnectionType 작업(Python: describe_connection_type)

• ListConnectionTypes 작업(Python: list_connection_types)

• ConnectionTypeBrief 구조

요청

• ConnectionType – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  설명할 연결 유형의 이름입니다.

응답

• ConnectionType – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  연결 유형의 이름입니다.

• Description – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.

• Capabilities – 기능 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.

• ConnectionProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  컴퓨팅 환경 전체에서 공통적인 연결 속성입니다.

• ConnectionOptions – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  ConnectionInput.ConnectionProperties에서 연결을 생성할 때 설정할 수 있는 속성을 반환합니다. ConnectionOptions는 데이터프레임에 전달되는 연결 옵션 맵의 Spark ETL 스크립트에서 설정할 수 있는 파라미터를 정의합니다.

• AuthenticationConfiguration – AuthConfiguration 객체입니다.

  연결에 사용되는 인증의 유형입니다.

• ComputeEnvironmentConfigurations – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 ComputeEnvironmentConfiguration 객체입니다.

  연결에서 지원하는 컴퓨팅 환경입니다.

• PhysicalConnectionRequirements – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  VPC, 서브넷, 보안 그룹 사양 등, 연결에 대한 물리적 요구 사항입니다.

• AthenaConnectionProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.

• PythonConnectionProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.

• SparkConnectionProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.

오류

• ValidationException

• InvalidInputException

• InternalServiceException

요청

• MaxResults – 1~1,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

• NextToken – Custom string pattern #11과(와) 일치하는 1~2,048바이트 길이의 UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답

• ConnectionTypes – ConnectionTypeBrief 객체의 배열입니다.

  지원되는 연결 유형에 대한 간략한 정보가 포함된 ConnectionTypeBrief 객체의 목록입니다.

• NextToken – Custom string pattern #11과(와) 일치하는 1~2,048바이트 길이의 UTF-8 문자열입니다.

  현재 list 세그먼트가 마지막이 아닌 경우의 연속 토큰입니다.

오류

• InternalServiceException

필드

• ConnectionType – UTF-8 문자열(유효한 값: JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | SLACK | STRIPE | INTERCOM | SNAPCHATADS).

  연결 유형의 이름입니다.

• Description – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.

• Capabilities – 기능 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.

• Validation 구조

• AuthConfiguration 구조

• Capabilities 구조

• Property 구조

• AllowedValue 구조

• ComputeEnvironmentConfiguration 구조

필드

• ValidationType – 필수: UTF-8 문자열입니다(유효한 값: REGEX | RANGE).

  수행할 검증 유형(예: REGEX)입니다.

• Patterns – UTF-8 문자열의 배열입니다.

  검증에 적용되는 패턴의 목록입니다.

• Description – 필수: 1~1,024바이트 길이의 UTF-8 문자열입니다.

  검증에 대한 설명입니다.

• MaxLength - 숫자(정수)입니다.

  문자열 연결 속성의 최대 길이입니다.

• Maximum - 숫자(정수)입니다.

  검증의 RANGE 유형을 지정할 때의 최댓값입니다.

• Minimum - 숫자(정수)입니다.

  검증의 RANGE 유형을 지정할 때의 최솟값입니다.

필드

• AuthenticationType – 필수: 속성 객체입니다.

  연결의 인증 유형입니다.

• SecretArn – 속성 객체입니다.

  Secrets Manager의 Amazon 리소스 이름(ARN)입니다.

• OAuth2Properties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 Property 객체입니다.

• BasicAuthenticationProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 Property 객체입니다.

• CustomAuthenticationProperties – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  사용자 지정 인증 속성의 키-값 페어 맵입니다. 각 값은 Property 객체입니다.

필드

• SupportedAuthenticationTypes – 필수: UTF-8 문자열의 배열입니다.

  지원되는 인증 유형의 목록입니다.

• SupportedDataOperations – 필수: UTF-8 문자열의 배열입니다.

  지원되는 데이터 작업의 목록입니다.

• SupportedComputeEnvironments – 필수: UTF-8 문자열의 배열입니다.

  지원되는 컴퓨팅 환경의 목록입니다.

필드

• Name – 필수: 1~128바이트 길이의 UTF-8 문자열입니다.

  속성의 이름입니다.

• Description – 필수: UTF-8 문자열입니다(1,024바이트 이하).

  속성에 대한 설명입니다.

• DataType – 필수: UTF-8 문자열입니다(유효한 값: STRING | INTEGER | BOOLEAN | STRING_LIST).

  속성의 데이터 유형입니다.

• Required – 필수(Required): 부울.

  속성이 필요한지 여부를 나타냅니다.

• DefaultValue – UTF-8 문자열입니다.

  속성의 기본값입니다.

• PropertyTypes – 필수: UTF-8 문자열의 배열입니다.

  속성의 유형을 설명합니다.

• AllowedValues – AllowedValue 객체의 배열입니다.

  속성에 허용되는 값을 나타내는 AllowedValue 객체의 목록입니다.

• DataOperationScopes – UTF-8 문자열의 배열입니다.

  속성에 적용할 수 있는 데이터 작업을 나타냅니다.

필드

• Description – UTF-8 문자열(1,024바이트 이하).

  허용되는 값에 대한 설명입니다.

• Value – 필수: 1~128바이트 길이의 UTF-8 문자열입니다.

  속성에 허용되는 값입니다.

필드

• Name – 필수: 1~128바이트 길이의 UTF-8 문자열입니다.

  컴퓨팅 환경 구성의 이름입니다.

• Description – 필수: UTF-8 문자열입니다(1,024바이트 이하).

  컴퓨팅 환경에 대한 설명입니다.

• ComputeEnvironment – 필수: UTF-8 문자열입니다(유효한 값: SPARK | ATHENA | PYTHON).

  컴퓨팅 환경의 유형입니다.

• SupportedAuthenticationTypes – 필수: UTF-8 문자열의 배열입니다.

  컴퓨팅 환경에 지원되는 인증 유형입니다.

• ConnectionOptions – 필수(Required): 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 속성 객체입니다.

  컴퓨팅 환경의 연결 옵션으로 사용되는 파라미터입니다.

• ConnectionPropertyNameOverrides – 필수(Required): 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1~128바이트인 UTF-8 문자열입니다.

  연결 속성 이름은 컴퓨팅 환경에 대해 재정의됩니다.

• ConnectionOptionNameOverrides – 필수(Required): 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1~128바이트인 UTF-8 문자열입니다.

  연결 옵션 이름은 컴퓨팅 환경에 대해 재정의됩니다.

• ConnectionPropertiesRequiredOverrides – 필수: UTF-8 문자열의 배열입니다.

  컴퓨팅 환경에 대한 재정의로서 요구되는 연결 속성입니다.

• PhysicalConnectionPropertiesRequired – 부울입니다.

  PhysicalConnectionProperties가 컴퓨팅 환경에 필요한지 여부를 나타냅니다.