--- title: Create a GCP integration description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > GCP Integration --- # Create a GCP integration{% #create-a-gcp-integration %} Copy pageCopied {% tab title="v1" %} | Datadog site | API endpoint | | ----------------- | --------------------------------------------------------- | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/integration/gcp | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/integration/gcp | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v1/integration/gcp | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v1/integration/gcp | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v1/integration/gcp | | app.datadoghq.com | POST https://api.datadoghq.com/api/v1/integration/gcp | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/integration/gcp | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/integration/gcp | ### Overview This endpoint is deprecated – use the V2 endpoints instead. Create a Datadog-GCP integration. This endpoint requires the `gcp_configurations_manage` permission. ### Request #### Body Data (required) Create a Datadog-GCP integration. {% tab title="Model" %} | Parent field | Field | Type | Description | | -------------------------- | ------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | auth_provider_x509_cert_url | string | Should be `https://www.googleapis.com/oauth2/v1/certs`. | | | auth_uri | string | Should be `https://accounts.google.com/o/oauth2/auth`. | | | automute | boolean | Silence monitors for expected GCE instance shutdowns. | | | client_email | string | Your email found in your JSON service account key. | | | client_id | string | Your ID found in your JSON service account key. | | | client_x509_cert_url | string | 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_filters | [string] | **DEPRECATED**: 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` | | | errors | [string] | An array of errors. | | | host_filters | string | **DEPRECATED**: 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_enabled | boolean | 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_enabled | boolean | When enabled, Datadog scans for all resource change data in your Google Cloud environment. | | | is_security_command_center_enabled | boolean | When enabled, Datadog will attempt to collect Security Command Center Findings. Note: This requires additional permissions on the service account. | | | monitored_resource_configs | [object] | Configurations for GCP monitored resources. | | monitored_resource_configs | filters | [string] | List of filters to limit the monitored resources that are pulled into Datadog by using tags. Only monitored resources that apply to specified filters are imported into Datadog. | | monitored_resource_configs | type | enum | The GCP monitored resource type. Only a subset of resource types are supported. Allowed enum values: `cloud_function,cloud_run_revision,gce_instance` | | | private_key | string | Your private key name found in your JSON service account key. | | | private_key_id | string | Your private key ID found in your JSON service account key. | | | project_id | string | Your Google Cloud project ID found in your JSON service account key. | | | resource_collection_enabled | boolean | When enabled, Datadog scans for all resources in your GCP environment. | | | token_uri | string | Should be `https://accounts.google.com/o/oauth2/token`. | | | type | string | The value for service_account found in your JSON service account key. | {% /tab %} {% tab title="Example" %} ```json { "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "client_email": "252bf553ef04b351@example.com", "client_id": "163662907116366290710", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL", "host_filters": "key:value,filter:example", "cloud_run_revision_filters": [ "dr:dre" ], "is_cspm_enabled": true, "is_security_command_center_enabled": true, "is_resource_change_collection_enabled": true, "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" } ``` {% /tab %} ### Response {% tab title="200" %} OK {% tab title="Model" %} | Field | Type | Description | | ----- | ---- | ----------- | {% /tab %} {% tab title="Example" %} ```json {} ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Authentication error {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \## default # \# Curl command curl -X POST "https://api.datadoghq.com/api/v1/integration/gcp" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "client_email": "test@sandbox.iam.gserviceaccount.com", "client_id": "123456712345671234567", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL", "host_filters": "$KEY1:$VALUE1,$KEY2:$VALUE2", "is_cspm_enabled": true, "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" } EOF ##### ```go // Create a GCP integration returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { body := datadogV1.GCPAccount{ AuthProviderX509CertUrl: datadog.PtrString("https://www.googleapis.com/oauth2/v1/certs"), AuthUri: datadog.PtrString("https://accounts.google.com/o/oauth2/auth"), ClientEmail: datadog.PtrString("252bf553ef04b351@example.com"), ClientId: datadog.PtrString("163662907116366290710"), ClientX509CertUrl: datadog.PtrString("https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL"), HostFilters: datadog.PtrString("key:value,filter:example"), CloudRunRevisionFilters: []string{ "dr:dre", }, IsCspmEnabled: datadog.PtrBool(true), IsSecurityCommandCenterEnabled: datadog.PtrBool(true), IsResourceChangeCollectionEnabled: datadog.PtrBool(true), PrivateKey: datadog.PtrString("private_key"), PrivateKeyId: datadog.PtrString("123456789abcdefghi123456789abcdefghijklm"), ProjectId: datadog.PtrString("datadog-apitest"), ResourceCollectionEnabled: datadog.PtrBool(true), TokenUri: datadog.PtrString("https://accounts.google.com/o/oauth2/token"), Type: datadog.PtrString("service_account"), } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewGCPIntegrationApi(apiClient) resp, r, err := api.CreateGCPIntegration(ctx, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `GCPIntegrationApi.CreateGCPIntegration`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `GCPIntegrationApi.CreateGCPIntegration`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // Create a GCP integration returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.GcpIntegrationApi; import com.datadog.api.client.v1.model.GCPAccount; import java.util.Collections; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); GcpIntegrationApi apiInstance = new GcpIntegrationApi(defaultClient); GCPAccount body = new GCPAccount() .authProviderX509CertUrl("https://www.googleapis.com/oauth2/v1/certs") .authUri("https://accounts.google.com/o/oauth2/auth") .clientEmail("252bf553ef04b351@example.com") .clientId("163662907116366290710") .clientX509CertUrl("https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL") .hostFilters("key:value,filter:example") .cloudRunRevisionFilters(Collections.singletonList("dr:dre")) .isCspmEnabled(true) .isSecurityCommandCenterEnabled(true) .isResourceChangeCollectionEnabled(true) .privateKey("private_key") .privateKeyId("123456789abcdefghi123456789abcdefghijklm") .projectId("datadog-apitest") .resourceCollectionEnabled(true) .tokenUri("https://accounts.google.com/o/oauth2/token") .type("service_account"); try { apiInstance.createGCPIntegration(body); } catch (ApiException e) { System.err.println("Exception when calling GcpIntegrationApi#createGCPIntegration"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```python from datadog import initialize, api options = { 'api_key': '', 'app_key': '' } initialize(**options) api.GcpIntegration.create( type="service_account", project_id="", private_key_id="", private_key="", client_email="", client_id="", auth_uri="", token_uri="", auth_provider_x509_cert_url="", client_x509_cert_url="", host_filters=":,:" ) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python-legacy) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python "example.py" ##### ```python """ Create a GCP integration returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.gcp_integration_api import GCPIntegrationApi from datadog_api_client.v1.model.gcp_account import GCPAccount body = GCPAccount( auth_provider_x509_cert_url="https://www.googleapis.com/oauth2/v1/certs", auth_uri="https://accounts.google.com/o/oauth2/auth", client_email="252bf553ef04b351@example.com", client_id="163662907116366290710", client_x509_cert_url="https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL", host_filters="key:value,filter:example", cloud_run_revision_filters=[ "dr:dre", ], is_cspm_enabled=True, is_security_command_center_enabled=True, is_resource_change_collection_enabled=True, 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", ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = GCPIntegrationApi(api_client) response = api_instance.create_gcp_integration(body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby require 'rubygems' require 'dogapi' api_key = '' app_key = '' config= { "type": "service_account", "project_id": "", "private_key_id": "", "private_key": "", "client_email": "", "client_id": "", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/", "host_filters": ":,:" } dog = Dogapi::Client.new(api_key, app_key) dog.gcp_integration_create(config) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby-legacy) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```ruby # Create a GCP integration returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V1::GCPIntegrationAPI.new body = DatadogAPIClient::V1::GCPAccount.new({ auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs", auth_uri: "https://accounts.google.com/o/oauth2/auth", client_email: "252bf553ef04b351@example.com", client_id: "163662907116366290710", client_x509_cert_url: "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL", host_filters: "key:value,filter:example", cloud_run_revision_filters: [ "dr:dre", ], is_cspm_enabled: true, is_security_command_center_enabled: true, is_resource_change_collection_enabled: true, 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", }) p api_instance.create_gcp_integration(body) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```rust // Create a GCP integration returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_gcp_integration::GCPIntegrationAPI; use datadog_api_client::datadogV1::model::GCPAccount; #[tokio::main] async fn main() { let body = GCPAccount::new() .auth_provider_x509_cert_url("https://www.googleapis.com/oauth2/v1/certs".to_string()) .auth_uri("https://accounts.google.com/o/oauth2/auth".to_string()) .client_email("252bf553ef04b351@example.com".to_string()) .client_id("163662907116366290710".to_string()) .client_x509_cert_url( "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL".to_string(), ) .cloud_run_revision_filters(vec!["dr:dre".to_string()]) .host_filters("key:value,filter:example".to_string()) .is_cspm_enabled(true) .is_resource_change_collection_enabled(true) .is_security_command_center_enabled(true) .private_key("private_key".to_string()) .private_key_id("123456789abcdefghi123456789abcdefghijklm".to_string()) .project_id("datadog-apitest".to_string()) .resource_collection_enabled(true) .token_uri("https://accounts.google.com/o/oauth2/token".to_string()) .type_("service_account".to_string()); let configuration = datadog::Configuration::new(); let api = GCPIntegrationAPI::with_config(configuration); let resp = api.create_gcp_integration(body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Create a GCP integration returns "OK" response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.GCPIntegrationApi(configuration); const params: v1.GCPIntegrationApiCreateGCPIntegrationRequest = { body: { authProviderX509CertUrl: "https://www.googleapis.com/oauth2/v1/certs", authUri: "https://accounts.google.com/o/oauth2/auth", clientEmail: "252bf553ef04b351@example.com", clientId: "163662907116366290710", clientX509CertUrl: "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL", hostFilters: "key:value,filter:example", cloudRunRevisionFilters: ["dr:dre"], isCspmEnabled: true, isSecurityCommandCenterEnabled: true, isResourceChangeCollectionEnabled: true, privateKey: "private_key", privateKeyId: "123456789abcdefghi123456789abcdefghijklm", projectId: "datadog-apitest", resourceCollectionEnabled: true, tokenUri: "https://accounts.google.com/o/oauth2/token", type: "service_account", }, }; apiInstance .createGCPIntegration(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}