翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
接続 API
接続 API では、AWS Glue 接続データ型と、接続を作成、削除、更新、および一覧表示するための API について説明します。
データ型
Connection 構造
データソースへの接続を定義します。
フィールド
-
Name
– UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。接続定義の名前。
-
Description
– 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。接続の説明。
-
ConnectionType
– UTF-8 文字列 (有効な値:JDBC
|SFTP
|MONGODB
|KAFKA
|NETWORK
|MARKETPLACE
|CUSTOM
|SALESFORCE
)。接続のタイプ。現在、SFTP はサポートされていません。
-
MatchCriteria
- UTF-8 文字列の配列。文字列 10 個以下。この接続を選択する際に使用可能な条件のリスト。
-
ConnectionProperties
– キーと値のペアのマップ配列。100 ペア以下。各キーは UTF-8 文字列です (有効な値:
HOST
|PORT
|USERNAME="USER_NAME"
|PASSWORD
|ENCRYPTED_PASSWORD
|JDBC_DRIVER_JAR_URI
|JDBC_DRIVER_CLASS_NAME
|JDBC_ENGINE
|JDBC_ENGINE_VERSION
|CONFIG_FILES
|INSTANCE_ID
|JDBC_CONNECTION_URL
|JDBC_ENFORCE_SSL
|CUSTOM_JDBC_CERT
|SKIP_CUSTOM_JDBC_CERT_VALIDATION
|CUSTOM_JDBC_CERT_STRING
|CONNECTION_URL
|KAFKA_BOOTSTRAP_SERVERS
|KAFKA_SSL_ENABLED
|KAFKA_CUSTOM_CERT
|KAFKA_SKIP_CUSTOM_CERT_VALIDATION
|KAFKA_CLIENT_KEYSTORE
|KAFKA_CLIENT_KEYSTORE_PASSWORD
|KAFKA_CLIENT_KEY_PASSWORD
|ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD
|ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD
|SECRET_ID
|CONNECTOR_URL
|CONNECTOR_TYPE
|CONNECTOR_CLASS_NAME
|KAFKA_SASL_MECHANISM
|KAFKA_SASL_PLAIN_USERNAME
|KAFKA_SASL_PLAIN_PASSWORD
|ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD
|KAFKA_SASL_SCRAM_USERNAME
|KAFKA_SASL_SCRAM_PASSWORD
|KAFKA_SASL_SCRAM_SECRETS_ARN
|ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD
|KAFKA_SASL_GSSAPI_KEYTAB
|KAFKA_SASL_GSSAPI_KRB5_CONF
|KAFKA_SASL_GSSAPI_SERVICE
|KAFKA_SASL_GSSAPI_PRINCIPAL
|ROLE_ARN
)。各値は Value 文字列で、1,024 バイト長以下です。
以下のキー/値ペアは接続のパラメータを定義します。
-
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 メカニズムです。 -
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 リソースネーム。 -
KAFKA_SASL_GSSAPI_KEYTAB
- Kerberoskeytab
ファイルの S3 の場所。キータブには、1 つ以上のプリンシパルの長期キーが保存されます。詳細については、MIT Kerberos ドキュメント: キータブを参照してください。 -
KAFKA_SASL_GSSAPI_KRB5_CONF
- Kerberoskrb5.conf
ファイルの S3 の場所。krb5.conf には、KDC サーバーの場所などの Kerberos 構成情報が保存されます。詳細については、MIT Kerberos ドキュメント: krb5.confを参照してください。 -
KAFKA_SASL_GSSAPI_SERVICE
- Kafka 構成の sasl.kerberos.service.name
で設定した通りのKerberos サービスの名前。 -
KAFKA_SASL_GSSAPI_PRINCIPAL
- AWS Glue によって使用される Kerberos プリンシパルの名前。詳細については、Kafka ドキュメント: Kafka ブローカーの構成を参照してください。
-
-
PhysicalConnectionRequirements
– PhysicalConnectionRequirements オブジェクト。この接続を正常に行うために必要な物理接続要件 (例: 仮想プライベートクラウド (VPC)、
SecurityGroup
)。 -
CreationTime
– タイムスタンプ。この接続定義が作成された時刻のタイムスタンプ。
-
LastUpdatedTime
– タイムスタンプ。この接続定義が更新された最終時刻のタイムスタンプ。
-
LastUpdatedBy
– UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。この接続定義を最終更新したユーザー、グループ、またはロール。
-
Status
– UTF-8 文字列 (有効な値:READY
|IN_PROGRESS
|FAILED
)。接続のステータス。
READY
、IN_PROGRESS
、またはFAILED
のいずれか。 -
StatusReason
– UTF-8 文字列、1~16384 バイト長。接続ステータスの理由。
-
LastConnectionValidationTime
– タイムスタンプ。この接続が最後に検証された時刻のタイムスタンプ。
-
AuthenticationConfiguration
– AuthenticationConfiguration オブジェクト。接続の認証プロパティ。
ConnectionInput 構造
作成または更新する接続を指定するために使用される構造。
フィールド
-
Name
– 必須: UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。コレクションの名前。
-
Description
– 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。接続の説明。
-
ConnectionType
– 必須: UTF-8 文字列 (有効な値:JDBC
|SFTP
|MONGODB
|KAFKA
|NETWORK
|MARKETPLACE
|CUSTOM
|SALESFORCE
)。接続のタイプ。現在、次のタイプがサポートされています。
-
JDBC
- Java データベース接続 (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
。
-
-
SALESFORCE
- OAuth 認証を使用して Salesforce への接続を指定します。-
AuthenticationConfiguration
メンバーを設定する必要があります。
-
-
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 がネイティブにサポートしていないデータストアに対する読み取りと書き込みを行います。
SFTP
はサポートされていません。オプションの ConnectionProperties を使用して AWS Glue の機能を設定する方法の詳細については、「AWS Glue 接続プロパティ」を参照してください。
オプションの ConnectionProperties を使用して AWS Glue Studio の機能を設定する方法の詳細については、「コネクタと接続の使用」を参照してください。
-
-
MatchCriteria
- UTF-8 文字列の配列。文字列 10 個以下。この接続を選択する際に使用可能な条件のリスト。
-
ConnectionProperties
– 必須: キーと値のペアのマップ配列。100 ペア以下。各キーは UTF-8 文字列です (有効な値:
HOST
|PORT
|USERNAME="USER_NAME"
|PASSWORD
|ENCRYPTED_PASSWORD
|JDBC_DRIVER_JAR_URI
|JDBC_DRIVER_CLASS_NAME
|JDBC_ENGINE
|JDBC_ENGINE_VERSION
|CONFIG_FILES
|INSTANCE_ID
|JDBC_CONNECTION_URL
|JDBC_ENFORCE_SSL
|CUSTOM_JDBC_CERT
|SKIP_CUSTOM_JDBC_CERT_VALIDATION
|CUSTOM_JDBC_CERT_STRING
|CONNECTION_URL
|KAFKA_BOOTSTRAP_SERVERS
|KAFKA_SSL_ENABLED
|KAFKA_CUSTOM_CERT
|KAFKA_SKIP_CUSTOM_CERT_VALIDATION
|KAFKA_CLIENT_KEYSTORE
|KAFKA_CLIENT_KEYSTORE_PASSWORD
|KAFKA_CLIENT_KEY_PASSWORD
|ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD
|ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD
|SECRET_ID
|CONNECTOR_URL
|CONNECTOR_TYPE
|CONNECTOR_CLASS_NAME
|KAFKA_SASL_MECHANISM
|KAFKA_SASL_PLAIN_USERNAME
|KAFKA_SASL_PLAIN_PASSWORD
|ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD
|KAFKA_SASL_SCRAM_USERNAME
|KAFKA_SASL_SCRAM_PASSWORD
|KAFKA_SASL_SCRAM_SECRETS_ARN
|ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD
|KAFKA_SASL_GSSAPI_KEYTAB
|KAFKA_SASL_GSSAPI_KRB5_CONF
|KAFKA_SASL_GSSAPI_SERVICE
|KAFKA_SASL_GSSAPI_PRINCIPAL
|ROLE_ARN
)。各値は Value 文字列で、1,024 バイト長以下です。
以下のキーバリューペアは接続のパラメータを定義します。
-
PhysicalConnectionRequirements
– PhysicalConnectionRequirements オブジェクト。この接続を正常に行うために必要な物理接続要件 (例: 仮想プライベートクラウド (VPC)、
SecurityGroup
)。 -
AuthenticationConfiguration
– AuthenticationConfigurationInput オブジェクト。接続の認証プロパティ。Salesforce 接続に使用されます。
-
ValidateCredentials
– ブール。接続の作成中に認証情報を検証するフラグ。Salesforce 接続に使用されます。デフォルトは true です。
PhysicalConnectionRequirements 構造
GetConnection レスポンスの OAuth クライアントアプリ。
フィールド
-
SubnetId
– UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。接続で使用されるサブネット ID。
-
SecurityGroupIdList
- UTF-8 文字列の配列。文字列 50 個以下。接続で使用されるセキュリティグループ ID のリスト。
-
AvailabilityZone
– UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。接続のアベイラビリティーゾーン。
GetConnectionsFilter 構造
GetConnections
API オペレーションによって返る接続定義をフィルタリングします。
フィールド
-
MatchCriteria
- UTF-8 文字列の配列。文字列 10 個以下。接続定義を返すためにその接続定義に記録された条件と一致する必要がある条件文字列。
-
ConnectionType
– UTF-8 文字列 (有効な値:JDBC
|SFTP
|MONGODB
|KAFKA
|NETWORK
|MARKETPLACE
|CUSTOM
|SALESFORCE
)。返す接続のタイプ。現在、SFTP はサポートされていません。
操作
CreateConnection アクション (Python: create_connection)
データカタログで接続定義を作成します。
フェデレーションリソースの作成に使用される接続には IAM glue:PassConnection
権限が必要です。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続を作成するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
ConnectionInput
– 必須: ConnectionInput オブジェクト。作成する接続を定義する
ConnectionInput
オブジェクト。 -
Tags
– キーと値のペアのマップ配列。50 ペア以下。各キーは UTF-8 文字列で、1~128 バイト長です。
各値は UTF-8 文字列で、256 バイト長以下です。
接続に割り当てるタグ。
レスポンス
-
CreateConnectionStatus
– UTF-8 文字列 (有効な値:READY
|IN_PROGRESS
|FAILED
)。接続作成リクエストのステータス。リクエストは、VPC 経由でトークン交換を使用して OAuth 接続を作成する場合など、特定の認証タイプでは時間がかかる場合があります。
エラー
AlreadyExistsException
InvalidInputException
OperationTimeoutException
ResourceNumberLimitExceededException
GlueEncryptionException
DeleteConnection アクション (Python: delete_connection)
データカタログから接続を削除します。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
ConnectionName
– 必須: UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。削除する接続の名前。
レスポンス
応答パラメータはありません。
エラー
EntityNotFoundException
OperationTimeoutException
GetConnection アクション (Python: get_connection)
データカタログから接続定義を取得します。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
Name
– 必須: UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。取得する接続定義の名前。
-
HidePassword
– ブール。パスワードを返さずに接続メタデータを取得できます。例えば、AWS Glue コンソールではこのフラグを使用して接続を取得し、パスワードは表示しません。呼び出し元に AWS KMS キーを使用してパスワードを復号するアクセス許可がない可能性があるが、それ以外の接続プロパティへのアクセス許可がある場合は、このパラメータを設定します。
レスポンス
-
Connection
– Connection オブジェクト。リクエストされた接続定義。
エラー
EntityNotFoundException
OperationTimeoutException
InvalidInputException
GlueEncryptionException
GetConnections アクション (Python: get_connections)
データカタログから接続定義のリストを取得します。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
Filter
– GetConnectionsFilter オブジェクト。返される接続をコントロールするフィルター。
-
HidePassword
– ブール。パスワードを返さずに接続メタデータを取得できます。例えば、AWS Glue コンソールではこのフラグを使用して接続を取得し、パスワードは表示しません。呼び出し元に AWS KMS キーを使用してパスワードを復号するアクセス許可がない可能性があるが、それ以外の接続プロパティへのアクセス許可がある場合は、このパラメータを設定します。
-
NextToken
– UTF-8 文字列。継続トークン (これが継続呼び出しの場合)。
-
MaxResults
– 1~1000 の数値 (整数)。1 回の応答で返す接続の最大数。
レスポンス
-
ConnectionList
– Connection オブジェクトの配列。リクエストされた接続定義のリスト。
-
NextToken
– UTF-8 文字列。返された接続のリストにフィルタリングされた接続の最後のものが含まれていない場合は、継続トークン。
エラー
EntityNotFoundException
OperationTimeoutException
InvalidInputException
GlueEncryptionException
UpdateConnection アクション (Python: update_connection)
データカタログで接続定義を更新します。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
Name
– 必須: UTF-8 文字列、1~255 バイト長、Single-line string pattern に一致。更新する接続定義の名前。
-
ConnectionInput
– 必須: ConnectionInput オブジェクト。該当する接続を再定義する
ConnectionInput
オブジェクト。
レスポンス
応答パラメータはありません。
エラー
InvalidInputException
EntityNotFoundException
OperationTimeoutException
InvalidInputException
GlueEncryptionException
BatchDeleteConnection アクション (Python: batch_delete_connection)
データカタログから接続定義のリストを削除します。
リクエスト
-
CatalogId
– カタログ ID 文字列、1~255 バイト長、Single-line string pattern に一致。接続が存在するデータカタログの ID。設定しない場合は、AWS アカウント ID がデフォルトで使用されます。
-
ConnectionNameList
– 必須: UTF-8 文字列の配列。文字列 25 個以下。削除する接続の名前のリスト。
レスポンス
-
Succeeded
– UTF-8 文字列の配列。正常に削除された接続定義の名前のリスト。
-
Errors
– キーバリューペアのマップ配列。各キーは UTF-8 文字列、1~255 バイト長で、Single-line string pattern に一致します。
各値は ErrorDetail オブジェクトです。
エラーの詳細への正常に削除されなかった接続の名前のマップ。
エラー
InternalServiceException
OperationTimeoutException
認証の設定
AuthenticationConfiguration 構造
認証の設定を含む構造。
フィールド
-
AuthenticationType
– UTF-8 文字列 (有効な値:BASIC
|OAUTH2
|CUSTOM
)。認証の設定を含む構造。
-
SecretArn
– UTF-8 文字列、「Custom string pattern #11」に一致。認証情報を保存するシークレットマネージャー ARN。
-
OAuth2Properties
– OAuth2Properties オブジェクト。OAuth2 認証のプロパティ。
AuthenticationConfigurationInput 構造
CreateConnection リクエストの認証の設定を含む構造。
フィールド
-
AuthenticationType
– UTF-8 文字列 (有効な値:BASIC
|OAUTH2
|CUSTOM
)。CreateConnection リクエストの認証の設定を含む構造。
-
SecretArn
– UTF-8 文字列、「Custom string pattern #11」に一致。CreateConnection リクエストに認証情報を保存するシークレットマネージャー ARN。
-
OAuth2Properties
– OAuth2PropertiesInput オブジェクト。CreateConnection リクエストの OAuth2 認証のプロパティ。
OAuth2Properties 構造
OAuth2 認証のプロパティを含む構造。
フィールド
-
OAuth2GrantType
– UTF-8 文字列 (有効な値:AUTHORIZATION_CODE
|CLIENT_CREDENTIALS
|JWT_BEARER
)。OAuth2 付与タイプ。例えば、
AUTHORIZATION_CODE
、JWT_BEARER
、またはCLIENT_CREDENTIALS
などです。 -
OAuth2ClientApplication
– OAuth2ClientApplication オブジェクト。クライアントアプリケーションタイプ。たとえば、AWS_MANAGED または USER_MANAGED。
-
TokenUrl
- UTF-8 文字列、256 バイト長以下、Custom string pattern #12 に一致。認証コードをアクセストークンと交換するための、プロバイダーの認証サーバーの URL。
-
TokenUrlParametersMap
– キーバリューペアのマップ配列。各キーは UTF-8 文字列で、1~128 バイト長です。
各値は UTF-8 文字列で、1~512 バイト長です。
トークン
GET
リクエストに追加されるパラメータのマップ。
OAuth2PropertiesInput 構造
CreateConnection リクエストの OAuth2 のプロパティを含む構造。
フィールド
-
OAuth2GrantType
– UTF-8 文字列 (有効な値:AUTHORIZATION_CODE
|CLIENT_CREDENTIALS
|JWT_BEARER
)。CreateConnection リクエストの OAuth2 付与タイプ。例えば、
AUTHORIZATION_CODE
、JWT_BEARER
、またはCLIENT_CREDENTIALS
などです。 -
OAuth2ClientApplication
– OAuth2ClientApplication オブジェクト。CreateConnection リクエストのクライアントアプリケーションタイプ。例えば、
AWS_MANAGED
、USER_MANAGED
などです。 -
TokenUrl
- UTF-8 文字列、256 バイト長以下、Custom string pattern #12 に一致。認証コードをアクセストークンと交換するための、プロバイダーの認証サーバーの URL。
-
TokenUrlParametersMap
– キーバリューペアのマップ配列。各キーは UTF-8 文字列で、1~128 バイト長です。
各値は UTF-8 文字列で、1~512 バイト長です。
トークン
GET
リクエストに追加されるパラメータのマップ。 -
AuthorizationCodeProperties
– AuthorizationCodeProperties オブジェクト。OAuth2
AUTHORIZATION_CODE
付与タイプに必要なプロパティのセット。
OAuth2ClientApplication 構造
接続に使用される OAuth2 クライアントアプリ。
フィールド
-
UserManagedClientApplicationClientId
- UTF-8 文字列。2,048 バイト長以下。Custom string pattern #13 に一致。ClientAppType が
USER_MANAGED
の場合のクライアントアプリケーションの clientID。 -
AWSManagedClientApplicationReference
- UTF-8 文字列。2,048 バイト長以下。Custom string pattern #13 に一致。AWS によって管理されている SaaS 側のクライアントアプリケーションへの参照。
AuthorizationCodeProperties 構造
OAuth2 AUTHORIZATION_CODE
付与タイプのワークフローに必要なプロパティのセット。
フィールド
-
AuthorizationCode
– UTF-8 文字列、1~4096 バイト長、Custom string pattern #13 に一致。AUTHORIZATION_CODE
で付与されるワークフローの 3 番目のレッグで使用される認証コード。これは、アクセストークンと交換されると無効になるワンタイムコードであるため、この値をリクエストパラメータとして指定できます。 -
RedirectUri
- UTF-8 文字列、512 バイト長以下、Custom string pattern #14 に一致。認証コードの発行時にユーザーが認証サーバーによってリダイレクトされるリダイレクト URI。この URI は、認証コードがアクセストークンと交換されるときに使用されます。