Fluxos de recursos

Antes de escrever, obtenha IDs reais nas listas. Defina ENV_ID, PHONE_ID, TEAM_APP_ID, GROUP_ID e FILE_ID para seus recursos; são tipos diferentes. Os exemplos são receitas independentes.

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 busca por nome, grupo, tag ou observação; só abre com um candidato único. env start aceita --encrypt-key para perfis criptografados. Núcleos: 1 Chrome, 2 Firefox; 1–20 entradas ou JSON Cores. As versões são exemplos.

env create-quick inclui grupo, proxy, credenciais, localização e monitoramento IP. fingerprint-refresh aceita --browser-type-id, --operator-system-id, --ua-version, --advanced-setting; resolution-list, --ua. set-group/set-remark aceita --env-ids ou --unique-ids. app-hide-accessibility --package-name é repetível (alias --package-names). Veja Comandos.

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 mostra a janela; true a oculta. A inicialização aceita --disable-money-saving-mode. Abrir por nome ou palavra-chave exige correspondência única. Sucesso da solicitação não confirma inicialização nem streaming.

team-app-list consulta a biblioteca da equipe; app-list, o catálogo. Use o ID do registro da equipe, não do telefone nem do catálogo. versionCode da lista é texto; --version-code e JSON versionCode exigem inteiros i64, não strings, decimais, nomes ou IDs de versão.

team-app-list usa pageNo=1, pageSize=10 por padrão; a paginação deve caber em u32. Obtenha PACKAGE_NAME e VERSION_CODE inteiro em app-list. Atualizar versão aceita apenas aplicativos do catálogo e outra versão disponível do mesmo pacote; o servidor valida a disponibilidade.

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"

Criar aceita apenas aplicativos do catálogo e retorna data.id; não envia APK personalizado. isAll=false exige grupos não vazios; com true podem ser omitidos/null. Política 1 sobrescreve, 2 ignora. Excluir preserva aplicativos e dados do dispositivo.

Configurações: permission/keep-alive/auto-start/hide ou PERMISSION/KEEP_ALIVE/AUTO_START/HIDE. Operações: start/stop/restart/uninstall ou maiúsculas. Flags e JSON aceitam essas grafias exatas e enviam maiúsculas. Outros valores são rejeitados. onlyStartedByMe omitido/null vale false; enabled ausente/null é rejeitado.

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

Versão/configuração retorna data=null: confirma salvamento, não execução. Versão, permissões e início automático aplicam-se na inicialização; persistência/ocultação também podem ser enviadas de forma assíncrona. data=true em lote não garante sucesso individual. A CLI não liga, repete nem consulta automaticamente. Desinstalar pode apagar dados do dispositivo e preserva a pré-instalação. Verifique com team-app-list e no dispositivo.

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

Envie em três etapas: presign, PUT binário para presignedUrl, depois complete --id com o ID recebido. Inclua os headers retornados. Complete apenas após PUT bem-sucedido. Se rede/sandbox bloquear PUT, obtenha acesso ou peça execução local. Não publique URLs temporárias.

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 aceita morelogin://cloudfile?ids=<fileId> e vários IDs separados por vírgulas. Preserve __Extra__ nos parâmetros. Para agendamento e consultas use 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

Esses comandos gerenciam runtimes remotos; env start/open controla perfis locais. Start/stop/connect têm contratos próprios; consulte a ajuda antes de reutilizar IDs ou portas.

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

As respostas podem incluir groupName (null sem grupo), tagInfos (vazio sem tags) e envRemark. IDs de tags são strings. A tabela prioriza esses campos; JSON preserva a estrutura. Flags de criação, edição e exclusão estão em Comandos.