grafana-util docs
Home / Manpages / grafana-util-access-service-account.1

grafana-util-access-service-account.1

Browser-readable rendering of a generated roff manpage.

This page renders the generated roff manpage into readable HTML for browser use. For richer per-subcommand detail, prefer the command-reference pages.

NAME

grafana-util-access-service-account - List live or local Grafana service accounts, create, export, import, diff, or delete Grafana service accounts, and manage their tokens.

SYNOPSIS

grafana-util access service-account [OPTIONS]

DESCRIPTION

List live or local Grafana service accounts, create, export, import, diff, or delete Grafana service accounts, and manage their tokens.

  • Inspect service-account inventory.
  • Inspect service accounts from a live Grafana server or from a local export bundle.
  • Create or update service-account bundles.
  • Generate or delete service-account tokens.

BEFORE / AFTER

  • Before: service-account work often starts with a manual UI lookup and a one-off token action.
  • After: one namespace covers service-account inventory, bundle management, token creation, and token deletion with repeatable CLI input.

COMMON OPTIONS

list
--input-dir, --query, --page, --per-page, --table, --csv, --json, --yaml, --output-format
add
--name, --role, --disabled, --json
export and diff
--output-dir or --diff-dir, --overwrite, --dry-run
import
--input-dir, --replace-existing, --dry-run, --table, --json, --output-format, --yes
delete
--name, --yes, --json
token add
--service-account-id or --name, --token-name, --seconds-to-live, --json
token delete
--service-account-id or --name, --token-name, --yes, --json

SUCCESS CRITERIA

  • service-account changes stay tied to one named identity instead of a loose UI click path
  • token operations are explicit enough to review or script
  • inventory and bundle output can be passed to later access or change workflows without guesswork

FAILURE CHECKS

  • if a token add or delete fails, recheck whether the service account name or ID matches the target environment
  • if an inventory listing looks incomplete, confirm auth scope and org context before assuming the service account is missing
  • if the output is going into another step, pick the exact --output-format you want rather than relying on a default

EXAMPLES

List live or local Grafana service accounts, create, export, import, diff, or delete Grafana service accounts, and manage their tokens.

grafana-util access service-account list --url http://localhost:3000 --basic-user admin --basic-password admin --output-format text

SEE ALSO

grafana-util(1), grafana-util-access(1)