Partilhar via


Obter estatísticas de relacionamento de administrador delegado

Aplica-se a: Partner Center

Retorna informações sobre a contagem de relações de Administrador Delegado (DAP) estabelecidas ou ativas associadas a um parceiro em todos os seus clientes.

Finalidade: os parceiros estão em conformidade para gerenciar com segurança o locatário do cliente e remover relacionamentos de DAP inativos que ultrapassam 90 dias usando o Remover um relacionamento de DAP com um cliente - desenvolvedor do aplicativo Partner Center.

Essa API ajuda a controlar as estatísticas de DAPs ativos para que os parceiros possam fazer a transição de DAPs ativos para GDAP (Granular delegated Admin Privileges).

Nota

Essa API é de curta duração e terá suporte durante a fase de descontinuação do DAP. Após o programa de descontinuação do DAP, essa API será desativada.

Pré-requisitos

Credencial

Este cenário suporta autenticação apenas com credenciais App+User.

Troca de tokens para receber token de acesso

Para obter mais informações, consulte Configurar um aplicativo para acessar uma API da Web.

Crie uma entidade de serviço para o aplicativo da API de Administração Delegada do Cliente Parceiro no locatário parceiro executando os seguintes comandos a partir de um console do PowerShell.

  1. Conecte-se ao Microsoft Entra ID.

    Connect-MgGraph

    Exemplo: migrar do Azure AD PowerShell para o Microsoft Graph PowerShell. Para saber mais, consulte Introdução ao SDK do Microsoft Graph PowerShell.

    Isso abre uma janela interativa para entrar. Insira as credenciais do locatário parceiro de área restrita.

  2. Em seguida, crie uma nova entidade de serviço: New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

    Para saber mais, consulte New-MgServicePrincipal (Microsoft.Graph.Applications).

    ObjectId AppId DisplayName
    C1BF31DA-09E5-4985-AB50-3232D4AE4F5A 2832473f-ec63-45fb-976f-5d45a7d4bb91 Administração delegada de clientes parceiros
  3. Em seguida, você cria um aplicativo no locatário acessando o portal do Azure, depois Registros de aplicativo e, em seguida, Criar um aplicativo cliente público ou Usar um aplicativo existente.

  4. Selecione Exibir permissões>da API Adicionar uma permissão>que minha organização usa

  5. Selecionar Cliente Parceiro Administração>Delegada Permissões>delegadas Adicionar permissões

  6. Conceda consentimento de administrador para esta nova permissão.

Agora você pode usar um token App+User (com recurso https://api.partnercustomeradministration.microsoft.com) usando este aplicativo (com um administrador locatário conectado) para chamar as APIs GDAP.

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>

Pedido REST

Sintaxe da solicitação

Método URI do pedido
GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics

Parâmetro URI

Nenhum parâmetro de URI necessário para esta API.

Cabeçalhos do pedido

Cabeçalho Description valor
Autorização O token de autorização no formato Portador <token>. String

Corpo do pedido

Não forneça um corpo de solicitação para esta API.

Exemplo de solicitação

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

Resposta do REST

Se bem-sucedido, esse método retorna uma coleção de recursos delegatedAdminStatistics no corpo da resposta.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

recurso delegatedAdminStatistics

Representa o objeto que contém estatísticas do uso de relações de Privilégio de Administrador Delegado (DAP).

_Propriedades

Property Type Descrição
id String O identificador exclusivo do locatário parceiro.
partnerTenantId String O identificador exclusivo do locatário parceiro.
totalDapCustomerCount Int O número total de clientes com acesso DAP.
estabelecidoDapCount coleção delegatedAdminAccessCount O número de DAPs estabelecidos (criados) e Data de criação. Exemplo: Se 10 DAPs criados em 18/06/2021, a resposta incluiria "contar" como 10 e "data" como "18/06/2021".
inativoDapCount coleção delegatedAdminAccessCount A contagem de clientes que tiveram entradas com a última data de entrada. Exemplo: Se o(s) parceiro(s) entrar(em) em 10 clientes locatário em 18/06/2021, a resposta incluiria "contar" como 10 e "data" como "18/06/2021".

recurso delegatedAdminAccessCount

Representa a contagem de administradores delegados por dia.

Propriedade Type Description
Data String A data da ação [estabelecida ou assinada].
Count Int A contagem de clientes.

Exemplo de resposta

{ 

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

    } 

  ] 

}