파트너의 위임된 관리자 고객 나열

아티클
03/12/2024

적용 대상: 파트너 센터

파트너가 DAP/DAP가 아닌 관계가 있는지 여부를 나타내는 파트너의 모든 고객 목록을 반환합니다.

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

참고 항목

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

필수 조건

자격 증명

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

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

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

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

Microsoft Entra ID로 커넥트.

Connect-MgGraph

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

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/delegatedAdminCustomers`

URI 매개 변수

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

요청 헤더

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

요청 본문

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

선택적 쿼리 매개 변수

이 메서드는 $select응답을 사용자 지정하는 데 도움이 되는 , $filter, $skip$top$count및 $orderBy (허용된 필드: organizationDisplayName, dapEnabled, startDateTime, lastSignInDateTime)을 지원합니다.

$top 는 최대 300개의 개체를 지원합니다.

요청 예제

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

REST 응답

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

응답 성공 및 오류 코드

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

delegated관리Customers 리소스

파트너의 위임된 관리자 고객과 고객의 테넌트에 대한 파트너의 액세스에 대한 세부 정보를 나타냅니다.

속성

속성	Type	설명
id	문자열	고객 테넌트 고유 식별자입니다.
customerTenantId	문자열	고객 테넌트 고유 식별자입니다.
OrganizationDisplayName	문자열	고객 조직의 표시 이름입니다.
partnerAgentCount	정수	지난 1일 동안 고객 테넌트에 로그인한 파트너 수입니다.
partnerSignInCount	정수	파트너가 지난 1일 동안 고객 테넌트에 로그인한 횟수입니다.
dapEnabled	Boolean	값은 파트너가 고객에 대한 DAP 관계를 가지고 있는지 여부를 나타냅니다. False인 경우: 해당 고객에 대한 DAP 관계가 없습니다. True인 경우: 해당 고객에 대한 DAP 관계가 있습니다.
startDateTime	문자열	DAP 관계가 설정된 날짜 시간입니다.
endDateTime	문자열	DAP 관계의 날짜 시간이 종료되었습니다.
lastSignInDateTime	문자열	이 고객 테넌트에 대한 파트너 로그인의 마지막 날짜 시간입니다. Null/empty: 파트너가 고객 테넌트에 로그인하지 않습니다.

응답 예제

{ 

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

    "value": [ 

        { 

            "id": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "customerTenantId": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "organizationDisplayName": "Test_Test_GAA_Partner_Account", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": false, 

            "startDateTime": "2021-08-06T21:15:04.3461507Z", 

            "endDateTime": null, 

            "lastSignInDateTime": null 

        }, 

        { 

            "id": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "customerTenantId": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "organizationDisplayName": "StagingTest", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": true, 

            "startDateTime": "2022-04-20T06:11:11.7227953Z", 

            "endDateTime": null, 

            "lastSignInDateTime": "2022-04-20T06:11:11.7227953Z" 

        } 
] 
}

다음을 통해 공유