Aktualisieren von inheritablePermission

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften eines inheritablePermission-Objekts in einem Agentidentitäts-Blueprint. Beim Wechsel zu einem restriktiveren Vererbungsmuster, z. B. von allAllowedScopes bis enumeratedScopes oder noScopes, benötigen alle Agentidentitäten, die Zugriff benötigen, eine neue Zustimmungserteilung, um die neu eingeschränkten Bereiche abzurufen.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

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

Anforderungsheader

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die zu aktualisierenden Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein aktualisiertes inheritablePermission-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren von inheritablePermission zur Verwendung des allAllowedScopes-Musters

Dieses Beispiel aktualisiert eine vorhandene inheritablePermission so, dass das allAllowedScopes-Vererbungsmuster verwendet wird, sodass alle delegierten Berechtigungsbereiche von der Ressourcenanwendung an Agentidentitäten vererbt werden können.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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);

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Aktualisieren von inheritablePermission zur Verwendung des enumeratedScopes-Musters

Dieses Beispiel aktualisiert eine vorhandene inheritablePermission auf die Verwendung des enumeratedScopes-Vererbungsmusters, sodass nur die angegebenen delegierten Berechtigungsbereiche aus der Ressourcenanwendung von Agentidentitäten vererbt werden können.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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);

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 3: Aktualisieren von inheritablePermission zur Verwendung des noScopes-Musters

Dieses Beispiel aktualisiert eine vorhandene inheritablePermission auf die Verwendung des noScopes-Vererbungsmusters, wodurch verhindert wird, dass delegierte Berechtigungsbereiche aus der Ressourcenanwendung von Agentidentitäten vererbt werden können.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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);

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content