Azure 구독 취소
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
손상되거나 남용되는 경우 Azure 고객 구독을 사용하는 파트너는 파트너 센터 포털 또는 API를 통해 직접 구독을 취소하여 Azure 플랜 구독에서 검색된 의심스러운 활동을 종료할 수 있습니다.
이 API는 Azure 구독을 취소합니다. 파트너가 둘 이상의 구독을 취소하려는 경우 API를 별도로 호출하여 각 구독을 취소해야 합니다.
파트너가 Azure 플랜을 일시 중단하려는 경우 사용 가능한 기존 API를 사용해야 하며 ID별로 구독을 업데이트합니다.
Azure 플랜 취소는 다음 API에서 지원되지 않습니다.
파트너는 취소하려면 관리자 에이전트 역할이 있는 전역 관리자여야 합니다.
필수 조건
파트너 센터 인증에 설명된 대로 자격 증명 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명으로 인증을 지원합니다.
Customer_id.
Subscription_id.
Entitlement_id.
C#
Azure 구독을 취소하려면 해당 구독에 대한 고객 ID, 구독 ID 및 권한 ID를 식별해야 합니다.
고객을 얻으려면 ID로 고객 가져오기 및 고객 ID별 고객 가져오기 - REST API를 참조하여 추가 도움말을 확인하세요.
구독을 가져오려면 ID별 구독 가져오기 및 ID별 구독 가져오기 - REST API를 참조하여 추가 도움말을 확인하세요.
자격을 얻으려면 구독에 대한 Azure 권한 가져오기 - REST API를 참조하세요.
REST 요청
요청 구문
| 방법 | 요청 URI |
|---|---|
| POST | {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1 |
URI 매개 변수
이 표에는 Azure 구독을 취소하는 데 필요한 쿼리 매개 변수가 나열됩니다.
| 이름 | 유형 | 필요함 | 설명 |
|---|---|---|---|
| customer_id | 문자열 | Y | 값은 고객의 식별자를 나타내는 문자열입니다. |
| subscription_id | 문자열 | Y | 값은 구독의 식별자를 나타내는 문자열입니다. |
| entitlement_id | 문자열 | Y | 값은 Azure 구독 자격의 식별자를 나타내는 문자열입니다. |
요청 헤더
파트너 센터 REST 헤더를 참조 하세요.
요청 본문
HTTP
{ "cancellationReason": "compromise" }
요청 예제
POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"friendlyName": "Cancel_Azure_Subscription ",
"status": "active",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"links": {
"self": {
"uri":
"/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
}
}
}
REST 응답
성공하면 이 메서드는 응답 본문의 구독 리소스에 대한 Azure 자격을 반환합니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.
| HTTP 상태 | HTTP 코드 | 오류 코드 | 설명 |
|---|---|---|---|
| BadRequest | 400 | 900118 | 고객 ID가 잘못되었습니다. |
| BadRequest | 400 | 800002 | 고객 ID {0} 에는 GUID 형식(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)이 있어야 합니다. |
| BadRequest | 400 | 800002 | 구독 ID가 필요합니다. |
| BadRequest | 400 | 800002 | 자격 ID가 필요합니다. |
| BadRequest | 400 | 800002 | Azure 권한 취소 요청 콘텐츠가 필요합니다. |
| 금지 | 403 | 900159 | 계정 ID 및 조직 ID를 가진 파트너는 계정 ID {0} {2} 및 조직 ID {1} {3}를 가진 고객과의 상거래 관계가 없습니다. |
| BadRequest | 400 | 900307 | 취소 이유 '{0} 가 잘못되었습니다. |
| NotFound | 404 | 800111 | ID {0} 가 있는 Azure 자격을 찾을 수 없습니다. |
응답 예제
구독 취소에 대한 응답에는 자격 상태가 포함됩니다. 상태가 반영되는 데 약 10분이 필요합니다(즉, 활성에서 비활성 상태로).
HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"links": {
"self": {
"uri":
"/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
}
}