IP Ranges

Get a list of IP prefixes belonging to Datadog.

GET https://ip-ranges.ap1.datadoghq.com/https://ip-ranges.datadoghq.eu/https://ip-ranges.ddog-gov.com/https://ip-ranges.datadoghq.com/https://ip-ranges.us3.datadoghq.com/https://ip-ranges.us5.datadoghq.com/

Overview

Get information about Datadog IP ranges.

Response

OK

IP ranges.

Expand All

Field

Type

Description

agents

object

Available prefix information for the Agent endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

api

object

Available prefix information for the API endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

apm

object

Available prefix information for the APM endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

global

object

Available prefix information for all Datadog endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

logs

object

Available prefix information for the Logs endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

modified

string

Date when last updated, in the form YYYY-MM-DD-hh-mm-ss.

orchestrator

object

Available prefix information for the Orchestrator endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

process

object

Available prefix information for the Process endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

remote-configuration

object

Available prefix information for the Remote Configuration endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

synthetics

object

Available prefix information for the Synthetics endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv4_by_location

object

List of IPv4 prefixes by location.

<any-key>

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

prefixes_ipv6_by_location

object

List of IPv6 prefixes by location.

<any-key>

[string]

List of IPv6 prefixes.

synthetics-private-locations

object

Available prefix information for the Synthetics Private Locations endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

version

int64

Version of the IP list.

webhooks

object

Available prefix information for the Webhook endpoints.

prefixes_ipv4

[string]

List of IPv4 prefixes.

prefixes_ipv6

[string]

List of IPv6 prefixes.

{
  "agents": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "api": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "apm": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "global": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "logs": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "modified": "2019-10-31-20-00-00",
  "orchestrator": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "process": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "remote-configuration": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "synthetics": {
    "prefixes_ipv4": [],
    "prefixes_ipv4_by_location": {
      "<any-key>": []
    },
    "prefixes_ipv6": [],
    "prefixes_ipv6_by_location": {
      "<any-key>": []
    }
  },
  "synthetics-private-locations": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  },
  "version": 11,
  "webhooks": {
    "prefixes_ipv4": [],
    "prefixes_ipv6": []
  }
}

Too many requests

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

"""
List IP Ranges returns "OK" response
"""

from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v1.api.ip_ranges_api import IPRangesApi

configuration = Configuration()
with ApiClient(configuration) as api_client:
    api_instance = IPRangesApi(api_client)
    response = api_instance.get_ip_ranges()

    print(response)

Instructions

First install the library and its dependencies and then save the example to example.py and run following commands:

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" python3 "example.py"