project list#
Description#
プロジェクト一覧を出力します。
Examples#
基本的な使い方#
--organization
に出力対象のプロジェクトが所属する組織名を指定してください。
以下のコマンドは、組織"org1"配下で、自分が所属しているすべてのプロジェクトを出力します。
$ annofabcli project list --organization org1
プロジェクトのタイトルやステータスなどで絞り込み#
--project_query
を指定すると、プロジェクトのタイトルやステータスなどで絞り込めます。
--project_query
に渡す値は、https://annofab.com/docs/api/#operation/getProjectsOfOrganization のクエリパラメータとほとんど同じです。
さらに追加で、user_id
, except_user_id
キーも指定できます。
以下のコマンドは、組織"org1"配下で、プロジェクト名に"test"を含むプロジェクト一覧を出力します。
$ annofabcli project list --organization org1 --project_query '{"title":"test"}'
組織"org1"配下で、プロジェクトのステータスが「進行中」のプロジェクト一覧を出力します。
$ annofabcli project list --organization org1 --project_query '{"status": "active"}'
組織"org1"配下で、ユーザ"user1"がプロジェクトメンバとして参加しているプロジェクトの一覧を出力します。
$ annofabcli project list --organization org1 --project_query '{"user_id": "user1"}'
組織"org1"配下で、動画プロジェクトの一覧を出力します。
$ annofabcli project list --organization org1 --project_query '{"input_data_type": "movie"}'
所属していないプロジェクトも出力する#
--include_not_joined_project
を指定すると、所属していないプロジェクトも出力します。
指定しない場合は、所属しているプロジェクトのみ出力します( --project_query '{"user_id":"my_user_id"}'
と結果は同じ)。
$ annofabcli project list --organization org1 --include_not_joined_project
project_idで絞り込み#
project_idが prj1
, prj2
であるプロジェクトの一覧を出力します。
$ annofabcli project list --project_id prj1 prj2
出力結果#
CSV出力#
$ annofabcli project list --organization org1 --format csv --output out.csv
最小限の列のみ出力する場合は、--format minimal_csv
を指定してください。
$ annofabcli project list --organization org1 --format minimal_csv --output out_minimal.csv
JSON出力#
$ annofabcli project list --organization org1 --format pretty_json --output out.json
[
{
"project_id": "prj1",
"organization_id": "org1",
"title": "test-project",
"overview": "",
"project_status": "suspended",
"input_data_type": "image",
"created_datetime": "2020-03-30T13:15:01.903+09:00",
"updated_datetime": "2020-12-17T13:49:37.564+09:00",
"configuration": {
"number_of_inspections": 1,
"assignee_rule_of_resubmitted_task": "no_assignee",
"task_assignment_type": "random",
"max_tasks_per_member": 30,
"max_tasks_per_member_including_hold": 30,
"private_storage_aws_iam_role_arn": null,
"plugin_id": null,
"custom_task_assignment_plugin_id": null,
"custom_specs_plugin_id": null,
"input_data_set_id_list": null,
"input_data_max_long_side_length": null,
"sampling_inspection_rate": 50,
"sampling_acceptance_rate": 0,
"editor_version": "stable"
},
"summary": {
"last_tasks_updated_datetime": "2020-11-11T18:06:58.642+09:00"
},
"organization_name": "test-organization"
}
]
project_idの一覧を出力#
$ annofabcli project list --organization org1 --format project_id_list --output out.txt
prj1
prj2
...
Usage Details#
プロジェクト一覧を出力します。
usage: annofabcli project list [-h] [--yes] [--endpoint_url ENDPOINT_URL]
[--annofab_user_id ANNOFAB_USER_ID]
[--annofab_password ANNOFAB_PASSWORD]
[--logdir LOGDIR] [--disable_log] [--debug]
(-p PROJECT_ID [PROJECT_ID ...] | -org ORGANIZATION)
[-pq PROJECT_QUERY]
[--include_not_joined_project]
[-f {csv,minimal_csv,json,pretty_json,project_id_list}]
[-o OUTPUT] [--csv_format CSV_FORMAT]
[-q QUERY]
Named Arguments#
- -p, --project_id
対象プロジェクトのproject_idを指定します。
file://
を先頭に付けると、project_idの一覧が記載されたファイルを指定できます。- -org, --organization
対象の組織名を指定してください。
- -pq, --project_query
プロジェクトの検索クエリをJSON形式で指定します。'--organization'を指定したときのみ有効なオプションです。指定しない場合は、組織配下のすべてのプロジェクトを取得します。
file://
を先頭に付けると、JSON形式のファイルを指定できます。クエリのフォーマットは、[getProjectsOfOrganization API](https://annofab.com/docs/api/#operation/getProjectsOfOrganization)のクエリパラメータと同じです。さらに追加で、user_id
,except_user_id
キーも指定できます。ただしpage
,limit
キーは指定できません。- --include_not_joined_project
'--organization'を指定したときのみ有効なオプションです。指定した場合は、所属していないプロジェクトも出力します。指定しない場合は、自分が所属しているプロジェクトのみ出力します(
--project_query '{"user_id":"my_user_id"}'
が指定されている状態と同じ)- -f, --format
Possible choices: csv, minimal_csv, json, pretty_json, project_id_list
出力フォーマットを指定します。
Default: "csv"
- -o, --output
出力先のファイルパスを指定します。未指定の場合は、標準出力に出力されます。
- --csv_format
CSVのフォーマットをJSON形式で指定します。
--format
がcsv
でないときは、このオプションは無視されます。file://
を先頭に付けると、JSON形式のファイルを指定できます。 指定した値はpandas.DataFrame.to_csv
の引数として渡されます。- -q, --query
JMESPath形式で指定します。出力結果の抽出や、出力内容の変更に利用できます。
global optional arguments#
- --yes
処理中に現れる問い合わせに対して、常に
yes
と回答します。- --endpoint_url
Annofab WebAPIのエンドポイントを指定します。
Default: "https://annofab.com"
- --annofab_user_id
Annofabにログインする際のユーザーID
- --annofab_password
Annofabにログインする際のパスワード
- --logdir
ログファイルを保存するディレクトリを指定します。
Default: .log
- --disable_log
ログを無効にします。
- --debug
HTTPリクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。