메인 콘텐츠로 건너뛰기
릴리스 간에 명령이 얼마나 변경될 수 있는지는 CLI의 버전과 도움말에서 해당 명령에 [Experimental] 레이블이 지정되어 있는지에 따라 달라집니다. 명령 그룹의 레이블은 그룹에 속한 모든 명령에 적용됩니다.

1.0 이전

1.0 릴리스 전까지 XBOX CLI는 미리 보기 상태이며, 실험적 레이블 지정 여부와 관계없이 모든 명령이 릴리스 간에 변경되거나 제거될 수 있습니다. 여기에는 명령의 경로, 인수, 옵션, 기본값, 구조화된 출력 및 종료 코드가 포함됩니다. 자동화를 위해서는 테스트된 CLI 버전을 고정하고 업그레이드하기 전에 워크플로를 테스트하세요.

1.0부터

1.0 릴리스부터 실험적 레이블이 지정되지 않은 명령은 문서화된 계약을 유지합니다. 자동화를 중단시키는 변경은 호환성이 깨지는 변경이라고 명시한 릴리스에서만 제공됩니다. 계약에는 다음이 포함됩니다.
  • 명령 및 하위 명령 경로.
  • 인수 및 옵션 이름과 의미.
  • 필수 입력.
  • 문서화된 기본값.
  • 필드 이름과 의미를 포함한 문서화된 JSON 출력.
  • 문서화된 종료 코드.
새 명령, 옵션 및 JSON 속성은 모든 릴리스에서 추가될 수 있으므로 스크립트는 인식하지 못하는 JSON 속성을 무시해야 합니다. 텍스트 및 표와 같이 사람이 읽도록 작성된 출력은 계약에 포함되지 않습니다.

API 패스스루

xbox playfab api처럼 명령이 서비스의 응답을 그대로 반환하는 경우, 해당 응답은 CLI가 아니라 서비스 자체의 호환성 계약을 따릅니다. CLI의 입력, 종료 코드 및 CLI가 추가하는 출력(예: --data-only가 제거하는 응답 봉투)은 여전히 계약에 포함됩니다.

실험적

실험적 명령은 인터페이스에 대한 피드백을 받기 위해 릴리스됩니다. 1.0 이후에도 경로, 옵션, 기본값, 출력 및 동작이 변경되거나 명령이 제거될 수 있으므로, 이러한 명령을 사용하는 자동화가 계속 호환될 것이라고 가정하지 마세요. 실험적 명령은 완성되고 테스트되었으며, 파괴적 작업 전 확인을 포함하여 다른 모든 명령과 동일한 보안 및 안전 규칙을 따릅니다. 다른 명령처럼 실행되므로 따로 켤 필요가 없습니다.
마지막 수정일 2026년 11월 19일