Obtener estado de adopción de MFAGet MFA adoption status

Se aplica a:Applies to:

  • API del Centro de partnersPartner Center API

En este artículo se explica cómo obtener el estado de adopción de la autenticación multifactor (MFA) para cada asociado dentro de un inquilino.This article explains how to get the multi-factor authentication (MFA) adoption status for each partner within a tenant.

Requisitos previosPrerequisites

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/applicationmfaadoptionstatus>{baseURL}/v1/applicationmfaadoptionstatus>

Encabezados de solicitudRequest headers

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

GET https://api.partnercenter.microsoft.com/v1/applicationmfaadoptionstatus HTTP/1.1
Authorization: Bearer <token>
Host: api.partnercenter.microsoft.com
Content-Type: application/json

Respuesta RESTREST response

Si es correcto, este método devuelve una colección de solicitudes de API resumidos por los recursos de la aplicación en el cuerpo de la respuesta.If successful, this method returns a collection of API request summarized by Application resources in the response body.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte Códigos de error.For the full list, see Error Codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 313
Content-Type: application/json
MS-CorrelationId: 4cb80cbe-566b-4d8b-8b8f-af1454b73089
MS-RequestId: 566330a7-1e4b-4848-9c23-f135c70fd810
Date: Thu, 21 May 2020 22:29:17 GMT
[
    {
        "loginDate": "2020-05-20",
        "mfaCompliantRequestCount": 7,
        "totalRequestCount": 7,
        "applicationId": "14f38d7d-c4fc-448a-b2df-0fc60e75465a",
        "applicationName": ""
    },
    {
        "loginDate": "2020-05-19",
        "mfaCompliantRequestCount": 7,
        "totalRequestCount": 14,
        "applicationId": "60a00bf2-0644-4279-83b3-87ddf96f2509",
        "applicationName": ""
    }
]