yandex_datalens_connection (DataSource)
Written by
Updated at February 20, 2026
Retrieves information about a DataLens connection. For more information, see the official documentation.
Arguments & Attributes Reference
created_at(Read-Only) (String). The creation timestamp of the resource.description(String). The resource description.id(Read-Only) (String). The resource identifier.name(Required)(String). The resource name. Changing this attribute forces recreation of the resource.organization_id(String). The organization ID for the DataLens instance. If not specified, the provider-levelorganization_idis used.type(Required)(String). The connection type. Currently supported:ydb. Changing this attribute forces recreation of the resource.updated_at(Read-Only) (String). The last update timestamp of the resource.ydb[FW-Block]. Configuration for YDB connection type. Must be specified whentypeisydb.auth_type(String). The authentication type for the connection. Possible values:anonymous,password,oauth.cache_ttl_sec(Number). The cache TTL in seconds.nullmeans default caching behavior.cloud_id(Required)(String). The cloud ID where the YDB database is located.data_export_forbidden(String). Whether data export is forbidden. Possible values:on,off. Defaults tooff.db_name(Required)(String). The YDB database name (path).delegation_is_set(Bool). Whether delegation is configured for the connection.dir_path(String). The directory path where the connection entry will be stored (used when connections are organized in folders instead of workbooks). Eitherworkbook_idordir_pathmust be specified. Changing this attribute forces recreation of the resource.folder_id(Required)(String). The folder ID where the YDB database is located.host(Required)(String). The hostname of the YDB database endpoint.mdb_cluster_id(String). The Managed Databases cluster ID (for managed YDB instances).mdb_folder_id(String). The folder ID for Managed Databases cluster lookup.port(Required)(Number). The port number of the YDB database endpoint.raw_sql_level(String). The level of raw SQL queries allowed. Possible values:off,subselect,template,dashsql. Defaults tooff.service_account_id(Required)(String). The service account ID used to access the YDB database.ssl_ca(String). The SSL CA certificate for secure connections.ssl_enable(String). Whether SSL is enabled for the connection. Possible values:on,off. Defaults toon.token(String). The OAuth token for authentication (used whenauth_typeisoauth). This is a write-only field and will not be returned by the API.username(String). The username for authentication (used whenauth_typeispassword).workbook_id(String). The workbook ID where the connection will be created. Eitherworkbook_idordir_pathmust be specified. Changing this attribute forces recreation of the resource.