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).
Adquisición del consentimiento
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 |
Eliminación del consentimiento
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 |