# 接続 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>

データソースへの接続を定義します。

**フィールド**
+ `Name` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続定義の名前。
+ `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`)。

  接続のタイプ。現在、SFTP はサポートされていません。
+ `MatchCriteria` – UTF-8 文字列の配列。文字列 10 個以下。

  この接続を選択する際に使用可能な条件のリスト。
+ `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～1,024 バイト長です。

  これらのキーと値のペアは、バージョン 1 の接続スキーマを使用する場合の接続のパラメータを定義します。
  + `HOST` - ホスト URI: データベースホストの完全修飾ドメイン名 (FQDN) または IPv4 アドレス。
  + `PORT` - データベースホストがデータベース接続をリッスンするポート番号 (1024 〜 65535)。
  + `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` - ホスト名のマッチによる 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 証明書文字列。Oracle データベースでは、これは `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 の 3 つのアルゴリズムについて検証されます。デフォルト値は「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 Resource Name。
  + `KAFKA_SASL_GSSAPI_KEYTAB` - Kerberos `keytab` ファイルの S3 の場所。キータブには、1 つ以上のプリンシパルの長期キーが保存されます。詳細については、[MIT Kerberos ドキュメント: キータブ](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html) を参照してください。
  + `KAFKA_SASL_GSSAPI_KRB5_CONF` - Kerberos `krb5.conf` ファイルの S3 の場所。krb5.conf には、KDC サーバーの場所などの Kerberos 構成情報が保存されます。詳細については、[MIT Kerberos ドキュメント: krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html) を参照してください。
  + `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 ドキュメント: Kafka ブローカーの構成](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig) を参照してください。
  + `ROLE_ARN` - クエリの実行に使用されるロール。
  + `REGION` - AWS クエリが実行されるリージョン。
  + `WORKGROUP_NAME` - クエリを実行する Amazon Redshift Serverless ワークグループまたは Amazon Athena ワークグループの名前。
  + `CLUSTER_IDENTIFIER` - クエリを実行する Amazon Redshift クラスターのクラスター識別子。
  + `DATABASE` - 接続先の Amazon Redshift データベース。
+ `SparkProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Spark コンピューティング環境に固有の接続プロパティ。
+ `AthenaProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Athena コンピューティング環境に固有の接続プロパティ。
+ `PythonProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Python コンピューティング環境に固有の接続プロパティ。
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) オブジェクト。

  この接続を正常に行うために必要な物理接続要件 (例: 仮想プライベートクラウド (VPC)、`SecurityGroup`)。
+ `CreationTime` – タイムスタンプ。

  この接続定義が作成された時刻のタイムスタンプ。
+ `LastUpdatedTime` – タイムスタンプ。

  この接続定義が更新された最終時刻のタイムスタンプ。
+ `LastUpdatedBy` – UTF-8 文字列。1～255 バイト長。[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～16384 バイト長。

  接続ステータスの理由。
+ `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>

作成または更新する接続を指定するために使用される構造。

**フィールド**
+ `Name` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  コレクションの名前。
+ `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` - Java Database Connectivity (JDBC) を介してデータベースへの接続を指定します。

    `JDBC` 接続では、次の ConnectionParameters を使用します。
    + 必須: (`HOST`、`PORT`、`JDBC_ENGINE`) のすべて、または `JDBC_CONNECTION_URL`。
    + 必須: (`USERNAME`、`PASSWORD`) の両方、または `SECRET_ID`。
    + オプション: `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`。
    + 必須: (`USERNAME`、`PASSWORD`) のすべて、または `SECRET_ID`。
  + `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` 接続に必須: (`USERNAME`、`PASSWORD`) のすべて、または `SECRET_ID`。
  + `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` – UTF-8 文字列の配列。文字列 10 個以下。

  この接続を選択する際に使用可能な条件のリスト。
+ `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～1,024 バイト長です。

  以下のキーバリューペアは接続のパラメータを定義します。
+ `SparkProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Spark コンピューティング環境に固有の接続プロパティ。
+ `AthenaProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Athena コンピューティング環境に固有の接続プロパティ。
+ `PythonProperties` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  Python コンピューティング環境に固有の接続プロパティ。
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) オブジェクト。

  この接続を正常に行うために必要な物理接続要件 (例: 仮想プライベートクラウド (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>

サービスへの接続テストを指定するために使用される構造。

**フィールド**
+ `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` – *必須:* キーと値のペアのマップ配列。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～1,024 バイト長です。

  接続のパラメータを定義するキーと値のペア。

  JDBC 接続では次の接続プロパティを使用します。
  + 必須: (`HOST`、`PORT`、`JDBC_ENGINE`) のすべて、または `JDBC_CONNECTION_URL`。
  + 必須: (`USERNAME`、`PASSWORD`) の両方、または `SECRET_ID`。
  + オプション: `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 クライアントアプリ。

**フィールド**
+ `SubnetId` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続で使用されるサブネット ID。
+ `SecurityGroupIdList` - UTF-8 文字列の配列。文字列 50 個以下。

  接続で使用されるセキュリティグループ ID のリスト。
+ `AvailabilityZone` – UTF-8 文字列。1～255 バイト長。[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 オペレーションによって返る接続定義をフィルタリングします。

**フィールド**
+ `MatchCriteria` – UTF-8 文字列の配列。文字列 10 個以下。

  接続定義を返すためにその接続定義に記録された条件と一致する必要がある条件文字列。
+ `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>

認証の設定を含む構造。

**フィールド**
+ `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 リクエストの認証の設定を含む構造。

**フィールド**
+ `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` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～2,048 バイト長です。

  認証のタイプがカスタム認証である場合に使用される認証情報。

## OAuth2Properties 構造
<a name="aws-glue-api-catalog-connections-connections-OAuth2Properties"></a>

OAuth2 認証のプロパティを含む構造。

**フィールド**
+ `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` – UTF-8 文字列。256 バイト長以下。[Custom string pattern #40](aws-glue-api-common.md#regex_40) に一致。

  認可コードをアクセストークンと交換するための、プロバイダーの認証サーバーの URL。
+ `TokenUrlParametersMap` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～512 バイト長です。

  トークン `GET` リクエストに追加されるパラメータのマップ。

## OAuth2PropertiesInput 構造
<a name="aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput"></a>

CreateConnection リクエストの OAuth2 のプロパティを含む構造。

**フィールド**
+ `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` – UTF-8 文字列、256 バイト長以下。[Custom string pattern #40](aws-glue-api-common.md#regex_40) に一致。

  認可コードをアクセストークンと交換するための、プロバイダーの認証サーバーの URL。
+ `TokenUrlParametersMap` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、1～512 バイト長です。

  トークン `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 クライアントアプリ。

**フィールド**
+ `UserManagedClientApplicationClientId` – UTF-8 文字列。2,048 バイト長以下。[Custom string pattern #37](aws-glue-api-common.md#regex_37) に一致。

  ClientAppType が `USER_MANAGED` の場合のクライアントアプリケーションの clientID。
+ `AWSManagedClientApplicationReference` – UTF-8 文字列。2,048 バイト長以下。[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` グラントタイプのワークフローに必要なプロパティのセット。

**フィールド**
+ `AuthorizationCode` – UTF-8 文字列、1～4096 バイト長、[Custom string pattern #37](aws-glue-api-common.md#regex_37) に一致。

  `AUTHORIZATION_CODE` で付与されるワークフローの 3 番目のレッグで使用される認可コード。これは、アクセストークンと交換されると無効になるワンタイムコードであるため、この値をリクエストパラメータとして指定できます。
+ `RedirectUri` - UTF-8 文字列、512 バイト長以下、[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` の値を指定しない場合に基本的な認証情報を提供する。

**フィールド**
+ `Username` – UTF-8 文字列、512 バイト長以下、[Custom string pattern #37](aws-glue-api-common.md#regex_37) に一致。

  データソースに接続するためのユーザー名。
+ `Password` – UTF-8 文字列、512 バイト長以下、[Custom string pattern #33](aws-glue-api-common.md#regex_33) に一致。

  データソースに接続するためのパスワード。

## OAuth2Credentials 構造
<a name="aws-glue-api-catalog-connections-connections-OAuth2Credentials"></a>

認証のタイプが OAuth2 認証である場合に使用される認証情報。

**フィールド**
+ `UserManagedClientApplicationClientSecret` – UTF-8 文字列、512 バイト長以下、[Custom string pattern #38](aws-glue-api-common.md#regex_38) に一致。

  クライアント アプリケーションがユーザー マネージドである場合のクライアント アプリケーション シークレット。
+ `AccessToken` – UTF-8 文字列。4,096 バイト長以下。[Custom string pattern #38](aws-glue-api-common.md#regex_38) に一致。

  認証タイプが OAuth2 である場合に使用されるアクセストークン。
+ `RefreshToken` – UTF-8 文字列。4,096 バイト長以下。[Custom string pattern #38](aws-glue-api-common.md#regex_38) に一致。

  認証タイプが OAuth2 である場合に使用される更新トークン。
+ `JwtToken` – UTF-8 文字列。8,000 バイト長以下。[Custom string pattern #39](aws-glue-api-common.md#regex_39) に一致。

  認証タイプが 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` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続を作成するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `ConnectionInput` – *必須:* [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput) オブジェクト。

  作成する接続を定義する `ConnectionInput` オブジェクト。
+ `Tags` – キーと値のペアのマップ配列。50 ペア以下。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、256 バイト長以下です。

  接続に割り当てるタグ。

**応答**
+ `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` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `ConnectionName` – *必須:* UTF-8 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  削除する接続の名前。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetConnection アクション (Python: get\$1connection)
<a name="aws-glue-api-catalog-connections-connections-GetConnection"></a>

データカタログから接続定義を取得します。

**リクエスト**
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `Name` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  取得する接続定義の名前。
+ `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` – カタログ ID 文字列、1～255 バイト長、[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～1000 の数値 (整数)。

  1 回の応答で返す接続の最大数。

**応答**
+ `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` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `Name` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  更新する接続定義の名前。
+ `ConnectionInput` – *必須:* [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` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  オプション。テストする接続の名前。名前のみを指定すると、オペレーションは接続を取得してそれをテストに使用します。
+ `CatalogId` – カタログ ID 文字列、1～255 バイト長、[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` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
+ `ConnectionNameList` – *必須:* UTF-8 文字列の配列。文字列 25 個以下。

  削除する接続の名前のリスト。

**応答**
+ `Succeeded` – UTF-8 文字列の配列。

  正常に削除された接続定義の名前のリスト。
+ `Errors` – キーバリューペアのマップ配列。

  各キーは UTF-8 文字列、1～255 バイト長で、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致します。

  各値は A [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) オブジェクトです。

  エラーの詳細への正常に削除されなかった接続の名前のマップ。

**エラー**
+ `InternalServiceException`
+ `OperationTimeoutException`