Saltar al contenido principal
Las cuentas de prueba de XBOX se crean en lotes para un vendedor de Partner Center. Estos comandos crean, actualizan y eliminan lotes, hacen el seguimiento del trabajo que crea las cuentas, y leen los lotes y las cuentas que contienen. No pueden cambiar cuentas individuales y nunca devuelven contraseñas. Tu cuenta necesita el rol de cuentas de prueba de Partner Center para el vendedor. Todos los comandos aceptan --seller-id. Sin esta opción, un comando usa XBOX_SELLER_ID o el vendedor guardado con xbox context set y, después, tu único vendedor; si tienes varios, pasa --seller-id.

Comandos

batch create, batch update y batch delete preguntan antes de cambiar nada, y se envían una sola vez sin reintentos. Consulta Seguridad y operaciones destructivas.

Opciones para leer lotes

Las etiquetas aparecen como keywords en la salida JSON y en códigos de error como test_account_keyword_invalid. --tag coincide con una etiqueta completa, no con parte de una. Si no puedes leer todos los lotes del vendedor, no recibes ningún error: batch list devuelve solo los lotes que creaste.

Lotes expirados

Un lote ha expirado una vez que ha pasado su accessExpirationDate, la fecha en que termina su acceso a los sandboxes. Un lote sin fecha nunca expira. La expiración no indica si las cuentas todavía pueden iniciar sesión. batch list --expired lee la lista completa del vendedor para encontrar los lotes expirados, por lo que es más lento para un vendedor con muchos lotes. No se puede combinar con --include-sandboxes; ejecuta batch get en un lote expirado para ver su acceso a los sandboxes.

Forma de la respuesta

list devuelve:
  • keywords y sandboxAccess son null a menos que pases --include-sandboxes. get siempre los devuelve.
  • isComplete significa que el trabajo de creación se detuvo, no que se crearon todas las cuentas. Compara el número de cuentas de get con batchSize, y lee progress para ver el mensaje de estado.
  • createdBy es un identificador numérico de usuario de Partner Center.
  • jobId es el trabajo en ejecución del lote, y es null una vez que el trabajo se ha detenido. Los trabajos de actualización y eliminación también aparecen aquí, pero solo se puede hacer el seguimiento de un trabajo de creación con job wait.
get devuelve el mismo objeto de lote más sus cuentas:
Cada cuenta tiene solo xuid, email, gamertag e isDeleted. xuid es una cadena.

Errores al leer lotes

batch list, batch get y test-account get salen con 1 cuando se produce un error. Cuando el servicio devuelve un error JSON, stderr recibe un error JSON con status, title, detail, code cuando la respuesta incluye uno, y su correlationId; la mayoría agregan una sugerencia a detail. Otros errores imprimen una línea de texto. Comprueba el código de salida antes de analizar stderr.

Búsqueda de una cuenta

test-account get <email> indica si el lote que contiene una cuenta ha expirado. El correo electrónico debe terminar en @xboxtest.com. El comando busca en los 10 lotes más recientes cuya plantilla de correo electrónico coincide con el nombre de la cuenta. Cuando no encuentra la cuenta allí, indica que no se buscó en los lotes más antiguos e imprime comandos batch list y batch get para que los compruebes tú mismo. Devuelve lo siguiente, abreviado aquí; batch contiene todos los campos de lote que devuelve batch list:
expiredOn es null cuando el lote no ha expirado. Una cuenta eliminada solo se notifica cuando no existe ninguna copia activa, con account.isDeleted establecido. El comando sale con 0 siempre que encuentra la cuenta, haya expirado o no, por lo que los scripts deben leer expired. Sale con 1 cuando:
  • La cuenta no está en los lotes que puedes ver. Es posible que pertenezca a otro vendedor, así que prueba con --seller-id, o que otro desarrollador haya creado su lote y no puedas leer todos los lotes del vendedor.
  • El correo electrónico aparece en más de un lote. stderr enumera un comando batch get para cada uno.
  • Se produce un error en una solicitud, como en Errores al leer lotes.

Creación de un lote

batch create inicia un trabajo que crea las cuentas y, después, espera a que se detenga. Las cuentas cuentan para el límite de cuentas de prueba del vendedor hasta que el lote se elimina. En un terminal, el comando muestra el selector de pregunta de seguridad, enumera los valores que enviará, incluidos los valores predeterminados de las opciones que omitiste, y te pide que confirmes. A continuación, te solicita la contraseña y la respuesta de seguridad, inicia sesión y envía la solicitud. --confirm (--yes, -y) omite solo la confirmación. Sin un terminal, pasa --password-file, --security-answer-file y --confirm. Sin --confirm, el comando imprime los valores, se niega y no envía nada.

Elección de una pregunta de seguridad

En un terminal, cuando no pasas --security-question ni --security-answer-file, el comando muestra un selector numerado con estas preguntas. Al pulsar Entrar se selecciona la primera. Para elegir una sin el selector, pasa su texto con --security-question:
  1. What is your favorite hobby? (¿Cuál es tu pasatiempo favorito?)
  2. Who is your favorite athlete? (¿Quién es tu deportista favorito?)
  3. What is your maternal grandmother’s first name? (¿Cuál es el nombre de tu abuela materna?)
  4. What was your childhood best friend’s first name? (¿Cuál era el nombre de tu mejor amigo de la infancia?)
  5. What was the name of your first pet? (¿Cómo se llamaba tu primera mascota?)
  6. What is your current best friend’s first name? (¿Cuál es el nombre de tu mejor amigo actual?)
  7. What was your favorite city to visit as a child? (¿Cuál era tu ciudad favorita para visitar cuando eras niño?)
Pasa el texto en inglés tal como aparece en la lista. Sin un terminal, o con un archivo de respuesta y sin pregunta, la pregunta es What is your favorite hobby?. Ctrl+C en el selector cancela sin crear nada. Elegir una pregunta no confirma la creación.

Secretos

La contraseña y la respuesta de seguridad nunca se aceptan como valores de opción ni como variables de entorno, de modo que no aparecen en el historial del shell, en las listas de procesos ni en los registros. Cada una procede de:
  • Su --password-file o --security-answer-file. Se quita un único salto de línea final.
  • - en lugar de una ruta de acceso, que la lee desde stdin. Solo una de las dos puede leer stdin.
  • Sin opción de archivo, una solicitud en el terminal que no muestra lo que escribes.
La contraseña debe tener entre 8 y 16 caracteres y contener al menos tres de los siguientes elementos: letras minúsculas, letras mayúsculas, números y símbolos. El guion bajo no cuenta como símbolo. La contraseña no puede coincidir con la respuesta de seguridad.

Espera y códigos de salida

Mientras espera, el comando imprime el progreso en stderr. Escribe el trabajo final en stdout, con la misma forma que job get.

Cuando el resultado es desconocido

Cuando la CLI no puede saber si el servicio creó un lote, por ejemplo cuando la conexión se interrumpe después de enviar la solicitud o el servicio devuelve un error 5xx, sale con 3. Nunca vuelve a enviar la creación. stderr imprime la hora a la que se inició la solicitud, en UTC, y estos pasos:
  1. Espera unos minutos; es posible que un lote que todavía se está creando aún no aparezca en la lista.
  2. Ejecuta xbox test-account batch list --mine --email-prefix <prefix> y busca un lote con el mismo prefijo de correo electrónico y la misma plantilla, creado a esa hora o después.
  3. Si el jobId de ese lote está establecido, haz su seguimiento con xbox test-account job wait <job-id> --batch-id <batch-id>. Si jobId es null, el trabajo se ha detenido; inspecciónalo con xbox test-account batch get <batch-id>.
  4. Vuelve a crear el lote solo si no existe ningún lote de ese tipo.
Los comandos impresos conservan las opciones de vendedor, perfil e inicio de sesión que usaste, por lo que puedes copiarlos tal como están.

Errores al crear

Los errores escriben en stderr un error JSON con status, title, detail y code cuando la respuesta incluye uno. Bifurca según code, no según detail.

Seguimiento de un trabajo de creación

batch create imprime los identificadores del lote y del trabajo en cuanto se acepta el trabajo. Un trabajo puede ejecutarse durante días, por lo que puedes dejar de esperar en cualquier momento y hacer su seguimiento más adelante: Ambos devuelven el trabajo:
state es running, succeeded o failed. errorCode es test_account_job_failed cuando el trabajo produjo un error. job wait reintenta los errores de lectura temporales, como la limitación o una conexión interrumpida.

Errores al hacer el seguimiento de un trabajo

Estos códigos de error apuntan al identificador del trabajo, a --batch-id o a --seller-id:

Actualización de un lote

batch update cambia todas las cuentas de un lote: puede darles acceso a más sandboxes, quitarles acceso, mover la fecha en que expira ese acceso, y agregar etiquetas al lote o reemplazarlas. Después, espera hasta que el lote muestre el cambio. En un terminal, el comando muestra primero cada cambio solicitado junto al valor actual del lote, advierte cuando todavía se está ejecutando un trabajo en el lote, y pregunta. Pasa --confirm (--yes, -y) para omitir la solicitud. Sin un terminal y sin --confirm, imprime los cambios, se niega y no envía nada. Pasa al menos un cambio. Un lote puede tener como máximo 20 etiquetas. --replace-tags y --clear-tags conservan la etiqueta que registra qué herramienta creó el lote, que no cuenta para el límite. Cambiar los sandboxes o la expiración requiere acceso a esos sandboxes; ampliar la expiración requiere acceso a todos los sandboxes del lote. El comando devuelve los valores del lote una vez completada la actualización:
state es updated una vez que el lote muestra el cambio, o updating con --no-wait o cuando la espera termina antes. Cuando el lote ya tiene todos los valores solicitados, no cambia nada: state es unchanged, jobId es null y el comando sale con 0. No se puede hacer el seguimiento de los trabajos de actualización con job get ni job wait.

Espera y códigos de salida al actualizar

Errores al actualizar

Un 404 o 405 sin código significa que la actualización de lotes no está disponible.

Eliminación de un lote

batch delete elimina un lote completo y, después, espera hasta que desaparezca. Cada cuenta del lote pierde su acceso a los sandboxes, y se elimina su registro de cuenta de prueba. Las cuentas Microsoft y los perfiles de XBOX de las cuentas no se cierran. En un terminal, el comando muestra primero la plantilla de correo electrónico, el tamaño y el creador del lote, advierte cuando todavía se está ejecutando un trabajo en él, y pregunta. Pasa --confirm (--yes, -y) para omitir la solicitud. Sin un terminal y sin --confirm, imprime lo que eliminaría, se niega y no envía nada. No hay eliminación masiva; elimina los lotes de uno en uno. El comando devuelve:
state es deleted una vez que el lote ha desaparecido, o deleting con --no-wait o cuando la espera termina antes. No se puede hacer el seguimiento de los trabajos de eliminación con job get ni job wait; mientras se ejecuta la eliminación, el lote muestra su jobId.

Espera y códigos de salida al eliminar

Errores al eliminar

Un 404 o 405 sin código significa que la eliminación de lotes no está disponible.

Salida de tabla

Todos los comandos aceptan --output table. Las horas se muestran en UTC, y las líneas de resumen van a stderr, de modo que stdout contiene solo la tabla.

Ejemplos

Estos comandos enumeran y leen lotes, cuentas y trabajos:
Crea un lote de cinco cuentas. El comando solicita la contraseña y la respuesta de seguridad y, después, te pide que confirmes:
Crea un lote de forma desatendida, con los secretos leídos desde archivos, sin solicitud de confirmación y con una espera de hasta 30 minutos:
Espera hasta dos horas a que termine un trabajo de creación:
Agrega un sandbox y establece cuándo expira el acceso a los sandboxes. El comando muestra los cambios, te pide que confirmes y, después, espera hasta que el lote los muestre:
Agrega dos etiquetas de forma desatendida, sin esperar:
Reemplaza todas las etiquetas por una:
Elimina un lote. El comando muestra el lote, te pide que confirmes y, después, espera hasta que desaparezca:
Elimina un lote que creó otro desarrollador, de forma desatendida y sin esperar:
Última modificación el 19 de noviembre de 2026