NAME

grid-po-list - List all purchase orders.

SYNOPSIS

grid po list [FLAGS] [OPTIONS]

DESCRIPTION

List all purchase orders in grid.

FLAGS

-h, --help

Prints help information.

-q, --quiet

Do not display output.

-V, --version

Prints version information.

--accepted

Filter on whether the purchase order has an accepted version. Conflicts with --not-accepted.

--not-accepted

Filter on whether the purchase order does not have an accepted version. Conflicts with --accepted.

--closed

Selects closed purchase orders only. Conflicts with --open.

--open

Selects open purchase orders only. Conflicts with --closed.

-v

Increases verbosity (the opposite of -q). Specify multiple times for more output.

OPTIONS

-F, --format=FORMAT

Specifies the output format of the list. Possible values for formatting are human, csv, yaml, and json. Defaults to human.

--buyer-org

Optionally, filter the purchase orders by the buyer’s organization ID.

--seller-org

Optionally, filter the purchase orders by the seller’s organization ID.

--service-id

The ID of the service the payload should be sent to; required if running on Splinter. Format: <circuit-id>::<service-id>.

--url

URL for the REST API.

EXAMPLES

The command

$ grid po list --buyer-org=crgl

will list all purchase orders for the org crgl in human-readable format:

BUYER SELLER   UID                 STATE     ACCEPTED CLOSED
crgl  tst      PO-1234-56789       confirmed v3       false

The command

$ grid po list --accepted

will list all the purchase orders that have an accepted version in human-readable format:

BUYER SELLER   UID                 STATE     ACCEPTED CLOSED
crgl  tst      PO-1234-56789       confirmed v3       false
tst   crgl     PO-2345-67890       issued    v1       false
crgl  tst      PO-3456-78901       closed    v1       true

The command

% grid po list \
    --accepted \
    --open \
    --format=csv

will display all of the purchase orders that have an accepted version and are open. The output is formatted in csv:

BUYER,SELLER,UID,STATE,ACCEPTED,CLOSED
crgl,tst,PO-1234-56789,confirmed,v3,false
tst,crgl,PO-2345-67890,issued,v1,false

ENVIRONMENT VARIABLES

GRID_DAEMON_ENDPOINT

Specifies a default value for --url

GRID_SERVICE_ID

Specifies a default value for --service-id

SEE ALSO