0
# Connection Management
1

2
External data source connections for accessing data outside Google Cloud, including database connections, cloud storage from other providers, and hybrid environments.
3

4
## Capabilities
5

6
### Connection Operations
7

8
```python { .api }
9
def create_connection(
10
    request: dlp.CreateConnectionRequest,
11
    *,
12
    parent: Optional[str] = None,
13
    connection: Optional[dlp.Connection] = None,
14
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
15
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
16
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
17
) -> dlp.Connection: ...
18

19
def get_connection(
20
    request: dlp.GetConnectionRequest,
21
    *,
22
    name: Optional[str] = None,
23
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
24
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
25
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
26
) -> dlp.Connection: ...
27

28
def list_connections(
29
    request: dlp.ListConnectionsRequest,
30
    *,
31
    parent: Optional[str] = None,
32
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
33
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
34
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
35
) -> pagers.ListConnectionsPager: ...
36

37
def search_connections(
38
    request: dlp.SearchConnectionsRequest,
39
    *,
40
    parent: Optional[str] = None,
41
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
42
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
43
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
44
) -> pagers.SearchConnectionsPager: ...
45

46
def update_connection(
47
    request: dlp.UpdateConnectionRequest,
48
    *,
49
    name: Optional[str] = None,
50
    connection: Optional[dlp.Connection] = None,
51
    update_mask: Optional[field_mask_pb2.FieldMask] = None,
52
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
53
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
54
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
55
) -> dlp.Connection: ...
56

57
def delete_connection(
58
    request: dlp.DeleteConnectionRequest,
59
    *,
60
    name: Optional[str] = None,
61
    retry: OptionalRetry = gapic_v1.method.DEFAULT,
62
    timeout: Union[float, object] = gapic_v1.method.DEFAULT,
63
    metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
64
) -> None: ...
65
```
66

67
## Types
68

69
```python { .api }
70
class Connection:
71
    """External data source connection."""
72
    
73
    name: str
74
    create_time: timestamp_pb2.Timestamp
75
    state: ConnectionState
76
    errors: Sequence[Error]
77
    cloud_sql: CloudSqlProperties
78

79
class CloudSqlProperties:
80
    """Cloud SQL connection properties."""
81
    
82
    connection_name: str
83
    username_password: CloudSqlIamCredential
84
    cloud_sql_iam: CloudSqlIamCredential
85
    max_connections: int
86
    database_engine: CloudSqlProperties.DatabaseEngine
87

88
class CloudSqlIamCredential:
89
    """Cloud SQL IAM credentials."""
90
    
91
    username: str
92
    password: SecretManagerCredential
93
```