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.
100 lines
2.2 KiB
Bash
100 lines
2.2 KiB
Bash
#!/usr/bin/env bash
|
|
# vim:ts=4:sts=4:sw=4:et
|
|
#
|
|
# Author: Hari Sekhon
|
|
# Date: 2022-03-11 16:24:49 +0000 (Fri, 11 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,SC1091
|
|
. "$srcdir/lib/utils.sh"
|
|
|
|
# shellcheck disable=SC2034,SC2154
|
|
usage_description="
|
|
Queries the Jira API
|
|
|
|
Requires following environment variables to be defined:
|
|
|
|
\$JIRA_USER - eg. hari.sekhon@domain.com
|
|
\$JIRA_TOKEN
|
|
\$JIRA_DOMAIN - eg. mycompany (if your Jira URLs in your browser are https://mycompany.atlassian.net)
|
|
|
|
Can specify \$CURL_OPTS for options to pass to curl or provide them as arguments
|
|
|
|
|
|
Set up a personal access token here:
|
|
|
|
https://id.atlassian.com/manage-profile/security/api-tokens
|
|
|
|
|
|
API Reference:
|
|
|
|
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
|
|
|
|
https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/
|
|
|
|
|
|
This defaults to API v3 but to use an older API such as v2 simply prefix the path with /2/
|
|
|
|
|
|
Examples:
|
|
|
|
# List Users:
|
|
|
|
${0##*/} /2/users/search | jq -r '.[].displayName' | sort -fu
|
|
|
|
# List Groups (admin privileges required otherwise gets 403 error):
|
|
|
|
${0##*/} /2/group | jq .
|
|
|
|
# List Projects:
|
|
|
|
${0##*/} /project/search | jq .
|
|
|
|
# List Issues:
|
|
|
|
${0##*/} /2/search?jql= | jq .
|
|
|
|
"
|
|
|
|
# used by usage() in lib/utils.sh
|
|
# shellcheck disable=SC2034
|
|
usage_args="/path [<curl_options>]"
|
|
|
|
check_env_defined JIRA_DOMAIN
|
|
check_env_defined JIRA_USER
|
|
check_env_defined JIRA_TOKEN
|
|
|
|
url_base="https://$JIRA_DOMAIN.atlassian.net/rest/api/3"
|
|
|
|
help_usage "$@"
|
|
|
|
min_args 1 "$@"
|
|
|
|
curl_api_opts "$@"
|
|
|
|
export USERNAME="$JIRA_USER"
|
|
export PASSWORD="$JIRA_TOKEN"
|
|
|
|
url_path="$1"
|
|
shift || :
|
|
|
|
if [[ "$url_path" =~ ^/?[[:digit:]]+(\.[[:digit:]]+)?/ ]]; then
|
|
url_base="${url_base%%/3}"
|
|
fi
|
|
url_path="${url_path//$url_base}"
|
|
url_path="${url_path##/}"
|
|
|
|
"$srcdir/curl_auth.sh" "$url_base/$url_path" "${CURL_OPTS[@]}" "$@"
|