Statistieken over gedelegeerde beheerdersrelaties ophalen

  • Artikel

Van toepassing op: Partnercentrum

Retourneert informatie over het aantal gedelegeerde Beheer (DAP)-relaties die zijn ingesteld of actief zijn 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

Referenties

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 partnerklant gedelegeerd Beheer istration-API-app in de partnertenant door de volgende opdrachten uit te voeren vanuit een PowerShell-console.

  1. Verbinding maken naar Azure Active Directory.

    Connect-AzureAD

    Hiermee opent u een interactief venster om u aan te melden. Voer de referenties van de tenant van de sandbox-partner in.

  2. Maak vervolgens een nieuwe service-principal: New-AzureADServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

    ObjectId AppId WeergaveNaam
    c1bf31da-09e5-4985-ab50-3232d4ae4f5a 2832473f-ec63-45fb-976f-5d45a7d4bb91 Gedelegeerd Beheer beheer van partnerklant

  3. 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.

  4. Api-machtigingen >weergeven selecteren: een machtigings-API>toevoegen die door mijn organisatie wordt gebruikt

  5. Gedelegeerde Beheer machtigingen>voor gedelegeerde partnermachtigingen selecteren>

  6. Beheerderstoestemming verlenen voor deze nieuwe machtiging.

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

Kop Omschrijving 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 gedelegeerde resources Beheer Statistics 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.

gedelegeerd Beheer Statistics-resource

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

Eigenschappen

Eigenschap 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 gedelegeerde Beheer AccessCount-verzameling 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 gedelegeerde Beheer AccessCount-verzameling 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'.

gedelegeerd Beheer AccessCount-resource

Vertegenwoordigt het aantal gedelegeerde beheerders per dag.

Eigenschappen Type Omschrijving
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 

    } 

  ] 

}