Update inheritablePermission

Espacio de nombres: microsoft.graph

Actualizar las propiedades de un objeto inheritablePermission en un plano técnico de identidad de agente. Al pasar a un patrón de herencia más restrictivo, como de a enumeratedScopes o , noScopeslas identidades de allAllowedScopes agente que requieran acceso requerirán una nueva concesión de consentimiento para adquirir los ámbitos recientemente restringidos.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.

Solicitud HTTP

PATCH /applications/{id}/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/{resourceAppId}

Encabezados de solicitud

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Respuesta

Si se realiza correctamente, este método devuelve un 200 OK código de respuesta y un objeto inheritablePermission actualizado en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Actualizar inheritablePermission para usar el patrón allAllowedScopes

En este ejemplo se actualiza un inheritablePermission existente para usar el patrón de herencia allAllowedScopes, lo que permite que todos los ámbitos de permisos delegados de la aplicación de recursos sean heredados por las identidades de agente.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0ff1-ce00-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.allAllowedScopes"
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const inheritablePermission = {
  inheritableScopes: {
    '@odata.type': 'microsoft.graph.allAllowedScopes'
  }
};

await client.api('/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0ff1-ce00-000000000000')
	.version('beta')
	.update(inheritablePermission);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Actualizar inheritablePermission para usar el patrón enumeratedScopes

En este ejemplo se actualiza un inheritablePermission existente para usar el patrón de herencia enumeratedScopes, lo que permite que solo los ámbitos de permisos delegados especificados de la aplicación de recursos sean heredados por las identidades de agente.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.enumeratedScopes",
    "scopes": [
      "User.Read",
      "Mail.Read"
    ]
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const inheritablePermission = {
  inheritableScopes: {
    '@odata.type': 'microsoft.graph.enumeratedScopes',
    scopes: [
      'User.Read',
      'Mail.Read'
    ]
  }
};

await client.api('/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000')
	.version('beta')
	.update(inheritablePermission);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 3: Actualizar el permiso heredable para usar el patrón noScopes

En este ejemplo se actualiza un heredadoPermission existente para usar el patrón de herencia noScopes, lo que impide que las identidades de agente hereden los ámbitos de permisos delegados de la aplicación de recursos.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.noScopes"
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const inheritablePermission = {
  inheritableScopes: {
    '@odata.type': 'microsoft.graph.noScopes'
  }
};

await client.api('/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000')
	.version('beta')
	.update(inheritablePermission);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content