input_data put#
Description#
入力データを作成します。
Examples#
CSVファイルを指定する場合#
入力データ情報が記載されたCSVファイルを元に、入力データを作成します。
CSVのフォーマットは以下の通りです。
カンマ区切り
ヘッダ行なし
列番号 |
名前 |
必須 |
備考 |
|---|---|---|---|
1列目 |
input_data_name |
Yes |
|
2列目 |
input_data_path |
Yes |
先頭が |
3列目 |
input_data_id |
No |
省略した場合はinput_data_nameに近い値(IDに使えない文字を加工した値)になります。 |
各項目の詳細は AnnofabのWebAPIドキュメント を参照してください。
以下はCSVファイルのサンプルです。
data1,s3://example.com/data1,id1,
data2,s3://example.com/data2,id2,true
data3,s3://example.com/data3,id3,false
data4,https://example.com/data4,,
data5,file://sample.jpg,,
data6,file:///tmp/sample.jpg,,
警告
プライベートストレージが利用可能な組織配下のプロジェクトでしか、 input_data_path に https または s3 スキームを利用できません。
プライベートストレージを利用するには、Annofabサポート窓口への問い合わせが必要です。
詳細は https://annofab.readme.io/docs/external-storage を参照してください。
--csv に、CSVファイルのパスを指定してください。
$ annofabcli input_data put --project_id prj1 --csv input_data.csv
input_data_idが一致する入力データが既に存在する場合、デフォルトではスキップします。入力データを上書きする場合は、 --overwrite を指定してください。
$ annofabcli input_data put --project_id prj1 --csv input_data.csv --overwrite
JSON文字列を指定する場合#
入力データ情報が記載されたJSONファイルを元に、入力データを作成します。
以下は、JSONのサンプルです。
[
{
"input_data_name":"data1",
"input_data_path":"file://sample.jpg"
},
{
"input_data_name":"data2",
"input_data_path":"s3://example.com/data2",
"input_data_id":"id2",
}
]
JSONのキーは、--csv に指定するCSVファイルの列に対応します。
--json にJSON形式の文字列、またはJSONファイルのパスを指定できます。
$ annofabcli input_data put --project_id prj1 --json file://input_data.json
並列処理#
--csv を指定したときは、並列実行が可能です。
$ annofabcli input_data put --project_id prj1 --csv input_data.csv
--parallelism 4 --yes
Usage Details#
[DEPRECATED] 入力データを登録します。 [DEPRECATED] :: input_data put コマンドは非推奨です。代わりに input_data create コマンドを使用してください。 input_data put コマンドは2027/01/01以降に廃止予定です。
usage: annofabcli input_data put [-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
(--csv CSV | --json JSON) [--overwrite]
[--allow_duplicated_input_data]
[--parallelism {2,3,4}]
Named Arguments#
- -p, --project_id
対象のプロジェクトのproject_idを指定します。
- --csv
入力データが記載されたCSVファイルのパスを指定してください。 CSVのフォーマットは以下の通りです。詳細は https://annofab-cli.readthedocs.io/ja/latest/command_reference/input_data/put.html を参照してください。
ヘッダ行なし, カンマ区切り
1列目: input_data_name (required)
2列目: input_data_path (required)
3列目: input_data_id
- --json
登録対象の入力データをJSON形式で指定してください。 JSONの各キーは
--csvに渡すCSVの各列に対応しています。file://を先頭に付けるとjsonファイルを指定できます。 (ex)[{"input_data_name":"data1", "input_data_path":"file://lenna.png"}]- --overwrite
指定した場合、input_data_idがすでに存在していたら上書きします。指定しなければ、スキップします。
- --allow_duplicated_input_data
--csv,--jsonに渡した入力データの重複(input_data_name, input_data_path)を許可します。- --parallelism
Possible choices: 2, 3, 4
並列度。指定しない場合は、逐次的に処理します。指定する場合は、
--yesも指定してください。
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リクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。
オーナロールを持つユーザで実行してください。