Pular para o conteúdo principal
As contas de teste do XBOX são criadas em lotes para um vendedor do Partner Center. Estes comandos criam, atualizam e excluem lotes, acompanham o trabalho que cria as contas e leem os lotes e as contas que eles contêm. Eles não podem alterar contas individuais e nunca retornam senhas. Sua conta precisa da função de conta de teste do Partner Center para o vendedor. Todos os comandos aceitam --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 sua accessExpirationDate, 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:
  • keywords e sandboxAccess são null, a menos que você passe --include-sandboxes. get sempre os retorna.
  • isComplete significa que o trabalho de criação parou, e não que todas as contas foram criadas. Compare o número de contas de get com batchSize e leia progress para 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 ser null quando 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 com job wait.
get retorna o mesmo objeto de lote, além das contas dele:
Cada conta tem somente 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 get para 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:
  1. What is your favorite hobby?
  2. Who is your favorite athlete?
  3. What is your maternal grandmother’s first name?
  4. What was your childhood best friend’s first name?
  5. What was the name of your first pet?
  6. What is your current best friend’s first name?
  7. What was your favorite city to visit as a child?
Sem um terminal, ou com um arquivo de resposta e nenhuma pergunta, a pergunta é 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-file ou --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.
A senha deve ter de 8 a 16 caracteres e conter pelo menos três destes tipos: letras minúsculas, letras maiúsculas, números e símbolos. O sublinhado não conta como símbolo. A senha não pode ser igual à resposta de segurança.

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 de job 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 erro 5xx, 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:
  1. Aguarde alguns minutos; um lote que ainda está sendo criado pode não estar listado ainda.
  2. 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.
  3. Se o jobId desse lote estiver definido, acompanhe-o com xbox test-account job wait <job-id> --batch-id <batch-id>. Se jobId for null, o trabalho parou; inspecione-o com xbox test-account batch get <batch-id>.
  4. Crie novamente somente se esse lote não existir.
Os comandos impressos mantêm as opções de vendedor, perfil e entrada que você usou; portanto, você pode copiá-los como estão.

Erros ao criar

As falhas gravam em stderr um erro JSON com status, 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.

Exemplos

Estes comandos listam e leem lotes, contas e trabalhos:
Crie um lote de cinco contas. O comando solicita a senha e a resposta de segurança e, em seguida, pede sua confirmação:
Crie um lote sem supervisão, com os segredos lidos de arquivos, sem prompt e com uma espera de até 30 minutos:
Aguarde até duas horas para que um trabalho de criação termine:
Adicione uma sandbox e defina quando o acesso às sandboxes expira. O comando mostra as alterações, pede sua confirmação e, em seguida, aguarda até que o lote as mostre:
Adicione duas marcas sem supervisão, sem aguardar:
Substitua todas as marcas por uma:
Exclua um lote. O comando mostra o lote, pede sua confirmação e, em seguida, aguarda até que ele deixe de existir:
Exclua um lote criado por outro desenvolvedor, sem supervisão e sem aguardar:
Última modificação em 19 de novembro de 2026