リソースの操作手順

書き込み例の前に一覧から実際の ID を取得し、ENV_ID、PHONE_ID、TEAM_APP_ID、GROUP_ID、FILE_ID を対象の種類に応じて設定します。各例は独立した手順で、一括実行用スクリプトではありません。

ブラウザープロファイルとコア

ml-cli env find --keyword Amazon
ml-cli --timeout 30 env open --keyword Amazon --exact
ml-cli --timeout 30 env start --env-id "$ENV_ID" --is-headless false --cdp-evasion true
ml-cli env core-download --core 1:124 --core 2:146

find/open は名前・グループ・タグ・備考で検索し、一意の候補だけを開きます。暗号化プロファイルの env start は --encrypt-key に対応します。コアは 1 Chrome、2 Firefox、1 回 1〜20 件または JSON Cores です。バージョンは例示です。

env create-quick はグループ、プロキシ、認証、地域、IP 監視のフラグを備えます。fingerprint-refresh は --browser-type-id、--operator-system-id、--ua-version、--advanced-setting、resolution-list は --ua に対応します。set-group/set-remark は --env-ids または --unique-ids を指定します。app-hide-accessibility --package-name は繰り返せます（別名 --package-names）。詳細はコマンドを参照してください。

クラウド端末

ml-cli cloudphone find --keyword android-test
ml-cli --timeout 120 cloudphone open --keyword android-test --headless false
ml-cli --timeout 120 cloudphone power-on --id "$PHONE_ID" --headless true --disable-money-saving-mode false
ml-cli --timeout 30 cloudphone close --keyword android-test

headless=false はウィンドウを表示、true は非表示にします。起動は --disable-money-saving-mode にも対応します。名前・キーワードでの起動には一意の一致が必要です。要求の成功だけでは起動・ストリーミング完了を確認できません。

チームアプリ

team-app-list はチームライブラリ、app-list はカタログを取得します。端末・カタログではなくチーム登録の ID を使います。一覧の versionCode は文字列ですが、--version-code と JSON versionCode は符号付き i64 整数が必須で、文字列・小数・バージョン名・レコード ID は指定できません。

team-app-list の既定は pageNo=1、pageSize=10、ページ値は u32 の範囲です。app-list から PACKAGE_NAME と整数の VERSION_CODE を選びます。バージョン更新はストアアプリのみで、同じパッケージの別の利用可能なバージョンを指定し、バックエンドが可用性を検証します。

ml-cli cloudphone team-app-list --app-name Facebook --page-no 1 --page-size 10
ml-cli cloudphone app-list --app-name Facebook
ml-cli --fail-on-business-error cloudphone team-app-create --package-name "$PACKAGE_NAME" --version-code "$VERSION_CODE"
ml-cli --fail-on-business-error cloudphone team-app-update-group --id "$TEAM_APP_ID" --is-all false --group-ids "$GROUP_ID"
ml-cli --fail-on-business-error cloudphone team-app-enable --id "$TEAM_APP_ID" --enabled false
ml-cli --fail-on-business-error cloudphone team-app-update-install-setting --id "$TEAM_APP_ID" --install-setting 2
ml-cli --fail-on-business-error cloudphone team-app-update-enable-root --id "$TEAM_APP_ID" --enable-root false
ml-cli --fail-on-business-error cloudphone team-app-update-version --id "$TEAM_APP_ID" --package-name "$PACKAGE_NAME" --version-code "$VERSION_CODE"
ml-cli --fail-on-business-error cloudphone team-app-update-setting --id "$TEAM_APP_ID" --setting-type keep-alive --enabled false
ml-cli --fail-on-business-error cloudphone team-app-operate --id "$TEAM_APP_ID" --operation START --only-started-by-me true
ml-cli --fail-on-business-error cloudphone team-app-delete --id "$TEAM_APP_ID"

作成はストアアプリのみで data.id を返し、独自 APK のアップロードは対象外です。isAll=false は空でないグループ ID が必須、true は省略/null 可です。方針 1 は上書き、2 はスキップです。登録削除後も端末のアプリ・データは残ります。

設定は permission/keep-alive/auto-start/hide または PERMISSION/KEEP_ALIVE/AUTO_START/HIDE、操作は start/stop/restart/uninstall または全大文字です。フラグ・JSON ともこれらの表記を受け付け、API には大文字を送信します。その他は拒否されます。onlyStartedByMe の省略/null は false、enabled の欠落/null はエラーです。

ml-cli --fail-on-business-error cloudphone team-app-update-setting --json-data '{"id":"123456","settingType":"KEEP_ALIVE","enabled":true}' --enabled false

バージョン・設定の data=null は保存の確認であり、端末での完了ではありません。バージョン・権限・自動起動は起動時、常駐・非表示はバックエンドから非同期配信される場合もあります。一括の data=true は全端末の成功を保証しません。CLI は自動起動・再試行・ポーリングを行いません。アンインストールは端末のアプリデータを削除する場合がありますが、チームの事前インストール設定は残します。team-app-list と端末の結果を別々に確認してください。

クラウドストレージ

ml-cli cloud-storage info
ml-cli cloud-storage list --keyword video --page-no 1 --page-size 20
ml-cli cloud-storage presign --file-name video.mp4

アップロードは presign、返された presignedUrl へのバイナリ PUT、取得した ID での complete --id の 3 段階です。指定ヘッダーも付け、PUT 成功後にだけ complete します。ネットワーク・サンドボックスで禁止される場合は権限を得るか、同じアップロードをユーザーにローカル実行してもらいます。一時 URL は公開しないでください。

curl -f -L -X PUT --upload-file ./video.mp4 "$PRESIGNED_URL"
ml-cli cloud-storage complete --id "$UPLOAD_ID"

curl.exe -f -L -X PUT --upload-file .\video.mp4 "$env:PRESIGNED_URL"
ml-cli cloud-storage complete --id "$env:UPLOAD_ID"

ml-cli cloud-storage labels
ml-cli cloud-storage label-create --label-name automation --color "#2F80ED"
ml-cli cloud-storage label-update --label-id "$LABEL_ID" --label-name automation-ready --color "#27AE60"
ml-cli cloud-storage file-labels --file-id "$FILE_ID"
ml-cli cloud-storage add-labels --file-id "$FILE_ID" --tag-id "$LABEL_ID"
ml-cli cloud-storage set-labels --file-id "$FILE_ID" --tag-id "$LABEL_ID"
ml-cli cloud-storage label-delete --label-id "$LABEL_ID"
ml-cli cloud-storage delete --file-id "$FILE_ID"

RPA は morelogin://cloudfile?ids=<fileId>、複数 ID はコンマ区切りで参照できます。パラメーターの __Extra__ メタデータを保持してください。スケジュール・実行照会は schedule template-market/template-personal/list/create-once-task/cancel/subtask-list/subtask-detail/subtask-cancel で行います。

クラウドブラウザー

ml-cli cloud-browser list --page-no 1 --page-size 10
ml-cli --timeout 30 cloud-browser start --env-id "$ENV_ID"
ml-cli cloud-browser connect --env-id "$ENV_ID"
ml-cli cloud-browser stop --env-id "$ENV_ID" --force false

これらはリモートのクラウドブラウザーを管理し、env start/open はローカルプロファイルを操作します。start/stop/connect は固有の引数・JSON を使うため、ID やポートを流用する前にヘルプを確認してください。

グループ・タグ・プロキシ・メタデータ

ml-cli group list
ml-cli tag list
ml-cli proxy list
ml-cli env set-group --help
ml-cli env set-proxy --help
ml-cli env set-remark --help

応答には groupName（未分類は null）、tagInfos（タグなしは空配列）、envRemark が含まれる場合があります。タグ ID は文字列です。表表示はこれらを優先し、JSON は入れ子を保持します。作成・編集・削除のフラグはコマンドを参照してください。