projects#

usage: awx projects [-h] action ...

positional arguments:
  action
    list
    create
    get
    modify
    delete
    update
    associate
    disassociate

options:
  -h, --help    show this help message and exit

awx projects: the following arguments are required: action

projects list#

usage: awx projects list [-h] [--all] [--order_by ORDER_BY] [-f {json,yaml,jq,human}] [--filter TEXT] [--conf.color BOOLEAN] [-v] [--type {project}]
                         [--created CREATED] [--modified MODIFIED] [--name TEXT] [--description TEXT] [--local_path TEXT] [--scm_type {,git,svn,insights,archive}]
                         [--scm_url TEXT] [--scm_branch TEXT] [--scm_refspec TEXT] [--scm_clean BOOLEAN] [--scm_track_submodules BOOLEAN]
                         [--scm_delete_on_update BOOLEAN] [--credential ID] [--timeout INTEGER] [--scm_revision TEXT] [--last_job_run LAST_JOB_RUN]
                         [--last_job_failed BOOLEAN] [--next_job_run NEXT_JOB_RUN]
                         [--status {new,pending,waiting,running,successful,failed,error,canceled,never updated,ok,missing}] [--organization ID]
                         [--scm_update_on_launch BOOLEAN] [--scm_update_cache_timeout INTEGER] [--allow_override BOOLEAN] [--custom_virtualenv TEXT]
                         [--default_environment ID] [--signature_validation_credential ID]

options:
  -h, --help            show this help message and exit
  --all                 fetch all pages of content from the API when returning results (instead of just the first page)
  --order_by ORDER_BY   order results by given field name, prefix the field name with a dash (-) to sort in reverse eg --order_by='-name',multiple sorting fields may
                        be specified by separating the field names with a comma (,)
  --type {project}      only list projects with the specified type
  --created CREATED     only list projects with the specified created
  --modified MODIFIED   only list projects with the specified modified
  --name TEXT           only list projects with the specified name
  --description TEXT    only list projects with the specified description
  --local_path TEXT     only list projects with the specified local_path
  --scm_type {,git,svn,insights,archive}
                        only list projects with the specified scm_type
  --scm_url TEXT        only list projects with the specified scm_url
  --scm_branch TEXT     only list projects with the specified scm_branch
  --scm_refspec TEXT    only list projects with the specified scm_refspec
  --scm_clean BOOLEAN   only list projects with the specified scm_clean
  --scm_track_submodules BOOLEAN
                        only list projects with the specified scm_track_submodules
  --scm_delete_on_update BOOLEAN
                        only list projects with the specified scm_delete_on_update
  --credential ID       only list projects with the specified credential
  --timeout INTEGER     only list projects with the specified timeout
  --scm_revision TEXT   only list projects with the specified scm_revision
  --last_job_run LAST_JOB_RUN
                        only list projects with the specified last_job_run
  --last_job_failed BOOLEAN
                        only list projects with the specified last_job_failed
  --next_job_run NEXT_JOB_RUN
                        only list projects with the specified next_job_run
  --status {new,pending,waiting,running,successful,failed,error,canceled,never updated,ok,missing}
                        only list projects with the specified status
  --organization ID     only list projects with the specified organization
  --scm_update_on_launch BOOLEAN
                        only list projects with the specified scm_update_on_launch
  --scm_update_cache_timeout INTEGER
                        only list projects with the specified scm_update_cache_timeout
  --allow_override BOOLEAN
                        only list projects with the specified allow_override
  --custom_virtualenv TEXT
                        only list projects with the specified custom_virtualenv
  --default_environment ID
                        only list projects with the specified default_environment
  --signature_validation_credential ID
                        only list projects with the specified signature_validation_credential

input/output formatting:
  -f {json,yaml,jq,human}, --conf.format {json,yaml,jq,human}
                        specify a format for the input and output
  --filter TEXT         specify an output filter (only valid with jq or human format)
  --conf.color BOOLEAN  Display colorized output. Defaults to True
  -v, --verbose         print debug-level logs, including requests made

projects create#

usage: awx projects create [-h] [--monitor] [--wait] --name TEXT [--description TEXT] [--local_path TEXT] [--scm_type {,git,svn,insights,archive}] [--scm_url TEXT]
                           [--scm_branch TEXT] [--scm_refspec TEXT] [--scm_clean BOOLEAN] [--scm_track_submodules BOOLEAN] [--scm_delete_on_update BOOLEAN]
                           [--credential ID] [--timeout INTEGER] [--organization ID] [--scm_update_on_launch BOOLEAN] [--scm_update_cache_timeout INTEGER]
                           [--allow_override BOOLEAN] [--default_environment ID] [--signature_validation_credential ID]

required arguments:
  --name TEXT           Name of this project.

options:
  -h, --help            show this help message and exit
  --monitor             If set, prints stdout of the project update until it finishes.
  --wait                If set, waits until the new project has updated.
  --description TEXT    Optional description of this project.
  --local_path TEXT     Local path (relative to PROJECTS_ROOT) containing playbooks and related files for this project.
  --scm_type {,git,svn,insights,archive}
                        Specifies the source control system used to store the project.
  --scm_url TEXT        The location where the project is stored.
  --scm_branch TEXT     Specific branch, tag or commit to checkout.
  --scm_refspec TEXT    For git projects, an additional refspec to fetch.
  --scm_clean BOOLEAN   Discard any local changes before syncing the project.
  --scm_track_submodules BOOLEAN
                        Track submodules latest commits on defined branch.
  --scm_delete_on_update BOOLEAN
                        Delete the project before syncing.
  --credential ID       the ID of the associated credential
  --timeout INTEGER     The amount of time (in seconds) to run before the task is canceled.
  --organization ID     The organization used to determine access to this template.
  --scm_update_on_launch BOOLEAN
                        Update the project when a job is launched that uses the project.
  --scm_update_cache_timeout INTEGER
                        The number of seconds after the last project update ran that a new project update will be launched as a job dependency.
  --allow_override BOOLEAN
                        Allow changing the SCM branch or revision in a job template that uses this project.
  --default_environment ID
                        The default execution environment for jobs run using this project.
  --signature_validation_credential ID
                        An optional credential used for validating files in the project against unexpected changes.

awx projects create: the following arguments are required: --name

projects get#

usage: awx projects get [-h] [-f {json,yaml,jq,human}] [--filter TEXT] [--conf.color BOOLEAN] [-v] id

positional arguments:
  id                    the ID (or unique name) of the resource

options:
  -h, --help            show this help message and exit

input/output formatting:
  -f {json,yaml,jq,human}, --conf.format {json,yaml,jq,human}
                        specify a format for the input and output
  --filter TEXT         specify an output filter (only valid with jq or human format)
  --conf.color BOOLEAN  Display colorized output. Defaults to True
  -v, --verbose         print debug-level logs, including requests made

awx projects get: the following arguments are required: id

projects modify#

usage: awx projects modify [-h] id

positional arguments:
  id          the ID (or unique name) of the resource

options:
  -h, --help  show this help message and exit

awx projects modify: the following arguments are required: id

projects delete#

usage: awx projects delete [-h] id

positional arguments:
  id          the ID (or unique name) of the resource

options:
  -h, --help  show this help message and exit

awx projects delete: the following arguments are required: id

projects update#

usage: awx projects update [-h] [--monitor] [--action-timeout ACTION_TIMEOUT] [--wait] [--interval INTERVAL] id

positional arguments:
  id

options:
  -h, --help            show this help message and exit
  --monitor             If set, prints stdout of the launched job until it finishes.
  --action-timeout ACTION_TIMEOUT
                        If set with --monitor or --wait, time out waiting on job completion.
  --wait                If set, waits until the launched job finishes.
  --interval INTERVAL   If set with --monitor or --wait, amount of time to wait in seconds between api calls. Minimum value is 2.5 seconds to avoid overwhelming the
                        api

awx projects update: the following arguments are required: id

projects associate#

usage: awx projects associate [-h] (--start_notification  | --success_notification  | --failure_notification ) id

positional arguments:
  id

options:
  -h, --help            show this help message and exit
  --start_notification
                        The ID (or name) of the notification_template to associate
  --success_notification
                        The ID (or name) of the notification_template to associate
  --failure_notification
                        The ID (or name) of the notification_template to associate

awx projects associate: the following arguments are required: id

projects disassociate#

usage: awx projects disassociate [-h] (--start_notification  | --success_notification  | --failure_notification ) id

positional arguments:
  id

options:
  -h, --help            show this help message and exit
  --start_notification
                        The ID (or name) of the notification_template to disassociate
  --success_notification
                        The ID (or name) of the notification_template to disassociate
  --failure_notification
                        The ID (or name) of the notification_template to disassociate

awx projects disassociate: the following arguments are required: id