Pular para o conteúdo principal
O quanto um comando pode mudar entre versões depende da versão da CLI e de a Ajuda rotular ou não o comando como [Experimental]. Um rótulo em um grupo de comandos se aplica a todos os comandos do grupo.

Antes da 1.0

Até a versão 1.0, a XBOX CLI está em versão prévia, e qualquer comando pode mudar ou ser removido entre versões, esteja ele rotulado como Experimental ou não. Isso inclui seus caminhos, argumentos, opções, padrões, saída estruturada e códigos de saída. Para automação, fixe uma versão testada da CLI e teste seus fluxos de trabalho antes de atualizar.

A partir da 1.0

A partir da versão 1.0, os comandos que não estão rotulados como Experimental mantêm seu contrato documentado. Uma alteração que interrompa a automação só vem em uma versão que declare ser uma alteração interruptiva. O contrato abrange:
  • Caminhos de comandos e subcomandos.
  • Nomes e significados de argumentos e opções.
  • Quais entradas são obrigatórias.
  • Padrões documentados.
  • Saída JSON documentada, incluindo nomes e significados de campos.
  • Códigos de saída documentados.
Novos comandos, opções e propriedades JSON podem aparecer em qualquer versão; portanto, seus scripts devem ignorar as propriedades JSON que não reconhecem. A saída escrita para pessoas, como texto e tabelas, não faz parte do contrato.

Passagem direta da API

Quando um comando retorna a resposta de um serviço como ela é, como faz xbox playfab api, essa resposta segue o contrato de compatibilidade do próprio serviço, não o da CLI. As entradas da CLI, os códigos de saída e a saída que ela adiciona, como o envelope de resposta que --data-only remove, continuam abrangidos.

Experimental

Os comandos experimentais são lançados para coletar comentários sobre a interface. Mesmo após a 1.0, seus caminhos, opções, padrões, saída e comportamento podem mudar, ou os comandos podem ser removidos; portanto, não conte com a permanência da compatibilidade de automações que os utilizam. Os comandos experimentais estão concluídos e testados e seguem as mesmas regras de segurança e proteção que todos os outros comandos, incluindo a confirmação antes de operações destrutivas. Eles são executados como qualquer outro comando; você não precisa ativá-los.
Última modificação em 19 de novembro de 2026