Freigeben über


Auflisten von policyDeletableItem-Objekten

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Rufen Sie eine Liste der policyDeletableItem-Objekte und deren Eigenschaften ab, bei denen es sich um einen der folgenden gelöschten Richtlinientypen handeln kann:

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

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.

Berechtigungen zum Abrufen mandantenübergreifender Zugriffsrichtlinienobjekte

Berechtigungstyp Berechtigung mit den geringsten Rechten Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten, in denen der angemeldete Benutzer auf einen anderen Benutzer agiert, muss ihm eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

  • Sicherheitsleseberechtigter – Grundlegende Eigenschaften lesen
  • Globaler Reader : Grundlegende Eigenschaften lesen
  • Globaler Administrator für sicheren Zugriff : Grundlegende Eigenschaften mit Ausnahme der Identitätssynchronisierungseinstellungen lesen
  • Teams-Administrator : Grundlegende Eigenschaften ohne Identitätssynchronisierungseinstellungen lesen
  • Sicherheitsadministrator

Berechtigungen zum Abrufen von Richtlinienobjekten für bedingten Zugriff

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Policy.Read.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Policy.Read.All Nicht verfügbar.

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten, in denen der angemeldete Benutzer auf einen anderen Benutzer wirkt, muss ihm eine der folgenden unterstützten Microsoft Entra Rollen zugewiesen werden:

  • Global Secure Access Administrator – Lesen von Standardeigenschaften
  • Sicherheitsleseberechtigter – Lesen von Standardeigenschaften
  • Sicherheitsadministrator – Lesen von Standardeigenschaften
  • Globaler Leser
  • Administrator für bedingten Zugriff

HTTP-Anforderung

Auflisten gelöschter crossTenantAccessPolicyConfigurationPartner-Objekte :

GET /policies/deletedItems/crossTenantPartners

Auflisten gelöschter crossTenantIdentitySyncPolicyPartner-Objekte :

GET /policies/deletedItems/crossTenantSyncPolicyPartners

Auflisten gelöschter conditionalAccessPolicy-Objekte :

GET /identity/conditionalAccess/deletedItems/policies

Auflisten gelöschter namedLocation-Objekte :

GET /identity/conditionalAccess/deletedItems/namedLocations

Optionale Abfrageparameter

Diese Methode unterstützt einige der OData-Abfrageparameter zur Anpassung der Antwort. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Auflistung von policyDeletableItem-Objekten im Antworttext zurückgegeben. Die @odata.context -Eigenschaft im Anforderungstext gibt an, welcher Richtlinientyp zurückgegeben wird.

Beispiele

Beispiel 1: Abrufen gelöschter crossTenantAccessPolicyConfigurationPartner-Objekte

Anforderung

Das folgende Beispiel zeigt eine Anforderung für crossTenantAccessPolicyConfigurationPartner.

GET https://graph.microsoft.com/beta/policies/deletedItems/crossTenantPartners/

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft-ppe.com/testppebetadeleteapis/$metadata#policies/deletedItems/crossTenantPartners",
  "value": [
    {
      "tenantId": "01d0e717-bc90-46ba-94a9-71b4a811fddb",
      "deletedDateTime": "2025-06-18T22:58:04Z",
      "displayName": null,
      "isServiceProvider": null,
      "isInMultiTenantOrganization": false,
      "blockServiceProviderOutboundAccess": null,
      "inboundTrust": null,
      "b2bCollaborationOutbound": null,
      "b2bCollaborationInbound": null,
      "b2bDirectConnectOutbound": null,
      "b2bDirectConnectInbound": null,
      "tenantRestrictions": null,
      "invitationRedemptionIdentityProviderConfiguration": null,
      "crossCloudMeetingConfiguration": {
        "inboundAllowed": null,
        "outboundAllowed": null
      },
      "automaticUserConsentSettings": {
        "inboundAllowed": null,
        "outboundAllowed": null
      },
      "protectedContentSharing": {
        "inboundAllowed": null,
        "outboundAllowed": null
      }
    },
    {
      "tenantId": "809cbbd2-2325-4c17-bd51-f8f098db19c8",
      "deletedDateTime": "2025-06-18T22:53:31Z",
      "displayName": null,
      "isServiceProvider": null,
      "isInMultiTenantOrganization": false,
      "blockServiceProviderOutboundAccess": null,
      "inboundTrust": null,
      "b2bCollaborationOutbound": null,
      "b2bCollaborationInbound": null,
      "b2bDirectConnectOutbound": null,
      "b2bDirectConnectInbound": null,
      "tenantRestrictions": null,
      "invitationRedemptionIdentityProviderConfiguration": null,
      "crossCloudMeetingConfiguration": {
        "inboundAllowed": null,
        "outboundAllowed": null
      },
      "automaticUserConsentSettings": {
        "inboundAllowed": null,
        "outboundAllowed": null
      },
      "protectedContentSharing": {
        "inboundAllowed": null,
        "outboundAllowed": null
      }
    }
  ]
}

Beispiel 2: Abrufen gelöschter crossTenantIdentitySyncPolicyPartner-Objekte

Anforderung

Das folgende Beispiel zeigt eine Anforderung für crossTenantIdentitySyncPolicyPartner.

GET https://graph.microsoft.com/beta/policies/deletedItems/crossTenantSyncPolicyPartners/

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft-ppe.com/testppebetadeleteapis/$metadata#policies/deletedItems/crossTenantSyncPolicyPartners",
  "value": [
    {
      "tenantId": "01d0e717-bc90-46ba-94a9-71b4a811fddb",
      "displayName": null,
      "deletedDateTime": "2025-06-18T23:11:01Z",
      "externalCloudAuthorizedApplicationId": null,
      "userSyncInbound": null
    }
  ]
}

Beispiel 3: Abrufen gelöschter conditionalAccessPolicy-Objekte

Anforderung

Das folgende Beispiel zeigt eine Anforderung für eine conditionalAccessPolicy.

GET https://graph.microsoft.com/beta/identity/conditionalAccess/deletedItems/policies

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/conditionalAccess/deletedItems/policies",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identity/conditionalAccess/deletedItems/policies?$select=conditions,createdDateTime",
    "value": [
        {
            "id": "1a71ea59-9583-4f16-9de4-47ecb42adfc6",
            "templateId": null,
            "displayName": "Demo",
            "createdDateTime": "2024-06-26T22:13:41.3634477Z",
            "modifiedDateTime": "2025-01-22T17:30:09.4040798Z",
            "state": "disabled",
            "deletedDateTime": "2025-09-12T17:01:05Z",
            "partialEnablementStrategy": null,
            "sessionControls": null,
            "conditions": {
                "userRiskLevels": [],
                "signInRiskLevels": [],
                "clientAppTypes": [
                    "all"
                ],
                "platforms": null,
                "times": null,
                "deviceStates": null,
                "devices": null,
                "applications": {
                    "includeApplications": [
                        "None"
                    ],
                    "excludeApplications": [],
                    "includeUserActions": [],
                    "includeAuthenticationContextClassReferences": [],
                    "applicationFilter": null
                },
                "users": {
                    "includeUsers": [
                        "None"
                    ],
                    "excludeUsers": [],
                    "includeGroups": [],
                    "excludeGroups": [],
                    "includeRoles": [],
                    "excludeRoles": [],
                    "includeGuestsOrExternalUsers": null,
                    "excludeGuestsOrExternalUsers": null
                },
                "locations": {
                    "includeLocations": [
                        "41f20046-7b5b-4721-b049-eccd63d614ef"
                    ],
                    "excludeLocations": []
                },
                "clientApplications": {
                    "includeServicePrincipals": [
                        "ServicePrincipalsInMyTenant"
                    ],
                    "excludeServicePrincipals": []
                }
            },
            "grantControls": {
                "operator": "OR",
                "builtInControls": [
                    "block"
                ],
                "customAuthenticationFactors": [],
                "termsOfUse": [],
                "authenticationStrength@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/conditionalAccess/deletedItems/policies('1a71ea59-9583-4f16-9de4-47ecb42adfc6')/grantControls/authenticationStrength/$entity",
                "authenticationStrength": null
            }
        }
    ]
}

Beispiel 4: Abrufen gelöschter namedLocation-Objekte

Anforderung

Das folgende Beispiel zeigt eine Anforderung für einen namedLocation.

GET https://graph.microsoft.com/beta/identity/conditionalAccess/deletedItems/namedLocations

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/conditionalAccess/deletedItems/namedLocations",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identity/conditionalAccess/deletedItems/namedLocations?$select=createdDateTime,displayName",
    "value": [
        {
            "@odata.type": "#microsoft.graph.countryNamedLocation",
            "id": "1a4c0633-332f-4691-a27a-fd8334938a62",
            "displayName": "Calvin Test USA",
            "modifiedDateTime": "2025-09-05T22:12:01.4444669Z",
            "createdDateTime": "2025-09-05T22:12:01.4444669Z",
            "deletedDateTime": "2025-09-08T16:03:43Z",
            "countriesAndRegions": [
                "US"
            ],
            "includeUnknownCountriesAndRegions": false,
            "countryLookupMethod": "clientIpAddress"
        },
        {
            "@odata.type": "#microsoft.graph.ipNamedLocation",
            "id": "003fe866-1f11-4356-8ddc-22e52f491cc5",
            "displayName": "Pallav IP Test",
            "modifiedDateTime": "2025-09-10T15:36:17.992593Z",
            "createdDateTime": "2025-09-10T15:35:45.6440841Z",
            "deletedDateTime": "2025-09-12T16:56:35Z",
            "isTrusted": false,
            "ipRanges": [
                {
                    "@odata.type": "#microsoft.graph.iPv4CidrRange",
                    "cidrAddress": "127.30.27.128/30"
                }
            ]
        }
    ]
}