You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
115 lines
2.5 KiB
Bash
115 lines
2.5 KiB
Bash
#!/usr/bin/env bash
|
|
# vim:ts=4:sts=4:sw=4:et
|
|
# args: /v1/validate
|
|
#
|
|
# Author: Hari Sekhon
|
|
# Date: 2022-03-03 12:23:03 +0000 (Thu, 03 Mar 2022)
|
|
#
|
|
# https://github.com/HariSekhon/DevOps-Bash-tools
|
|
#
|
|
# License: see accompanying Hari Sekhon LICENSE file
|
|
#
|
|
# If you're using my code you're welcome to connect with me on LinkedIn and optionally send me feedback to help steer this or other code I publish
|
|
#
|
|
# https://www.linkedin.com/in/HariSekhon
|
|
#
|
|
|
|
set -euo pipefail
|
|
[ -n "${DEBUG:-}" ] && set -x
|
|
srcdir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
|
|
# shellcheck disable=SC1090
|
|
. "$srcdir/lib/utils.sh"
|
|
|
|
# shellcheck disable=SC1090
|
|
. "$srcdir/lib/git.sh"
|
|
|
|
# shellcheck disable=SC2034,SC2154
|
|
usage_description="
|
|
Queries the DataDog API
|
|
|
|
Requires \$DD_API_KEY / \$DATADOG_TOKEN to be set in the environment
|
|
If \$DD_APP_KEY is set, will also be sent in requests
|
|
|
|
Create an organization API key here:
|
|
|
|
https://app.datadoghq.eu/organization-settings/api-keys
|
|
|
|
(hint: copy the key, not the key id):
|
|
|
|
Create \$DD_APP_KEY here:
|
|
|
|
https://app.datadoghq.eu/organization-settings/application-keys
|
|
or
|
|
https://app.datadoghq.eu/personal-settings/application-keys
|
|
|
|
|
|
If not using default US site, must also set \$DATADOG_HOST, eg:
|
|
|
|
export DATADOG_HOST=https://api.datadoghq.eu
|
|
|
|
For site names, see:
|
|
|
|
https://docs.datadoghq.com/api/latest/authentication/
|
|
|
|
|
|
Can specify \$CURL_OPTS for options to pass to curl or provide them as arguments
|
|
|
|
|
|
API Reference:
|
|
|
|
https://docs.datadoghq.com/api/latest/
|
|
|
|
|
|
Defaults to /v2 API, but if /vN is specified, then uses that API instead, eg. prefixing /v1 to API endpoints that are only available in v1 such as /v1/org
|
|
|
|
|
|
Examples:
|
|
|
|
# Validate your API token is working:
|
|
|
|
${0##*/} /v1/validate | jq .
|
|
|
|
# List users:
|
|
|
|
${0##*/} /users | jq .
|
|
or
|
|
${0##*/} /v1/user | jq .
|
|
|
|
|
|
# List your organizations:
|
|
|
|
${0##*/} /v1/org | jq .
|
|
|
|
"
|
|
|
|
# used by usage() in lib/utils.sh
|
|
# shellcheck disable=SC2034
|
|
usage_args="/path [<curl_options>]"
|
|
|
|
url_base="${DATADOG_HOST:-https://api.datadoghq.com}/api/v2"
|
|
|
|
help_usage "$@"
|
|
|
|
min_args 1 "$@"
|
|
|
|
curl_api_opts "$@"
|
|
|
|
export TOKEN="${DD_API_KEY:-${DATADOG_TOKEN:-}}"
|
|
export CURL_AUTH_HEADER="DD-API-KEY:"
|
|
|
|
if [ -n "${DD_APP_KEY:-}" ]; then
|
|
CURL_OPTS+=(-H "DD-APPLICATION-KEY: $DD_APP_KEY")
|
|
fi
|
|
|
|
url_path="$1"
|
|
shift || :
|
|
|
|
if [[ "$url_path" =~ ^/?v[[:digit:]]+/ ]]; then
|
|
url_base="${url_base%%/v2}"
|
|
fi
|
|
url_path="${url_path//$url_base}"
|
|
url_path="${url_path##/}"
|
|
|
|
"$srcdir/curl_auth.sh" "$url_base/$url_path" "${CURL_OPTS[@]}" "$@"
|