名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
policyDeletableItem オブジェクトのプロパティとリレーションシップを読み取ります。これは、次の削除されたポリシーの種類のいずれかである可能性があります。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
✅ |
✅ |
✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
テナント間アクセス ポリシー オブジェクトを取得するためのアクセス許可
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
サポートされていません。 |
サポートされていません。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
サポートされていません。 |
サポートされていません。 |
重要
サインインしているユーザーが別のユーザーを操作している職場または学校アカウントを使用して委任されたアクセスを行うには、サポートされているMicrosoft Entraロールまたはこの操作に必要なアクセス許可を付与するカスタム ロールを割り当てる必要があります。 この操作では、必要最小限の特権のみを提供する次の組み込みロールがサポートされています。
- セキュリティ リーダー - 基本的なプロパティの読み取り
- グローバル リーダー - 基本的なプロパティの読み取り
- グローバル セキュリティで保護されたアクセス管理者 - ID 同期設定を除く基本的なプロパティの読み取り
- Teams 管理者 - ID 同期設定を除く基本的なプロパティの読み取り
- セキュリティ管理者
条件付きアクセス ポリシー オブジェクトを取得するためのアクセス許可
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
Policy.Read.All |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
Policy.Read.All |
注意事項なし。 |
重要
サインインしているユーザーが別のユーザーを操作している職場または学校アカウントを使用して委任されたアクセスを行うには、サポートされているMicrosoft Entraロールまたはこの操作に必要なアクセス許可を付与するカスタム ロールを割り当てる必要があります。 この操作では、必要最小限の特権のみを提供する次の組み込みロールがサポートされています。
- グローバル セキュリティで保護されたアクセス管理者 - 標準プロパティの読み取り
- セキュリティ 閲覧者 - 標準プロパティの読み取り
- セキュリティ管理者 - 標準プロパティの読み取り
- グローバル閲覧者
- 条件付きアクセス管理者
HTTP 要求
削除された crossTenantAccessPolicyConfigurationPartner オブジェクトを 取得します。
GET /policies/deletedItems/crossTenantPartners/{id}
削除された crossTenantIdentitySyncPolicyPartner オブジェクトを 取得します。
GET /policies/deletedItems/crossTenantSyncPolicyPartners/{id}
削除された conditionalAccessPolicy オブジェクトを 取得します。
GET /identity/conditionalAccess/deletedItems/policies/{id}
削除された 名前付きLocation オブジェクトを 取得します。
GET /identity/conditionalAccess/deletedItems/namedLocations/{id}
オプションのクエリ パラメーター
このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーターをサポートしていません。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答コード 200 OK と、応答本文に policyDeletableItem オブジェクトを返します。 要求本文の @odata.context プロパティは、返されるポリシーの種類を示します。
例
例 1: 削除された crossTenantAccessPolicyConfigurationPartner オブジェクトを取得する
要求
次の例は、crossTenantAccessPolicyConfigurationPartner に対する要求を示しています。
GET https://graph.microsoft.com/beta/policies/deletedItems/crossTenantPartners/01d0e717-bc90-46ba-94a9-71b4a811fddb
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.DeletedItems.CrossTenantPartners["{crossTenantAccessPolicyConfigurationPartner-tenantId}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
crossTenantPartners, err := graphClient.Policies().DeletedItems().CrossTenantPartners().ByCrossTenantAccessPolicyConfigurationPartnerTenantId("crossTenantAccessPolicyConfigurationPartner-tenantId").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
CrossTenantAccessPolicyConfigurationPartner result = graphClient.policies().deletedItems().crossTenantPartners().byCrossTenantAccessPolicyConfigurationPartnerTenantId("{crossTenantAccessPolicyConfigurationPartner-tenantId}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let crossTenantAccessPolicyConfigurationPartner = await client.api('/policies/deletedItems/crossTenantPartners/01d0e717-bc90-46ba-94a9-71b4a811fddb')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->policies()->deletedItems()->crossTenantPartners()->byCrossTenantAccessPolicyConfigurationPartnerTenantId('crossTenantAccessPolicyConfigurationPartner-tenantId')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaPolicyDeletedItemCrossTenantPartner -CrossTenantAccessPolicyConfigurationPartnerTenantId $crossTenantAccessPolicyConfigurationPartnerTenantId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.policies.deleted_items.cross_tenant_partners.by_cross_tenant_access_policy_configuration_partner_tenant_id('crossTenantAccessPolicyConfigurationPartner-tenantId').get()
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft-ppe.com/testppebetadeleteapis/$metadata#policies/deletedItems/crossTenantPartners/$entity",
"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
}
}
例 2: 削除された crossTenantIdentitySyncPolicyPartner オブジェクトを取得する
要求
次の例は、crossTenantIdentitySyncPolicyPartner に対する要求を示しています。
GET https://graph.microsoft.com/beta/policies/deletedItems/crossTenantSyncPolicyPartners/01d0e717-bc90-46ba-94a9-71b4a811fddb
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.DeletedItems.CrossTenantSyncPolicyPartners["{crossTenantIdentitySyncPolicyPartner-tenantId}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
crossTenantSyncPolicyPartners, err := graphClient.Policies().DeletedItems().CrossTenantSyncPolicyPartners().ByCrossTenantIdentitySyncPolicyPartnerTenantId("crossTenantIdentitySyncPolicyPartner-tenantId").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
CrossTenantIdentitySyncPolicyPartner result = graphClient.policies().deletedItems().crossTenantSyncPolicyPartners().byCrossTenantIdentitySyncPolicyPartnerTenantId("{crossTenantIdentitySyncPolicyPartner-tenantId}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let crossTenantIdentitySyncPolicyPartner = await client.api('/policies/deletedItems/crossTenantSyncPolicyPartners/01d0e717-bc90-46ba-94a9-71b4a811fddb')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->policies()->deletedItems()->crossTenantSyncPolicyPartners()->byCrossTenantIdentitySyncPolicyPartnerTenantId('crossTenantIdentitySyncPolicyPartner-tenantId')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaPolicyDeletedItemCrossTenantSyncPolicyPartner -CrossTenantIdentitySyncPolicyPartnerTenantId $crossTenantIdentitySyncPolicyPartnerTenantId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.policies.deleted_items.cross_tenant_sync_policy_partners.by_cross_tenant_identity_sync_policy_partner_tenant_id('crossTenantIdentitySyncPolicyPartner-tenantId').get()
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft-ppe.com/testppebetadeleteapis/$metadata#policies/deletedItems/crossTenantSyncPolicyPartners/$entity",
"tenantId": "01d0e717-bc90-46ba-94a9-71b4a811fddb",
"displayName": null,
"deletedDateTime": "2025-06-18T23:11:01Z",
"externalCloudAuthorizedApplicationId": null,
"groupSyncInbound": null,
"userSyncInbound": null
}
例 3: 削除された conditionalAccessPolicy オブジェクトを取得する
要求
次の例は、 conditionalAccessPolicy の要求を示しています。
GET https://graph.microsoft.com/beta/identity/conditionalAccess/deletedItems/policies/1a71ea59-9583-4f16-9de4-47ecb42adfc6
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.ConditionalAccess.DeletedItems.Policies["{conditionalAccessPolicy-id}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
policies, err := graphClient.Identity().ConditionalAccess().DeletedItems().Policies().ByConditionalAccessPolicyId("conditionalAccessPolicy-id").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
ConditionalAccessPolicy result = graphClient.identity().conditionalAccess().deletedItems().policies().byConditionalAccessPolicyId("{conditionalAccessPolicy-id}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let conditionalAccessPolicy = await client.api('/identity/conditionalAccess/deletedItems/policies/1a71ea59-9583-4f16-9de4-47ecb42adfc6')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->identity()->conditionalAccess()->deletedItems()->policies()->byConditionalAccessPolicyId('conditionalAccessPolicy-id')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaIdentityConditionalAccessDeletedItemPolicy -ConditionalAccessPolicyId $conditionalAccessPolicyId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.identity.conditional_access.deleted_items.policies.by_conditional_access_policy_id('conditionalAccessPolicy-id').get()
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/conditionalAccess/deletedItems/policies/$entity",
"@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('<guid>')?$select=conditions,createdDateTime",
"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
}
}
例 4: 削除された namedLocation オブジェクトを取得する
要求
次の例は、 namedLocation の要求を示しています。
GET https://graph.microsoft.com/beta/identity/conditionalAccess/deletedItems/namedLocations/1a4c0633-332f-4691-a27a-fd8334938a62
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.ConditionalAccess.DeletedItems.NamedLocations["{namedLocation-id}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
namedLocations, err := graphClient.Identity().ConditionalAccess().DeletedItems().NamedLocations().ByNamedLocationId("namedLocation-id").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
NamedLocation result = graphClient.identity().conditionalAccess().deletedItems().namedLocations().byNamedLocationId("{namedLocation-id}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let namedLocation = await client.api('/identity/conditionalAccess/deletedItems/namedLocations/1a4c0633-332f-4691-a27a-fd8334938a62')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->identity()->conditionalAccess()->deletedItems()->namedLocations()->byNamedLocationId('namedLocation-id')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaIdentityConditionalAccessDeletedItemNamedLocation -NamedLocationId $namedLocationId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.identity.conditional_access.deleted_items.named_locations.by_named_location_id('namedLocation-id').get()
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/conditionalAccess/deletedItems/namedLocations/$entity",
"@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"
}