Configuration Automation - Ping CLI

pingcli request

Send a custom REST API request to a Ping platform service.

Synopsis

Send a custom REST API request to a Ping Service.

The custom REST API request is most powerful when product connection details have been configured in the CLI configuration file. The command offers a cURL-like experience to interact with the Ping platform services, with authentication and environment details dynamically filled by the CLI.

pingcli request [flags] API_URI

Examples

  Send a custom API request to the configured PingOne tenant, making a GET request against the /environments endpoint.
    pingcli request --service pingone environments

  Send a custom API request to the configured PingOne tenant, making a GET request to retrieve JSON configuration for a specific environment.
    pingcli request --service pingone --http-method GET --output-format json environments/$MY_ENVIRONMENT_ID

  Send a custom API request to the configured PingOne tenant, making a POST request to create a new environment with JSON data sourced from a file.
    pingcli request --service pingone --http-method POST --data ./my-environment.json environments

  Send a custom API request to the configured PingOne tenant, making a POST request to create a new environment using raw JSON data.
    pingcli request --service pingone --http-method POST --data-raw '{"name": "My environment"}' environments

  Send a custom API request to the configured PingOne tenant, making a DELETE request to remove an application attribute mapping.
    pingcli request --service pingone --http-method DELETE environments/$MY_ENVIRONMENT_ID/applications/$MY_APPLICATION_ID/attributes/$MY_ATTRIBUTE_MAPPING_ID

Options

      --data string          The file containing data to send in the request.
                             Example: './data.json'
      --data-raw string      The raw data to send in the request.
                             Example: '{"name": "My environment"}'
  -f, --fail                 Return non-zero exit code when HTTP custom request returns a failure status code.
  -h, --help                 help for request
  -m, --http-method string   The HTTP method to use for the request. (default GET)
                             Options are: DELETE, GET, PATCH, POST, PUT.
                             Example: 'POST'
  -s, --service string       The Ping service (configured in the active profile) to send the custom request to.
                             Options are: pingone.
                             Example: 'pingone'

Options inherited from parent commands

  -C, --config string          The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml)
      --no-color               Disable text output in color. (default false)
  -O, --output-format string   Specify the console output format. (default text)
                               Options are: json, text.
  -P, --profile string         The name of a configuration profile to use.

More information

  • pingcli - A CLI tool for managing the configuration of Ping Identity products.