For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/spa/get-spa-recommendations-v2.md. A documentation index is available at /llms.txt.
Language
Datadog site

Get SPA recommendations v2

WARNINGNote: This endpoint is in preview and may change in the future. It is not yet recommended for production use.
POSThttps://api.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.us3.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.us5.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.datadoghq.eu/api/v2/spa/recommendations-v2/{service}https://api.ap1.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.ap2.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.uk1.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.ddog-gov.com/api/v2/spa/recommendations-v2/{service}https://api.us2.ddog-gov.com/api/v2/spa/recommendations-v2/{service}

Présentation

This endpoint is experimental and restricted to Datadog internal use only. Retrieve resource recommendations for a Spark job. The caller (Spark Gateway) provides a service name and the job's raw arguments. SPA determines which arguments are relevant for the service and returns structured recommendations for driver and executor resources.

Arguments

Paramètres du chemin

Name
Type
Description
service [required]
string

The service name for a Spark job

Requête

Body Data (required)

Champ
Type
Description
data [required]
object

JSON:API resource object for the SPA v2 recommendation request.

Réponse

OK

JSON:API document containing a single Recommendation resource. Returned by SPA when the Spark Gateway requests recommendations.

Champ
Type
Description
data [required]
object

JSON:API resource object for SPA Recommendation. Includes type, optional ID, and resource attributes with structured recommendations.

Exemple de code

Get SPA recommendations v2
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# 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/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF