위임된 관리자 관계 통계 가져오기

아티클
03/12/2024

적용 대상: 파트너 센터

모든 고객의 파트너와 연결된 DAP(위임된 관리) 관계 또는 활성 관계에 대한 정보를 반환합니다.

목적: 파트너는 고객과 DAP 관계 제거 - 파트너 센터 앱 개발자를 사용하여 고객 테넌트를 안전하게 관리하고 90일을 초과하는 비활성 DAP 관계를 제거하기 위해 규정을 준수합니다.

이 API는 파트너가 활성 DAP를 GDAP(세분화된 위임된 관리자 권한)로 전환할 수 있도록 활성 DAP의 통계를 추적하는 데 도움이 됩니다.

참고 항목

이 API는 수명이 짧으며 DAP 사용 중단 단계에서 지원됩니다. DAP 사용 중단 프로그램을 게시하면 이 API는 사용 중지됩니다.

필수 조건

자격 증명

이 시나리오는 앱 + 사용자 자격 증명을 사용한 인증만 지원합니다.

액세스 토큰을 받기 위한 토큰 교환

자세한 내용은 웹 API에 액세스하도록 앱 구성을 참조하세요.

PowerShell 콘솔에서 다음 명령을 실행하여 파트너 테넌트에서 파트너 고객 위임 관리istration API 앱에 대한 서비스 주체를 만듭니다.

Microsoft Entra ID로 커넥트.

Connect-MgGraph

예: Azure AD PowerShell에서 Microsoft Graph PowerShell로 마이그레이션합니다. 자세한 내용은 Microsoft Graph PowerShell SDK 시작을 참조하세요.

그러면 로그인할 대화형 창이 열립니다. 샌드박스 파트너 테넌트 자격 증명을 입력합니다.
다음으로, 새 서비스 주체를 만듭니다. New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

자세한 내용은 New-MgServicePrincipal(Microsoft.Graph.Applications)을 참조하세요.

ObjectId AppId DisplayName

c1bf31da-09e5-4985-ab50-3232d4ae4f5a 2832473f-ec63-45fb-976f-5d45a7d4bb91 파트너 고객 위임 관리
다음으로 Azure Portal로 이동하여 테넌트에서 앱을 만든 다음, 앱 등록 공용 클라이언트 앱을 만들거나 기존 앱을 사용합니다.
API 권한>보기 선택 조직에서 사용하는 권한>API 추가
파트너 고객 위임 관리이용>위임된 권한 추가 권한 선택 >
이 새 권한에 대한 관리자 동의를 부여합니다.

ObjectId	AppId	DisplayName
c1bf31da-09e5-4985-ab50-3232d4ae4f5a	2832473f-ec63-45fb-976f-5d45a7d4bb91	파트너 고객 위임 관리

이제 이 앱(로그인한 테넌트 관리자 포함)을 사용하여 App+사용자 토큰(리소스 https://api.partnercustomeradministration.microsoft.com포함)을 사용하여 GDAP API를 호출할 수 있습니다.

POST https://login.microsoftonline.com/<partner_tenant_id>/oauth2/token grant_type=client_credentials&scope:https://api.partnercustomeradministration.microsoft.com&client_id:<client_id>&client_secret:<client_secret>

REST 요청

요청 구문

메서드	요청 URI
GET	`https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics`

URI 매개 변수

이 API에 필요한 URI 매개 변수가 없습니다.

요청 헤더

헤더	설명	값
Authorization	전달자 형식의 권한 부여 토큰입니다 `<token>`.	문자열

요청 본문

이 API에 대한 요청 본문을 제공하지 마세요.

요청 예제

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics  
HTTP/1.1 
Authorization: Bearer \<token\> 
Content-Type: application/json; charset=utf-8

REST 응답

성공하면 이 메서드는 응답 본문에 위임된관리Statistics 리소스의 컬렉션을 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 기타 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

delegated관리Statistics 리소스

DAP(위임된 관리 권한) 관계의 사용 통계를 포함하는 개체를 나타냅니다.

속성

속성	Type	설명
id	문자열	파트너 테넌트 고유 식별자입니다.
partnerTenantId	문자열	파트너 테넌트 고유 식별자입니다.
totalDapCustomerCount	정수	DAP 액세스 권한이 있는 총 고객 수입니다.
establishedDapCount	delegated관리AccessCount 컬렉션	설정된 DAP 수(만든 날짜) 및 생성 날짜입니다. 예: 2021년 6월 18일에 10개의 DAP를 만든 경우 응답에는 "count"를 10으로, "date"를 "2021년 6월 18일"로 포함합니다.
inactiveDapCount	delegated관리AccessCount 컬렉션	로그인 마지막 날짜에 로그인한 고객 수입니다. 예: 파트너가 2021년 6월 18일에 10명의 고객 테넌트에 로그인한 경우 응답에는 "count"를 10으로, "date"를 "2021년 6월 18일"로 포함합니다.

delegated관리AccessCount 리소스

일일 위임된 관리자 수를 나타냅니다.

속성	Type	설명
날짜	문자열	작업 날짜[설정 또는 로그인]입니다.
Count	정수	고객 수입니다.

응답 예제

{ 

  "@odata.context": "https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/$metadata#delegatedAdminStatistics/$entity", 

  "id": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "partnerTenantId": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "totalDapCustomerCount": 200, 

  "establishedDapCount": [ 

    { 

      "date": "6/18/2021", 

      "count": 1 

    }, 

    { 

      "date": "2/18/2022", 

      "count": 1 

    } 

  ], 

  "inactiveDapCount": [ 

    { 

      "date": "2/18/2022", 

      "count": 1  

    }, 

    { 

      "date": "2/24/2022", 

      "count": 1 

    } 

  ] 

}

다음을 통해 공유