1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="connectors_v1.html">Connectors API</a> . <a href="connectors_v1.projects.html">projects</a> . <a href="connectors_v1.projects.locations.html">locations</a> . <a href="connectors_v1.projects.locations.global_.html">global_</a> . <a href="connectors_v1.projects.locations.global_.providers.html">providers</a> . <a href="connectors_v1.projects.locations.global_.providers.connectors.html">connectors</a> . <a href="connectors_v1.projects.locations.global_.providers.connectors.versions.html">versions</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#get">get(name, view=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Gets details of a single connector version.</p> 83<p class="toc_element"> 84 <code><a href="#list">list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p> 85<p class="firstline">Lists Connector Versions in a given project and location.</p> 86<p class="toc_element"> 87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 88<p class="firstline">Retrieves the next page of results.</p> 89<h3>Method Details</h3> 90<div class="method"> 91 <code class="details" id="close">close()</code> 92 <pre>Close httplib2 connections.</pre> 93</div> 94 95<div class="method"> 96 <code class="details" id="get">get(name, view=None, x__xgafv=None)</code> 97 <pre>Gets details of a single connector version. 98 99Args: 100 name: string, Required. Resource name of the form: `projects/*/locations/*/providers/*/connectors/*/versions/*` (required) 101 view: string, Specifies which fields of the ConnectorVersion are returned in the response. Defaults to `CUSTOMER` view. 102 Allowed values 103 CONNECTOR_VERSION_VIEW_UNSPECIFIED - CONNECTOR_VERSION_VIEW_UNSPECIFIED. 104 CONNECTOR_VERSION_VIEW_BASIC - Do not include role grant configs. 105 CONNECTOR_VERSION_VIEW_FULL - Include role grant configs. 106 x__xgafv: string, V1 error format. 107 Allowed values 108 1 - v1 error format 109 2 - v2 error format 110 111Returns: 112 An object of the form: 113 114 { # ConnectorVersion indicates a specific version of a connector. 115 "authConfigTemplates": [ # Output only. List of auth configs supported by the Connector Version. 116 { # AuthConfigTemplate defines required field over an authentication type. 117 "authType": "A String", # The type of authentication configured. 118 "configVariableTemplates": [ # Config variables to describe an `AuthConfig` for a `Connection`. 119 { # ConfigVariableTemplate provides metadata about a `ConfigVariable` that is used in a Connection. 120 "description": "A String", # Description. 121 "displayName": "A String", # Display name of the parameter. 122 "key": "A String", # Key of the config variable. 123 "required": True or False, # Flag represents that this `ConfigVariable` must be provided for a connection. 124 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Role grant configuration for the config variable. 125 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 126 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 127 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 128 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 129 "type": "A String", # Different types of resource supported. 130 }, 131 "roles": [ # List of roles that need to be granted. 132 "A String", 133 ], 134 }, 135 "validationRegex": "A String", # Regular expression in RE2 syntax used for validating the `value` of a `ConfigVariable`. 136 "valueType": "A String", # Type of the parameter: string, int, bool etc. consider custom type for the benefit for the validation. 137 }, 138 ], 139 }, 140 ], 141 "configVariableTemplates": [ # Output only. List of config variables needed to create a connection. 142 { # ConfigVariableTemplate provides metadata about a `ConfigVariable` that is used in a Connection. 143 "description": "A String", # Description. 144 "displayName": "A String", # Display name of the parameter. 145 "key": "A String", # Key of the config variable. 146 "required": True or False, # Flag represents that this `ConfigVariable` must be provided for a connection. 147 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Role grant configuration for the config variable. 148 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 149 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 150 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 151 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 152 "type": "A String", # Different types of resource supported. 153 }, 154 "roles": [ # List of roles that need to be granted. 155 "A String", 156 ], 157 }, 158 "validationRegex": "A String", # Regular expression in RE2 syntax used for validating the `value` of a `ConfigVariable`. 159 "valueType": "A String", # Type of the parameter: string, int, bool etc. consider custom type for the benefit for the validation. 160 }, 161 ], 162 "createTime": "A String", # Output only. Created time. 163 "displayName": "A String", # Output only. Display name. 164 "egressControlConfig": { # Egress control config for connector runtime. These configurations define the rules to identify which outbound domains/hosts needs to be whitelisted. It may be a static information for a particular connector version or it is derived from the configurations provided by the customer in Connection resource. # Output only. Configuration for Egress Control. 165 "backends": "A String", # Static Comma separated backends which are common for all Connection resources. Supported formats for each backend are host:port or just host (host can be ip address or domain name). 166 "extractionRules": { # Extraction Rules to identity the backends from customer provided configuration in Connection resource. # Extractions Rules to extract the backends from customer provided configuration. 167 "extractionRule": [ # Collection of Extraction Rule. 168 { # Extraction Rule. 169 "extractionRegex": "A String", # Regex used to extract backend details from source. If empty, whole source value will be used. 170 "source": { # Source to extract the backend from. # Source on which the rule is applied. 171 "fieldId": "A String", # Field identifier. For example config vaiable name. 172 "sourceType": "A String", # Type of the source. 173 }, 174 }, 175 ], 176 }, 177 }, 178 "labels": { # Output only. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources 179 "a_key": "A String", 180 }, 181 "launchStage": "A String", # Output only. Flag to mark the version indicating the launch stage. 182 "name": "A String", # Output only. Resource name of the Version. Format: projects/{project}/locations/{location}/providers/{provider}/connectors/{connector}/versions/{version} 183 "releaseVersion": "A String", # Output only. ReleaseVersion of the connector, for example: "1.0.1-alpha". 184 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Output only. Role grant configuration for this config variable. It will be DEPRECATED soon. 185 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 186 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 187 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 188 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 189 "type": "A String", # Different types of resource supported. 190 }, 191 "roles": [ # List of roles that need to be granted. 192 "A String", 193 ], 194 }, 195 "roleGrants": [ # Output only. Role grant configurations for this connector version. 196 { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. 197 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 198 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 199 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 200 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 201 "type": "A String", # Different types of resource supported. 202 }, 203 "roles": [ # List of roles that need to be granted. 204 "A String", 205 ], 206 }, 207 ], 208 "supportedRuntimeFeatures": { # Supported runtime features of a connector version. This is passed to the management layer to add a new connector version by the connector developer. Details about how this proto is passed to the management layer is covered in this doc - go/runtime-manifest. # Output only. Information about the runtime features supported by the Connector. 209 "actionApis": True or False, # Specifies if the connector supports action apis like 'executeAction'. 210 "entityApis": True or False, # Specifies if the connector supports entity apis like 'createEntity'. 211 "sqlQuery": True or False, # Specifies if the connector supports 'ExecuteSqlQuery' operation. 212 }, 213 "updateTime": "A String", # Output only. Updated time. 214}</pre> 215</div> 216 217<div class="method"> 218 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code> 219 <pre>Lists Connector Versions in a given project and location. 220 221Args: 222 parent: string, Required. Parent resource of the connectors, of the form: `projects/*/locations/*/providers/*/connectors/*` (required) 223 pageSize: integer, Page size. 224 pageToken: string, Page token. 225 view: string, Specifies which fields of the ConnectorVersion are returned in the response. Defaults to `CUSTOMER` view. 226 Allowed values 227 CONNECTOR_VERSION_VIEW_UNSPECIFIED - CONNECTOR_VERSION_VIEW_UNSPECIFIED. 228 CONNECTOR_VERSION_VIEW_BASIC - Do not include role grant configs. 229 CONNECTOR_VERSION_VIEW_FULL - Include role grant configs. 230 x__xgafv: string, V1 error format. 231 Allowed values 232 1 - v1 error format 233 2 - v2 error format 234 235Returns: 236 An object of the form: 237 238 { # Response message for Connectors.ListConnectorVersions. 239 "connectorVersions": [ # A list of connector versions. 240 { # ConnectorVersion indicates a specific version of a connector. 241 "authConfigTemplates": [ # Output only. List of auth configs supported by the Connector Version. 242 { # AuthConfigTemplate defines required field over an authentication type. 243 "authType": "A String", # The type of authentication configured. 244 "configVariableTemplates": [ # Config variables to describe an `AuthConfig` for a `Connection`. 245 { # ConfigVariableTemplate provides metadata about a `ConfigVariable` that is used in a Connection. 246 "description": "A String", # Description. 247 "displayName": "A String", # Display name of the parameter. 248 "key": "A String", # Key of the config variable. 249 "required": True or False, # Flag represents that this `ConfigVariable` must be provided for a connection. 250 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Role grant configuration for the config variable. 251 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 252 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 253 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 254 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 255 "type": "A String", # Different types of resource supported. 256 }, 257 "roles": [ # List of roles that need to be granted. 258 "A String", 259 ], 260 }, 261 "validationRegex": "A String", # Regular expression in RE2 syntax used for validating the `value` of a `ConfigVariable`. 262 "valueType": "A String", # Type of the parameter: string, int, bool etc. consider custom type for the benefit for the validation. 263 }, 264 ], 265 }, 266 ], 267 "configVariableTemplates": [ # Output only. List of config variables needed to create a connection. 268 { # ConfigVariableTemplate provides metadata about a `ConfigVariable` that is used in a Connection. 269 "description": "A String", # Description. 270 "displayName": "A String", # Display name of the parameter. 271 "key": "A String", # Key of the config variable. 272 "required": True or False, # Flag represents that this `ConfigVariable` must be provided for a connection. 273 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Role grant configuration for the config variable. 274 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 275 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 276 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 277 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 278 "type": "A String", # Different types of resource supported. 279 }, 280 "roles": [ # List of roles that need to be granted. 281 "A String", 282 ], 283 }, 284 "validationRegex": "A String", # Regular expression in RE2 syntax used for validating the `value` of a `ConfigVariable`. 285 "valueType": "A String", # Type of the parameter: string, int, bool etc. consider custom type for the benefit for the validation. 286 }, 287 ], 288 "createTime": "A String", # Output only. Created time. 289 "displayName": "A String", # Output only. Display name. 290 "egressControlConfig": { # Egress control config for connector runtime. These configurations define the rules to identify which outbound domains/hosts needs to be whitelisted. It may be a static information for a particular connector version or it is derived from the configurations provided by the customer in Connection resource. # Output only. Configuration for Egress Control. 291 "backends": "A String", # Static Comma separated backends which are common for all Connection resources. Supported formats for each backend are host:port or just host (host can be ip address or domain name). 292 "extractionRules": { # Extraction Rules to identity the backends from customer provided configuration in Connection resource. # Extractions Rules to extract the backends from customer provided configuration. 293 "extractionRule": [ # Collection of Extraction Rule. 294 { # Extraction Rule. 295 "extractionRegex": "A String", # Regex used to extract backend details from source. If empty, whole source value will be used. 296 "source": { # Source to extract the backend from. # Source on which the rule is applied. 297 "fieldId": "A String", # Field identifier. For example config vaiable name. 298 "sourceType": "A String", # Type of the source. 299 }, 300 }, 301 ], 302 }, 303 }, 304 "labels": { # Output only. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources 305 "a_key": "A String", 306 }, 307 "launchStage": "A String", # Output only. Flag to mark the version indicating the launch stage. 308 "name": "A String", # Output only. Resource name of the Version. Format: projects/{project}/locations/{location}/providers/{provider}/connectors/{connector}/versions/{version} 309 "releaseVersion": "A String", # Output only. ReleaseVersion of the connector, for example: "1.0.1-alpha". 310 "roleGrant": { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. # Output only. Role grant configuration for this config variable. It will be DEPRECATED soon. 311 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 312 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 313 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 314 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 315 "type": "A String", # Different types of resource supported. 316 }, 317 "roles": [ # List of roles that need to be granted. 318 "A String", 319 ], 320 }, 321 "roleGrants": [ # Output only. Role grant configurations for this connector version. 322 { # This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user. 323 "helperTextTemplate": "A String", # Template that UI can use to provide helper text to customers. 324 "principal": "A String", # Prinicipal/Identity for whom the role need to assigned. 325 "resource": { # Resource definition # Resource on which the roles needs to be granted for the principal. 326 "pathTemplate": "A String", # Template to uniquely represent a GCP resource in a format IAM expects This is a template that can have references to other values provided in the config variable template. 327 "type": "A String", # Different types of resource supported. 328 }, 329 "roles": [ # List of roles that need to be granted. 330 "A String", 331 ], 332 }, 333 ], 334 "supportedRuntimeFeatures": { # Supported runtime features of a connector version. This is passed to the management layer to add a new connector version by the connector developer. Details about how this proto is passed to the management layer is covered in this doc - go/runtime-manifest. # Output only. Information about the runtime features supported by the Connector. 335 "actionApis": True or False, # Specifies if the connector supports action apis like 'executeAction'. 336 "entityApis": True or False, # Specifies if the connector supports entity apis like 'createEntity'. 337 "sqlQuery": True or False, # Specifies if the connector supports 'ExecuteSqlQuery' operation. 338 }, 339 "updateTime": "A String", # Output only. Updated time. 340 }, 341 ], 342 "nextPageToken": "A String", # Next page token. 343 "unreachable": [ # Locations that could not be reached. 344 "A String", 345 ], 346}</pre> 347</div> 348 349<div class="method"> 350 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 351 <pre>Retrieves the next page of results. 352 353Args: 354 previous_request: The request for the previous page. (required) 355 previous_response: The response from the request for the previous page. (required) 356 357Returns: 358 A request object that you can call 'execute()' on to request the next 359 page. Returns None if there are no more items in the collection. 360 </pre> 361</div> 362 363</body></html>