구독에 대한 Azure 자격 가져오기
에 적용: 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드의 파트너 센터
파트너는 고객에 대한 구독 식별자의 자격을 가져오는 이 API를 사용하여 구독에 대한 Azure 자격을 볼 수 있습니다.
필수 구성 요소
- 자격 증명은 파트너 센터 인증에 설명된 대로입니다. 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
- 고객 ID.
- 구독_아이디 (Subscription_id)
- 권한_ID.
C#
Azure 구독을 취소하려면 취소하려는 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} HTTP/1.1 |
URI 매개 변수
이 표에는 Azure 구독을 취소하는 데 필요한 쿼리 매개 변수가 나열됩니다.
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| 고객 ID | 문자열 | Y | 값은 고객의 식별자를 나타내는 문자열입니다. |
| subscription_id (구독 ID) | 문자열 | Y | 값은 고객의 식별자를 나타내는 문자열입니다. |
| 사용권_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: aaaa0000-bb11-2222-33cc-444444dddddd
REST 응답
성공하면 이 메서드는 응답 본문의 구독 리소스에 대한 Azure 자격을 반환합니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.
| HTTP 상태 | HTTP 코드 | 오류 코드 | 설명 |
|---|---|---|---|
| 잘못된 요청 | 400 | 900118 | 고객 ID가 잘못되었습니다. |
| 잘못된 요청 | 400 | 800002 | 고객 ID {0}는 GUID 형식(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)이어야 합니다. |
| 잘못된 요청 | 400 | 800002 | 구독 ID가 필요합니다. |
| 잘못된 요청 | 400 | 800002 | 자격 ID가 필요합니다. |
| 잘못된 요청 | 400 | 800002 | Azure 권한 취소 요청 콘텐츠가 필요합니다. |
| 금지된 | 403 | 900159 | 계정 ID {0} 및 조직 ID {1} 파트너는 계정 ID {2} 및 조직 ID {3}고객과 상거래 관계가 없습니다. |
| 잘못된 요청 | 400 | 900307 | 취소 이유 '{0} 잘못되었습니다. |
| 찾을 수 없음 | 404 | 800111 | ID {0}의 Azure 자격이 발견되지 않았습니다. |
응답 예제
응답은 지정된 고객에 대한 Azure 자격을 반환합니다.
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": “inactive",
"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": []
}
}
관련 콘텐츠
- Azure 플랜 - 구독 & 리소스 관리
- Azure 사용 지출 - Azure 사용 권한 취소 - REST API
- Azure 구독 취소 - 파트너 센터 앱 개발자
- Azure 지출 - 구독에 대한 Azure 자격 가져오기 - REST API