# 연결 API
<a name="aws-glue-api-catalog-connections"></a>

연결 API는 AWS Glue에서의 연결 작업과 관련된 API 및 데이터 유형에 대해 설명합니다.

**Topics**
+ [연결 API](aws-glue-api-catalog-connections-connections.md)
+ [연결 유형 API](aws-glue-api-catalog-connections-connections-type.md)
+ [연결 메타데이터 및 미리 보기 API](aws-glue-api-catalog-connections-connections-metadata.md)

# 연결 API
<a name="aws-glue-api-catalog-connections-connections"></a>

연결 API는 AWS Glue 연결 데이터 유형과 연결을 생성, 삭제, 업데이트 및 나열하기 위한 API에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-connections-connections-objects"></a>
+ [연결 구조](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput 구조](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput 구조](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements 구조](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter 구조](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration 구조](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput 구조](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Properties 구조](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput 구조](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication 구조](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties 구조](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials 구조](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2Credentials 구조](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)

## 연결 구조
<a name="aws-glue-api-catalog-connections-connections-Connection"></a>

데이터 원본으로 연결을 정의합니다.

**Fields**
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 정의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  연결에 대한 설명입니다.
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형입니다. 현재 SFTP는 지원되지 않습니다.
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.
+ `ConnectionProperties` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이러한 키-값 페어는 버전 1 연결 스키마를 사용할 때 연결에 대한 파라미터를 정의합니다.
  + `HOST` - 호스트 URI: 데이터베이스 호스트의 IPv4 주소 또는 FQDN(fully qualified domain name: 정규화된 도메인 이름).
  + `PORT` - 데이터베이스 호스트가 데이터베이스 연결을 수신 중인 포트의 포트 번호(1,024\$165,535)입니다.
  + `USER_NAME`- 데이터베이스에 로그인할 이름. `USER_NAME`의 값 문자열은 "`USERNAME`"입니다.
  + `PASSWORD`- 사용자 이름에 해당하는 암호(사용할 경우).
  + `ENCRYPTED_PASSWORD` - 데이터 카탈로그 암호화 설정에서 `ConnectionPasswordEncryption`을 설정하여 연결 암호 보호를 활성화하면 이 필드가 암호화된 암호를 저장합니다.
  + `JDBC_DRIVER_JAR_URI` - 사용할 JDBC 드라이버가 포함된 JAR 파일의 Amazon Simple Storage Service(Amazon S3) 경로.
  + `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` - 호스트 이름이 일치하는 SSL(Secure Sockets Layer)을 클라이언트의 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 인증서 문자열입니다. Oracle Database에서는 `SSL_SERVER_CERT_DN`으로, Microsoft SQL Server에서는 `hostNameInCertificate`로 사용됩니다.
  + `CONNECTION_URL` - 일반(비JDBC) 데이터 원본에 연결하기 위한 URL입니다.
  + `SECRET_ID` - 자격 증명의 보안 관리자에 사용되는 보안 암호 ID입니다.
  + `CONNECTOR_URL` - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 URL입니다.
  + `CONNECTOR_TYPE` - 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 포맷)의 Amazon S3 URL입니다. 기본값은 빈 문자열입니다.
  + `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 메커니즘](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml)입니다.
  + `KAFKA_SASL_PLAIN_USERNAME` - "PLAIN" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.
  + `KAFKA_SASL_PLAIN_PASSWORD` - "PLAIN" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다.
  + `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` - Kafka SASL PLAIN 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `KAFKA_SASL_SCRAM_USERNAME` - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.
  + `KAFKA_SASL_SCRAM_PASSWORD` - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다.
  + `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` - Kafka SASL SCRAM 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `KAFKA_SASL_SCRAM_SECRETS_ARN` - AWS Secrets Manager에서 보안 암호의 Amazon 리소스 이름(ARN)입니다.
  + `KAFKA_SASL_GSSAPI_KEYTAB` - Kerberos `keytab` 파일의 S3 위치입니다. keytab은 하나 이상의 보안 주체에 대한 장기 키를 저장합니다. 자세한 내용은 [MIT Kerberos Documentation: Keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html)(MIT Kerberos 설명서: Keytab)을 참조하세요.
  + `KAFKA_SASL_GSSAPI_KRB5_CONF` - Kerberos `krb5.conf` 파일의 S3 위치입니다. krb5.conf는 KDC 서버의 위치와 같은 Kerberos 구성 정보를 저장합니다. 자세한 내용은 [MIT Kerberos Documentation: krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)(MIT Kerberos 설명서: krb5.conf)를 참조하세요.
  + `KAFKA_SASL_GSSAPI_SERVICE` - [Kafka 구성](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name)에서 `sasl.kerberos.service.name`으로 설정된 Kerberos 서비스 이름입니다.
  + `KAFKA_SASL_GSSAPI_PRINCIPAL` - 에서 사용하는 Kerberos 보안 주체의 이름입니다.AWS Glue 자세한 내용은 [Kafka Documentation: Configuring Kafka Brokers](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig)(Kafka 설명서: Kafka 브로커 구성)를 참조하세요.
  + `ROLE_ARN` - 쿼리를 실행하는 데 사용할 역할.
  + `REGION` - 쿼리를 실행할 AWS 리전.
  + `WORKGROUP_NAME` - 쿼리가 실행되는 Amazon Redshift Serverless 작업 그룹 또는 Amazon Athena 작업 그룹의 이름.
  + `CLUSTER_IDENTIFIER` - 쿼리가 실행되는 Amazon Redshift 클러스터의 클러스터 식별자.
  + `DATABASE` - 연결하려는 Amazon Redshift 데이터베이스.
+ `SparkProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `AthenaProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) 객체입니다.

  Virtual Private Cloud(VPC) 및 `SecurityGroup`과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항입니다.
+ `CreationTime` – 타임스탬프입니다.

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

  이 연결 정의가 업데이트된 마지막 시간의 타임스탬프입니다.
+ `LastUpdatedBy` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 연결 정의를 마지막으로 업데이트한 사용자, 그룹 혹은 역할입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  연결 상태입니다. `READY`, `IN_PROGRESS` 또는 `FAILED` 중 하나일 수 있습니다.
+ `StatusReason` – UTF-8 문자열입니다(1\$116384바이트).

  연결 상태의 이유입니다.
+ `LastConnectionValidationTime` – 타임스탬프입니다.

  이 연결이 마지막으로 검증된 시간의 타임스탬프입니다.
+ `AuthenticationConfiguration` – [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration) 객체입니다.

  연결의 인증 속성입니다.
+ `ConnectionSchemaVersion` - 1 이상 2 이하의 숫자(정수)입니다.

  이 연결에 대한 연결 스키마의 버전입니다. 버전 2는 특정 컴퓨팅 환경에 대한 속성을 지원합니다.
+ `CompatibleComputeEnvironments` – UTF-8 문자열의 배열입니다.

  연결과 호환되는 컴퓨팅 환경 목록입니다.

## ConnectionInput 구조
<a name="aws-glue-api-catalog-connections-connections-ConnectionInput"></a>

생성 혹은 업데이트를 위한 연결을 지정할 때 사용되는 구조입니다.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  연결의 이름입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  연결에 대한 설명입니다.
+ `ConnectionType` – *필수:* UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형입니다. 현재 이러한 유형이 지원됩니다.
  + `JDBC` - JDBC(Java Database Connectivity)를 통해 데이터베이스에 대한 연결을 지정합니다.

    `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`. 이러한 파라미터는 JDBC로 SSL을 구성하는 데 사용됩니다.
  + `KAFKA` - Apache Kafka 스트리밍 플랫폼에 대한 연결을 지정합니다.

    `KAFKA` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `KAFKA_BOOTSTRAP_SERVERS`.
    + 선택 사항: `KAFKA_SSL_ENABLED`, `KAFKA_CUSTOM_CERT`, `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. 이러한 파라미터는 `KAFKA`로 SSL을 구성하는 데 사용됩니다.
    + 선택 사항: `KAFKA_CLIENT_KEYSTORE`, `KAFKA_CLIENT_KEYSTORE_PASSWORD`, `KAFKA_CLIENT_KEY_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. 이러한 파라미터는 `KAFKA`에서 SSL로 TLS 클라이언트 구성을 지정하는 데 사용됩니다.
    + 선택 사항: `KAFKA_SASL_MECHANISM`. `SCRAM-SHA-512`, `GSSAPI` 또는 `AWS_MSK_IAM`으로 지정할 수 있습니다.
    + 선택 사항: `KAFKA_SASL_SCRAM_USERNAME`, `KAFKA_SASL_SCRAM_PASSWORD`, `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. 이러한 파라미터는 `KAFKA`로 SASL/SCRAM-SHA-512 인증을 구성하는 데 사용됩니다.
    + 선택 사항: `KAFKA_SASL_GSSAPI_KEYTAB`, `KAFKA_SASL_GSSAPI_KRB5_CONF`, `KAFKA_SASL_GSSAPI_SERVICE`, `KAFKA_SASL_GSSAPI_PRINCIPAL`. 이러한 파라미터는 `KAFKA`로 SASL/GSSAPI 인증을 구성하는 데 사용됩니다.
  + `MONGODB` - MongoDB 문서 데이터베이스에 대한 연결을 지정합니다.

    `MONGODB` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `CONNECTION_URL`.
    + 필수 항목: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
  + `VIEW_VALIDATION_REDSHIFT` - Amazon Redshift에서 보기 검증에 사용되는 연결을 지정합니다.
  + `VIEW_VALIDATION_ATHENA` - Amazon Athena에서 보기 검증에 사용되는 연결을 지정합니다.
  + `NETWORK` - Amazon Virtual Private Cloud(Amazon VPC) 환경 내의 데이터 원본에 대한 네트워크 연결을 지정합니다.

    `NETWORK` 연결에는 ConnectionParameters가 필요하지 않습니다. 대신 PhysicalConnectionRequirements를 제공합니다.
  + `MARKETPLACE` - AWS Marketplace에서 구입한 커넥터에 포함된 구성 설정을 사용하여 AWS Glue에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 씁니다.

    `MARKETPLACE` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `CONNECTOR_TYPE`, `CONNECTOR_URL`, `CONNECTOR_CLASS_NAME`, `CONNECTION_URL`.
    + `JDBC` `CONNECTOR_TYPE` 연결에 필요: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
  + `CUSTOM` - 에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 쓰기 위해 사용자 정의 커넥터에 포함된 구성 설정을 사용합니다.AWS Glue

  특정 커넥터에 필요한 연결 파라미터에 대한 자세한 내용은 AWS Glue 사용 설명서의 [AWS Glue 연결 추가](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html)에서 커넥터에 대한 설명서를 참조하세요.

  `SFTP`는 지원되지 않습니다.

  선택적 ConnectionProperties를 사용하여 AWS Glue의 기능을 구성하는 방법에 대한 자세한 내용을 알아보려면 [AWS Glue 연결 속성](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html)을 참조하세요.

  선택적 ConnectionProperties를 사용하여 AWS Glue Studio의 기능을 구성하는 방법에 대한 자세한 내용을 알아보려면 [커넥터 및 연결 사용](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html)을 참조하세요.
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.
+ `ConnectionProperties` – *필수(Required):* 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이러한 키-값 쌍은 연결용 파라미터를 정의합니다.
+ `SparkProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `AthenaProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) 객체입니다.

  Virtual Private Cloud(VPC) 및 `SecurityGroup`과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항입니다.
+ `AuthenticationConfiguration` – [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput) 객체입니다.

  연결의 인증 속성입니다.
+ `ValidateCredentials` – 부울입니다.

  연결 생성 중에 자격 증명을 검증하기 위한 플래그입니다. 기본값은 true입니다.
+ `ValidateForComputeEnvironments` – UTF-8 문자열의 배열입니다.

  지정된 연결 속성을 검증하는 데 기준이 되는 컴퓨팅 환경입니다.

## TestConnectionInput 구조
<a name="aws-glue-api-catalog-connections-connections-TestConnectionInput"></a>

서비스에 대한 연결 테스트를 지정할 때 사용되는 구조입니다.

**Fields**
+ `ConnectionType` – *필수:* UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  테스트할 연결의 유형입니다. 이 작업은 `JDBC` 또는 `SALESFORCE` 연결 유형에만 사용할 수 있습니다.
+ `ConnectionProperties` – *필수(Required):* 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이 키-값 페어는 연결에 대한 파라미터를 정의합니다.

  JDBC 연결에는 다음 연결 속성이 사용됩니다.
  + 필수 항목: `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`. 이러한 파라미터는 JDBC로 SSL을 구성하는 데 사용됩니다.

  SALESFORCE 연결을 사용하려면 `AuthenticationConfiguration` 멤버를 구성해야 합니다.
+ `AuthenticationConfiguration` – [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput) 객체입니다.

  TestConnection 요청에서 인증 구성을 포함하는 구조입니다. OAuth 인증을 사용하여 Salesforce에 연결하는 데 필요합니다.

## PhysicalConnectionRequirements 구조
<a name="aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements"></a>

GetConnection 응답의 OAuth 클라이언트 앱입니다.

**Fields**
+ `SubnetId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결에서 사용하는 서브넷 ID입니다.
+ `SecurityGroupIdList` – 50개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  연결에서 사용하는 보안 그룹 ID 목록입니다.
+ `AvailabilityZone` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결의 가용 영역입니다.

## GetConnectionsFilter 구조
<a name="aws-glue-api-catalog-connections-connections-GetConnectionsFilter"></a>

`GetConnections` API 작업에서 반환하는 연결 정의를 필터링합니다.

**Fields**
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  연결 정의가 반환되도록 연결 정의에 기록된 기준과 반드시 일치해야 하는 기준 문자열입니다.
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  반환할 연결 유형입니다. 현재 SFTP는 지원되지 않습니다.
+ `ConnectionSchemaVersion` - 1 이상 2 이하의 숫자(정수)입니다.

  스키마 버전 1 또는 2로 연결이 생성되었는지 여부를 나타냅니다.

## AuthenticationConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfiguration"></a>

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

**Fields**
+ `AuthenticationType` – UTF-8 문자열입니다(유효한 값: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  인증 구성을 포함하는 구조입니다.
+ `SecretArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #36](aws-glue-api-common.md#regex_36)

  자격 증명을 저장할 보안 관리자 ARN입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  민감한 인증 정보를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN)입니다. 이 키는 인증 구성 내에 저장된 자격 증명 및 기타 민감한 데이터를 보호하는 데 사용됩니다.
+ `OAuth2Properties` – [OAuth2Properties](#aws-glue-api-catalog-connections-connections-OAuth2Properties) 객체입니다.

  OAuth2 인증을 위한 속성입니다.

## AuthenticationConfigurationInput 구조
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput"></a>

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

**Fields**
+ `AuthenticationType` – UTF-8 문자열입니다(유효한 값: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  CreateConnection 요청에서 인증 구성을 포함하는 구조입니다.
+ `OAuth2Properties` – [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput) 객체입니다.

  CreateConnection 요청에서 OAuth2 인증의 속성입니다.
+ `SecretArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #36](aws-glue-api-common.md#regex_36)

  CreateConnection 요청에서 자격 증명을 저장할 보안 관리자 ARN입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  연결을 암호화하는 데 사용되는 KMS 키의 ARN입니다. 요청에서 입력만 가져와 Secret Manager에 저장합니다.
+ `BasicAuthenticationCredentials` – [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials) 객체입니다.

  인증 유형이 기본 인증일 때 사용되는 자격 증명입니다.
+ `CustomAuthenticationCredentials` – 키-값 페어의 맵 배열입니다.

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

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  인증 유형이 사용자 지정 인증일 때 사용되는 자격 증명입니다.

## OAuth2Properties 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2Properties"></a>

OAuth2 인증을 위한 속성을 포함하는 구조입니다.

**Fields**
+ `OAuth2GrantType` – UTF-8 문자열입니다(유효한 값: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  OAuth2 권한 부여 유형입니다. 예: `AUTHORIZATION_CODE`, `JWT_BEARER` 또는 `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication) 객체입니다.

  클라이언트 애플리케이션 유형입니다. 예: AWS\$1MANAGED 또는 USER\$1MANAGED.
+ `TokenUrl` – 과(와) 일치하는 256바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #40](aws-glue-api-common.md#regex_40)

  인증 코드를 액세스 토큰으로 교환하기 위한 제공업체 인증 서버 URL입니다.
+ `TokenUrlParametersMap` – 키-값 페어의 맵 배열입니다.

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

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

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

## OAuth2PropertiesInput 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput"></a>

CreateConnection 요청에서 OAuth2를 위한 속성을 포함하는 구조입니다.

**Fields**
+ `OAuth2GrantType` – UTF-8 문자열입니다(유효한 값: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  CreateConnection 요청에서 OAuth2 권한 부여 유형입니다. 예: `AUTHORIZATION_CODE`, `JWT_BEARER` 또는 `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication) 객체입니다.

  CreateConnection 요청에서 클라이언트 애플리케이션 유형입니다. 예: `AWS_MANAGED`또는 `USER_MANAGED`.
+ `TokenUrl` – 과(와) 일치하는 256바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #40](aws-glue-api-common.md#regex_40)

  인증 코드를 액세스 토큰으로 교환하기 위한 제공업체 인증 서버 URL입니다.
+ `TokenUrlParametersMap` – 키-값 페어의 맵 배열입니다.

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

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

  토큰 `GET` 요청에 추가된 파라미터의 맵입니다.
+ `AuthorizationCodeProperties` – [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties) 객체입니다.

  OAuth2 `AUTHORIZATION_CODE` 권한 부여 유형에 필요한 속성 세트입니다.
+ `OAuth2Credentials` – [OAuth2Credentials](#aws-glue-api-catalog-connections-connections-OAuth2Credentials) 객체입니다.

  인증 유형이 OAuth2 인증일 때 사용되는 자격 증명입니다.

## OAuth2ClientApplication 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2ClientApplication"></a>

연결에 사용된 OAuth2 클라이언트 앱입니다.

**Fields**
+ `UserManagedClientApplicationClientId` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  ClientAppType이 `USER_MANAGED`인 경우 클라이언트 애플리케이션의 clientID입니다.
+ `AWSManagedClientApplicationReference` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

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

## AuthorizationCodeProperties 구조
<a name="aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties"></a>

OAuth2 `AUTHORIZATION_CODE` 권한 부여 유형 워크플로에 필요한 속성 세트입니다.

**Fields**
+ `AuthorizationCode` – 과(와) 일치하는 1\$14096바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  `AUTHORIZATION_CODE` 권한 부여 워크플로의 세 번째 레그에서 사용할 인증 코드입니다. 이 코드는 액세스 토큰으로 교환되면 유효하지 않게 되는 일회용 코드이므로 이 값을 요청 파라미터로 사용하는 것이 허용됩니다.
+ `RedirectUri` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #41](aws-glue-api-common.md#regex_41)

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

## BasicAuthenticationCredentials 구조
<a name="aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials"></a>

`SecretArn` 값을 제공하지 않는 경우 기본 인증 자격 증명을 제공하는 데 사용됩니다.

**Fields**
+ `Username` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  데이터 소스에 연결할 사용자 이름.
+ `Password` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #33](aws-glue-api-common.md#regex_33)

  데이터 소스에 연결할 암호.

## OAuth2Credentials 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2Credentials"></a>

인증 유형이 OAuth2 인증일 때 사용되는 자격 증명입니다.

**Fields**
+ `UserManagedClientApplicationClientSecret` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #38](aws-glue-api-common.md#regex_38)

  클라이언트 애플리케이션이 사용자 관리형인 경우 클라이언트 애플리케이션 클라이언트 보안 암호.
+ `AccessToken` – [Custom string pattern #38](aws-glue-api-common.md#regex_38)과(와) 일치하는 4,096바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 액세스 토큰.
+ `RefreshToken` – [Custom string pattern #38](aws-glue-api-common.md#regex_38)과(와) 일치하는 4,096바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 새로 고침 토큰.
+ `JwtToken` – [Custom string pattern #39](aws-glue-api-common.md#regex_39)과(와) 일치하는 8,000바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 JSON 웹 토큰(JWT).

## 작업
<a name="aws-glue-api-catalog-connections-connections-actions"></a>
+ [CreateConnection 작업(Python: create\$1connection)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection 작업(Python: delete\$1connection)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection 작업(Python: get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections 작업(Python: get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection 작업(Python: update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection 작업(Python: test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection 작업(Python: batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)

## CreateConnection 작업(Python: create\$1connection)
<a name="aws-glue-api-catalog-connections-connections-CreateConnection"></a>

데이터 카탈로그에서 연결 정의를 생성합니다.

페더레이션 리소스를 생성하는 데 사용되는 연결에는 IAM `glue:PassConnection` 권한이 필요합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결을 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionInput` – *필수(Required):* [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput) 객체입니다.

  생성할 연결을 정의하는 `ConnectionInput` 객체입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

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

**응답**
+ `CreateConnectionStatus` – UTF-8 문자열입니다(유효한 값: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  연결 생성 요청의 상태입니다. VPC를 통해 토큰을 교환하는 OAuth 연결을 생성하는 경우와 같이, 특정 인증 유형의 경우 요청에 다소 시간이 걸릴 수 있습니다.

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## DeleteConnection 작업(Python: delete\$1connection)
<a name="aws-glue-api-catalog-connections-connections-DeleteConnection"></a>

데이터 카탈로그에서 연결을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetConnection 작업(Python: get\$1connection)
<a name="aws-glue-api-catalog-connections-connections-GetConnection"></a>

데이터 카탈로그에서 연결 정의를 검색합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  검색할 연결 정의 이름입니다.
+ `HidePassword` – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하되 암호를 표시하지 않습니다. 호출자에게 AWS KMS 키를 사용하여 암호를 복호화할 권한이 없지만 연결 속성의 나머지에 액세스할 권한이 있는 경우 이 파라미터를 설정합니다.
+ `ApplyOverrideForComputeEnvironment` – UTF-8 문자열입니다(유효한 값: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  여러 서비스에서 사용할 수 있는 연결의 경우, 지정된 컴퓨팅 환경에 대한 반환 속성을 지정합니다.

**응답**
+ `Connection` – [연결](#aws-glue-api-catalog-connections-connections-Connection) 객체입니다.

  요청한 연결 정의입니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## GetConnections 작업(Python: get\$1connections)
<a name="aws-glue-api-catalog-connections-connections-GetConnections"></a>

데이터 카탈로그에서 연결 정의의 목록을 검색합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Filter` – [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter) 객체입니다.

  반환되는 연결을 관리하는 필터입니다.
+ `HidePassword` – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하되 암호를 표시하지 않습니다. 호출자에게 AWS KMS 키를 사용하여 암호를 복호화할 권한이 없지만 연결 속성의 나머지에 액세스할 권한이 있는 경우 이 파라미터를 설정합니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

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

**응답**
+ `ConnectionList` – [연결](#aws-glue-api-catalog-connections-connections-Connection) 객체의 배열입니다.

  요청한 연결 정의의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## UpdateConnection 작업(Python: update\$1connection)
<a name="aws-glue-api-catalog-connections-connections-UpdateConnection"></a>

데이터 카탈로그에서 연결 정의를 업데이트합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트할 연결 정의 이름입니다.
+ `ConnectionInput` – *필수(Required):* [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput) 객체입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## TestConnection 작업(Python: test\$1connection)
<a name="aws-glue-api-catalog-connections-connections-TestConnection"></a>

서비스에 대한 연결을 테스트하여 사용자가 제공하는 서비스 자격 증명을 검증합니다.

기존 연결 이름을 제공하거나, 기존 연결 이외의 연결을 테스트하는 경우 `TestConnectionInput`을 제공할 수 있습니다. 둘 다 동시에 제공하면 오류가 발생합니다.

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  선택 사항입니다. 테스트에 대한 연결의 이름입니다. 이름만 제공하면 이 작업은 해당 연결을 가져와 테스트에 사용합니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 상주하는 카탈로그 ID.
+ `TestConnectionInput` – [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput) 객체입니다.

  서비스에 대한 연결 테스트를 지정할 때 사용되는 구조입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`

## BatchDeleteConnection 작업(Python: batch\$1delete\$1connection)
<a name="aws-glue-api-catalog-connections-connections-BatchDeleteConnection"></a>

데이터 카탈로그에서 연결 정의의 목록을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionNameList` – *필수(Required):* 25개 이하의 문자열로 구성된 UTF-8 문자열입니다.

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

**응답**
+ `Succeeded` – UTF-8 문자열의 배열입니다.

  성공적으로 삭제된 연결 정의 이름의 목록입니다.
+ `Errors` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

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

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`

# 연결 유형 API
<a name="aws-glue-api-catalog-connections-connections-type"></a>

연결 유형 API는 연결 유형 설명과 관련된 AWS Glue API를 설명합니다.

## 연결 관리 API
<a name="aws-glue-api-catalog-connections-connections-type-connection-management"></a>
+ [DescribeConnectionType 작업(Python: describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes 작업(Python: list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief 구조](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant 구조](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)

## DescribeConnectionType 작업(Python: describe\$1connection\$1type)
<a name="aws-glue-api-catalog-connections-connections-type-DescribeConnectionType"></a>

`DescribeConnectionType` API는 AWS Glue에 지정된 연결 유형에 대해 지원되는 옵션에 대한 전체 세부 정보를 제공합니다.

**요청**
+ `ConnectionType` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ `ConnectionType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 유형의 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.
+ `Capabilities` – [기능](#aws-glue-api-catalog-connections-connections-type-Capabilities) 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.
+ `ConnectionProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  컴퓨팅 환경 전체에서 공통적인 연결 속성입니다.
+ `ConnectionOptions` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  `ConnectionInput.ConnectionProperties`에서 연결을 생성할 때 설정할 수 있는 속성을 반환합니다. `ConnectionOptions`는 데이터프레임에 전달되는 연결 옵션 맵의 Spark ETL 스크립트에서 설정할 수 있는 파라미터를 정의합니다.
+ `AuthenticationConfiguration` – [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) 객체입니다.

  연결에 사용되는 인증의 유형입니다.
+ `ComputeEnvironmentConfigurations` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) 객체입니다.

  연결에서 지원하는 컴퓨팅 환경입니다.
+ `PhysicalConnectionRequirements` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  VPC, 서브넷, 보안 그룹 사양 등, 연결에 대한 물리적 요구 사항입니다.
+ `AthenaConnectionProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonConnectionProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `SparkConnectionProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

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

**오류**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`

## ListConnectionTypes 작업(Python: list\$1connection\$1types)
<a name="aws-glue-api-catalog-connections-connections-type-ListConnectionTypes"></a>

`ListConnectionTypes` API는 AWS Glue에서 사용 가능한 연결 유형을 학습하는 검색 메커니즘을 제공합니다. 응답에는 각 연결 유형에 지원되는 항목에 대한 상위 수준 세부 정보가 포함된 연결 유형 목록이 포함되어 있습니다. 나열된 연결 유형은 `CreateConnection` API의 `ConnectionType` 값에 지원되는 옵션 세트입니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**응답**
+ `ConnectionTypes` – [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) 객체의 배열입니다.

  지원되는 연결 유형에 대한 간략한 정보가 포함된 `ConnectionTypeBrief` 객체의 목록입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**오류**
+ `InternalServiceException`

## ConnectionTypeBrief 구조
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief"></a>

`ListConnectionTypes` API에서 반환하는 지원되는 연결 유형에 대한 간략한 정보입니다.

**Fields**
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형의 이름입니다.
+ `DisplayName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 콘솔에 표시되는 연결 유형의 이름이며 인간이 읽을 수 있는 이름입니다.
+ `Vendor` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  이 연결 유형을 생성 또는 유지 관리하는 공급업체 또는 공급자의 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.
+ `Categories` – .

  이 연결 유형이 속한 범주 목록입니다. 범주는 사용자가 사용 사례에 기반하여 적절한 연결 유형을 필터링하고 찾는 데 도움이 됩니다.
+ `Capabilities` – [기능](#aws-glue-api-catalog-connections-connections-type-Capabilities) 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.
+ `LogoUrl` – UTF-8 문자열입니다.

  연결 유형과 연결된 로고의 URL입니다.
+ `ConnectionTypeVariants` – [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant) 객체의 배열입니다.

  이 연결 유형에 사용할 수 있는 변형 목록입니다. 각 변형은 동일한 일반 연결 유형의 특정 사용 사례 또는 구현에 대한 특별 구성을 제공할 수 있습니다.

## ConnectionTypeVariant 구조
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant"></a>

AWS Glue 데이터 카탈로그에서 연결 유형의 변형을 나타냅니다. 연결 유형 변형은 동일한 일반 연결 유형의 다양한 구현을 위한 특정 구성 및 동작을 제공합니다.

**Fields**
+ `ConnectionTypeVariantName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  연결 유형 변형의 고유 식별자입니다. 이 이름은 내부적으로 연결 유형의 특정 변형을 식별하는 데 사용됩니다.
+ `DisplayName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 콘솔에 표시되는 연결 유형 변형의 이름이며 인간이 읽을 수 있는 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  용도, 사용 사례 및 특정 구성 요구 사항 등 연결 유형 변형에 대한 자세한 설명입니다.
+ `LogoUrl` – UTF-8 문자열입니다.

  연결 유형 변형과 연결된 로고의 URL입니다.

## 데이터 유형
<a name="aws-glue-api-catalog-connections-connections-type-connection-types"></a>
+ [Validation 구조](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration 구조](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Capabilities 구조](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Property 구조](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue 구조](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration 구조](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)

## Validation 구조
<a name="aws-glue-api-catalog-connections-connections-type-Validation"></a>

연결 속성에서 검증이 수행되는 방법을 정의합니다.

**Fields**
+ `ValidationType` – *필수:* UTF-8 문자열입니다(유효한 값: `REGEX` \$1 `RANGE`).

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

  검증에 적용되는 패턴의 목록입니다.
+ `Description` – **필수: 1\$11,024바이트 길이의 UTF-8 문자열입니다.

  검증에 대한 설명입니다.
+ `MaxLength` - 숫자(정수)입니다.

  문자열 연결 속성의 최대 길이입니다.
+ `Maximum` - 숫자(정수)입니다.

  검증의 `RANGE` 유형을 지정할 때의 최댓값입니다.
+ `Minimum` - 숫자(정수)입니다.

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

## AuthConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-type-AuthConfiguration"></a>

`DescribeConnectionType` API에서 반환되는 연결에 대한 인증 구성입니다.

**Fields**
+ `AuthenticationType` – *필수:* [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  연결의 인증 유형입니다.
+ `SecretArn` – [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Secrets Manager의 Amazon 리소스 이름(ARN)입니다.
+ `OAuth2Properties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 `Property` 객체입니다.
+ `BasicAuthenticationProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 `Property` 객체입니다.
+ `CustomAuthenticationProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

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

## Capabilities 구조
<a name="aws-glue-api-catalog-connections-connections-type-Capabilities"></a>

`DescribeConnectionType` API에서 반환하는 지원되는 인증 유형을 지정합니다.

**Fields**
+ `SupportedAuthenticationTypes` – *필수:* UTF-8 문자열의 배열입니다.

  지원되는 인증 유형의 목록입니다.
+ `SupportedDataOperations` – *필수:* UTF-8 문자열의 배열입니다.

  지원되는 데이터 작업의 목록입니다.
+ `SupportedComputeEnvironments` – *필수:* UTF-8 문자열의 배열입니다.

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

## Property 구조
<a name="aws-glue-api-catalog-connections-connections-type-Property"></a>

컴퓨팅 환경의 연결 유형을 정의하는 객체입니다.

**Fields**
+ `Name` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  속성의 이름입니다.
+ `Description` – *필수:* UTF-8 문자열입니다(1,024바이트 이하).

  속성에 대한 설명입니다.
+ `Required` – *필수(Required):* 부울.

  속성이 필요한지 여부를 나타냅니다.
+ `PropertyTypes` – *필수:* UTF-8 문자열의 배열입니다.

  속성의 유형을 설명합니다.
+ `AllowedValues` – [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue) 객체의 배열입니다.

  속성에 허용되는 값을 나타내는 `AllowedValue` 객체의 목록입니다.
+ `DataOperationScopes` – UTF-8 문자열의 배열입니다.

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

## AllowedValue 구조
<a name="aws-glue-api-catalog-connections-connections-type-AllowedValue"></a>

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

**Fields**
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  허용되는 값에 대한 설명입니다.
+ `Value` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

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

## ComputeEnvironmentConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration"></a>

`DescribeConnectionType` API에서 반환하는 컴퓨팅 환경(예: Spark, Python 또는 Athena)에 대한 구성이 포함되는 객체입니다.

**Fields**
+ `Name` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  컴퓨팅 환경 구성의 이름입니다.
+ `Description` – *필수:* UTF-8 문자열입니다(1,024바이트 이하).

  컴퓨팅 환경에 대한 설명입니다.
+ `ComputeEnvironment` – *필수:* UTF-8 문자열입니다(유효한 값: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  컴퓨팅 환경의 유형입니다.
+ `SupportedAuthenticationTypes` – *필수:* UTF-8 문자열의 배열입니다.

  컴퓨팅 환경에 지원되는 인증 유형입니다.
+ `ConnectionOptions` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  컴퓨팅 환경의 연결 옵션으로 사용되는 파라미터입니다.
+ `ConnectionPropertyNameOverrides` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

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

  연결 속성 이름은 컴퓨팅 환경에 대해 재정의됩니다.
+ `ConnectionOptionNameOverrides` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

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

  연결 옵션 이름은 컴퓨팅 환경에 대해 재정의됩니다.
+ `ConnectionPropertiesRequiredOverrides` – *필수:* .

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

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

# 연결 메타데이터 및 미리 보기 API
<a name="aws-glue-api-catalog-connections-connections-metadata"></a>

다음 연결 API는 연결 메타데이터를 설명하는 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-connections-connections-metadata-objects"></a>
+ [Entity 구조](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Field 구조](#aws-glue-api-catalog-connections-connections-metadata-Field)

## Entity 구조
<a name="aws-glue-api-catalog-connections-connections-metadata-Entity"></a>

지정된 `ConnectionType`에서 지원하는 개체입니다.

**Fields**
+ `EntityName` – UTF-8 문자열입니다.

  개체의 이름입니다.
+ `Label` – UTF-8 문자열입니다.

  엔터티에 사용되는 레이블입니다.
+ `IsParentEntity` – 부울입니다.

  나열할 수 있는 하위 객체가 있는지 확인하는 데 도움이 되는 부울 값입니다.
+ `Description` – UTF-8 문자열입니다.

  엔터티에 대한 설명입니다.
+ `Category` – UTF-8 문자열입니다.

  응답에 있는 엔터티의 유형입니다. 이 값은 소스 연결에 따라 다릅니다. 예를 들어 Salesforce의 경우 `SObjects`이고 Amazon Redshift와 같은 소스의 경우 `databases`, `schemas` 또는 `tables`입니다.
+ `CustomProperties` – 

  커넥터가 엔터티에 대해 반환할 수 있는 키의 선택적 맵입니다.

## Field 구조
<a name="aws-glue-api-catalog-connections-connections-metadata-Field"></a>

`Field` 객체에는 커넥터의 필드와 연결된 다양한 속성에 대한 정보가 있습니다.

**Fields**
+ `FieldName` – UTF-8 문자열입니다.

  필드의 고유 식별자입니다.
+ `Label` – UTF-8 문자열입니다.

  필드에 사용되는 읽기 가능한 레이블입니다.
+ `Description` – UTF-8 문자열입니다.

  필드에 대한 설명입니다.
+ `FieldType` – UTF-8 문자열입니다(유효한 값: `INT` \$1 `SMALLINT` \$1 `BIGINT` \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 `STRING` \$1 `TIMESTAMP` \$1 `DECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE` \$1 `STRUCT`).

  필드의 데이터 유형입니다.
+ `IsPrimaryKey` – 부울입니다.

  이 필드를 지정된 엔터티의 기본 키로 사용할 수 있는지 여부를 나타냅니다.
+ `IsNullable` – 부울입니다.

  이 필드에 null 값이 허용되는지 여부를 나타냅니다.
+ `IsRetrievable` – 부울입니다.

  SQL 쿼리의 Select 절에 이 필드를 추가할 수 있는지 또는 이 필드를 검색할 수 있는지 여부를 나타냅니다.
+ `IsFilterable` – 부울입니다.

   데이터를 쿼리할 때 SQL 문의 filter 절(`WHERE` 절)에 이 필드를 사용할 수 있는지 여부를 나타냅니다.
+ `IsPartitionable` – 부울입니다.

  SaaS에 대한 쿼리를 분할하는 데 지정된 필드를 사용할 수 있는지 여부를 나타냅니다.
+ `IsCreateable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 생성할 수 있는지 여부를 나타냅니다.
+ `IsUpdateable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 업데이트할 수 있는지 여부를 나타냅니다.
+ `IsUpsertable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 삽입할 수 있는지 여부를 나타냅니다.
+ `IsDefaultOnCreate` – 부울입니다.

  타임스탬프에서 생성되는 객체와 같은 객체가 생성될 때 이 필드가 자동으로 채워지는지 여부를 나타냅니다.
+ `SupportedValues` – .

  필드의 지원되는 값 목록입니다.
+ `SupportedFilterOperators` – UTF-8 문자열의 배열입니다.

  이 필드에 대한 지원 필터 연산자를 나타냅니다.
+ `CustomProperties` – 

  반환되는 키의 선택적 맵입니다.

## 작업
<a name="aws-glue-api-catalog-connections-connections-metadata-actions"></a>
+ [ListEntities 작업(Python: list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity 작업(Python: describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords 작업(Python: get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)

## ListEntities 작업(Python: list\$1entities)
<a name="aws-glue-api-catalog-connections-connections-metadata-ListEntities"></a>

연결 유형에서 지원하는 사용 가능한 엔터티를 반환합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  모든 연결 유형을 쿼리하는 데 필요한 자격 증명이 있는 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `ParentEntityName` – UTF-8 문자열입니다.

  하위 항목을 나열하려는 상위 엔터티의 이름입니다. 이 파라미터는 하위 엔터티를 나열하기 위해 엔터티의 정규화된 경로를 사용합니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  SaaS 커넥터의 API 버전입니다.

**응답**
+ `Entities` – [개체](#aws-glue-api-catalog-connections-connections-metadata-Entity) 객체의 배열입니다.

  `Entity` 객체의 목록.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## DescribeEntity 작업(Python: describe\$1entity)
<a name="aws-glue-api-catalog-connections-connections-metadata-DescribeEntity"></a>

선택한 엔터티의 각 필드의 데이터 모델에 대한 설명과 함께 연결 유형에 사용되는 엔터티에 대한 세부 정보를 제공합니다.

 엔터티를 구성하는 모든 필드가 응답에 포함됩니다.

**요청**
+ `ConnectionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  연결 유형 자격 증명이 포함된 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `EntityName` – *필수:* UTF-8 문자열입니다.

  연결 유형에서 설명할 엔터티의 이름입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  데이터 스토어에 사용되는 API의 버전입니다.

**응답**
+ `Fields` – [필드](#aws-glue-api-catalog-connections-connections-metadata-Field) 객체의 배열입니다.

  해당 커넥터 엔터티의 필드를 설명합니다. `Field` 객체의 목록입니다. `Field`는 데이터베이스의 열과 매우 유사합니다. `Field` 객체에는 커넥터의 필드와 연결된 다양한 속성에 대한 정보가 있습니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## GetEntityRecords 작업(Python: get\$1entity\$1records)
<a name="aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords"></a>

이 API는 지정된 연결 유형 또는 기본 Amazon S3 기반 AWS Glue Data Catalog에서 미리 보기 데이터를 쿼리하는 데 사용됩니다.

레코드를 JSON Blob의 배열로 반환합니다. 각 레코드는 `DescribeEntity` API에서 정의한 필드 유형에 따라 Jackson JsonNode를 사용하여 형식이 지정됩니다.

Spark 커넥터는 `DescribeEntity` API와 동일한 데이터 형식 매핑에 따라 스키마를 생성합니다. Spark 커넥터는 행을 반환할 때 데이터를 스키마와 일치하는 적절한 데이터 유형으로 변환합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 유형 자격 증명이 포함된 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `EntityName` – *필수:* UTF-8 문자열입니다.

  지정된 연결 유형에서 미리 보기 데이터를 쿼리하려는 엔터티의 이름입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  SaaS 커넥터의 API 버전입니다.
+ `ConnectionOptions` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #18](aws-glue-api-common.md#regex_18)과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #17](aws-glue-api-common.md#regex_17)과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다.

  데이터를 쿼리하는 데 필요한 커넥터 옵션입니다.
+ `FilterPredicate` – UTF-8 문자열입니다(1\$1100,000바이트).

  쿼리 요청에 적용할 수 있는 필터 조건자입니다.
+ `Limit` – *필수:* 1\$11,000의 숫자(long)입니다.

  요청으로 가져오는 레코드 수를 제한합니다.
+ `SelectedFields` – UTF-8 문자열의 배열입니다(1\$11,000개의 문자열).

   미리 보기 데이터의 일부로 가져오려는 필드 목록입니다.

**응답**
+ `Records` - 구조의 배열입니다.

  요청한 객체의 목록입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`