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

  • Artículo

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

Parámetros del identificador URI

Nombre En Obligatorio Tipo 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 Tipo Descripción
Authorization True string Token de acceso para la audiencia https://api.partnercenter.microsoft.com
Aceptar True string Tipo de contenido aceptable; aplicación/json de tipo ampliamente aceptado
ms-correlationid string Se usa para realizar el seguimiento de solicitudes internamente. Si no se proporciona un valor ms-correlationid, el servidor generará uno nuevo para cada solicitud.
ms-requestid string Se usa para la idempotencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Cuerpo de la solicitud

Tipos de medios: application/json

Nombre Tipo 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 para los clientes en su inquilino

Respuestas

Nombre Tipo 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 Falta la entrada o no es 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 ha autenticado. 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 Prohibido 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"
Error de servidor interno 500 El servicio de API del asociado o una de sus dependencias no pudo 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 Tipo 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}

Parámetros del identificador URI

Nombre En Obligatorio Tipo 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 Tipo Descripción
Authorization True string Token de acceso para la audiencia https://api.partnercenter.microsoft.com
Aceptar True string Tipo de contenido aceptable, normalmente tipo application/json
ms-correlationid string Se usa para realizar el seguimiento de solicitudes internamente. Si no se proporciona un ms-correlationid elemento , el servidor generará uno nuevo para cada solicitud.
ms-requestid string Se usa para la idempotencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Respuestas

Nombre Tipo 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 Falta la entrada o no es 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 ha autenticado. 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 Prohibido 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"
Error de servidor interno 500 El servicio de API del asociado o una de sus dependencias no pudo cumplir la solicitud. Los autores de llamadas pueden reintentar la solicitud. Tipos de medios: "application/json", "application/xml", "text/xml", "text/json"

Pasos siguientes