메인 콘텐츠로 건너뛰기
XBOX 테스트 계정은 Partner Center 판매자에 대해 배치 단위로 생성됩니다. 이 명령은 배치를 생성, 업데이트 및 삭제하고, 계정을 생성하는 작업을 추적하며, 배치와 그 안의 계정을 읽습니다. 개별 계정은 변경할 수 없으며, 암호는 절대 반환하지 않습니다. 계정에 해당 판매자에 대한 Partner Center 테스트 계정 역할이 있어야 합니다. 모든 명령은 --seller-id를 사용합니다. 이 옵션이 없으면 명령은 XBOX_SELLER_ID 또는 xbox context set으로 저장한 판매자를 사용하고, 그다음에는 유일한 판매자를 사용합니다. 판매자가 여러 개라면 --seller-id를 전달하세요.

명령

batch create, batch update, batch delete는 무언가를 변경하기 전에 묻고, 한 번만 전송되며 절대 다시 시도되지 않습니다. 안전 및 파괴적 작업을 참조하세요.

배치 읽기 옵션

태그는 JSON 출력과 test_account_keyword_invalid 같은 오류 코드에서 keywords로 나타납니다. --tag는 태그의 일부가 아니라 태그 전체와 일치합니다. 판매자의 모든 배치를 읽을 수 없는 경우 오류가 발생하지 않으며, batch list는 직접 생성한 배치만 반환합니다.

만료된 배치

배치는 샌드박스 액세스가 끝나는 날짜인 accessExpirationDate가 지나면 만료됩니다. 날짜가 없는 배치는 만료되지 않습니다. 만료 여부는 계정이 여전히 로그인할 수 있는지를 나타내지 않습니다. batch list --expired는 만료된 배치를 찾기 위해 판매자의 전체 목록을 읽으므로, 배치가 많은 판매자의 경우 더 느립니다. --include-sandboxes와 함께 사용할 수 없으며, 만료된 배치의 샌드박스 액세스를 보려면 해당 배치에 대해 batch get을 실행하세요.

응답 형식

list는 다음을 반환합니다.
  • keywords와 sandboxAccess는 --include-sandboxes를 전달하지 않으면 null입니다. get은 항상 이 값을 반환합니다.
  • isComplete는 모든 계정이 생성되었다는 뜻이 아니라 생성 작업이 중지되었다는 뜻입니다. get의 계정 수를 batchSize와 비교하고, 상태 메시지는 progress에서 확인하세요.
  • createdBy는 숫자 Partner Center 사용자 ID입니다.
  • jobId는 배치에서 실행 중인 작업이며, 작업이 중지되면 null입니다. 업데이트 및 삭제 작업도 여기에 표시되지만, job wait로 추적할 수 있는 것은 생성 작업뿐입니다.
get은 같은 배치 개체와 그 계정을 반환합니다.
각 계정에는 xuid, email, gamertag, isDeleted만 있습니다. xuid는 문자열입니다.

배치를 읽을 때의 오류

batch list, batch get, test-account get은 실패하면 1로 종료합니다. 서비스가 JSON 오류를 반환하면 stderr에 status, title, detail, 응답에 포함된 경우 code, 그리고 correlationId가 있는 JSON 오류가 출력되며, 대부분 detail에 힌트를 추가합니다. 그 밖의 실패는 텍스트 한 줄을 출력합니다. stderr를 구문 분석하기 전에 종료 코드를 확인하세요.

계정 조회

test-account get <email>은 계정이 속한 배치가 만료되었는지 알려 줍니다. 이메일은 @xboxtest.com으로 끝나야 합니다. 이 명령은 이메일 템플릿이 계정 이름과 일치하는 최신 배치 10개를 검색합니다. 그 안에서 계정을 찾지 못하면 이전 배치는 검색하지 않았다고 알리고, 직접 확인할 수 있도록 batch list 및 batch get 명령을 출력합니다. 다음을 반환합니다(여기서는 축약됨). batch에는 batch list가 반환하는 모든 배치 필드가 포함됩니다.
배치가 만료되지 않았으면 expiredOn은 null입니다. 삭제된 계정은 활성 사본이 없을 때만 account.isDeleted가 설정된 상태로 보고됩니다. 명령은 계정을 찾으면 만료 여부와 관계없이 0으로 종료하므로, 스크립트는 expired를 읽어야 합니다. 다음 경우에는 1로 종료합니다.
  • 볼 수 있는 배치에 계정이 없습니다. 계정이 다른 판매자에 속할 수 있으므로 --seller-id를 사용해 보거나, 다른 개발자가 계정의 배치를 생성했고 판매자의 모든 배치를 읽을 수 없는 경우입니다.
  • 이메일이 둘 이상의 배치에 나타납니다. stderr에 각 배치에 대한 batch get 명령이 나열됩니다.
  • 배치를 읽을 때의 오류에서처럼 요청이 실패합니다.

배치 생성

batch create는 계정을 생성하는 작업을 시작한 다음 작업이 중지될 때까지 기다립니다. 계정은 배치가 삭제될 때까지 판매자의 테스트 계정 한도에 포함됩니다. 터미널에서는 명령이 보안 질문 선택기를 표시하고, 생략한 옵션의 기본값을 포함하여 보낼 값을 나열하고, 확인을 요청합니다. 그런 다음 암호와 보안 답변을 입력하라는 메시지를 표시하고, 로그인하고, 요청을 보냅니다. --confirm(--yes, -y)은 확인만 건너뜁니다. 터미널이 없으면 --password-file, --security-answer-file, --confirm을 전달하세요. --confirm이 없으면 명령은 값을 출력하고 거부하며 아무것도 보내지 않습니다.

보안 질문 선택

터미널에서 --security-question과 --security-answer-file을 모두 전달하지 않으면 명령이 다음 질문의 번호 매기기 선택기를 표시합니다. Enter를 누르면 첫 번째 질문이 선택됩니다. 선택기 없이 질문을 선택하려면 --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?
터미널이 없거나, 답변 파일은 있지만 질문이 없으면 질문은 What is your favorite hobby?입니다. 선택기에서 Ctrl+C를 누르면 아무것도 생성하지 않고 취소됩니다. 질문을 선택해도 생성이 확인되지는 않습니다.

비밀

암호와 보안 답변은 옵션 값이나 환경 변수로 절대 받지 않으므로 셸 기록, 프로세스 목록, 로그에 남지 않습니다. 각 값은 다음에서 가져옵니다.
  • 해당 --password-file 또는 --security-answer-file. 끝에 있는 줄 바꿈 하나는 제거됩니다.
  • 경로 대신 -를 사용하면 stdin에서 읽습니다. 둘 중 하나만 stdin에서 읽을 수 있습니다.
  • 파일 옵션이 없으면 입력 내용을 표시하지 않는 터미널 프롬프트.
암호는 8~16자여야 하며 소문자, 대문자, 숫자, 기호 중 세 가지 이상을 포함해야 합니다. 밑줄은 기호로 간주되지 않습니다. 암호는 보안 답변과 같을 수 없습니다.

대기 및 종료 코드

기다리는 동안 명령은 진행 상황을 stderr에 출력합니다. 최종 작업은 job get과 같은 형식으로 stdout에 씁니다.

결과를 알 수 없는 경우

요청이 전송된 후 연결이 끊기거나 서비스가 5xx 오류를 반환하는 경우처럼 서비스가 배치를 생성했는지 CLI가 알 수 없으면 3으로 종료합니다. 생성 요청을 다시 보내지는 않습니다. stderr에 요청이 시작된 시간(UTC)과 다음 단계가 출력됩니다.
  1. 몇 분 기다립니다. 아직 생성 중인 배치는 목록에 표시되지 않을 수 있습니다.
  2. xbox test-account batch list --mine --email-prefix <prefix>를 실행하고, 이메일 접두사와 템플릿이 같고 해당 시간 또는 그 이후에 생성된 배치를 찾습니다.
  3. 해당 배치의 jobId가 설정되어 있으면 xbox test-account job wait <job-id> --batch-id <batch-id>로 추적합니다. jobId가 null이면 작업이 중지된 것이므로 xbox test-account batch get <batch-id>로 검사합니다.
  4. 그러한 배치가 없을 때만 다시 생성합니다.
출력된 명령에는 사용한 판매자, 프로필, 로그인 옵션이 유지되므로 그대로 복사할 수 있습니다.

생성 시 오류

실패하면 status, title, detail, 응답에 포함된 경우 code가 있는 JSON 오류를 stderr에 씁니다. detail이 아니라 code를 기준으로 분기하세요.

생성 작업 추적

batch create는 작업이 수락되는 즉시 배치 ID와 작업 ID를 출력합니다. 작업은 며칠 동안 실행될 수 있으므로 언제든지 대기를 멈추고 나중에 추적할 수 있습니다. 두 명령 모두 작업을 반환합니다.
state는 running, succeeded 또는 failed입니다. 작업이 실패하면 errorCode는 test_account_job_failed입니다. job wait는 제한이나 연결 끊김 같은 일시적인 읽기 실패를 다시 시도합니다.

작업 추적 시 오류

다음 오류 코드는 작업 ID, --batch-id 또는 --seller-id를 가리킵니다.

배치 업데이트

batch update는 배치의 모든 계정을 변경합니다. 더 많은 샌드박스에 대한 액세스 권한을 부여하거나, 액세스 권한을 제거하거나, 액세스 만료 시점을 옮기거나, 배치의 태그를 추가하거나 대체할 수 있습니다. 그런 다음 배치에 변경 내용이 표시될 때까지 기다립니다. 터미널에서는 명령이 먼저 요청된 각 변경 내용을 배치의 현재 값과 함께 표시하고, 배치에서 작업이 아직 실행 중이면 경고한 다음 묻습니다. 프롬프트를 건너뛰려면 --confirm(--yes, -y)을 전달하세요. 터미널이 없고 --confirm도 없으면 변경 내용을 출력하고 거부하며 아무것도 보내지 않습니다. 변경 내용을 하나 이상 전달하세요. 배치에는 태그를 최대 20개까지 지정할 수 있습니다. --replace-tags와 --clear-tags는 배치를 생성한 도구를 기록하는 태그를 유지하며, 이 태그는 한도에 포함되지 않습니다. 샌드박스나 만료를 변경하려면 해당 샌드박스에 대한 액세스 권한이 필요하며, 만료를 연장하려면 배치의 모든 샌드박스에 대한 액세스 권한이 필요합니다. 업데이트가 완료되면 명령은 배치의 값을 반환합니다.
state는 배치에 변경 내용이 표시되면 updated이고, --no-wait를 사용했거나 대기가 먼저 끝나면 updating입니다. 배치에 요청한 모든 값이 이미 있으면 아무것도 변경되지 않으며, state는 unchanged, jobId는 null이고 명령은 0으로 종료합니다. 업데이트 작업은 job get이나 job wait로 추적할 수 없습니다.

업데이트 시 대기 및 종료 코드

업데이트 시 오류

코드 없는 404 또는 405는 배치 업데이트를 사용할 수 없다는 뜻입니다.

배치 삭제

batch delete는 배치 전체를 삭제한 다음 배치가 없어질 때까지 기다립니다. 배치의 모든 계정은 샌드박스 액세스 권한을 잃고, 테스트 계정 레코드가 삭제됩니다. 계정의 Microsoft 계정과 XBOX 프로필은 해지되지 않습니다. 터미널에서는 명령이 먼저 배치의 이메일 템플릿, 크기, 생성자를 표시하고, 배치에서 작업이 아직 실행 중이면 경고한 다음 묻습니다. 프롬프트를 건너뛰려면 --confirm(--yes, -y)을 전달하세요. 터미널이 없고 --confirm도 없으면 삭제할 내용을 출력하고 거부하며 아무것도 보내지 않습니다. 일괄 삭제는 없으므로 배치를 하나씩 삭제하세요. 명령은 다음을 반환합니다.
state는 배치가 없어지면 deleted이고, --no-wait를 사용했거나 대기가 먼저 끝나면 deleting입니다. 삭제 작업은 job get이나 job wait로 추적할 수 없습니다. 삭제가 실행되는 동안 배치에 jobId가 표시됩니다.

삭제 시 대기 및 종료 코드

삭제 시 오류

코드 없는 404 또는 405는 배치 삭제를 사용할 수 없다는 뜻입니다.

테이블 출력

모든 명령은 --output table을 허용합니다. 시간은 UTC로 표시되고 요약 줄은 stderr로 출력되므로, stdout에는 테이블만 남습니다.

예제

다음 명령은 배치, 계정, 작업을 나열하고 읽습니다.
계정 5개로 구성된 배치를 생성합니다. 명령은 암호와 보안 답변을 입력하라는 메시지를 표시한 다음 확인을 요청합니다.
파일에서 비밀을 읽고, 프롬프트 없이, 최대 30분 동안 기다리도록 무인으로 배치를 생성합니다.
생성 작업이 끝날 때까지 최대 2시간 동안 기다립니다.
샌드박스를 추가하고 샌드박스 액세스 만료 시점을 설정합니다. 명령은 변경 내용을 표시하고 확인을 요청한 다음, 배치에 변경 내용이 표시될 때까지 기다립니다.
기다리지 않고 무인으로 태그 두 개를 추가합니다.
모든 태그를 태그 하나로 대체합니다.
배치를 삭제합니다. 명령은 배치를 표시하고 확인을 요청한 다음, 배치가 없어질 때까지 기다립니다.
다른 개발자가 생성한 배치를 기다리지 않고 무인으로 삭제합니다.
마지막 수정일 2026년 11월 19일