구독에 대한 Azure 권리 유형 가져오기
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
파트너는 고객에 대한 구독 식별자의 자격을 가져오는 이 API를 사용하여 구독에 대한 Azure 자격을 볼 수 있습니다.
필수 조건
- 자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
- Customer_id.
- Subscription_id.
- Entitlement_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 구독을 취소하는 데 필요한 쿼리 매개 변수가 나열됩니다.
| 이름 | 유형 | 필요함 | 설명 |
|---|---|---|---|
| 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: aaaa0000-bb11-2222-33cc-444444dddddd
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: 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": []
}
}