connectedOrganization resource type
Namespace: microsoft.graph
In Microsoft Entra entitlement management, a connected organization is a reference to a directory or domain of another organization whose users can request access.
Methods
| Method | Return type | Description |
|---|---|---|
| List | connectedOrganization collection | Retrieve a list of connectedOrganization objects. |
| Create | connectedOrganization | Create a new connectedOrganization object. |
| Get | connectedOrganization | Read properties and relationships of a connectedOrganization object. |
| Update | connectedOrganization collection | Update a connectedOrganization. |
| Delete | None | Delete a connectedOrganization. |
| External sponsors | ||
| List | directoryObject collection | Retrieve a list of a connectedOrganization's external sponsors. |
| Add | None | Add a user or group to a connectedOrganization's external sponsors. |
| Remove | None | Remove a user or group from the connectedOrganization's external sponsors. |
| Internal sponsors | ||
| List | directoryObject collection | Retrieve a list of a connectedOrganization's internal sponsors. |
| Add | None | Add a user or group to a connectedOrganization's internal sponsors. |
| Remove | None | Remove a user or group from the connectedOrganization's internal sponsors. |
Properties
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| description | String | The description of the connected organization. |
| displayName | String | The display name of the connected organization. Supports $filter (eq). |
| id | String | Read-only. |
| identitySources | identitySource collection | The identity sources in this connected organization, one of azureActiveDirectoryTenant, crossCloudAzureActiveDirectoryTenant, domainIdentitySource, externalDomainFederation, or socialIdentitySource. Nullable. |
| modifiedDateTime | DateTimeOffset | *The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| state | connectedOrganizationState | The state of a connected organization defines whether assignment policies with requestor scope type AllConfiguredConnectedOrganizationSubjects are applicable or not. The possible values are: configured, proposed, unknownFutureValue. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| externalSponsors | directoryObject collection | Nullable. |
| internalSponsors | directoryObject collection | Nullable. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.connectedOrganization",
"description": "String",
"displayName": "String",
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"identitySources": [
{
"@odata.type": "microsoft.graph.azureActiveDirectoryTenant"
}
],
"modifiedDateTime": "String (timestamp)",
"state": "String"
}