ExternalConnection.Read.All
Allows the app to read all external connections without a signed-in user.
Permission Details
Read all external connections
Allows the app to read all external connections without a signed-in user.
1914711b-a1cb-4793-b019-c2ce0ed21b8c
Read all external connections
Allows the app to read all external connections on behalf of a signed-in user. The signed-in user must be an administrator.
a38267a5-26b6-4d76-9493-935b7599116b
Properties
Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Property | Type | Description |
|---|---|---|
configuration |
object |
|
description |
stringNullable |
|
groups |
externalGroup collection |
|
id |
string |
The unique identifier for an entity. Read-only. |
items |
externalItem collection |
|
name |
stringNullable |
|
operations |
connectionOperation collection |
|
schema |
object |
|
state |
objectRead-only |
JSON Representation
JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
{
"configuration": {
"sample": "value"
},
"description": "String",
"groups": [
{
"@type": "externalGroup",
"id": "00000000-0000-0000-0000-000000000000"
}
],
"id": "String",
"items": [
{
"@type": "externalItem",
"id": "00000000-0000-0000-0000-000000000000"
}
],
"name": "String",
"operations": [
{
"@type": "connectionOperation",
"id": "00000000-0000-0000-0000-000000000000"
}
],
"schema": {
"sample": "value"
},
"state": {
"sample": "value"
}
}
Relationships
Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Relationship | Type | Description |
|---|---|---|
groups |
externalGroup collection |
External groups in the connection. |
items |
externalItem collection |
External items in the connection. |
schema |
schema |
Schema definition for the external connection. |
operations |
connectionOperation collection |
Related operations data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/external/connections
|
GET
/external/connections/{connection-id}/operations/{operation-id}
|
GET
/external/connections/{id}
|
GET
/external/connections/{id}/schema
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// 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.External.Connections["{externalConnection-id}"].Operations["{connectionOperation-id}"].GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let connectionOperation = await client.api('/external/connections/contosohr/operations/3ed1595a-4bae-43c2-acda-ef973e581323')
.get();
Import-Module Microsoft.Graph.Search
Get-MgExternalConnectionOperation -ExternalConnectionId $externalConnectionId -ConnectionOperationId $connectionOperationId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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.external.connections.by_external_connection_id('externalConnection-id').operations.by_connection_operation_id('connectionOperation-id').get()
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for ExternalConnection.Read.All
Grant Admin Consent
Application permissions always require admin consent.