--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 suaccessExpirationDate, 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:
keywordsysandboxAccesssonnulla menos que pases--include-sandboxes.getsiempre los devuelve.isCompletesignifica que el trabajo de creación se detuvo, no que se crearon todas las cuentas. Compara el número de cuentas degetconbatchSize, y leeprogresspara ver el mensaje de estado.createdByes un identificador numérico de usuario de Partner Center.jobIdes el trabajo en ejecución del lote, y esnulluna 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 conjob wait.
get devuelve el mismo objeto de lote más sus cuentas:
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 getpara 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:
- What is your favorite hobby? (¿Cuál es tu pasatiempo favorito?)
- Who is your favorite athlete? (¿Quién es tu deportista favorito?)
- What is your maternal grandmother’s first name? (¿Cuál es el nombre de tu abuela materna?)
- What was your childhood best friend’s first name? (¿Cuál era el nombre de tu mejor amigo de la infancia?)
- What was the name of your first pet? (¿Cómo se llamaba tu primera mascota?)
- What is your current best friend’s first name? (¿Cuál es el nombre de tu mejor amigo actual?)
- What was your favorite city to visit as a child? (¿Cuál era tu ciudad favorita para visitar cuando eras niño?)
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-fileo--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.
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 quejob 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 error5xx, 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:
- Espera unos minutos; es posible que un lote que todavía se está creando aún no aparezca en la lista.
- 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. - Si el
jobIdde ese lote está establecido, haz su seguimiento conxbox test-account job wait <job-id> --batch-id <batch-id>. SijobIdesnull, el trabajo se ha detenido; inspecciónalo conxbox test-account batch get <batch-id>. - Vuelve a crear el lote solo si no existe ningún lote de ese tipo.
Errores al crear
Los errores escriben en stderr un error JSON constatus, 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.
