For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ja/api/latest/service-accounts/create-an-access-token-for-a-service-account.md. A documentation index is available at /llms.txt.
Language
Datadog site

Create an access token for a service account

POSThttps://api.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us3.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us5.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.datadoghq.eu/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ap1.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ap2.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.uk1.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ddog-gov.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us2.ddog-gov.com/api/v2/service_accounts/{service_account_id}/access_tokens

概要

Create an access token for a service account.

This endpoint requires the service_account_write permission.

引数

パスパラメーター

名前
タイプ
説明
service_account_id [required]
string

The ID of the service account.

リクエスト

Body Data (required)

フィールド
タイプ
説明
data [required]
object

Object used to create a service account access token.

応答

Created

Response for creating an access token. Includes the token key.

フィールド
タイプ
説明
data
object

Datadog access token, including the token key.

コード例

Create an access token for a service account returns "Created" response
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF