Compartir a través de

Obtención del consentimiento del cliente como proveedor de Panel de control

Como proveedor de Panel de control (CPV), puede usar las API REST para adquirir y quitar el consentimiento de los clientes de CSP para obtener permisos en sus inquilinos.

POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents

Nota:

El límite de velocidad es de 50 solicitudes por segundo (RPS) para cada applicationId (id. de aplicación del asociado de CPV).

Parámetros del identificador URI

Nombre En Obligatorio Type Descripción
customer_id path True string Identificador del cliente generado en el Centro de partners

Encabezado de solicitud

Tipos de medios: application/json

Nombre Obligatorio Type Descripción
Autorización True string Token de acceso para la audiencia https://api.partnercenter.microsoft.com
Accept True string Tipo de contenido aceptable; aplicación o json de tipo ampliamente aceptado
ms-correlationid string Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor genera uno nuevo para cada solicitud.
ms-requestid string Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor genera uno nuevo para cada solicitud.

Cuerpo de la solicitud

Tipos de medios: application/json

Nombre Escribir Descripción
applicationId string Id. de aplicación del asociado de CPV
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Lista de concesiones de aplicación para obtener el acceso a los clientes en su inquilino

Respuestas

Nombre Escribir Descripción
200 OK La solicitud finalizó correctamente. Tipos de medios: application/json, application/xml, text/xml, text/json
201 creado Se crea el consentimiento de la aplicación. Tipos de medios: application/json, application/xml, text/xml, text/json
400 - Solicitud incorrecta Faltaba o no había ninguna entrada no válida. El cuerpo de la respuesta contiene los detalles del error. Tipos de medios: application/json, application/xml, text/xml, text/json
401 No autorizado La solicitud no se autenticó. El cliente debe pasar un token de acceso válido para la audiencia válida. Tipos de medios: application/json, application/xml, text/xml, text/json
403 Prohibida La solicitud se autenticó pero se rechazó porque el autor de la llamada no tiene los derechos para invocarla. Tipos de medios: application/json, application/xml, text/xml, text/json
404 No encontrado El recurso no se encuentra o no está disponible con los parámetros de entrada especificados. Tipos de medios: application/json, application/xml, text/xml, text/json
500 Error interno del servidor El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden reintentar la solicitud. Tipos de medios: application/json, application/xml, text/xml, text/json

Definiciones

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Nombre Escribir Descripción
enterpriseApplicationId string Representación GUID del recurso que obtiene acceso
scope string Valores separados por comas del ámbito para obtener acceso 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Nota:

El límite de velocidad es de 50 solicitudes por segundo (RPS) para cada applicationId (id. de aplicación del asociado de CPV).

Parámetros del identificador URI

Nombre En Obligatorio Type Descripción
customer_id path True string Identificador del cliente generado en el Centro de partners
Application_id path True string Identificador de la aplicación CPV

Encabezado de solicitud

Tipos de medios: application/json

Nombre Obligatorio Type Descripción
Autorización True string Token de acceso para la audiencia https://api.partnercenter.microsoft.com
Accept True string Tipo de contenido aceptable, normalmente escriba application/json
ms-correlationid string Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid , el servidor genera uno nuevo para cada solicitud.
ms-requestid string Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor genera uno nuevo para cada solicitud.

Respuestas

Nombre Escribir Descripción
200 OK La solicitud finalizó correctamente. Tipos de medios: application/json, application/xml, text/xml, text/json
201 creado Se elimina el consentimiento de la aplicación. Tipos de medios: application/json, application/xml, text/xml, text/json
400 - Solicitud incorrecta Faltaba o no había ninguna entrada no válida. El cuerpo de la respuesta contiene los detalles del error. Tipos de medios: application/json, application/xml, text/xml, text/json
401 No autorizado La solicitud no se autenticó. El cliente debe pasar un token de acceso válido para la audiencia válida. Tipos de medios: application/json, application/xml, text/xml, text/json
403 Prohibida La solicitud se autenticó pero se rechazó porque el autor de la llamada no tiene los derechos para invocarla. Tipos de medios: application/json, application/xml, text/xml, text/json
404 No encontrado El recurso no se encuentra o no está disponible con los parámetros de entrada especificados. Tipos de medios: application/json, application/xml, text/xml, text/json
500 Error interno del servidor El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden reintentar la solicitud. Tipos de medios: application/json, application/xml, text/xml, text/json

Contenido relacionado

  • Last updated on