Создайте новый объект приложения , если он не существует, или обновите свойства существующего объекта приложения .
Важно!
Использование метода PATCH для настройки passwordCredential не поддерживается. Используйте методы addPassword и removePassword , чтобы обновить пароль или секрет для приложения.
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения
Разрешения с наименьшими привилегиями
Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)
Application.ReadWrite.All
Недоступно.
Делегированные (личная учетная запись Майкрософт)
Application.ReadWrite.All
Недоступно.
Приложение
Application.ReadWrite.OwnedBy
Application.ReadWrite.All
HTTP-запрос
Чтобы создать или обновить приложение, укажите альтернативный ключ uniqueName , предоставленный клиентом.
PATCH /applications(uniqueName='{uniqueName}')
Заголовки запросов
Имя
Описание
Авторизация
Bearer {token}. Обязательно.
Content-Type
application/json. Обязательный параметр.
Prefer
create-if-missing. Требуется для поведения upsert, в противном случае запрос обрабатывается как операция обновления.
Текст запроса
В тексте запроса укажите представление объекта приложения в формате JSON. Текст запроса должен содержать displayName, который является обязательным свойством. Укажите другие доступные для записи свойства, необходимые для приложения, для создания или обновления.
Отклик
В случае успешного выполнения, если объект приложения с uniqueName не существует, этот метод возвращает код отклика 201 Created и новый объект приложения в тексте ответа.
Если объект приложения с uniqueName уже существует, этот метод обновляет объект приложения и возвращает 204 No Content код ответа.
Примеры
Пример 1. Создание приложения, если оно не существует
В следующем примере создается приложение, так как приложение с указанным значением uniqueName не существует.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Application
{
DisplayName = "Display name",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.ApplicationsWithUniqueName("{uniqueName}").PatchAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Prefer", "create-if-missing");
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Application application = new Application();
application.setDisplayName("Display name");
Application result = graphClient.applicationsWithUniqueName("{uniqueName}").patch(application, requestConfiguration -> {
requestConfiguration.headers.add("Prefer", "create-if-missing");
});
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Application
{
DisplayName = "Display name",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.ApplicationsWithUniqueName("{uniqueName}").PatchAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Prefer", "create-if-missing");
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Application application = new Application();
application.setDisplayName("Display name");
Application result = graphClient.applicationsWithUniqueName("{uniqueName}").patch(application, requestConfiguration -> {
requestConfiguration.headers.add("Prefer", "create-if-missing");
});
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.