--seller-id. Sem essa opção, o comando usa XBOX_SELLER_ID ou o vendedor
salvo com xbox context set e, em seguida, seu único vendedor; se você tiver vários,
passe --seller-id.
Comandos
batch create, batch update e batch delete pedem confirmação antes de alterar qualquer coisa e são
enviados uma única vez, sem novas tentativas. Consulte Segurança e operações destrutivas.
Opções para ler lotes
As marcas aparecem como
keywords na saída JSON e em códigos de erro como
test_account_keyword_invalid. --tag corresponde a uma marca inteira, e não a parte dela.
Se você não puder ler todos os lotes do vendedor, não receberá nenhum erro: batch list retornará somente os
lotes que você criou.
Lotes expirados
Um lote expira quando suaaccessExpirationDate, a data em que o acesso às sandboxes termina,
passa. Um lote sem data nunca expira. A expiração não indica se as contas ainda podem
entrar.
batch list --expired lê a lista inteira do vendedor para encontrar os lotes expirados; por isso, é
mais lento para um vendedor com muitos lotes. Não pode ser combinado com --include-sandboxes; execute
batch get em um lote expirado para ver o acesso às sandboxes dele.
Formato da resposta
list retorna:
keywordsesandboxAccesssãonull, a menos que você passe--include-sandboxes.getsempre os retorna.isCompletesignifica que o trabalho de criação parou, e não que todas as contas foram criadas. Compare o número de contas degetcombatchSizee leiaprogresspara ver a mensagem de status.createdByé uma ID numérica de usuário do Partner Center.jobIdé o trabalho em execução do lote e passa a sernullquando o trabalho para. Os trabalhos de atualização e exclusão também aparecem aqui, mas somente um trabalho de criação pode ser acompanhado comjob wait.
get retorna o mesmo objeto de lote, além das contas dele:
xuid, email, gamertag e isDeleted. xuid é uma cadeia de caracteres.
Erros ao ler lotes
batch list, batch get e test-account get saem com o código 1 em caso de falha. Quando o serviço retorna
um erro JSON, stderr recebe um erro JSON com status, title, detail, code quando a
resposta inclui um, e seu correlationId; a maioria adiciona uma dica em detail. Outras falhas
imprimem uma linha de texto. Verifique o código de saída antes de analisar stderr.
Consultar uma conta
test-account get <email> informa se o lote que contém uma conta expirou. O email
deve terminar com @xboxtest.com. O comando pesquisa os 10 lotes mais recentes cujo modelo de email
corresponde ao nome da conta. Quando não encontra a conta neles, ele informa que os lotes mais antigos
não foram pesquisados e imprime os comandos batch list e batch get para que você os verifique
por conta própria.
Ele retorna o seguinte, abreviado aqui; batch contém todos os campos de lote que batch list
retorna:
expiredOn é null quando o lote não expirou. Uma conta excluída é relatada somente quando não
existe nenhuma cópia ativa, com account.isDeleted definido. O comando sai com 0 sempre que encontra a
conta, expirada ou não; portanto, os scripts devem ler expired. Ele sai com 1 quando:
- A conta não está nos lotes que você pode ver. Ela pode pertencer a outro vendedor; então, tente
--seller-id, ou outro desenvolvedor criou o lote dela e você não pode ler todos os lotes do vendedor. - O email aparece em mais de um lote. stderr lista um comando
batch getpara cada um. - Uma solicitação falha, como em Erros ao ler lotes.
Criar um lote
batch create inicia um trabalho que cria as contas e, em seguida, aguarda até que ele pare. As contas
contam para o limite de contas de teste do vendedor até que o lote seja
excluído.
Em um terminal, o comando mostra o seletor de pergunta de segurança,
lista os valores que enviará, incluindo os padrões das opções que você omitiu, e pede sua
confirmação. Em seguida, ele solicita a senha e a resposta de segurança, entra e envia
a solicitação. --confirm (--yes, -y) ignora somente a confirmação.
Sem um terminal, passe --password-file, --security-answer-file e --confirm. Sem
--confirm, o comando imprime os valores, recusa-se a continuar e não envia nada.
Escolher uma pergunta de segurança
Em um terminal, quando você não passa--security-question nem --security-answer-file, o
comando mostra um seletor numerado com estas perguntas. Enter seleciona a primeira. Para escolher uma
sem o seletor, passe o texto dela com --security-question:
- What is your favorite hobby?
- Who is your favorite athlete?
- What is your maternal grandmother’s first name?
- What was your childhood best friend’s first name?
- What was the name of your first pet?
- What is your current best friend’s first name?
- What was your favorite city to visit as a child?
What is your favorite hobby?. Pressionar Ctrl+C no seletor cancela sem criar nada.
Escolher uma pergunta não confirma a criação.
Segredos
A senha e a resposta de segurança nunca são aceitas como valores de opção ou variáveis de ambiente, para que fiquem fora do histórico do shell, das listagens de processos e dos logs. Cada uma vem de:- Seu
--password-fileou--security-answer-file. Uma única quebra de linha no final é removida. -no lugar de um caminho, o que a lê de stdin. Somente uma das duas pode ler stdin.- Sem opção de arquivo, um prompt no terminal que não exibe o que você digita.
Espera e códigos de saída
Enquanto aguarda, o comando imprime o progresso em stderr. Ele grava o trabalho final em stdout, no mesmo formato dejob get.
Quando o resultado é desconhecido
Quando a CLI não consegue determinar se o serviço criou um lote, por exemplo quando a conexão cai depois que a solicitação é enviada ou o serviço retorna um erro5xx, ela sai com 3. Ela nunca envia a
criação novamente. stderr imprime a hora em que a solicitação começou, em UTC, e estas etapas:
- Aguarde alguns minutos; um lote que ainda está sendo criado pode não estar listado ainda.
- Execute
xbox test-account batch list --mine --email-prefix <prefix>e procure um lote com o mesmo prefixo de email e modelo criado nessa hora ou depois dela. - Se o
jobIddesse lote estiver definido, acompanhe-o comxbox test-account job wait <job-id> --batch-id <batch-id>. SejobIdfornull, o trabalho parou; inspecione-o comxbox test-account batch get <batch-id>. - Crie novamente somente se esse lote não existir.
Erros ao criar
As falhas gravam em stderr um erro JSON comstatus, title, detail e code quando a
resposta inclui um. Ramifique com base em code, e não em detail.
Acompanhar um trabalho de criação
batch create imprime as IDs do lote e do trabalho assim que o trabalho é aceito. Um trabalho pode ser executado por
dias; portanto, você pode parar de aguardar a qualquer momento e acompanhá-lo depois:
Ambos retornam o trabalho:
state é running, succeeded ou failed. errorCode é test_account_job_failed quando o
trabalho falhou. job wait tenta novamente as falhas temporárias de leitura, como limitação ou uma
conexão perdida.
Erros ao acompanhar um trabalho
Estes códigos de erro apontam para a ID do trabalho,--batch-id ou --seller-id:
Atualizar um lote
batch update altera todas as contas de um lote: ele pode conceder a elas acesso a mais sandboxes,
remover o acesso, mudar quando esse acesso expira e adicionar marcas ao lote ou substituí-las. Em
seguida, ele aguarda até que o lote mostre a alteração.
Em um terminal, o comando primeiro mostra cada alteração solicitada ao lado do valor atual do lote,
avisa quando um trabalho ainda está em execução no lote e pede confirmação. Passe --confirm (--yes,
-y) para ignorar o prompt. Sem um terminal e sem --confirm, ele imprime as alterações,
recusa-se a continuar e não envia nada.
Passe pelo menos uma alteração. Um lote pode ter no máximo 20 marcas.
--replace-tags e
--clear-tags mantêm a marca que registra qual ferramenta criou o lote, que não conta
para o limite. Alterar sandboxes ou a expiração exige acesso a essas sandboxes;
estender a expiração exige acesso a todas as sandboxes do lote.
O comando retorna os valores do lote quando a atualização é concluída:
state é updated quando o lote mostra a alteração, ou updating com --no-wait ou quando
a espera termina antes. Quando o lote já tem todos os valores solicitados, nada muda:
state é unchanged, jobId é null e o comando sai com 0. Os trabalhos de atualização não podem ser
acompanhados com job get ou job wait.
Espera e códigos de saída ao atualizar
Erros ao atualizar
Um
404 ou 405 sem código significa que a atualização de lotes não está disponível.
Excluir um lote
batch delete exclui um lote inteiro e, em seguida, aguarda até que ele deixe de existir. Todas as contas do lote
perdem o acesso às sandboxes, e o registro de conta de teste delas é excluído. As contas
Microsoft e os perfis do XBOX das contas não são encerrados.
Em um terminal, o comando primeiro mostra o modelo de email, o tamanho e o criador do lote, avisa
quando um trabalho ainda está em execução nele e pede confirmação. Passe --confirm (--yes, -y) para ignorar o
prompt. Sem um terminal e sem --confirm, ele imprime o que excluiria, recusa-se a continuar
e não envia nada. Não há exclusão em massa; exclua os lotes um de cada vez.
O comando retorna:
state é deleted quando o lote deixa de existir, ou deleting com --no-wait ou quando a espera
termina antes. Os trabalhos de exclusão não podem ser acompanhados com job get ou job wait; enquanto a exclusão é executada,
o lote mostra a jobId dela.
Espera e códigos de saída ao excluir
Erros ao excluir
Um
404 ou 405 sem código significa que a exclusão de lotes não está disponível.
Saída em tabela
Todos os comandos aceitam--output table. Os horários são mostrados em UTC, e as linhas de resumo vão para
stderr; assim, stdout contém somente a tabela.
