Вывод списка remoteNetworks
Пространство имен: microsoft.graph.networkaccess
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получите список удаленных сетей в клиенте, подключенном к службам глобального безопасного доступа.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешение с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | Не поддерживается. | Не поддерживается. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Для приложений | Не поддерживается. | Не поддерживается. |
Чтобы прочитать конфигурацию, вызывающему пользователю также необходимо назначить хотя бы одну из следующих ролей Microsoft Entra.
- Глобальный читатель
- Глобальный администратор безопасного доступа
- Администратор безопасности
HTTP-запрос
GET /networkAccess/connectivity/remoteNetworks
Необязательные параметры запросов
Этот метод поддерживает $expand параметры запроса OData и $select для настройки ответа. Общие сведения см. в статье Параметры запроса OData.
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов microsoft.graph.networkaccess.remoteNetwork в теле отклика.
Примеры
Запрос
Ниже приведен пример запроса.
GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET networkAccess/connectivity/remoteNetworks?$select=bandwidthCapacity,connectivityState",
"value": [
{
"id": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04",
"name": "Test branch",
"region": "canadaEast",
"version": "1.0.0",
"lastModifiedDateTime": "2023-12-12T14:26:24Z",
"forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/forwardingProfiles",
"forwardingProfiles": [
{
"trafficForwardingType": "m365",
"priority": 0,
"id": "1adaf535-1e31-4e14-983f-2270408162bf",
"name": "Microsoft 365 traffic forwarding profile",
"description": "Default traffic forwarding profile for Microsoft 365 traffic acquisition. Assign the profile to client or branch offices to acquire Microsoft 365 traffic for Zero Trust Network Access.",
"state": "disabled",
"version": "1.0.0",
"lastModifiedDateTime": "2024-01-22T12:10:49Z",
"associations": [
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "9ffbc1a5-2916-4fb4-b277-76cdc89cc491"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "43c7a0d3-1072-4da1-9e30-e513b02bb559"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9"
}
]
}
],
"deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04')/deviceLinks",
"deviceLinks": [
{
"id": "47aab2e9-7f5c-42ba-bbfc-1b049193126a",
"name": "name",
"ipAddress": "1.2.3.1",
"bandwidthCapacityInMbps": "mbps500",
"deviceVendor": "barracudaNetworks",
"lastModifiedDateTime": "2023-12-12T14:26:24Z",
"bgpConfiguration": {
"localIpAddress": "10.1.1.1",
"peerIpAddress": "10.2.2.1",
"asn": 899
},
"redundancyConfiguration": {
"zoneLocalIpAddress": null,
"redundancyTier": "noRedundancy"
},
"tunnelConfiguration": {
"@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default",
"preSharedKey": "dcf"
}
}
]
},
{
"id": "43c7a0d3-1072-4da1-9e30-e513b02bb559",
"name": "USA branch 1",
"region": "eastUS",
"version": "1.0.0",
"lastModifiedDateTime": "2024-01-17T19:23:32Z",
"forwardingProfiles@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('43c7a0d3-1072-4da1-9e30-e513b02bb559')/forwardingProfiles",
"forwardingProfiles": [
{
"trafficForwardingType": "m365",
"priority": 0,
"id": "1adaf535-1e31-4e14-983f-2270408162bf",
"name": "Microsoft 365 traffic forwarding profile",
"description": "Default traffic forwarding profile for Microsoft 365 traffic acquisition. Assign the profile to client or branch offices to acquire Microsoft 365 traffic for Zero Trust Network Access.",
"state": "disabled",
"version": "1.0.0",
"lastModifiedDateTime": "2024-01-22T12:10:49Z",
"associations": [
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "9ffbc1a5-2916-4fb4-b277-76cdc89cc491"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "43c7a0d3-1072-4da1-9e30-e513b02bb559"
},
{
"@odata.type": "#microsoft.graph.networkaccess.associatedBranch",
"branchId": "4ecfc62c-ec85-42fd-af37-5a93c7deb1d9"
}
]
}
],
"deviceLinks@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/remoteNetworks('43c7a0d3-1072-4da1-9e30-e513b02bb559')/deviceLinks",
"deviceLinks": [
{
"id": "6833faf3-b4ea-4cd4-a256-3ee71985e51d",
"name": "Cisco device 1",
"ipAddress": "20.1.1.1",
"bandwidthCapacityInMbps": "mbps1000",
"deviceVendor": "ciscoMeraki",
"lastModifiedDateTime": "2024-01-17T19:23:32Z",
"bgpConfiguration": {
"localIpAddress": "10.1.1.2",
"peerIpAddress": "10.2.2.2",
"asn": 65533
},
"redundancyConfiguration": {
"zoneLocalIpAddress": null,
"redundancyTier": "noRedundancy"
},
"tunnelConfiguration": {
"@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default",
"preSharedKey": "test123"
}
}
]
}
]
}
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по