Statistieken over gedelegeerde beheerdersrelaties ophalen

Artikel
07/02/2024

Van toepassing op: Partnercentrum

Retourneert informatie over het aantal DAP-relaties (Delegated Admin) dat tot stand is gebracht of actief is die zijn gekoppeld aan een partner voor al hun klanten.

Doel: Partners zijn compatibel om de tenant van de klant veilig te beheren en inactieve DAP-relaties te verwijderen die langer zijn dan 90 dagen met behulp van de DAP-relatie verwijderen met een klant - Partnercentrum-app-ontwikkelaar.

Deze API helpt bij het bijhouden van de statistieken van actieve DAP's, zodat partners actieve DAPs kunnen overstappen op gedetailleerde gedelegeerde beheerdersbevoegdheden (GDAP).

Notitie

Deze API heeft een korte levensduur en wordt ondersteund tijdens de afschaffingsfase van DAP. Na het DAP-afschaffingsprogramma wordt deze API buiten gebruik gesteld.

Vereisten

Referentie

Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.

Tokenuitwisseling om toegangstoken te ontvangen

Zie Een app configureren voor toegang tot een web-API voor meer informatie.

Maak een service-principal voor de Partner Customer Delegated Administration API-app in de partnertenant door de volgende opdrachten uit te voeren vanuit een PowerShell-console.

Maak verbinding met Microsoft Entra ID.

Connect-MgGraph

Voorbeeld: Migreren van Azure AD PowerShell naar Microsoft Graph PowerShell. Zie Aan de slag met de Microsoft Graph PowerShell SDK voor meer informatie.

Hiermee opent u een interactief venster om u aan te melden. Voer de referenties van de tenant van de sandbox-partner in.
Maak vervolgens een nieuwe service-principal: New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

Zie New-MgServicePrincipal (Microsoft.Graph.Applications) voor meer informatie.

ObjectId AppId DisplayName

c1bf31da-09e5-4985-ab50-3232d4ae4f5a 2832473f-ec63-45fb-976f-5d45a7d4bb91 Gedelegeerd beheer partner
Vervolgens maakt u een app in de tenant door naar Azure Portal te gaan en vervolgens App-registraties en vervolgens een openbare client-app maken of een bestaande app gebruiken.
Api-machtigingen >weergeven selecteren: een machtigings-API>toevoegen die door mijn organisatie wordt gebruikt
Gedelegeerde beheermachtigingen>>voor partnerklant selecteren: machtigingen toevoegen
Beheerderstoestemming verlenen voor deze nieuwe machtiging.

ObjectId	AppId	DisplayName
c1bf31da-09e5-4985-ab50-3232d4ae4f5a	2832473f-ec63-45fb-976f-5d45a7d4bb91	Gedelegeerd beheer partner

U kunt nu een App+User-token (met resource https://api.partnercustomeradministration.microsoft.com) gebruiken met deze app (met een aangemelde tenantbeheerder) om de GDAP-API's aan te roepen.

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-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	`https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics`

URI-parameter

Er zijn geen URI-parameters vereist voor deze API.

Aanvraagheaders

Koptekst	Beschrijving	Waarde
Autorisatie	Het autorisatietoken in de vorm Bearer `<token>`.	String

Aanvraagtekst

Geef geen aanvraagbody op voor deze API.

Aanvraagvoorbeeld

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-antwoord

Als dit lukt, retourneert deze methode een verzameling gedelegeerdeAdminStatistics-resources in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

delegatedAdminStatistics-resource

Vertegenwoordigt het object met statistieken van het gebruik van DAP-relaties (Delegated Admin Privilege).

Eigenschappen

Eigenschappen	Type	Beschrijving
id	String	De unieke id van de partnertenant.
partnerTenantId	String	De unieke id van de partnertenant.
totalDapCustomerCount	Int	Het totale aantal klanten met DAP-toegang.
establishedDapCount	delegatedAdminAccessCount collection	Het aantal tot stand gebrachte DAP's (gemaakt) en de aanmaakdatum. Voorbeeld: Als 10 DAPs die zijn gemaakt op 18-6-2021, bevat het antwoord 'count' als 10 en 'date' als '18-6-2021'.
inactiveDapCount	delegatedAdminAccessCount collection	Het aantal klanten dat aanmeldingen heeft gehad met de laatste aanmeldingsdatum. Voorbeeld: Als partners zich op 10-18-2021 hebben aangemeld bij de tenant van 10 klanten, bevat het antwoord 'count' als 10 en 'date' als '18-6-2021'.

gedelegeerdeAdminAccessCount-resource

Vertegenwoordigt het aantal gedelegeerde beheerders per dag.

Eigenschap	Type	Description
Datum	String	De datum van de actie [vastgesteld of aangemeld].
Tellen	Int	Het aantal klanten.

Responsvoorbeeld

{ 

  "@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 

    } 

  ] 

}

Delen via