Previous Topic: ExampleNext Topic: Example


list—List Job Container

This action lists all the required jobcontainers. The list supports the feature of "renewed states". The first status information of a job container is its primary state information, while the second one is from the "renewed state".

This action has the following format:

jobcontainer action=list
[{filter=filter|filterfile=file_name}]
filter

Specifies the expression to confine the amount of information listed

The following attributes are valid to build atomic filter expressions:

Attribute

Type

Job container name

string

Job container state

{created | waiting | evaluating | cascading | building | in progress | successfully completed | failed | terminating | successfully built | build completed with failures | warning | halt in progress | halted}

Job container renew state

{created | waiting | evaluating | cascading | building | in progress | successfully completed | failed | terminating | successfully built | build completed with failures | warning | halt in progress | halted}

filterfile

Specifies the name of the file that contains the filter commands.

The commands in the file are specified in the same way as in the filter parameter, but the size of the file is limited by the capacity of the system that runs this command.