구독에 대한 Azure 자격 목록 가져오기
Azure 권한 리소스(AzureEntitlement)를 사용하여 구독에 속하는 리소스 컬렉션을 가져올 수 있습니다.
필수 구성 요소
자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (
customer-tenant-id
). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 차례로 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id
)와 동일합니다.구독 식별자입니다.
REST 요청
요청 구문
방법 | 요청 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/azureentitlements HTTP/1.1 |
URI 매개 변수
다음 표에서는 구독에 대한 모든 Azure 자격을 가져오는 데 필요한 쿼리 매개 변수를 나열합니다.
Name | 형식 | 필수 | Description |
---|---|---|---|
customer-tenant-id | guid | Y | 고객에게 해당하는 GUID입니다. |
subscription-id | guid | Y | 구독에 해당하는 GUID입니다. |
요청 헤더
자세한 내용은 파트너 센터 REST 헤더를 참조하세요.
요청 본문
없음
요청 예제
GET https://api.partnercenter.microsoft.com/v1/customers/11f9bc2a-1f38-431c-a0b0-9455c6f5bbc0/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 16fee928-dc2c-412f-adbb-871f68babf16
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive
REST 응답
성공하면 이 메서드는 응답 본문에 AzureEntitlement 리소스 컬렉션을 반환합니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.
응답 예제
HTTP/1.1 200 OK
Content-Length: 73754
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 16fee928-dc2c-412f-adbb-871f68babf16
Date: Wed, 04 Oct 2019 05:50:45 GMT
{
"totalCount":1,
"items":[
{
"id":"899ae6f1-8a74-4d5e-b6c6-e6b5019bbff8",
"friendlyName":"Microsoft Azure",
"status":"active",
"subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
}],
"attributes":{"objectType":"Collection"}
}