# 接続タイプ 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` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  説明する接続タイプの名前。

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

  接続タイプの名前。
+ `Description` – UTF-8 文字列、1024 バイト長以下。

  接続タイプの説明。
+ `Capabilities` – [機能](#aws-glue-api-catalog-connections-connections-type-Capabilities) オブジェクト。

  サポートされている認証タイプ、データインターフェイスタイプ (コンピューティング環境)、コネクタのデータオペレーション。
+ `ConnectionProperties` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  コンピューティング環境間で共通の接続プロパティ。
+ `ConnectionOptions` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  `ConnectionInput.ConnectionProperties` で接続を作成するときに設定できるプロパティを返します。`ConnectionOptions` は、データフレームに渡される接続オプションマップの Spark ETL スクリプトで設定できるパラメータを定義します。
+ `AuthenticationConfiguration` – [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) オブジェクト。

  接続に使用する認証のタイプ。
+ `ComputeEnvironmentConfigurations` – キーバリューペアのマップ配列。

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

  各値は A [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) オブジェクトです。

  接続でサポートされているコンピューティング環境。
+ `PhysicalConnectionRequirements` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  接続の物理的な要件 (VPC、サブネット、セキュリティグループの仕様など)。
+ `AthenaConnectionProperties` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

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

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

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

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

  各値は A [プロパティ](#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～1000 の数値 (整数)。

  返される結果の最大数。
+ `NextToken` – UTF-8 文字列。1 ～ 2,048 バイト長。[Custom string pattern #11](aws-glue-api-common.md#regex_11) に一致。

  継続トークン (これが継続呼び出しの場合)。

**応答**
+ `ConnectionTypes` – [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) オブジェクトの配列。

  サポートされている接続タイプに関する簡単な情報を含む `ConnectionTypeBrief` オブジェクトのリスト。
+ `NextToken` – UTF-8 文字列。1 ～ 2,048 バイト長。[Custom string pattern #11](aws-glue-api-common.md#regex_11) に一致。

  継続トークン (現在のリストが最後ではない場合に表示されます)。

**エラー**
+ `InternalServiceException`

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

`ListConnectionTypes` API によって返される、サポートされている接続タイプに関する簡単な情報。

**フィールド**
+ `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` – UTF-8 文字列、1～128 バイト長。

  AWS Glue コンソールに表示される接続タイプの人間が読み取れる名前。
+ `Vendor` – UTF-8 文字列、1～128 バイト長。

  この接続タイプを作成または管理するベンダーまたはプロバイダーの名前。
+ `Description` – UTF-8 文字列、1024 バイト長以下。

  接続タイプの説明。
+ `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 データカタログの接続タイプバリアントを表します。接続タイプバリアントは、同じ一般的な接続タイプのさまざまな実装に特定の設定および動作があります。

**フィールド**
+ `ConnectionTypeVariantName` – UTF-8 文字列、1～128 バイト長。

  接続タイプバリアントの一意の識別子。この名前は、接続タイプの特定バリアントを識別するために内部で使用されます。
+ `DisplayName` – UTF-8 文字列、1～128 バイト長。

  AWS Glue コンソールに表示される接続タイプバリアントにおいて、人間が読み取れる名前。
+ `Description` – UTF-8 文字列、1024 バイト長以下。

  目的、ユースケース、特定の設定要件など、接続タイプバリアントの詳細な説明。
+ `LogoUrl` – UTF–8 文字列。

  接続タイプバリアントに関連付けられたロゴの URL。

## データ型
<a name="aws-glue-api-catalog-connections-connections-type-connection-types"></a>
+ [検証構造](#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)

## 検証構造
<a name="aws-glue-api-catalog-connections-connections-type-Validation"></a>

接続プロパティでの検証の実行方法を定義します。

**フィールド**
+ `ValidationType` – *必須:* UTF-8 文字列 (有効な値: `REGEX` \$1 `RANGE`)。

  実行する検証のタイプ (`REGEX` など)。
+ `Patterns` – .

  検証に適用されるパターンのリスト。
+ `Description` – *必須:* UTF-8 文字列、1～1024 バイト長。

  検証の説明。
+ `MaxLength` – 数値 (整数)。

  文字列接続プロパティの最大長。
+ `Maximum` – 数値 (整数)。

  検証の `RANGE` タイプを指定するときの最大値。
+ `Minimum` – 数値 (整数)。

  検証の `RANGE` タイプを指定するときの最小値。

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

`DescribeConnectionType` API によって返される接続の認証設定。

**フィールド**
+ `AuthenticationType` – *必須:* [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクト。

  接続の認証のタイプ。
+ `SecretArn` – [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクト。

  Secrets Manager の Amazon リソースネーム (ARN)。
+ `OAuth2Properties` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  OAuth2 プロパティのキーと値のペアのマップ。各値は A `Property` オブジェクトです。
+ `BasicAuthenticationProperties` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  OAuth2 プロパティのキーと値のペアのマップ。各値は A `Property` オブジェクトです。
+ `CustomAuthenticationProperties` – キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  カスタム認証プロパティのキーと値のペアのマップ。各値は A `Property` オブジェクトです。

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

`DescribeConnectionType` API によって返される、サポートされている認証タイプを指定します。

**フィールド**
+ `SupportedAuthenticationTypes` – *必須:* UTF-8 文字列の配列。

  サポートされている認証タイプのリスト。
+ `SupportedDataOperations` – *必須:* UTF-8 文字列の配列。

  サポートされているデータオペレーションのリスト。
+ `SupportedComputeEnvironments` – *必須:* UTF-8 文字列の配列。

  サポートされているコンピューティング環境のリスト。

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

コンピューティング環境の接続タイプを定義するオブジェクト。

**フィールド**
+ `Name` – *必須:* UTF-8 文字列。1～128 バイト長。

  プロパティの名前。
+ `Description` – *必須:* UTF-8 文字列。1024 以下のバイト長。

  プロパティの説明。
+ `Required` – *必須:* ブール。

  プロパティが必須かどうかを示します。
+ `PropertyTypes` – *必須:* UTF-8 文字列の配列。

  プロパティのタイプを説明します。
+ `AllowedValues` – [allowedValues](#aws-glue-api-catalog-connections-connections-type-AllowedValue) オブジェクトの配列。

  プロパティに許可される値を表す `AllowedValue` オブジェクトのリスト。
+ `DataOperationScopes` – UTF-8 文字列の配列。

  どのデータオペレーションをプロパティに適用できるかを示します。

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

プロパティに許可される値を表すオブジェクト。

**フィールド**
+ `Description` – UTF-8 文字列、1024 バイト長以下。

  許可される値の説明。
+ `Value` – *必須:* UTF-8 文字列。1～128 バイト長。

  プロパティに許可される値。

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

`DescribeConnectionType` API によって返されるコンピューティング環境 (Spark、Python、Athena など) の設定を含むオブジェクト。

**フィールド**
+ `Name` – *必須:* UTF-8 文字列。1～128 バイト長。

  コンピューティング環境設定の名前。
+ `Description` – *必須:* UTF-8 文字列。1,024 以下のバイト長。

  コンピューティング環境の説明。
+ `ComputeEnvironment` – *必須:* UTF-8 文字列 (有効な値: `SPARK` \$1 `ATHENA` \$1 `PYTHON`)。

  コンピューティング環境のタイプ。
+ `SupportedAuthenticationTypes` – *必須:* UTF-8 文字列の配列。

  コンピューティング環境でサポートされている認証タイプ。
+ `ConnectionOptions` – *必須:* キーバリューペアのマップ配列。

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

  各値は A [プロパティ](#aws-glue-api-catalog-connections-connections-type-Property) オブジェクトです。

  コンピューティング環境の接続オプションとして使用されるパラメータ。
+ `ConnectionPropertyNameOverrides` – *必須:* キーバリューペアのマップ配列。

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

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

  接続プロパティ名はコンピューティング環境に対して上書きされます。
+ `ConnectionOptionNameOverrides` – *必須:* キーバリューペアのマップ配列。

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

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

  接続オプション名はコンピューティング環境に対して上書きされます。
+ `ConnectionPropertiesRequiredOverrides` – *必須:*

  コンピューティング環境の上書きとして必要な接続プロパティ。
+ `PhysicalConnectionPropertiesRequired` – ブール。

  コンピューティング環境に `PhysicalConnectionProperties` が必要かどうかを示します。