커넥션 API

• 연결 구조

• ConnectionInput 구조

• PhysicalConnectionRequirements 구조

• GetConnectionsFilter 구조체

필드

• Name— UTF 다음과 일치하는 -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  연결 정의 이름입니다.

• Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  연결에 대한 설명입니다.

• ConnectionType— UTF -8 문자열 (유효한 값: JDBC | | | | | SFTP | | MONGODB | KAFKA | | NETWORK | MARKETPLACE CUSTOM |SALESFORCE). VIEW_VALIDATION_REDSHIFT VIEW_VALIDATION_ATHENA

  연결 유형입니다. 현재 SFTP는 지원되지 않습니다.

• MatchCriteria— UTF -8개의 문자열로 구성된 배열, 10개 이하 문자열.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.

• ConnectionProperties – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 UTF -8 문자열입니다 (유효한 값: HOST | | | | | PORT | | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | JDBC_ENGINE | | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | CUSTOM_JDBC_CERT | | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | | KAFKA_BOOTSTRAP_SERVERS | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | | SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | | CONNECTOR_CLASS_NAME | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | | KAFKA_SASL_PLAIN_PASSWORD | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD KAFKA_SASL_SCRAM_USERNAMEKAFKA_SASL_SCRAM_PASSWORD| KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB | KAFKA_SASL_GSSAPI_KRB5_CONF | KAFKA_SASL_GSSAPI_SERVICE KAFKA_SASL_GSSAPI_PRINCIPAL | ROLE_ARN | REGION | WORKGROUP_NAME CLUSTER_IDENTIFIER |DATABASE).

  각 값은 1,024 바이트 이하 길이의 값 문자열입니다.

  이러한 키-값 쌍은 연결용 파라미터를 정의합니다.

  • HOST- 호스트URI: 정규화된 도메인 이름 (FQDN) 또는 데이터베이스 호스트의 IPv4 주소.

  • PORT - 데이터베이스 호스트가 데이터베이스 연결을 수신 중인 포트의 포트 번호(1,024~65,535)입니다.

  • USER_NAME- 데이터베이스에 로그인할 이름. USER_NAME의 값 문자열은 "USERNAME"입니다.

  • PASSWORD- 사용자 이름에 해당하는 암호(사용할 경우).

  • ENCRYPTED_PASSWORD - 데이터 카탈로그 암호화 설정에서 ConnectionPasswordEncryption을 설정하여 연결 암호 보호를 활성화하면 이 필드가 암호화된 암호를 저장합니다.

  • JDBC_DRIVER_JAR_URI- 사용할 드라이버가 포함된 JDBC 파일의 Amazon Simple Storage 서비스 (Amazon S3) 경로입니다. JAR

  • JDBC_DRIVER_CLASS_NAME- 사용할 JDBC 드라이버의 클래스 이름.

  • JDBC_ENGINE- 사용할 JDBC 엔진 이름.

  • JDBC_ENGINE_VERSION- 사용할 JDBC 엔진 버전.

  • CONFIG_FILES - (추후 사용 예약.)

  • INSTANCE_ID- 사용할 인스턴스 ID.

  • JDBC_CONNECTION_URL- JDBC 데이터 소스에 연결하기 URL 위한 것입니다.

  • JDBC_ENFORCE_SSL- 호스트 이름이 일치하는 Secure Sockets Layer (SSL) 를 클라이언트 JDBC 연결에 적용할지 여부를 지정하는 부울 문자열 (true, false). 기본값은 false입니다.

  • CUSTOM_JDBC_CERT- 고객의 루트 인증서를 지정하는 Amazon S3 위치. AWS Glue 고객 데이터베이스에 연결할 때 이 루트 인증서를 사용하여 고객 인증서를 검증합니다. AWS Glue X.509 인증서만 처리합니다. 제공된 인증서는 DER -인코딩되고 Base64 인코딩 형식으로 제공되어야 합니다. PEM

  • SKIP_CUSTOM_JDBC_CERT_VALIDATION- 기본값은 다음과 같습니다. false AWS Glue 고객 인증서의 서명 알고리즘과 주제 공개 키 알고리즘을 검증합니다. 서명 알고리즘에 허용되는 유일한 알고리즘은 SHA256withRSA SHA384withRSA 또는 SHA512withRSA 입니다. 주제 퍼블릭 키 알고리즘의 경우, 키 길이는 2048 이상이어야 합니다. 이 속성 값을 true로 설정하여 AWS Glue의 고객 인증서 검증을 건너뛸 수 있습니다.

  • CUSTOM_JDBC_CERT_STRING- man-in-the-middle 공격을 방지하기 위해 도메인 일치 또는 고유 이름 일치에 사용되는 사용자 지정 JDBC 인증서 문자열입니다. 오라클 데이터베이스에서는 이 값을 SSL_SERVER_CERT_DN 로 사용하고 Microsoft SQL Server에서는 로 사용합니다hostNameInCertificate.

  • CONNECTION_URL- 일반 (비JDBC) 데이터 URL 원본에 연결하는 데 사용합니다.

  • SECRET_ID - 자격 증명의 보안 관리자에 사용되는 보안 암호 ID입니다.

  • CONNECTOR_URL- MARKETPLACE OR URL CUSTOM 연결용 커넥터.

  • CONNECTOR_TYPE- A MARKETPLACE 또는 CUSTOM 연결용 커넥터 유형.

  • CONNECTOR_CLASS_NAME- MARKETPLACE 또는 CUSTOM 연결의 커넥터 클래스 이름.

  • KAFKA_BOOTSTRAP_SERVERS - Kafka 클라이언트에서 연결하고 자체 부트스트랩하는 Kafka 클러스터에 있는 Apache Kafka 브로커의 주소입니다 호스트 및 포트 쌍의 쉼표로 구분된 목록입니다.

  • KAFKA_SSL_ENABLED- Apache Kafka SSL 연결을 활성화할지 비활성화할지 여부. 기본값은 "true"입니다.

  • KAFKA_CUSTOM_CERT- 사설 CA 인증서 파일 (.pem 형식) URL 용 Amazon S3. 기본값은 빈 문자열입니다.

  • KAFKA_SKIP_CUSTOM_CERT_VALIDATION- CA 인증서 파일의 검증을 생략할지 여부. AWS Glue 세 가지 SHA256withRSA 알고리즘 (, 및) 을 검증합니다. SHA384withRSA SHA512withRSA 기본값은 "false"입니다.

  • KAFKA_CLIENT_KEYSTORE - Kafka 클라이언트 측 인증을 위한 클라이언트 키 스토어 파일의 Amazon S3 위치입니다(선택 사항).

  • KAFKA_CLIENT_KEYSTORE_PASSWORD - 제공된 키 스토어에 액세스하기 위한 암호입니다(선택 사항).

  • KAFKA_CLIENT_KEY_PASSWORD - 키 스토어는 여러 키로 구성 될 수 있으므로 Kafka 서버 측 키와 함께 사용할 클라이언트 키에 액세스하기 위한 암호입니다(선택 사항).

  • ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD- Kafka 클라이언트 키스토어 비밀번호의 암호화된 버전 (사용자가 비밀번호 AWS Glue 암호화 설정을 선택한 경우).

  • ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD- 암호화된 버전의 Kafka 클라이언트 키 암호 (사용자가 암호 암호화 설정을 선택한 경우). AWS Glue

  • KAFKA_SASL_MECHANISM - "SCRAM-SHA-512", "GSSAPI", "AWS_MSK_IAM" 또는 "PLAIN". 지원되는 메커니즘은 다음과 같습니다. SASL

  • KAFKA_SASL_PLAIN_USERNAME- "PLAIN메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.

  • KAFKA_SASL_PLAIN_PASSWORD- "메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다. PLAIN

  • ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD- Kafka 암호의 암호화된 버전 (사용자가 SASL PLAIN 암호 AWS Glue 암호화 설정을 선택한 경우).

  • KAFKA_SASL_SCRAM_USERNAME- "- -512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름. SCRAM SHA

  • KAFKA_SASL_SCRAM_PASSWORD- "- -512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호. SCRAM SHA

  • ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD- Kafka 암호의 암호화된 버전 (사용자가 SASL SCRAM 암호 암호화 설정을 선택한 경우). AWS Glue

  • KAFKA_SASL_SCRAM_SECRETS_ARN- AWS Secrets Manager에 있는 비밀의 Amazon 리소스 이름.

  • KAFKA_SASL_GSSAPI_KEYTAB - Kerberos keytab 파일의 S3 위치입니다. keytab은 하나 이상의 보안 주체에 대한 장기 키를 저장합니다. 자세한 내용은 MITKerberos 설명서: Keytab을 참조하십시오.

  • KAFKA_SASL_GSSAPI_KRB5_CONF - Kerberos krb5.conf 파일의 S3 위치입니다. krb5.conf는 서버 위치와 같은 Kerberos 구성 정보를 저장합니다. KDC 자세한 내용은 Kerberos 설명서: krb5.conf를 참조하십시오. MIT

  • KAFKA_SASL_GSSAPI_SERVICE - Kafka 구성에서 sasl.kerberos.service.name으로 설정된 Kerberos 서비스 이름입니다.

  • KAFKA_SASL_GSSAPI_PRINCIPAL- 에서 사용하는 케르베로스 주체의 이름. AWS Glue자세한 내용은 Kafka Documentation: Configuring Kafka Brokers(Kafka 설명서: Kafka 브로커 구성)를 참조하세요.

  • ROLE_ARN- 쿼리 실행에 사용할 역할입니다.

  • REGION- 쿼리가 실행될 AWS 지역.

  • WORKGROUP_NAME- 쿼리가 실행될 Amazon Redshift 서버리스 워크그룹 또는 Amazon Athena 워크그룹의 이름.

  • CLUSTER_IDENTIFIER- 쿼리가 실행될 Amazon Redshift 클러스터의 클러스터 식별자입니다.

  • DATABASE- 연결 중인 아마존 Redshift 데이터베이스.

• PhysicalConnectionRequirements – PhysicalConnectionRequirements 객체입니다.

  이 연결을 성공적으로 수행하는 데 필요한 물리적 연결 요구 사항 (예: 가상 사설 클라우드 (VPC) 및 SecurityGroup

• CreationTime – 타임스탬프입니다.

  이 연결 정의가 생성된 시간의 타임스탬프입니다.

• LastUpdatedTime – 타임스탬프입니다.

  이 연결 정의가 업데이트된 마지막 시간의 타임스탬프입니다.

• LastUpdatedBy— UTF 일치하는 -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  이 연결 정의를 마지막으로 업데이트한 사용자, 그룹 혹은 역할입니다.

• Status— UTF -8 문자열 (유효한 값: READY | |). IN_PROGRESS FAILED

  연결 상태입니다. READY, IN_PROGRESS 또는 FAILED 중 하나일 수 있습니다.

• StatusReason— UTF -8 문자열, 1바이트 이상 또는 16384바이트 이상

  연결 상태의 이유입니다.

• LastConnectionValidationTime – 타임스탬프입니다.

  이 연결이 마지막으로 검증된 시간의 타임스탬프입니다.

• AuthenticationConfiguration – AuthenticationConfiguration 객체입니다.

  연결의 인증 속성입니다.

필드

• Name— 필수: UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

  연결의 이름입니다.

• Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  연결에 대한 설명입니다.

• ConnectionType— 필수: UTF -8 문자열 (유효한 값: JDBC | | | | | | SFTP | | MONGODB | KAFKA | | NETWORK | MARKETPLACE CUSTOM |SALESFORCE). VIEW_VALIDATION_REDSHIFT VIEW_VALIDATION_ATHENA

  연결 유형입니다. 현재 이러한 유형이 지원됩니다.

  • JDBC- Java 데이터베이스 연결 () 을 통해 데이터베이스 연결을 지정합니다. JDBC

    JDBC연결은 다음을 사용합니다. ConnectionParameters

    • 필수 항목: JDBC_CONNECTION_URL 또는 (HOST, PORT, JDBC_ENGINE) 모두.

    • 필수 항목: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

    • 선택 사항: JDBC_ENFORCE_SSL, CUSTOM_JDBC_CERT, CUSTOM_JDBC_CERT_STRING, SKIP_CUSTOM_JDBC_CERT_VALIDATION. 이러한 매개변수는 에서 구성하는 SSL 데 사용됩니다JDBC.

  • KAFKA - Apache Kafka 스트리밍 플랫폼에 대한 연결을 지정합니다.

    KAFKA연결은 다음을 사용합니다 ConnectionParameters.

    • 필수 항목: KAFKA_BOOTSTRAP_SERVERS.

    • 선택 사항: KAFKA_SSL_ENABLED, KAFKA_CUSTOM_CERT, KAFKA_SKIP_CUSTOM_CERT_VALIDATION. 이러한 매개변수는 에서 구성하는 SSL 데 사용됩니다KAFKA.

    • 선택 사항: KAFKA_CLIENT_KEYSTORE, KAFKA_CLIENT_KEYSTORE_PASSWORD, KAFKA_CLIENT_KEY_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD. 이러한 매개변수는 in을 사용하여 TLS 클라이언트 구성을 구성하는 데 사용됩니다KAFKA. SSL

    • 선택 사항: KAFKA_SASL_MECHANISM SCRAM-SHA-512, GSSAPI 또는 AWS_MSK_IAM으로 지정할 수 있습니다.

    • 선택 사항: KAFKA_SASL_SCRAM_USERNAME, KAFKA_SASL_SCRAM_PASSWORD, ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD. 이러한 매개 변수는SASL/SCRAM- SHA -512 인증을 구성하는 데 사용됩니다. KAFKA

    • 선택 사항: KAFKA_SASL_GSSAPI_KEYTAB, KAFKA_SASL_GSSAPI_KRB5_CONF, KAFKA_SASL_GSSAPI_SERVICE, KAFKA_SASL_GSSAPI_PRINCIPAL. 이러한 매개변수는SASL/GSSAPI인증을 구성하는 데 사용됩니다. KAFKA

  • MONGODB - MongoDB 문서 데이터베이스에 대한 연결을 지정합니다.

    MONGODB연결은 다음을 사용합니다 ConnectionParameters.

    • 필수 항목: CONNECTION_URL.

    • 필수 항목: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

  • SALESFORCE- 인증을 사용하여 Salesforce에 연결하도록 지정합니다. OAuth

    • AuthenticationConfiguration 멤버를 구성해야 합니다.

  • VIEW_VALIDATION_REDSHIFT- Amazon Redshift에서 뷰를 검증하는 데 사용되는 연결을 지정합니다.

  • VIEW_VALIDATION_ATHENA- Amazon Athena에서 뷰를 검증하는 데 사용되는 연결을 지정합니다.

  • NETWORK- Amazon Virtual Private Cloud 환경 (Amazon) 내의 데이터 소스에 대한 네트워크 연결을 지정합니다. VPC

    NETWORK연결은 필요하지 않습니다. ConnectionParameters 대신 a를 PhysicalConnectionRequirements 제공하세요.

  • MARKETPLACE- 구입한 커넥터에 포함된 구성 설정을 사용하여 에서 기본적으로 AWS Glue지원되지 않는 데이터 저장소에서 읽고 쓸 수 있습니다. AWS Marketplace

    MARKETPLACE연결에는 다음이 사용됩니다. ConnectionParameters

    • 필수 항목: CONNECTOR_TYPE, CONNECTOR_URL, CONNECTOR_CLASS_NAME, CONNECTION_URL.

    • JDBC CONNECTOR_TYPE 연결에 필요: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

  • CUSTOM - AWS Glue에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 쓰기 위해 사용자 정의 커넥터에 포함된 구성 설정을 사용합니다.

  SFTP는 지원되지 않습니다.

  옵션을 ConnectionProperties 사용하여 기능을 구성하는 방법에 대한 자세한 내용은 AWS Glue 연결 속성을 참조하십시오. AWS Glue

  AWS Glue Studio에서 옵션을 ConnectionProperties 사용하여 기능을 구성하는 방법에 대한 자세한 내용은 커넥터 및 연결 사용을 참조하십시오.

• MatchCriteria— 10개 이하의 UTF -8개 문자열 배열.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.

• ConnectionProperties – 필수(Required): 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 UTF -8 문자열입니다 (유효한 값: HOST | | | | | PORT | | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | JDBC_ENGINE | | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | CUSTOM_JDBC_CERT | | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | | KAFKA_BOOTSTRAP_SERVERS | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | | SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | | CONNECTOR_CLASS_NAME | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | | KAFKA_SASL_PLAIN_PASSWORD | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD KAFKA_SASL_SCRAM_USERNAMEKAFKA_SASL_SCRAM_PASSWORD| KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB | KAFKA_SASL_GSSAPI_KRB5_CONF | KAFKA_SASL_GSSAPI_SERVICE KAFKA_SASL_GSSAPI_PRINCIPAL | ROLE_ARN | REGION | WORKGROUP_NAME CLUSTER_IDENTIFIER |DATABASE).

  각 값은 1,024 바이트 이하 길이의 값 문자열입니다.

  이러한 키-값 쌍은 연결용 파라미터를 정의합니다.

• PhysicalConnectionRequirements – PhysicalConnectionRequirements 객체입니다.

  이 연결을 성공적으로 만드는 데 필요한 물리적 연결 요구 사항 (예: 가상 사설 클라우드 (VPC) 및 SecurityGroup

• AuthenticationConfiguration – AuthenticationConfigurationInput 객체입니다.

  연결의 인증 속성입니다. Salesforce 연결에 사용됩니다.

• ValidateCredentials – 부울입니다.

  연결 생성 중에 자격 증명을 검증하기 위한 플래그입니다. Salesforce 연결에 사용됩니다. 기본값은 true입니다.

필드

• SubnetId— 와 일치하는 UTF -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  연결에서 사용하는 서브넷 ID입니다.

• SecurityGroupIdList— UTF -8개의 문자열로 구성된 배열, 50개 이하

  연결에서 사용하는 보안 그룹 ID 목록입니다.

• AvailabilityZone— UTF 다음과 일치하는 -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  연결의 가용 영역입니다.

필드

• MatchCriteria— 10개 이하의 UTF -8개 문자열로 구성된 배열.

  연결 정의가 반환되도록 연결 정의에 기록된 기준과 반드시 일치해야 하는 기준 문자열입니다.

• ConnectionType— UTF -8 문자열 (유효한 값: JDBC | | | | SFTP | | MONGODB | KAFKA | NETWORK | | MARKETPLACE | CUSTOM | SALESFORCE VIEW_VALIDATION_REDSHIFT |VIEW_VALIDATION_ATHENA).

  반환할 연결 유형입니다. 현재 SFTP는 지원되지 않습니다.

• CreateConnection 액션 (Python: 커넥션 생성하기)

• DeleteConnection 액션 (Python: 연결 삭제_)

• GetConnection 액션 (파이썬: 겟_커넥션)

• GetConnections 액션 (파이썬: get_connections)

• UpdateConnection 액션 (Python: 업데이트_연결)

• BatchDeleteConnection 액션 (Python: 배치_삭제_연결)

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결을 생성할 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• ConnectionInput – 필수(Required): ConnectionInput 객체입니다.

  생성할 연결을 정의하는 ConnectionInput 객체입니다.

• Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 1바이트 이상 또는 128바이트 이상인 UTF -8 문자열입니다.

  각 값은 길이가 UTF 256바이트를 넘지 않는 -8 문자열입니다.

  연결에 할당하는 태그입니다.

응답

• CreateConnectionStatus— UTF -8 문자열 (유효한 값: READY | |). IN_PROGRESS FAILED

  연결 생성 요청의 상태입니다. 특정 인증 유형 (예: 토큰 교환으로 OAuth 연결을 생성하는 경우) 의 경우 요청에 시간이 걸릴 수 있습니다. VPC

Errors

• AlreadyExistsException

• InvalidInputException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• GlueEncryptionException

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• ConnectionName— 필수: 다음과 일치하는 UTF -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  삭제할 연결의 이름입니다.

응답

• 무응답 파라미터.

Errors

• EntityNotFoundException

• OperationTimeoutException

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• Name— 필수: 다음과 일치하는 UTF -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  검색할 연결 정의 이름입니다.

• HidePassword – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하고 암호는 표시하지 않습니다. 발신자가 AWS KMS 키를 사용하여 암호를 해독할 권한은 없지만 나머지 연결 속성에 액세스할 수 있는 권한은 있는 경우 이 매개 변수를 설정합니다.

응답

• Connection – 연결 객체입니다.

  요청한 연결 정의입니다.

Errors

• EntityNotFoundException

• OperationTimeoutException

• InvalidInputException

• GlueEncryptionException

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• Filter – GetConnectionsFilter 객체입니다.

  반환되는 연결을 관리하는 필터입니다.

• HidePassword – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하고 비밀번호는 표시하지 않습니다. 발신자가 AWS KMS 키를 사용하여 암호를 해독할 권한은 없지만 나머지 연결 속성에 액세스할 수 있는 권한은 있는 경우 이 매개 변수를 설정합니다.

• NextToken— -8 문자열UTF.

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

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

  한 번의 응답으로 반환될 최대 결과 수입니다.

응답

• ConnectionList – 연결 객체의 배열입니다.

  요청한 연결 정의의 목록입니다.

• NextToken— UTF -8 문자열.

  반환된 연결 목록이 필터링된 연결의 마지막을 포함하지 않는 경우의 연속 토큰입니다.

Errors

• EntityNotFoundException

• OperationTimeoutException

• InvalidInputException

• GlueEncryptionException

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• Name— 필수: 다음과 일치하는 UTF -8 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

  업데이트할 연결 정의 이름입니다.

• ConnectionInput – 필수(Required): ConnectionInput 객체입니다.

  질의에 따른 연결을 재정의하는 ConnectionInput 객체입니다.

응답

• 무응답 파라미터.

Errors

• InvalidInputException

• EntityNotFoundException

• OperationTimeoutException

• InvalidInputException

• GlueEncryptionException

요청

• CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

  연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

• ConnectionNameList— 필수: UTF -8개 문자열 배열, 25개 이하

  삭제할 연결 이름의 목록입니다.

응답

• Succeeded— UTF -8개의 문자열로 구성된 배열.

  성공적으로 삭제된 연결 정의 이름의 목록입니다.

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

  각 키는 와 일치하는 UTF -8 문자열로, 1바이트 이상 또는 255바이트 이상이어야 합니다. Single-line string pattern

  각 값은 ErrorDetail 객체입니다.

  오류 세부 정보에서 성공적으로 삭제된 연결 이름의 맵입니다.

Errors

• InternalServiceException

• OperationTimeoutException

• AuthenticationConfiguration 구조

• AuthenticationConfigurationInput 구조

• OAuth2Properties구조

• OAuth2PropertiesInput구조체

• OAuth2ClientApplication구조

• AuthorizationCodeProperties 구조

필드

• AuthenticationType— UTF -8 문자열 (유효한 값: BASIC | OAUTH2 |CUSTOM).

  인증 구성을 포함하는 구조입니다.

• SecretArn— UTF -8 문자열, 다음과 일치합니다. Custom string pattern #11

  자격 증명을 ARN 저장하는 비밀 관리자.

• OAuth2Properties – OAuth2Properties 객체입니다.

  OAuth2인증을 위한 속성.

필드

• AuthenticationType— UTF -8 문자열 (유효한 값: BASIC | OAUTH2 |CUSTOM).

  CreateConnection요청의 인증 구성을 포함하는 구조입니다.

• SecretArn— UTF 와 일치하는 -8 문자열. Custom string pattern #11

  CreateConnection 요청에 자격 증명을 ARN 저장하는 비밀 관리자.

• OAuth2Properties – OAuth2PropertiesInput 객체입니다.

  CreateConnection 요청의 OAuth2 인증을 위한 속성.

필드

• OAuth2GrantType— UTF -8 문자열 (유효한 값: AUTHORIZATION_CODE | CLIENT_CREDENTIALS |JWT_BEARER).

  OAuth2보조금 유형. 예: AUTHORIZATION_CODE, JWT_BEARER 또는 CLIENT_CREDENTIALS.

• OAuth2ClientApplication – OAuth2ClientApplication 객체입니다.

  클라이언트 애플리케이션 유형입니다. 예: AWS _ MANAGED 또는 USER _MANAGED.

• TokenUrl— UTF -8 문자열, 길이 256바이트 이하, 와 일치합니다. Custom string pattern #12

  권한 부여 코드를 액세스 토큰으로 교환하기 위한 URL 공급자의 인증 서버입니다.

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

  각 키는 1바이트 이상 또는 128바이트 이상인 UTF -8 문자열입니다.

  각 값은 1바이트 이상 또는 512바이트 이상인 UTF -8 문자열입니다.

  토큰 GET 요청에 추가된 파라미터의 맵입니다.

필드

• OAuth2GrantType— UTF -8 문자열 (유효한 값: AUTHORIZATION_CODE | CLIENT_CREDENTIALS |JWT_BEARER).

  CreateConnection 요청의 OAuth2 허가 유형. 예: AUTHORIZATION_CODE, JWT_BEARER 또는 CLIENT_CREDENTIALS.

• OAuth2ClientApplication – OAuth2ClientApplication 객체입니다.

  CreateConnection 요청의 클라이언트 애플리케이션 유형. 예: AWS_MANAGED또는 USER_MANAGED.

• TokenUrl— 와 UTF 일치하는 -8 문자열, 길이 256바이트 이하 Custom string pattern #12

  권한 부여 코드를 액세스 토큰으로 교환하기 위한 URL 공급자의 인증 서버입니다.

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

  각 키는 1바이트 이상 또는 128바이트 이상인 UTF -8 문자열입니다.

  각 값은 1바이트 이상 또는 512바이트 이상인 UTF -8 문자열입니다.

  토큰 GET 요청에 추가된 파라미터의 맵입니다.

• AuthorizationCodeProperties – AuthorizationCodeProperties 객체입니다.

  권한 부여 유형에 필요한 속성 세트. OAuth2 AUTHORIZATION_CODE

필드

• UserManagedClientApplicationClientId— UTF 다음과 일치하는 -8 문자열, 길이 2048바이트 이하 Custom string pattern #13

  클라이언트 애플리케이션 Clientid (있는 경우) ClientAppType USER_MANAGED

• AWSManagedClientApplicationReference— UTF -8 문자열로, 길이가 2048바이트를 넘지 않으며 다음과 일치합니다. Custom string pattern #13

  관리되는 SaaS 측 클라이언트 앱에 대한 참조입니다. AWS

필드

• AuthorizationCode— UTF -8 문자열, 길이가 1바이트 이상 또는 4096바이트 이상이어야 하며 다음과 일치해야 합니다. Custom string pattern #13

  AUTHORIZATION_CODE 권한 부여 워크플로의 세 번째 레그에서 사용할 인증 코드입니다. 이 코드는 액세스 토큰으로 교환되면 유효하지 않게 되는 일회용 코드이므로 이 값을 요청 파라미터로 사용하는 것이 허용됩니다.

• RedirectUri— UTF 일치하는 -8 문자열, 길이 512바이트 이하. Custom string pattern #14

  인증 코드를 URI 발급할 때 권한 부여 서버가 사용자를 리디렉션하는 리디렉션입니다. 이후에 인증 코드를 액세스 토큰으로 교환할 때 사용됩니다. URI