플라이트에 대한 출시 중지하기
Microsoft Store 제출 API에서 이 메서드를 사용하여 패키지 플라이트 제출에 대한 출시를 중지합니다. Microsoft Store 제출 API를 사용하여 패키지 플라이트 제출을 만드는 프로세스의 절차에 대한 자세한 정보는 패키지 플라이트 제출 관리하기를 참조하세요.
참고
패키지 플라이트 제출에 대한 출시를 중지한 후 새 패키지 플라이트 제출을 생성할 경우 새 제출은 중지된 제출의 복제본입니다.
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 제출 API에 대한 모든 필수 조건을 완료합니다
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
- 여러 앱 중 하나에 대한 제출을 만듭니다. 이 작업은 파트너 센터에서 수행하거나 앱 제출 만들기 메서드를 사용하여 수행할 수 있습니다.
- 제출에 대해 점진적 패키지 출시를 사용하도록 설정합니다. 이 작업은 파트너 센터에서 수행하거나 Microsoft Store 제출 API를 사용하여 수행할 수 있습니다.
요청
이 메서드의 구문은 다음과 같습니다. 헤더 및 요청 매개 변수에 대한 사용 예시 및 설명은 다음의 섹션을 참조하세요.
| 메서드 | 요청 URI |
|---|---|
| 게시 | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/haltpackagerollout |
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | string | 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰. |
요청 매개 변수
| 속성 | 형식 | 설명 |
|---|---|---|
| applicationId | 문자열 | 필수입니다. 중지하려는 패키지 출시가 포함된 패키지 플라이트 제출을 포함하는 앱의 Store ID입니다. Store ID에 대한 자세한 정보는 앱 ID 세부 정보 보기를 참조하세요. |
| flightId | 문자열 | 필수입니다. 중지하려는 패키지 출시가 포함된 제출을 포함하는 플라이트 제출의 Store ID입니다. 이 ID는 패키지 플라이트 만들기 및 앱의 패키지 플라이트 가져오기 요청에 대한 응답 데이터에서 사용할 수 있습니다. 파트너 센터에서 만든 플라이트의 경우, 파트너 센터의 플라이트 페이지 URL에서도 이 ID를 사용할 수 있습니다. |
| submissionId | 문자열 | 필수입니다. 중지할 패키지 출시가 포함된 제출의 ID입니다. 이 ID는 패키지 플라이트 제출 만들기 요청에 대한 응답 데이터에서 사용할 수 있습니다. 파트너 센터에서 만든 제출의 경우, 파트너 센터의 제출 페이지 URL에서도 이 ID를 사용할 수 있습니다. |
요청 본문
이 메서드에 대한 요청 본문을 제공하지 마세요.
요청 예시
다음의 예시는 패키지 플라이트 제출에 대한 패키지 출시를 중지하는 방법을 보여 줍니다.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>
Response
다음 예시는 이 메서드를 성공적으로 호출하기 위한 JSON 응답 본문을 보여 줍니다. 응답 본문의 값에 대한 자세한 정보는 패키지 출시 리소스를 참조하세요.
{
"isPackageRollout": true,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutStopped",
"fallbackSubmissionId": "1212922684621243058"
}
오류 코드
요청을 성공적으로 완료할 수 없는 경우, 응답은 다음의 HTTP 오류 코드 중 하나를 포함합니다.
| 오류 코드 | 설명 |
|---|---|
| 404 | 패키지 플라이트 제출을 찾을 수 없습니다. |
| 409 | 이 코드는 다음의 오류 중 하나를 나타냅니다.
|