Language

日本語 English Français 한국어 Español

Datadog Site

Site help
US1 US3 US5 EU AP1 AP2 US1-FED
このページは日本語には対応しておりません。随時翻訳に取り組んでいます。
翻訳に関してご質問やご意見ございましたら、お気軽にご連絡ください。

High Availability MultiRegion

Configure High Availability Multi-Region (HAMR) connections between Datadog organizations. HAMR provides disaster recovery capabilities by maintaining synchronized data between primary and secondary organizations across different datacenters.

Create or update HAMR organization connection

Note: This endpoint is in public beta and is subject to change. If you have any feedback, contact Datadog support.

POST https://api.ap1.datadoghq.com/api/v2/hamrhttps://api.ap2.datadoghq.com/api/v2/hamrhttps://api.datadoghq.eu/api/v2/hamrhttps://api.ddog-gov.com/api/v2/hamrhttps://api.datadoghq.com/api/v2/hamrhttps://api.us3.datadoghq.com/api/v2/hamrhttps://api.us5.datadoghq.com/api/v2/hamr

概要

Create or update the High Availability Multi-Region (HAMR) organization connection. This endpoint allows you to configure the HAMR connection between the authenticated organization and a target organization, including setting the connection status (ONBOARDING, PASSIVE, FAILOVER, ACTIVE, RECOVERY)

リクエスト

Body Data (required)

Expand All

フィールド

種類

説明

data [required]

object

attributes [required]

object

hamr_status [required]

enum

Status of the HAMR connection:

  • 0: UNSPECIFIED - Connection status not specified
  • 1: ONBOARDING - Initial setup of HAMR connection
  • 2: PASSIVE - Secondary organization in passive standby mode
  • 3: FAILOVER - Liminal status between PASSIVE and ACTIVE
  • 4: ACTIVE - Organization is an active failover
  • 5: RECOVERY - Recovery operation in progress Allowed enum values: 0,1,2,3,4,5

is_primary [required]

boolean

Indicates whether this organization is the primary organization in the HAMR relationship. If true, this is the primary organization. If false, this is the secondary/backup organization.

modified_by [required]

string

Username or identifier of the user who last modified this HAMR connection.

target_org_datacenter [required]

string

Datacenter location of the target organization (e.g., us1, eu1, us5).

target_org_name [required]

string

Name of the target organization in the HAMR relationship.

target_org_uuid [required]

string

UUID of the target organization in the HAMR relationship.

id [required]

string

The organization UUID for this HAMR connection. Must match the authenticated organization's UUID.

type [required]

enum

Type of the HAMR organization connection resource. Allowed enum values: hamr_org_connections

{
  "data": {
    "attributes": {
      "hamr_status": 4,
      "is_primary": true,
      "modified_by": "admin@example.com",
      "target_org_datacenter": "us1",
      "target_org_name": "Production Backup Org",
      "target_org_uuid": "660f9511-f3ac-52e5-b827-557766551111"
    },
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "hamr_org_connections"
  }
}

応答

OK

Expand All

フィールド

種類

説明

data [required]

object

attributes [required]

object

hamr_status [required]

enum

Status of the HAMR connection:

  • 0: UNSPECIFIED - Connection status not specified
  • 1: ONBOARDING - Initial setup of HAMR connection
  • 2: PASSIVE - Secondary organization in passive standby mode
  • 3: FAILOVER - Liminal status between PASSIVE and ACTIVE
  • 4: ACTIVE - Organization is an active failover
  • 5: RECOVERY - Recovery operation in progress Allowed enum values: 0,1,2,3,4,5

is_primary [required]

boolean

Indicates whether this organization is the primary organization in the HAMR relationship. If true, this is the primary organization. If false, this is the secondary/backup organization.

modified_at [required]

string

Timestamp of when this HAMR connection was last modified (RFC3339 format).

modified_by [required]

string

Username or identifier of the user who last modified this HAMR connection.

target_org_datacenter [required]

string

Datacenter location of the target organization (e.g., us1, eu1, us5).

target_org_name [required]

string

Name of the target organization in the HAMR relationship.

target_org_uuid [required]

string

UUID of the target organization in the HAMR relationship.

id [required]

string

The organization UUID for this HAMR connection.

type [required]

enum

Type of the HAMR organization connection resource. Allowed enum values: hamr_org_connections

{
  "data": {
    "attributes": {
      "hamr_status": 4,
      "is_primary": true,
      "modified_at": "2026-01-13T17:26:48.830968Z",
      "modified_by": "admin@example.com",
      "target_org_datacenter": "us1",
      "target_org_name": "Production Backup Org",
      "target_org_uuid": "660f9511-f3ac-52e5-b827-557766551111"
    },
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "hamr_org_connections"
  }
}

Bad Request

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Forbidden

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Too many requests

API error response.

Expand All

フィールド

種類

説明

errors [required]

[string]

A list of errors.

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

Internal Server Error

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

コード例

                  # Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/hamr" \
-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
{
  "data": {
    "attributes": {
      "hamr_status": 4,
      "is_primary": true,
      "modified_by": "admin@example.com",
      "target_org_datacenter": "us1",
      "target_org_name": "Production Backup Org",
      "target_org_uuid": "660f9511-f3ac-52e5-b827-557766551111"
    },
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "hamr_org_connections"
  }
}
EOF

Get HAMR organization connection

Note: This endpoint is in public beta and is subject to change. If you have any feedback, contact Datadog support.

GET https://api.ap1.datadoghq.com/api/v2/hamrhttps://api.ap2.datadoghq.com/api/v2/hamrhttps://api.datadoghq.eu/api/v2/hamrhttps://api.ddog-gov.com/api/v2/hamrhttps://api.datadoghq.com/api/v2/hamrhttps://api.us3.datadoghq.com/api/v2/hamrhttps://api.us5.datadoghq.com/api/v2/hamr

概要

Retrieve the High Availability Multi-Region (HAMR) organization connection details for the authenticated organization. This endpoint returns information about the HAMR connection configuration, including the target organization, datacenter, status, and whether this is the primary or secondary organization in the HAMR relationship.

応答

OK

Expand All

フィールド

種類

説明

data [required]

object

attributes [required]

object

hamr_status [required]

enum

Status of the HAMR connection:

  • 0: UNSPECIFIED - Connection status not specified
  • 1: ONBOARDING - Initial setup of HAMR connection
  • 2: PASSIVE - Secondary organization in passive standby mode
  • 3: FAILOVER - Liminal status between PASSIVE and ACTIVE
  • 4: ACTIVE - Organization is an active failover
  • 5: RECOVERY - Recovery operation in progress Allowed enum values: 0,1,2,3,4,5

is_primary [required]

boolean

Indicates whether this organization is the primary organization in the HAMR relationship. If true, this is the primary organization. If false, this is the secondary/backup organization.

modified_at [required]

string

Timestamp of when this HAMR connection was last modified (RFC3339 format).

modified_by [required]

string

Username or identifier of the user who last modified this HAMR connection.

target_org_datacenter [required]

string

Datacenter location of the target organization (e.g., us1, eu1, us5).

target_org_name [required]

string

Name of the target organization in the HAMR relationship.

target_org_uuid [required]

string

UUID of the target organization in the HAMR relationship.

id [required]

string

The organization UUID for this HAMR connection.

type [required]

enum

Type of the HAMR organization connection resource. Allowed enum values: hamr_org_connections

{
  "data": {
    "attributes": {
      "hamr_status": 4,
      "is_primary": true,
      "modified_at": "2026-01-13T17:26:48.830968Z",
      "modified_by": "admin@example.com",
      "target_org_datacenter": "us1",
      "target_org_name": "Production Backup Org",
      "target_org_uuid": "660f9511-f3ac-52e5-b827-557766551111"
    },
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "hamr_org_connections"
  }
}

Bad Request

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Forbidden

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Not Found

API error response.

Expand All

フィールド

種類

説明

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Too many requests

API error response.

Expand All

フィールド

種類

説明

errors [required]

[string]

A list of errors.

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

コード例

                  # Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/hamr" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"