Cree un nuevo objeto de aplicación si no existe o actualice las propiedades de un objeto de aplicación existente.
Importante
No es compatible con el uso de PATCH para establecer passwordCredential. Use los métodos addPassword y removePassword para actualizar la contraseña o el secreto de una aplicación.
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso
Permisos con privilegios mínimos
Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)
Application.ReadWrite.All
No disponible.
Delegado (cuenta personal de Microsoft)
Application.ReadWrite.All
No disponible.
Aplicación
Application.ReadWrite.OwnedBy
Application.ReadWrite.All
Solicitud HTTP
Para crear o actualizar una aplicación, especifique la clave alternativa proporcionada por el cliente uniqueName .
PATCH /applications(uniqueName='{uniqueName}')
Encabezados de solicitud
Nombre
Descripción
Authorization
{token} de portador. Obligatorio.
Content-Type
application/json. Necesario.
Prefer
create-if-missing. Necesario para el comportamiento de upsert; de lo contrario, la solicitud se trata como una operación de actualización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto de aplicación . El cuerpo de la solicitud debe contener displayName, que es una propiedad obligatoria. Especifique otras propiedades grabables según sea necesario para la aplicación, para su creación o actualización.
Respuesta
Si se ejecuta correctamente, si no existe un objeto de aplicación con uniqueName , este método devuelve un 201 Created código de respuesta y un nuevo objeto de aplicación en el cuerpo de la respuesta.
Si ya existe un objeto de aplicación con uniqueName , este método actualiza el objeto de aplicación y devuelve un 204 No Content código de respuesta.
Ejemplos
Ejemplo 1: Creación de una nueva aplicación si no existe
En el ejemplo siguiente se crea una aplicación porque no existe una aplicación con el valor de uniqueName especificado.
// 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");
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc applications-with-unique-name patch --unique-name {unique-name-id} --body '{\
"displayName": "Display name"\
}\
'
// 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");
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc applications-with-unique-name patch --unique-name {unique-name-id} --body '{\
"displayName": "Display name"\
}\
'
// 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");
});
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.