input_data list#

Description#

入力データ一覧を出力します。

Examples#

基本的な使い方#

以下のコマンドは、すべての入力データの一覧を出力します。 ただし10,000件までしか出力できません。

$ annofabcli input_data list --project_id prj1

警告

WebAPIの都合上、10,000件までしか出力できません。 10,000件以上の入力データを出力する場合は、annofabcli input_data list_all コマンドを使用してください。

絞り込み#

--input_data_query を指定すると、入力データの名前やinput_data_idで絞り込めます。 --input_data_query に渡す値は、https://annofab.com/docs/api/#operation/getInputDataList のクエリパラメータとほとんど同じです。

以下のコマンドは、入力データ名に"sample"を含む入力データの一覧を出力します。

$ annofabcli input_data list --project_id prj1 \
 --input_data_query '{"input_data_name": "sample"}'

以下のコマンドは、task_idに"task1"を含むタスクが使用している入力データの一覧を出力します。

$ annofabcli input_data list --project_id prj1 \
 --input_data_query '{"task_id": "task1"}'

--input_data_id を指定すると、input_data_idに合致する入力データの一覧を出力します。

$ annofabcli input_data list --project_id prj1 \
 --input_data_id file://input_data_id.txt

詳細な情報を出力する#

以下のオプションを指定すると、より詳細な情報を出力できます。ただし、実行するWeb APIが増えるため、出力するまでの時間が長くなります。

  • --with_parent_task_id_list : 入力データを参照しているタスクのtask_idのリスト

  • --with_supplementary_data_count : 入力データに紐づく補助情報の個数

出力結果#

CSV出力#

CSV形式で出力する場合、以下の特徴があります。

  • system_metadata や metadata のようなオブジェクト型のプロパティは、 system_metadata.original_resolution.width のように展開されて出力されます。

$ annofabcli input_data list --format csv --output out.csv
out.csv#

organization_id

input_data_set_id

project_id

input_data_id

input_data_name

input_data_path

url

etag

updated_datetime

sign_required

system_metadata._type

system_metadata.original_resolution.height

system_metadata.original_resolution.width

system_metadata.resized_resolution.height

system_metadata.resized_resolution.width

metadata.attr1

org1

12345678-abcd-1234-abcd-1234abcd5678

prj1

input1

test-input1

s3://af-production-input/organizations/…

d6ec2f3…

2021-01-04T21:21:28.169+09:00

False

Image

720

1280

foo

org1

12345678-abcd-1234-abcd-1234abcd5678

prj1

input2

test-input2

s3://af-production-input/organizations/…

7a9e32f…

2021-01-04T21:21:28.169+09:00

False

Image

435

975

285

640

JSON出力#

$ annofabcli input_data list --format pretty_json --output out.json
out.json#
[
    {
        "input_data_id": "input1",
        "project_id": "prj1",
        "organization_id": "org1",
        "input_data_set_id": ",12345678-abcd-1234-abcd-1234abcd5678",
        "input_data_name": "data1",
        "input_data_path": "s3://af-production-input/organizations/...",
        "updated_datetime": "2021-01-04T21:21:28.169+09:00",
        "sign_required": false,
        "metadata": {},
        "system_metadata": {
            "resized_resolution": null,
            "original_resolution": {
                "width": 128,
                "height": 128
            }
        },
        "_type": "Image"
    },
    ...
]

input_data_idの一覧を出力#

$ annofabcli input_data list --format input_data_id_list --output out.txt
out.txt#
input1
input2
...

Usage Details#

入力データ一覧を出力します。Annofabの制約上、10,000件までしか出力されません。

usage: annofabcli input_data list [-h] [--yes] [--endpoint_url ENDPOINT_URL]
                                  [--annofab_user_id ANNOFAB_USER_ID]
                                  [--annofab_password ANNOFAB_PASSWORD]
                                  [--annofab_pat ANNOFAB_PAT]
                                  [--logdir LOGDIR] [--disable_log] [--debug]
                                  -p PROJECT_ID
                                  [-iq INPUT_DATA_QUERY | -i INPUT_DATA_ID [INPUT_DATA_ID ...]]
                                  [--with_parent_task_id_list]
                                  [--with_supplementary_data_count]
                                  [-f {csv,json,pretty_json,input_data_id_list}]
                                  [-o OUTPUT]

Named Arguments#

-p, --project_id

対象のプロジェクトのproject_idを指定します。

-iq, --input_data_query

入力データの検索クエリをJSON形式で指定します。 file:// を先頭に付けると、JSON形式のファイルを指定できます。クエリのフォーマットは、getInputDataList APIのクエリパラメータと同じです。ただし page , limit キーは指定できません。

-i, --input_data_id

対象のinput_data_idを指定します。 --input_data_query 引数とは同時に指定できません。 file:// を先頭に付けると、input_data_idの一覧が記載されたファイルを指定できます。

--with_parent_task_id_list

入力データを参照しているタスクのIDのlist( parent_task_id_list )も出力します。

--with_supplementary_data_count

入力データに紐づく補助情報の個数( supplementary_data_count )も出力します。

-f, --format

Possible choices: csv, json, pretty_json, input_data_id_list

出力フォーマットを指定します。

Default: 'csv'

-o, --output

出力先のファイルパスを指定します。未指定の場合は、標準出力に出力されます。

global optional arguments#

--yes

処理中に現れる問い合わせに対して、常に yes と回答します。

--endpoint_url

Annofab WebAPIのエンドポイントを指定します。

Default: 'https://annofab.com'

--annofab_user_id

Annofabにログインする際のユーザーID

--annofab_password

Annofabにログインする際のパスワード

--annofab_pat

Annofabにログインする際のパーソナルアクセストークン

--logdir

ログファイルを保存するディレクトリを指定します。

Default: .log

--disable_log

ログを無効にします。

--debug

HTTPリクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。

See also#