구독에 대한 Azure 권리 유형 가져오기

  • 아티클

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

파트너는 고객에 대한 구독 식별자의 자격을 가져오는 이 API를 사용하여 구독에 대한 Azure 자격을 볼 수 있습니다.

필수 조건

  • 자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
  • Customer_id.
  • Subscription_id.
  • Entitlement_id.

C#

Azure 구독을 취소하려면 취소하려는 Azure 구독에 대한 고객 ID, 구독 ID 및 자격 ID를 식별해야 합니다.

REST 요청

요청 구문

방법 요청 URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

URI 매개 변수

이 표에는 Azure 구독을 취소하는 데 필요한 쿼리 매개 변수가 나열됩니다.

이름 유형 필요함 설명
customer_id 문자열 Y 값은 고객의 식별자를 나타내는 문자열입니다.
subscription_id 문자열 Y 값은 고객의 식별자를 나타내는 문자열입니다.
entitlement_id 문자열 Y 값은 Azure 구독 자격의 식별자를 나타내는 문자열입니다.

요청 헤더

파트너 센터 REST 헤더를 참조 하세요.

요청 본문

요청 본문이 필요하지 않습니다.

요청 예제

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

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 자격을 찾을 수 없습니다.

응답 예제

응답은 지정된 고객에 대한 Azure 자격을 반환합니다.

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": “inactive", 
    "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": [] 
        } 
    }

다음 단계