Azure 구독 취소

아티클
02/05/2024

적용 대상: 파트너 센터 | 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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
 "links": {
  "self": {
  "uri":
  "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
  "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: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
"links": {
"self": {
"uri":
"/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"method": "GET",
"headers": []
 }
}

Share via