Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Jenis Koneksi API
<a name="aws-glue-api-catalog-connections-connections-type"></a>

Connection Type API menjelaskan AWS Glue APIs terkait dengan mendeskripsikan jenis koneksi.

## Manajemen koneksi APIs
<a name="aws-glue-api-catalog-connections-connections-type-connection-management"></a>
+ [DescribeConnectionType tindakan (Python: describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes tindakan (Python: list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)

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

`DescribeConnectionType`API memberikan rincian lengkap tentang opsi yang didukung untuk jenis koneksi tertentu AWS Glue.

**Permintaan**
+ `ConnectionType` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama jenis koneksi yang akan dijelaskan.

**Respons**
+ `ConnectionType` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama jenis koneksi.
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.

  Deskripsi jenis koneksi.
+ `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities).

  Jenis otentikasi yang didukung, tipe antarmuka data (lingkungan komputasi), dan operasi data konektor.
+ `ConnectionProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Properti koneksi yang umum di seluruh lingkungan komputasi.
+ `ConnectionOptions` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Mengembalikan properti yang dapat diatur saat membuat koneksi di`ConnectionInput.ConnectionProperties`. `ConnectionOptions`mendefinisikan parameter yang dapat diatur dalam skrip Spark ETL di peta opsi koneksi yang diteruskan ke kerangka data.
+ `AuthenticationConfiguration` — Sebuah objek [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration).

  Jenis otentikasi yang digunakan untuk koneksi.
+ `ComputeEnvironmentConfigurations` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) A.

  Lingkungan komputasi yang didukung oleh koneksi.
+ `PhysicalConnectionRequirements` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Persyaratan fisik untuk koneksi, seperti spesifikasi VPC, Subnet, dan Grup Keamanan.
+ `AthenaConnectionProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Properti koneksi khusus untuk lingkungan komputasi Athena.
+ `PythonConnectionProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Properti koneksi khusus untuk lingkungan komputasi Python.
+ `SparkConnectionProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Properti koneksi khusus untuk lingkungan komputasi Spark.

**Kesalahan**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`

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

`ListConnectionTypes`API menyediakan mekanisme penemuan untuk mempelajari jenis koneksi yang tersedia di AWS Glue. Respons berisi daftar jenis koneksi dengan detail tingkat tinggi tentang apa yang didukung untuk setiap jenis koneksi. Jenis koneksi yang tercantum adalah kumpulan opsi yang didukung untuk `ConnectionType` nilai di `CreateConnection` API.

**Permintaan**
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

  Jumlah hasil maksimum yang akan dikembalikan.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

**Respons**
+ `ConnectionTypes` – Susunan objek [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief).

  Daftar `ConnectionTypeBrief` objek yang berisi informasi singkat tentang jenis koneksi yang didukung.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Token kelanjutan, jika segmen daftar saat ini bukan yang terakhir.

**Kesalahan**
+ `InternalServiceException`

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

Informasi singkat tentang jenis koneksi yang didukung yang dikembalikan oleh `ListConnectionTypes` API.

**Bidang**
+ `ConnectionType`— UTF-8 string (nilai yang valid: `JDBC` `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` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `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` `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`).

  Nama jenis koneksi.
+ `DisplayName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Nama yang dapat dibaca manusia untuk jenis koneksi yang ditampilkan di konsol. AWS Glue 
+ `Vendor` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Nama vendor atau penyedia yang membuat atau memelihara jenis koneksi ini.
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.

  Deskripsi jenis koneksi.
+ `Categories` – .

  Daftar kategori yang dimiliki oleh jenis koneksi ini. Kategori membantu pengguna memfilter dan menemukan jenis koneksi yang sesuai berdasarkan kasus penggunaannya.
+ `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities).

  Jenis otentikasi yang didukung, tipe antarmuka data (lingkungan komputasi), dan operasi data konektor.
+ `LogoUrl` – String UTF-8.

  URL logo yang terkait dengan jenis koneksi.
+ `ConnectionTypeVariants` – Susunan objek [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant).

  Daftar varian yang tersedia untuk jenis koneksi ini. Varian yang berbeda dapat menyediakan konfigurasi khusus untuk kasus penggunaan tertentu atau implementasi dari jenis koneksi umum yang sama.

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

Merupakan varian dari jenis koneksi dalam Katalog AWS Glue Data. Varian tipe koneksi menyediakan konfigurasi dan perilaku spesifik untuk implementasi yang berbeda dari jenis koneksi umum yang sama.

**Bidang**
+ `ConnectionTypeVariantName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Pengidentifikasi unik untuk varian tipe koneksi. Nama ini digunakan secara internal untuk mengidentifikasi varian spesifik dari jenis koneksi. 
+ `DisplayName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Nama yang dapat dibaca manusia untuk varian jenis koneksi yang ditampilkan di konsol. AWS Glue 
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.

  Penjelasan rinci tentang varian jenis koneksi, termasuk tujuannya, kasus penggunaan, dan persyaratan konfigurasi spesifik apa pun.
+ `LogoUrl` – String UTF-8.

  URL logo yang terkait dengan varian jenis koneksi.

## tipe data
<a name="aws-glue-api-catalog-connections-connections-type-connection-types"></a>
+ [Struktur validasi](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Struktur kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Struktur properti](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue struktur](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)

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

Mendefinisikan bagaimana validasi dilakukan pada properti koneksi.

**Bidang**
+ `ValidationType` – *Wajib:* String UTF-8 (nilai yang valid: `REGEX` \$1 `RANGE`).

  Jenis validasi yang akan dilakukan, seperti`REGEX`.
+ `Patterns` – .

  Daftar pola yang berlaku untuk validasi.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte.

  Deskripsi untuk validasi.
+ `MaxLength` — Nomor (bilangan bulat).

  Panjang maksimum untuk properti koneksi string.
+ `Maximum` — Nomor (bilangan bulat).

  Nilai maksimum saat menentukan `RANGE` jenis validasi.
+ `Minimum` — Nomor (bilangan bulat).

  Nilai minimum saat menentukan `RANGE` jenis validasi.

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

Konfigurasi otentikasi untuk koneksi yang dikembalikan oleh `DescribeConnectionType` API.

**Bidang**
+ `AuthenticationType` — *Wajib:* Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property).

  Jenis otentikasi untuk koneksi.
+ `SecretArn` — Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property).

  Nama Sumber Daya Amazon (ARN) untuk Secrets Manager.
+ `OAuth2Properties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Peta pasangan kunci-nilai untuk properti. OAuth2 Setiap nilai adalah `Property` objek.
+ `BasicAuthenticationProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Peta pasangan kunci-nilai untuk properti. OAuth2 Setiap nilai adalah `Property` objek.
+ `CustomAuthenticationProperties` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Peta pasangan kunci-nilai untuk properti otentikasi kustom. Setiap nilai adalah `Property` objek.

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

Menentukan jenis otentikasi didukung dikembalikan oleh API. `DescribeConnectionType`

**Bidang**
+ `SupportedAuthenticationTypes` – *Wajib:* Susunan string UTF-8.

  Daftar jenis otentikasi yang didukung.
+ `SupportedDataOperations` – *Wajib:* Susunan string UTF-8.

  Daftar operasi data yang didukung.
+ `SupportedComputeEnvironments` – *Wajib:* Susunan string UTF-8.

  Daftar lingkungan komputasi yang didukung.

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

Objek yang mendefinisikan jenis koneksi untuk lingkungan komputasi.

**Bidang**
+ `Name`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

  Nama properti.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak lebih dari 1024 byte.

  Deskripsi properti.
+ `Required` – *Wajib:* Boolean.

  Menunjukkan apakah properti diperlukan.
+ `PropertyTypes` – *Wajib:* Susunan string UTF-8.

  Menjelaskan jenis properti.
+ `AllowedValues` – Susunan objek [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue).

  Daftar `AllowedValue` objek yang mewakili nilai yang diizinkan untuk properti.
+ `DataOperationScopes` – Susunan string UTF-8.

  Menunjukkan operasi data mana yang berlaku untuk properti.

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

Objek yang mewakili nilai yang diizinkan untuk properti.

**Bidang**
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.

  Deskripsi nilai yang diizinkan.
+ `Value`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

  Nilai yang diizinkan untuk properti.

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

Objek yang berisi konfigurasi untuk lingkungan komputasi (seperti Spark, Python, atau Athena) yang dikembalikan oleh API. `DescribeConnectionType`

**Bidang**
+ `Name`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

  Nama untuk konfigurasi lingkungan komputasi.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak lebih dari 1024 byte.

  Deskripsi lingkungan komputasi.
+ `ComputeEnvironment` – *Wajib:* String UTF-8 (nilai yang valid: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  Tipe lingkungan komputasi.
+ `SupportedAuthenticationTypes` – *Wajib:* Susunan string UTF-8.

  Jenis otentikasi yang didukung untuk lingkungan komputasi.
+ `ConnectionOptions` – *Wajib:* Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.

  Parameter yang digunakan sebagai opsi koneksi untuk lingkungan komputasi.
+ `ConnectionPropertyNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

  Nama properti koneksi diganti untuk lingkungan komputasi.
+ `ConnectionOptionNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

  Nama opsi koneksi menggantikan untuk lingkungan komputasi.
+ `ConnectionPropertiesRequiredOverrides`— *Diperlukan:*.

  Properti koneksi yang diperlukan sebagai penggantian untuk lingkungan komputasi.
+ `PhysicalConnectionPropertiesRequired` – Boolean.

  Menunjukkan `PhysicalConnectionProperties` apakah diperlukan untuk lingkungan komputasi.