Close httplib2 connections.
create(parent, body=None, connectorConfigId=None, x__xgafv=None)
Creates a connector config.
delete(name, etag=None, x__xgafv=None)
Deletes a connector config.
Gets a connector config with customer ID and config ID.
list(parent, pageSize=None, pageToken=None, x__xgafv=None)
Lists connector configs of a customer.
Retrieves the next page of results.
close()
Close httplib2 connections.
create(parent, body=None, connectorConfigId=None, x__xgafv=None)
Creates a connector config.
Args:
parent: string, Required. Format: customers/{customer} (required)
body: object, The request body.
The object takes the form of:
{ # A representation of a connector config.
"details": { # The details of the connector config. LINT.IfChange # Required. The details of the connector config.
"crowdStrikeConfig": { # CrowdStrike connector config. # CrowdStrike connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeFalconNextGenConfig": { # CrowdStrike Falcon Next Gen connector config. # CrowdStrike Falcon Next Gen connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike Falcon Next Gen config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeXdrConfig": { # CrowdStrike XDR connector config. # CrowdStrike XDR connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the CrowdStrike XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"deviceTrustConfig": { # Device trust config for device trust connectors. # Device trust connector config.
"scope": "A String", # Required. The scope at which this configuration will be applied. Note that this only applies to Chrome browser, as in ChromeOS it's always applied.
"serviceAccounts": [ # Required. A list of email addresses of the service accounts which are allowed to call the Verified Access API with full access.
"A String",
],
"serviceProvider": "A String", # Optional. The service provider for the device trust connector.
"urlMatchers": [ # Required. List of URLs allowed to be part of the attestation flow to get the set of signals from the machine. URLs must have HTTPS scheme, e.g. "https://example.com". Wildcards, *, are allowed. For detailed information on valid URL patterns, please see https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
"A String",
],
},
"googleSecOpsConfig": { # Google SecOps connector config. # Google SecOps connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host of ingestion API endpoint. Allows customer to upload events to servers in specific geographical regions. Existing configs that don't have this setting default to US.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Google SecOps config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"paloAltoNetworksConfig": { # Palo Alto Networks connector config. # Palo Alto Networks connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Palo Alto Networks config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"pubSubConfig": { # Pub/Sub connector config. # Pub/Sub connector config.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Pub/Sub config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
},
"pubSubXdrConfig": { # Pub/Sub XDR connector config. # Pub/Sub XDR connector config.
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the Pub/Sub XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"splunkConfig": { # Splunk connector config. # Splunk connector config.
"hecToken": "A String", # Required. Input only. The data input's HTTP Event Collector token to use as an Authorization header.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"portNumber": 42, # Optional. The port number to use. If not set, the default Splunk port is used.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Splunk config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"source": "A String", # Optional. Optional source name to override the default one set in the Splunk admin console.
"unsecureScheme": True or False, # Optional. Whether to use an unsecure HTTP scheme. Defaults to false (HTTPS).
},
},
"displayName": "A String", # Required. The display name of the config.
"etag": "A String", # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
"name": "A String", # Identifier. Format: customers/{customer}/connectorConfigs/{connector_config}
"status": { # The status of the connector config. # Output only. The status of the connector config.
"failureStartTime": "A String", # Output only. Field recording time of the earliest failure since the last success event. This field is only set when the state is `DISABLED_BY_FAILURES`.
"state": "A String", # Output only. The state of the connector config. The connector state is disabled if the connector has not successfully sent an event in the last 24 hours.
"updateTime": "A String", # Output only. Field recording time of most recent modification of the status. For ENABLED, this is the time the status was changed to ENABLED. For DISABLED_BY_FAILURES, this is the time of the most recent failed attempt to send an event to this config.
},
"type": "A String", # Required. The type of the connector.
}
connectorConfigId: string, Optional. ID to use for the connector config, which becomes the final component of the connector config's resource name. If provided, the ID must be 1-63 characters long, and contain only lowercase letters, digits, and hyphens. It must start with a letter, and end with a letter or number. If not provided, the connector config will be assigned a random UUID.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A representation of a connector config.
"details": { # The details of the connector config. LINT.IfChange # Required. The details of the connector config.
"crowdStrikeConfig": { # CrowdStrike connector config. # CrowdStrike connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeFalconNextGenConfig": { # CrowdStrike Falcon Next Gen connector config. # CrowdStrike Falcon Next Gen connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike Falcon Next Gen config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeXdrConfig": { # CrowdStrike XDR connector config. # CrowdStrike XDR connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the CrowdStrike XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"deviceTrustConfig": { # Device trust config for device trust connectors. # Device trust connector config.
"scope": "A String", # Required. The scope at which this configuration will be applied. Note that this only applies to Chrome browser, as in ChromeOS it's always applied.
"serviceAccounts": [ # Required. A list of email addresses of the service accounts which are allowed to call the Verified Access API with full access.
"A String",
],
"serviceProvider": "A String", # Optional. The service provider for the device trust connector.
"urlMatchers": [ # Required. List of URLs allowed to be part of the attestation flow to get the set of signals from the machine. URLs must have HTTPS scheme, e.g. "https://example.com". Wildcards, *, are allowed. For detailed information on valid URL patterns, please see https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
"A String",
],
},
"googleSecOpsConfig": { # Google SecOps connector config. # Google SecOps connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host of ingestion API endpoint. Allows customer to upload events to servers in specific geographical regions. Existing configs that don't have this setting default to US.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Google SecOps config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"paloAltoNetworksConfig": { # Palo Alto Networks connector config. # Palo Alto Networks connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Palo Alto Networks config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"pubSubConfig": { # Pub/Sub connector config. # Pub/Sub connector config.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Pub/Sub config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
},
"pubSubXdrConfig": { # Pub/Sub XDR connector config. # Pub/Sub XDR connector config.
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the Pub/Sub XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"splunkConfig": { # Splunk connector config. # Splunk connector config.
"hecToken": "A String", # Required. Input only. The data input's HTTP Event Collector token to use as an Authorization header.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"portNumber": 42, # Optional. The port number to use. If not set, the default Splunk port is used.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Splunk config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"source": "A String", # Optional. Optional source name to override the default one set in the Splunk admin console.
"unsecureScheme": True or False, # Optional. Whether to use an unsecure HTTP scheme. Defaults to false (HTTPS).
},
},
"displayName": "A String", # Required. The display name of the config.
"etag": "A String", # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
"name": "A String", # Identifier. Format: customers/{customer}/connectorConfigs/{connector_config}
"status": { # The status of the connector config. # Output only. The status of the connector config.
"failureStartTime": "A String", # Output only. Field recording time of the earliest failure since the last success event. This field is only set when the state is `DISABLED_BY_FAILURES`.
"state": "A String", # Output only. The state of the connector config. The connector state is disabled if the connector has not successfully sent an event in the last 24 hours.
"updateTime": "A String", # Output only. Field recording time of most recent modification of the status. For ENABLED, this is the time the status was changed to ENABLED. For DISABLED_BY_FAILURES, this is the time of the most recent failed attempt to send an event to this config.
},
"type": "A String", # Required. The type of the connector.
}
delete(name, etag=None, x__xgafv=None)
Deletes a connector config.
Args:
name: string, Required. Format: customers/{customer}/connectorConfigs/{connector_config} (required)
etag: string, Optional. The etag of the connector config. If an etag is provided and does not match the current etag of the connector config, deletion will be blocked and an ABORTED error will be returned.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
get(name, x__xgafv=None)
Gets a connector config with customer ID and config ID.
Args:
name: string, Required. Format: customers/{customer}/connectorConfigs/{connector_config} (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A representation of a connector config.
"details": { # The details of the connector config. LINT.IfChange # Required. The details of the connector config.
"crowdStrikeConfig": { # CrowdStrike connector config. # CrowdStrike connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeFalconNextGenConfig": { # CrowdStrike Falcon Next Gen connector config. # CrowdStrike Falcon Next Gen connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike Falcon Next Gen config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeXdrConfig": { # CrowdStrike XDR connector config. # CrowdStrike XDR connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the CrowdStrike XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"deviceTrustConfig": { # Device trust config for device trust connectors. # Device trust connector config.
"scope": "A String", # Required. The scope at which this configuration will be applied. Note that this only applies to Chrome browser, as in ChromeOS it's always applied.
"serviceAccounts": [ # Required. A list of email addresses of the service accounts which are allowed to call the Verified Access API with full access.
"A String",
],
"serviceProvider": "A String", # Optional. The service provider for the device trust connector.
"urlMatchers": [ # Required. List of URLs allowed to be part of the attestation flow to get the set of signals from the machine. URLs must have HTTPS scheme, e.g. "https://example.com". Wildcards, *, are allowed. For detailed information on valid URL patterns, please see https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
"A String",
],
},
"googleSecOpsConfig": { # Google SecOps connector config. # Google SecOps connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host of ingestion API endpoint. Allows customer to upload events to servers in specific geographical regions. Existing configs that don't have this setting default to US.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Google SecOps config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"paloAltoNetworksConfig": { # Palo Alto Networks connector config. # Palo Alto Networks connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Palo Alto Networks config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"pubSubConfig": { # Pub/Sub connector config. # Pub/Sub connector config.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Pub/Sub config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
},
"pubSubXdrConfig": { # Pub/Sub XDR connector config. # Pub/Sub XDR connector config.
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the Pub/Sub XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"splunkConfig": { # Splunk connector config. # Splunk connector config.
"hecToken": "A String", # Required. Input only. The data input's HTTP Event Collector token to use as an Authorization header.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"portNumber": 42, # Optional. The port number to use. If not set, the default Splunk port is used.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Splunk config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"source": "A String", # Optional. Optional source name to override the default one set in the Splunk admin console.
"unsecureScheme": True or False, # Optional. Whether to use an unsecure HTTP scheme. Defaults to false (HTTPS).
},
},
"displayName": "A String", # Required. The display name of the config.
"etag": "A String", # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
"name": "A String", # Identifier. Format: customers/{customer}/connectorConfigs/{connector_config}
"status": { # The status of the connector config. # Output only. The status of the connector config.
"failureStartTime": "A String", # Output only. Field recording time of the earliest failure since the last success event. This field is only set when the state is `DISABLED_BY_FAILURES`.
"state": "A String", # Output only. The state of the connector config. The connector state is disabled if the connector has not successfully sent an event in the last 24 hours.
"updateTime": "A String", # Output only. Field recording time of most recent modification of the status. For ENABLED, this is the time the status was changed to ENABLED. For DISABLED_BY_FAILURES, this is the time of the most recent failed attempt to send an event to this config.
},
"type": "A String", # Required. The type of the connector.
}
list(parent, pageSize=None, pageToken=None, x__xgafv=None)
Lists connector configs of a customer.
Args:
parent: string, Required. Format: customers/{customer} (required)
pageSize: integer, Optional. The maximum number of connector configs to return. The default page size is 50 if page_size is unspecified, and the maximum page size allowed is 100. Values above 100 will be capped at 100.
pageToken: string, Optional. A page token, received from a previous `ListConnectorConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConnectorConfigs` must match the call that provided the page token.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response to ListConnectorConfigs method.
"connectorConfigs": [ # The list of connector configs returned.
{ # A representation of a connector config.
"details": { # The details of the connector config. LINT.IfChange # Required. The details of the connector config.
"crowdStrikeConfig": { # CrowdStrike connector config. # CrowdStrike connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeFalconNextGenConfig": { # CrowdStrike Falcon Next Gen connector config. # CrowdStrike Falcon Next Gen connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the CrowdStrike Falcon Next Gen config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"crowdStrikeXdrConfig": { # CrowdStrike XDR connector config. # CrowdStrike XDR connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the CrowdStrike XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"deviceTrustConfig": { # Device trust config for device trust connectors. # Device trust connector config.
"scope": "A String", # Required. The scope at which this configuration will be applied. Note that this only applies to Chrome browser, as in ChromeOS it's always applied.
"serviceAccounts": [ # Required. A list of email addresses of the service accounts which are allowed to call the Verified Access API with full access.
"A String",
],
"serviceProvider": "A String", # Optional. The service provider for the device trust connector.
"urlMatchers": [ # Required. List of URLs allowed to be part of the attestation flow to get the set of signals from the machine. URLs must have HTTPS scheme, e.g. "https://example.com". Wildcards, *, are allowed. For detailed information on valid URL patterns, please see https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
"A String",
],
},
"googleSecOpsConfig": { # Google SecOps connector config. # Google SecOps connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host of ingestion API endpoint. Allows customer to upload events to servers in specific geographical regions. Existing configs that don't have this setting default to US.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Google SecOps config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"paloAltoNetworksConfig": { # Palo Alto Networks connector config. # Palo Alto Networks connector config.
"apiKey": "A String", # Required. Input only. API key to use on the ingestion API.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Palo Alto Networks config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
},
"pubSubConfig": { # Pub/Sub connector config. # Pub/Sub connector config.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Pub/Sub config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
},
"pubSubXdrConfig": { # Pub/Sub XDR connector config. # Pub/Sub XDR connector config.
"topicFullPath": "A String", # Required. The full path to the topic to send the event to.
"xdrSettings": { # XDR settings for connector configs. # Required. The XDR settings for the Pub/Sub XDR config.
"enableAllXdrEvents": True or False, # Required. Whether to enable all XDR events.
},
},
"splunkConfig": { # Splunk connector config. # Splunk connector config.
"hecToken": "A String", # Required. Input only. The data input's HTTP Event Collector token to use as an Authorization header.
"host": "A String", # Required. Host to identify the customer specific server to receive the events.
"portNumber": 42, # Optional. The port number to use. If not set, the default Splunk port is used.
"reportingSettings": { # Reporting settings for connector configs. # Required. The reporting settings for the Splunk config.
"enabledDefaultEvents": [ # Optional. The list of user and browser events that are enabled for this connector. An empty list disables all default events, and using `ALL_DEFAULT_EVENTS` will enable all default events.
"A String",
],
"enabledDeviceEvents": [ # Optional. The list of device events that are enabled for this config. An empty list disables all device events, and using `ALL_DEVICE_EVENTS` will enable all device events.
"A String",
],
"enabledOptInEvents": [ # Optional. The list of opt-in events that are enabled for this config. An empty list disables all opt-in events, and using `ALL_OPT_IN_EVENTS` will enable all opt-in events.
"A String",
],
},
"source": "A String", # Optional. Optional source name to override the default one set in the Splunk admin console.
"unsecureScheme": True or False, # Optional. Whether to use an unsecure HTTP scheme. Defaults to false (HTTPS).
},
},
"displayName": "A String", # Required. The display name of the config.
"etag": "A String", # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
"name": "A String", # Identifier. Format: customers/{customer}/connectorConfigs/{connector_config}
"status": { # The status of the connector config. # Output only. The status of the connector config.
"failureStartTime": "A String", # Output only. Field recording time of the earliest failure since the last success event. This field is only set when the state is `DISABLED_BY_FAILURES`.
"state": "A String", # Output only. The state of the connector config. The connector state is disabled if the connector has not successfully sent an event in the last 24 hours.
"updateTime": "A String", # Output only. Field recording time of most recent modification of the status. For ENABLED, this is the time the status was changed to ENABLED. For DISABLED_BY_FAILURES, this is the time of the most recent failed attempt to send an event to this config.
},
"type": "A String", # Required. The type of the connector.
},
],
"nextPageToken": "A String", # The page token used to retrieve the next page of the listing request. If the token is empty, there are no more pages to retrieve.
"totalSize": 42, # The total size of the connector configs list.
}
list_next()
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.