连接类型 API

• DescribeConnectionType 操作（Python：describe_connection_type）

• ListConnectionTypes 操作（Python：list_connection_types）

• ConnectionTypeBrief 结构

• ConnectionTypeVariant 结构

请求

• ConnectionType – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要描述的连接类型的名称。

响应

• ConnectionType – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  连接类型的名称。

• Description – UTF-8 字符串，长度不超过 1024 个字节。

  连接类型的描述。

• Capabilities – 一个 功能 对象。

  连接器支持的身份验证类型、数据接口类型（计算环境）以及数据操作。

• ConnectionProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  跨计算环境的通用连接属性。

• ConnectionOptions – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  返回在 ConnectionInput.ConnectionProperties 中创建连接时可以设置的属性。ConnectionOptions 定义可以在传递给 DataFrame 的连接选项映射中的 Spark ETL 脚本中设置的参数。

• AuthenticationConfiguration – 一个 AuthConfiguration 对象。

  用于连接的身份验证类型。

• ComputeEnvironmentConfigurations – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 ComputeEnvironmentConfiguration 对象。

  连接支持的计算环境。

• PhysicalConnectionRequirements – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  连接的物理要求，如 VPC、子网和安全组规范。

• AthenaConnectionProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  特定于 Athena 计算环境的连接属性。

• PythonConnectionProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  特定于 Python 计算环境的连接属性。

• SparkConnectionProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  特定于 Spark 计算环境的连接属性。

错误

• ValidationException

• InvalidInputException

• InternalServiceException

请求

• MaxResults – 数字（整数），不小于 1 或大于 1000。

  要返回的最大结果数量。

• NextToken – UTF-8 字符串，不少于 1 个字节或超过 2048 个字节，与 Custom string pattern #11 匹配。

  延续标记 (如果这是延续调用)。

响应

• ConnectionTypes – ConnectionTypeBrief 对象的数组。

  ConnectionTypeBrief 对象列表，包含有关支持的连接类型的简要信息。

• NextToken – UTF-8 字符串，不少于 1 个字节或超过 2048 个字节，与 Custom string pattern #11 匹配。

  延续令牌（如果当前列表片段不是最后一个片段）。

错误

• InternalServiceException

字段

• ConnectionType：UTF-8 字符串（有效值：JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM | SALESFORCE | VIEW_VALIDATION_REDSHIFT | VIEW_VALIDATION_ATHENA | GOOGLEADS | GOOGLESHEETS | GOOGLEANALYTICS4 | SERVICENOW | MARKETO | SAPODATA | ZENDESK | JIRACLOUD | NETSUITEERP | HUBSPOT | FACEBOOKADS | INSTAGRAMADS | ZOHOCRM | SALESFORCEPARDOT | SALESFORCEMARKETINGCLOUD | SLACK | STRIPE | INTERCOM | SNAPCHATADS）。

  连接类型的名称。

• DisplayName – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  Amazon Glue 控制台中显示的连接类型的人类可读名称。

• Vendor – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  创建或维护此连接类型的供应商或者提供商的名称。

• Description – UTF-8 字符串，长度不超过 1024 个字节。

  连接类型的描述。

• Categories – UTF-8 字符串数组。

  此连接类型所属的类别列表。类别可帮助用户根据其用例筛选并找到合适的连接类型。

• Capabilities – 一个 功能 对象。

  连接器支持的身份验证类型、数据接口类型（计算环境）以及数据操作。

• LogoUrl – UTF-8 字符串。

  与连接类型相关联的徽标的 URL。

• ConnectionTypeVariants – ConnectionTypeVariant 对象的数组。

  此连接类型可用的变体列表。不同的变体可能会为特定用例或相同通用连接类型的实现提供专门的配置。

字段

• ConnectionTypeVariantName – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  连接类型变体的唯一标识符。此名称在内部用于标识连接类型的特定变体。

• DisplayName – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  Amazon Glue 控制台中显示的连接类型变体的人类可读名称。

• Description – UTF-8 字符串，长度不超过 1024 个字节。

  连接类型变体的详细描述，包括其用途、用例和任何特定的配置要求。

• LogoUrl – UTF-8 字符串。

  与连接类型变体关联的徽标的 URL。

• 验证结构

• AuthConfiguration 结构

• 功能结构

• 属性结构

• AllowedValue 结构

• ComputeEnvironmentConfiguration 结构

字段

• ValidationType – 必填：UTF-8 字符串（有效值：REGEX | RANGE）。

  要执行的验证类型，例如 REGEX。

• Patterns – UTF-8 字符串数组。

  适用于验证的模式列表。

• Description – 必填项：UTF-8 字符串，长度不少于 1 个字节，不超过 1024 个字节。

  验证的描述。

• MaxLength – 数字（整数）。

  字符串连接属性的最大长度。

• Maximum – 数字（整数）。

  指定 RANGE 类型验证时的最大值。

• Minimum – 数字（整数）。

  指定 RANGE 类型验证时的最小值。

字段

• AuthenticationType – 必填：一个 属性 对象。

  连接的身份验证类型。

• SecretArn – 一个 属性 对象。

  Secrets Manager 的 Amazon 资源名称 (ARN)。

• OAuth2Properties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  OAuth2 属性的键值对映射。每个值都是一个 Property 对象。

• BasicAuthenticationProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  OAuth2 属性的键值对映射。每个值都是一个 Property 对象。

• CustomAuthenticationProperties – 键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  自定义身份验证属性的键值对映射。每个值都是一个 Property 对象。

字段

• SupportedAuthenticationTypes – 必填：UTF-8 字符串数组。

  支持的身份验证类型列表。

• SupportedDataOperations – 必填：UTF-8 字符串数组。

  支持的数据操作列表。

• SupportedComputeEnvironments – 必填：UTF-8 字符串数组。

  支持的计算环境列表。

字段

• Name：必需：UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。

  属性的名称。

• Description：必需：UTF-8 字符串，长度不超过 1024 个字节。

  属性的描述。

• Required – 必填：布尔值。

  指示属性是否为必需属性。

• DefaultValue – UTF-8 字符串。

  属性的默认值。

• PropertyTypes – 必填：UTF-8 字符串数组。

  描述属性的类型。

• AllowedValues – AllowedValue 对象的数组。

  表示属性允许的值的 AllowedValue 对象列表。

• DataOperationScopes – UTF-8 字符串数组。

  指示哪些数据操作适用于该属性。

字段

• Description – UTF-8 字符串，长度不超过 1024 个字节。

  允许的值的描述。

• Value：必需：UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。

  属性允许的值。

字段

• Name：必需：UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。

  计算环境配置的名称。

• Description：必需：UTF-8 字符串，长度不超过 1024 个字节。

  计算环境的描述。

• ComputeEnvironment – 必填： UTF-8 字符串（有效值：SPARK | ATHENA | PYTHON）。

  计算环境的类型。

• SupportedAuthenticationTypes – 必填：UTF-8 字符串数组。

  计算环境支持的身份验证类型。

• ConnectionOptions – 必填：键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 属性 对象。

  用作计算环境的连接选项的参数。

• ConnectionPropertyNameOverrides – 必填：键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。

  计算环境的连接属性名称覆盖。

• ConnectionOptionNameOverrides – 必填：键值对的映射数组。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值都是一个 UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。

  计算环境的连接选项名称覆盖。

• ConnectionPropertiesRequiredOverrides – 必填：UTF-8 字符串数组。

  计算环境需要覆盖的连接属性。

• PhysicalConnectionPropertiesRequired – 布尔值。

  指示计算环境是否需要 PhysicalConnectionProperties。