directory resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a deleted item in the directory. A deleted item is sent to the deleted items "container." Deleted items remain available to restore for up to 30 days. After 30 days, the items are permanently deleted.
Currently, deleted items functionality is supported for the the following resources:
- administrative unit
- application
- externalUserProfile
- group
- pendingExternalUserProfile
- servicePrincipal
- user
Inherits from entity.
Methods
| Method | Return Type | Description |
|---|---|---|
| List | directoryObject collection | Gets a list of recently deleted items. |
| Get | directoryObject | Gets the properties of a deleted item. |
| Restore | directoryObject | Restores a recently deleted item. |
| Permanently delete | None | Permanently deletes an item. |
| List deleted items owned by user | directoryObject collection | Lists directory items owned by a user. |
Properties
| Property | Type | Description |
|---|---|---|
| id | String | A unique identifier for the object; for example, 12345678-9abc-def0-1234-56789abcde. Key. Not nullable. Read-only. Inherited from entity. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| administrativeUnits | administrativeUnit collection | Conceptual container for user and group directory objects. |
| attributeSets | attributeSet collection | Group of related custom security attribute definitions. |
| customSecurityAttributeDefinitions | customSecurityAttributeDefinition collection | Schema of a custom security attributes (key-value pairs). |
| deletedItems | directoryObject collection | Recently deleted items. Read-only. Nullable. |
| deviceLocalCredentials | deviceLocalCredential collection | The credentials of the device's local administrator account backed up to Microsoft Entra ID. |
| externalUserProfiles | externalUserProfile collection | Collection of external user profiles that represent collaborators in the directory. |
| featureRolloutPolicies | featureRolloutPolicy collection | Nullable. |
| federationConfigurations | identityProviderBase collection | Configure domain federation with organizations whose identity provider (IdP) supports either the SAML or WS-Fed protocol. |
| inboundSharedUserProfiles | inboundSharedUserProfile collection | A collection of external users whose profile data is shared with the Microsoft Entra tenant. Nullable. |
| onPremisesSynchronization | onPremisesDirectorySynchronization | A container for on-premises directory synchronization functionalities that are available for the organization. |
| outboundSharedUserProfile | outboundSharedUserProfile collection | A collection of Microsoft Entra users whose profile data is shared with an external Microsoft Entra tenant. Nullable. |
| pendingExternalUserProfiles | pendingExternalUserProfile collection | Collection of pending external user profiles representing collaborators in the directory that are unredeemed. |
| recommendations | recommendation collection | List of recommended improvements to improve tenant posture. |
| subscriptions | companySubscription collection | List of commercial subscriptions that an organization has. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.directory"
}