v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB

GCP Integration

Update a GCP integration

This endpoint is deprecated – use the V2 endpoints instead. Update a Datadog-GCP integrations host_filters and/or auto-mute. Requires a project_id and client_email, however these fields cannot be updated. If you need to update these fields, delete and use the create (POST) endpoint. The unspecified fields will keep their original values.

put/api/v1/integration/gcp

Request body

auth_provider_x509_cert_urlstring

Should be https://www.googleapis.com/oauth2/v1/certs.

auth_uristring

Should be https://accounts.google.com/o/oauth2/auth.

automuteboolean

Silence monitors for expected GCE instance shutdowns.

client_emailstring

Your email found in your JSON service account key.

client_idstring

Your ID found in your JSON service account key.

client_x509_cert_urlstring

Should be https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL where $CLIENT_EMAIL is the email found in your JSON service account key.

cloud_run_revision_filtersstring[]

List of filters to limit the Cloud Run revisions that are pulled into Datadog by using tags. Only Cloud Run revision resources that apply to specified filters are imported into Datadog. Note: This field is deprecated. Instead, use monitored_resource_configs with type=cloud_run_revision

errorsstring[]

An array of errors.

host_filtersstring

A comma-separated list of filters to limit the VM instances that are pulled into Datadog by using tags. Only VM instance resources that apply to specified filters are imported into Datadog. Note: This field is deprecated. Instead, use monitored_resource_configs with type=gce_instance

is_cspm_enabledboolean

When enabled, Datadog will activate the Cloud Security Monitoring product for this service account. Note: This requires resource_collection_enabled to be set to true.

is_resource_change_collection_enabledboolean

When enabled, Datadog scans for all resource change data in your Google Cloud environment.

is_security_command_center_enabledboolean

When enabled, Datadog will attempt to collect Security Command Center Findings. Note: This requires additional permissions on the service account.

private_keystring

Your private key name found in your JSON service account key.

private_key_idstring

Your private key ID found in your JSON service account key.

project_idstring

Your Google Cloud project ID found in your JSON service account key.

resource_collection_enabledboolean

When enabled, Datadog scans for all resources in your GCP environment.

token_uristring

Should be https://accounts.google.com/o/oauth2/token.

typestring

The value for service_account found in your JSON service account key.

Example request

{
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "client_email": "api-dev@datadog-sandbox.iam.gserviceaccount.com",
  "client_id": "123456712345671234567",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL",
  "cloud_run_revision_filters": [
    "$KEY:$VALUE"
  ],
  "errors": [
    "*"
  ],
  "host_filters": "$KEY1:$VALUE1,$KEY2:$VALUE2",
  "is_cspm_enabled": true,
  "is_resource_change_collection_enabled": true,
  "is_security_command_center_enabled": true,
  "monitored_resource_configs": [
    {
      "filters": [
        "$KEY:$VALUE"
      ],
      "type": "gce_instance"
    }
  ],
  "private_key": "private_key",
  "private_key_id": "123456789abcdefghi123456789abcdefghijklm",
  "project_id": "datadog-apitest",
  "resource_collection_enabled": true,
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "type": "service_account"
}

Response

object required

Example response

{}