client

package module
v2.16.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 23, 2023 License: Apache-2.0 Imports: 0 Imported by: 0

README

datadog-api-client-go

This repository contains a Go API client for the Datadog API.

Requirements

  • Go 1.19+

Layout

This repository contains per-major-version API client packages. Right now, Datadog has two API versions, v1, v2 and the common package.

The API v1 Client

The client library for Datadog API v1 is located in the api/datadogV1 directory. Import it with

import "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
The API v2 Client

The client library for Datadog API v2 is located in the api/datadogV2 directory. Import it with

import "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
The Datadog Package

The datadog package for Datadog API is located in the api/datadog directory. Import it with

import "github.com/DataDog/datadog-api-client-go/v2/api/datadog"

Getting Started

Here's an example creating a user:

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/DataDog/datadog-api-client-go/v2/api/datadog"
    "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)

func main() {
    ctx := context.WithValue(
        context.Background(),
        datadog.ContextAPIKeys,
        map[string]datadog.APIKey{
            "apiKeyAuth": {
                Key: os.Getenv("DD_CLIENT_API_KEY"),
            },
            "appKeyAuth": {
                Key: os.Getenv("DD_CLIENT_APP_KEY"),
            },
        },
    )

    body := *datadogV2.NewUserCreateRequest(*datadogV2.NewUserCreateData(*datadogV2.NewUserCreateAttributes("jane.doe@example.com"), datadogV2.UsersType("users")))

    configuration := datadog.NewConfiguration()
    apiClient := datadog.NewAPIClient(configuration)
    usersApi := datadogV2.NewUsersApi(apiClient)

    resp, r, err := usersApi.CreateUser(ctx, body)
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error creating user: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    responseData := resp.GetData()
    fmt.Fprintf(os.Stdout, "User ID: %s", responseData.GetId())
}

Save it to example.go, then run go get github.com/DataDog/datadog-api-client-go/v2. Set the DD_CLIENT_API_KEY and DD_CLIENT_APP_KEY to your Datadog credentials, and then run go run example.go.

Unstable Endpoints

This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints:

    configuration.SetUnstableOperationEnabled("<APIVersion>.<OperationName>", true)

where <OperationName> is the name of the method used to interact with that endpoint. For example: GetLogsIndex, or UpdateLogsIndex

Changing Server

When talking to a different server, like the eu instance, change the ContextServerVariables:

    ctx = context.WithValue(ctx,
        datadog.ContextServerVariables,
        map[string]string{
            "site": "datadoghq.eu",
    })
Disable compressed payloads

If you want to disable GZIP compressed responses, set the compress flag on your configuration object:

    configuration.Compress = false
Enable requests logging

If you want to enable requests logging, set the debug flag on your configuration object:

    configuration.Debug = true
Enable retry

If you want to enable retry when getting status code 429 rate-limited, set EnableRetry to true

    configuration.RetryConfiguration.EnableRetry = true

The default max retry is 3, you can change it with MaxRetries

    configuration.RetryConfiguration.MaxRetries = 3
Configure proxy

If you want to configure proxy, set env var HTTP_PROXY, and HTTPS_PROXY or set custom HTTPClient with proxy configured on configuration object:

    proxyUrl, _ := url.Parse("http://127.0.0.1:80")
    configuration.HTTPClient = &http.Client{
        Transport: &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
    }
Pagination

Several listing operations have a pagination method to help consume all the items available. For example, to retrieve all your incidents:

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)

func main() {
	ctx := datadog.NewDefaultContext(context.Background())
	configuration := datadog.NewConfiguration()
	configuration.SetUnstableOperationEnabled("v2.ListIncidents", true)
	apiClient := datadog.NewAPIClient(configuration)
	incidentsApi := datadogV2.NewIncidentsApi(apiClient)

	resp, _ := incidentsApi.ListIncidentsWithPagination(ctx, *datadog.NewListIncidentsOptionalParameters())
	for paginationResult := range resp {
		if paginationResult.Error != nil {
			fmt.Fprintf(os.Stderr, "Error when calling `IncidentsApi.ListIncidentsWithPagination`: %v\n", paginationResult.Error)
		}
		responseContent, _ := json.MarshalIndent(paginationResult.Item, "", "  ")
		fmt.Fprintf(os.Stdout, "%s\n", responseContent)
	}

}

Documentation

Developer documentation for API endpoints and models is available on Github pages. Released versions are available on pkg.go.dev.

Contributing

As most of the code in this repository is generated, we will only accept PRs for files that are not modified by our code-generation machinery (changes to the generated files would get overwritten). We happily accept contributions to files that are not autogenerated, such as tests and development tooling.

Author

support@datadoghq.com

Documentation

Overview

Package datadog-api-client-go.

This repository contains a Go API client for the Datadog API (https://docs.datadoghq.com/api/).

Requirements

• Go 1.19+

Layout

This repository contains per-major-version API client packages. Right now, Datadog has two API versions, v1, v2 and the common package.

The API v1 Client

The client library for Datadog API v1 is located in the api/datadogV1 directory. Import it with 

import "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"

The API v2 Client

The client library for Datadog API v2 is located in the api/datadogV2 directory. Import it with 

import "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"

The Datadog Package

The datadog package for Datadog API is located in the api/datadog directory. Import it with 

import "github.com/DataDog/datadog-api-client-go/v2/api/datadog"

Getting Started

Here's an example creating a user: 

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/DataDog/datadog-api-client-go/v2/api/datadog"
    "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)

func main() {
    ctx := context.WithValue(
        context.Background(),
        datadog.ContextAPIKeys,
        map[string]datadog.APIKey{
            "apiKeyAuth": {
                Key: os.Getenv("DD_CLIENT_API_KEY"),
            },
            "appKeyAuth": {
                Key: os.Getenv("DD_CLIENT_APP_KEY"),
            },
        },
    )

    body := *datadogV2.NewUserCreateRequest(*datadogV2.NewUserCreateData(*datadogV2.NewUserCreateAttributes("jane.doe@example.com"), datadogV2.UsersType("users")))

    configuration := datadog.NewConfiguration()
    apiClient := datadog.NewAPIClient(configuration)
    usersApi := datadogV2.NewUsersApi(apiClient)

    resp, r, err := usersApi.CreateUser(ctx, body)
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error creating user: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    responseData := resp.GetData()
    fmt.Fprintf(os.Stdout, "User ID: %s", responseData.GetId())
}

Save it to example.go, then run go get github.com/DataDog/datadog-api-client-go/v2. Set the DD_CLIENT_API_KEY and DD_CLIENT_APP_KEY to your Datadog credentials, and then run go run example.go.

Unstable Endpoints

This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints: 

configuration.SetUnstableOperationEnabled("<APIVersion>.<OperationName>", true)

where <OperationName> is the name of the method used to interact with that endpoint. For example: GetLogsIndex, or UpdateLogsIndex

Changing Server

When talking to a different server, like the eu instance, change the ContextServerVariables: 

ctx = context.WithValue(ctx,
    datadog.ContextServerVariables,
    map[string]string{
        "site": "datadoghq.eu",
})

Disable compressed payloads

If you want to disable GZIP compressed responses, set the compress flag on your configuration object: 

configuration.Compress = false

Enable requests logging

If you want to enable requests logging, set the debug flag on your configuration object: 

configuration.Debug = true

Enable retry

If you want to enable retry when getting status code 429 rate-limited, set EnableRetry to true 

configuration.RetryConfiguration.EnableRetry = true

The default max retry is 3, you can change it with MaxRetries 

configuration.RetryConfiguration.MaxRetries = 3

Configure proxy

If you want to configure proxy, set env var HTTP_PROXY, and HTTPS_PROXY or set custom HTTPClient with proxy configured on configuration object: 

proxyUrl, _ := url.Parse("http://127.0.0.1:80")
configuration.HTTPClient = &http.Client{
    Transport: &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
}

Pagination

Several listing operations have a pagination method to help consume all the items available. For example, to retrieve all your incidents: 

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)

func main() {
	ctx := datadog.NewDefaultContext(context.Background())
	configuration := datadog.NewConfiguration()
	configuration.SetUnstableOperationEnabled("v2.ListIncidents", true)
	apiClient := datadog.NewAPIClient(configuration)
	incidentsApi := datadogV2.NewIncidentsApi(apiClient)

	resp, _ := incidentsApi.ListIncidentsWithPagination(ctx, *datadog.NewListIncidentsOptionalParameters())
	for paginationResult := range resp {
		if paginationResult.Error != nil {
			fmt.Fprintf(os.Stderr, "Error when calling `IncidentsApi.ListIncidentsWithPagination`: %v\n", paginationResult.Error)
		}
		responseContent, _ := json.MarshalIndent(paginationResult.Item, "", "  ")
		fmt.Fprintf(os.Stdout, "%s\n", responseContent)
	}

}

Documentation

Developer documentation for API endpoints and models is available on Github pages (https://datadoghq.dev/datadog-api-client-go/pkg/github.com/DataDog/datadog-api-client-go/v2/). Released versions are available on pkg.go.dev (https://pkg.go.dev/github.com/DataDog/datadog-api-client-go/v2).

Contributing

As most of the code in this repository is generated, we will only accept PRs for files that are not modified by our code-generation machinery (changes to the generated files would get overwritten). We happily accept contributions to files that are not autogenerated, such as tests and development tooling.

Author

support@datadoghq.com

Index

Constants

View Source 
const Version = "2.16.0"

Version used in User-Agent header.

Variables

This section is empty.

Functions

This section is empty.

Types

This section is empty.

Source Files

View all Source files

Directories

Path Synopsis
api
datadog
datadogV1
List of APIs:
 List of APIs:
datadogV2
List of APIs:
 List of APIs:
examples
v1/authentication
v1/aws-integration
v1/aws-logs-integration
v1/azure-integration
v1/dashboard-lists
v1/dashboards
v1/downtimes
v1/events
v1/gcp-integration
v1/hosts
v1/ip-ranges
v1/key-management
v1/logs
v1/logs-indexes
v1/logs-pipelines
v1/metrics
v1/monitors
v1/notebooks
v1/organizations
v1/pagerduty-integration
v1/security-monitoring
v1/service-checks
v1/service-level-objective-corrections
v1/service-level-objectives
v1/slack-integration
v1/snapshots
v1/synthetics
v1/tags
v1/usage-metering
v1/users
v1/webhooks-integration
v2/audit
v2/authn-mappings
v2/ci-visibility-pipelines
v2/ci-visibility-tests
v2/cloud-workload-security
v2/cloudflare-integration
v2/confluent-cloud
v2/dashboard-lists
v2/downtimes
v2/events
v2/fastly-integration
v2/gcp-integration
v2/incident-services
v2/incident-teams
v2/incidents
v2/ip-allowlist
v2/key-management
v2/logs
v2/logs-archives
v2/logs-metrics
v2/metrics
v2/monitors
v2/opsgenie-integration
v2/organizations
v2/processes
v2/restriction-policies
v2/roles
v2/rum
v2/security-monitoring
v2/sensitive-data-scanner
v2/service-accounts
v2/service-definition
v2/spans
v2/spans-metrics
v2/synthetics
v2/teams
v2/usage-metering
v2/users

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.