Elastic Cloudのインテグレーションアカウントを取得してください

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

GET https://api.ap1.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.ap2.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.datadoghq.eu/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.ddog-gov.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.us2.ddog-gov.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.uk1.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.us3.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}https://api.us5.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/{account_id}

概要

Get an Elastic Cloud integration account. This endpoint requires the integrations_read permission.

引数

パスパラメーター

名前

タイプ

説明

account_id [required]

string

Unique identifier of the integration account.

応答

OK

Response payload for a single Elastic Cloud integration account.

Expand All

フィールド

タイプ

説明

data [required]

object

Data envelope of an Elastic Cloud integration account, including server-assigned identity.

attributes [required]

object

Attributes of an Elastic Cloud integration account returned in responses.

authentication

 <oneOf>

Authentication configured on the Elastic Cloud integration account.

<auth_type=basic>

object

The basic authentication method and username configured on the account.

auth_type [required]

enum

The authentication method type. Allowed enum values: basic

default: basic

username [required]

string

Non-secret username or public identifier for the credential pair.

dataflows

object

Data Datadog collects from Elastic Cloud, keyed by dataflow id.

elastic-cloud-detailed-index-stats

object

Primary shard metrics broken down per index, rather than aggregated across the cluster.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-index-stats

object

Metrics for individual indices. Only the indices granted to the role of the user in authentication are collected.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-metrics

object

Node-level statistics for the clusters in your deployment, such as the number of nodes and the number of documents on each node. This is the integration's baseline collection: it is always on and cannot be turned off, which is why it appears in responses only.

enabled

boolean

Whether Datadog collects this data. Always true, because this collection cannot be turned off.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-pending-task-stats

object

Metrics for cluster-level changes that have been submitted but not yet executed.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-primary-shard-graceful-timeout

object

Tolerance for slow primary shard requests, keeping the rest of the collection running when a primary shard request times out instead of failing the run. Only has an effect alongside elastic-cloud-primary-shard-stats.

enabled

boolean

Whether this tolerance is applied.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-primary-shard-stats

object

Metrics covering only the cluster's primary shards.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-shard-allocation-stats

object

Metrics for how many shards are allocated to each data node, and the disk space they use.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

elastic-cloud-slm-stats

object

Metrics about the actions taken by snapshot lifecycle management. Requires the read_slm Elasticsearch cluster privilege on the role of the user in authentication; without it this dataflow collects no data.

enabled

boolean

Whether Datadog collects this data.

status

object

Read-only collection status of a dataflow.

health

enum

Collection health of a single dataflow. Allowed enum values: DATAFLOW_HEALTH_OK,DATAFLOW_HEALTH_BROKEN,DATAFLOW_HEALTH_UNKNOWN

message

string

Human-readable detail, populated when the dataflow is not healthy.

updated_at

date-time

Time the status was last computed.

name [required]

string

Human-readable name of the Elastic Cloud integration account.

settings [required]

object

Settings configured on the Elastic Cloud integration account.

tags

string

Comma-separated list of custom tags for this Elastic Cloud deployment.

url [required]

string

Elastic Cloud deployment URL.

id [required]

string

Server-generated unique identifier of the Elastic Cloud integration account.

type [required]

enum

The type of the integration account resource. Always integration-account. Allowed enum values: integration-account

default: integration-account

{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "basic",
        "username": "datadog"
      },
      "dataflows": {
        "elastic-cloud-detailed-index-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-index-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-metrics": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-pending-task-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-primary-shard-graceful-timeout": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-primary-shard-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-shard-allocation-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "elastic-cloud-slm-stats": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        }
      },
      "name": "elastic-cloud-prod",
      "settings": {
        "tags": "env:prod,team:saasint",
        "url": "https://example.es.us-central1.gcp.cloud.es.io:9243"
      }
    },
    "id": "953a0060-81ec-4221-aed4-d4733b59cd96",
    "type": "integration-account"
  }
}

Bad Request

API error response.

Expand All

フィールド

タイプ

説明

errors [required]

[string]

A list of errors.

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

Forbidden

API error response.

Expand All

フィールド

タイプ

説明

errors [required]

[string]

A list of errors.

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

Not Found

API error response.

Expand All

フィールド

タイプ

説明

errors [required]

[string]

A list of errors.

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

Too many requests

API error response.

Expand All

フィールド

タイプ

説明

errors [required]

[string]

A list of errors.

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

コード例

                  # Path parameters
export account_id="CHANGE_ME"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

# 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.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/integration-interfaces/elastic-cloud/accounts/${account_id}" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}"
"""
Get an Elastic Cloud integration account returns "OK" response
"""

from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v2.api.elastic_cloud_integration_api import ElasticCloudIntegrationApi

configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
configuration.unstable_operations["get_elastic_cloud_integration_account"] = True
with ApiClient(configuration) as api_client:
    api_instance = ElasticCloudIntegrationApi(api_client)
    response = api_instance.get_elastic_cloud_integration_account(
        account_id="account_id",
    )

    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.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"
# Get an Elastic Cloud integration account returns "OK" response

require "datadog_api_client"
DatadogAPIClient.configure do |config|
  config.access_token = ENV["DD_BEARER_TOKEN"]
  config.unstable_operations["v2.get_elastic_cloud_integration_account".to_sym] = true
end
api_instance = DatadogAPIClient::V2::ElasticCloudIntegrationAPI.new
p api_instance.get_elastic_cloud_integration_account("account_id")

Instructions

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

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"
// Get an Elastic Cloud integration account 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/datadogV2"
)

func main() {
	ctx := datadog.NewDefaultContext(context.Background())
	ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
	configuration := datadog.NewConfiguration()
	configuration.SetUnstableOperationEnabled("v2.GetElasticCloudIntegrationAccount", true)
	apiClient := datadog.NewAPIClient(configuration)
	api := datadogV2.NewElasticCloudIntegrationApi(apiClient)
	resp, r, err := api.GetElasticCloudIntegrationAccount(ctx, "account_id")

	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `ElasticCloudIntegrationApi.GetElasticCloudIntegrationAccount`: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}

	responseContent, _ := json.MarshalIndent(resp, "", "  ")
	fmt.Fprintf(os.Stdout, "Response from `ElasticCloudIntegrationApi.GetElasticCloudIntegrationAccount`:\n%s\n", responseContent)
}

Instructions

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

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"
// Get an Elastic Cloud integration account returns "OK" response

import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.ElasticCloudIntegrationApi;
import com.datadog.api.client.v2.model.ElasticCloudIntegrationAccountResponse;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = ApiClient.getDefaultApiClient();
    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
    defaultClient.setUnstableOperationEnabled("v2.getElasticCloudIntegrationAccount", true);
    ElasticCloudIntegrationApi apiInstance = new ElasticCloudIntegrationApi(defaultClient);

    try {
      ElasticCloudIntegrationAccountResponse result =
          apiInstance.getElasticCloudIntegrationAccount("account_id");
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println(
          "Exception when calling ElasticCloudIntegrationApi#getElasticCloudIntegrationAccount");
      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 and then save the example to Example.java and run following commands:

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"
// Get an Elastic Cloud integration account returns "OK" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV2::api_elastic_cloud_integration::ElasticCloudIntegrationAPI;

#[tokio::main]
async fn main() {
    let mut configuration = datadog::Configuration::new();
    configuration.set_unstable_operation_enabled("v2.GetElasticCloudIntegrationAccount", true);
    let api = ElasticCloudIntegrationAPI::with_config(configuration);
    let resp = api
        .get_elastic_cloud_integration_account("account_id".to_string())
        .await;
    if let Ok(value) = resp {
        println!("{:#?}", value);
    } else {
        println!("{:#?}", resp.unwrap_err());
    }
}

Instructions

First install the library and its dependencies and then save the example to src/main.rs and run following commands:

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" cargo run
/**
 * Get an Elastic Cloud integration account returns "OK" response
 */

import { client, v2 } from "@datadog/datadog-api-client";

const configuration = client.createConfiguration({
  authMethods: {
    AuthZ: {
      accessToken: process.env.DD_BEARER_TOKEN as string,
    },
  },
});
configuration.unstableOperations["v2.getElasticCloudIntegrationAccount"] = true;
const apiInstance = new v2.ElasticCloudIntegrationApi(configuration);

const params: v2.ElasticCloudIntegrationApiGetElasticCloudIntegrationAccountRequest =
  {
    accountId: "account_id",
  };

apiInstance
  .getElasticCloudIntegrationAccount(params)
  .then((data: v2.ElasticCloudIntegrationAccountResponse) => {
    console.log(
      "API called successfully. Returned data: " + JSON.stringify(data)
    );
  })
  .catch((error: any) => console.error(error));

Instructions

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

    
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"