Получение согласия клиента в качестве поставщика панели управления
Будучи поставщиком панели управления (CPV), вы можете использовать REST API для получения и отзыва согласия у ваших клиентов CSP, чтобы получить разрешения на доступ к их арендаторам.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Заметка
Ограничение скорости составляет 50 запросов в секунду (RPS) для каждого приложения (идентификатор приложения партнера CPV).
Получение согласия
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
| идентификатор клиента | путь | Верно | струна | Идентификатор клиента, созданного в Центре партнеров |
Заголовок запроса
Типы носителей: application/json
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| Авторизация | Верно | струна | Токен доступа для аудитории https://api.partnercenter.microsoft.com |
| Принимать | Верно | струна | Допустимый тип контента; широко принятый тип application/json |
| ms-correlationid | струна | Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создает новый для каждого запроса. | |
| ms-requestid | струна | Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создает новый для каждого запроса. |
Содержимое запроса
Типы носителей: application/json
| Имя | Тип | Описание |
|---|---|---|
| applicationId | струна | Идентификатор приложения партнера CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Список разрешений приложений для получения доступа к вашим клиентам в их арендуемой среде |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 ОК | Запрос выполнен успешно. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 201 Создано | Создано разрешение приложения. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 400 Недопустимый запрос | Отсутствуют или недопустимые входные данные. Текст ответа содержит сведения об ошибке. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 401 Несанкционированный доступ | Запрос не прошел проверку подлинности. Клиент должен передать допустимый токен доступа для предназначенной аудитории. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 403 Запрещено | Запрос прошел проверку подлинности, но был отклонен, так как запрашивающая сторона не имеет прав на его использование. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 404 Не найдено | Ресурс не найден или недоступен с заданными входными параметрами. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| Ошибка внутреннего сервера 500 | Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить запрос. Типы носителей: application/json, application/xml, text/xml, text/json |
Определения
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Имя | Тип | Описание |
|---|---|---|
| идентификаторКорпоративногоПриложения | струна | Представление GUID ресурса, получающего доступ |
| охват | струна | Разделенные запятыми значения области для получения доступа |
Удаление согласия
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Заметка
Ограничение скорости составляет 50 запросов в секунду (RPS) для каждого приложения (идентификатор приложения партнера CPV).
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
| идентификатор клиента | путь | Верно | струна | Идентификатор клиента, созданного в Центре партнеров |
| идентификатор приложения | путь | Верно | струна | Идентификатор приложения CPV |
Заголовок запроса
Типы носителей: application/json
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| Авторизация | Верно | струна | Токен доступа для аудитории https://api.partnercenter.microsoft.com |
| Принимать | Верно | струна | Допустимый тип контента, обычно тип application/json |
| ms-correlationid | струна | Используется для отслеживания запросов внутри системы. Если ms-correlationid не предоставлен, сервер создает новый для каждого запроса. |
|
| ms-requestid | струна | Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создает новый для каждого запроса. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 ОК | Запрос выполнен успешно. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 201 Создано | Согласие на приложение удалено. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 400 Недопустимый запрос | Отсутствуют или недопустимые входные данные. Текст ответа содержит сведения об ошибке. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 401 Несанкционированный доступ | Запрос не прошел проверку подлинности. Клиент должен передать действительный токен доступа для целевой аудитории. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 403 Запрещено | Запрос прошел проверку подлинности, но был отклонен, так как запрашивающая сторона не имеет прав на его использование. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| 404 Не найдено | Ресурс не найден или недоступен с заданными входными параметрами. Типы носителей: application/json, application/xml, text/xml, text/json |
|
| Ошибка внутреннего сервера 500 | Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить запрос. Типы носителей: application/json, application/xml, text/xml, text/json |