创建 deviceLink

项目
11/06/2024

命名空间：microsoft.graph.networkaccess

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

为远程网络创建设备链接。若要在同一请求中创建远程网络和设备链接，请参阅创建远程网络。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	❌	❌	❌

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	不支持。	不支持。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	不支持。	不支持。

重要

在具有工作或学校帐户的委托方案中，必须为登录用户分配受支持的Microsoft Entra角色或具有支持的角色权限的自定义角色。此操作支持以下最低特权角色。

全局安全访问管理员
安全管理员

HTTP 请求

POST /networkAccess/connectivity/remoteNetworks/{remoteNetworkId}/deviceLinks

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
Content-Type	application/json. 必需。

请求正文

在请求正文中，提供 microsoft.graph.networkaccess.deviceLink 对象的 JSON 表示形式。

创建 deviceLink 时，可以指定以下属性。

属性	类型	说明
name	String	与设备链接关联的名称或标识符。必填。
ipAddress	String	与设备链接关联的 IP 地址。必填。
deviceVendor	microsoft.graph.networkaccess.deviceVendor	与设备链接关联的设备的供应商或制造商。可能的值为：`barracudaNetworks`、、`ciscoMerakicheckPoint`、`hpeArubafortinetopenSystemspaloAltoNetworkscitrixnetFoundrynuage`、、`riverbedTechnologysilverPeak`、、、`vmWareSdWan`、、。 `otherversa` 必填。
tunnelConfiguration	microsoft.graph.networkaccess.tunnelConfiguration	与设备链接关联的隧道配置设置。必填。
bgpConfiguration	microsoft.graph.networkaccess.bgpConfiguration	边界网关协议 (BGP) 与设备链接关联的配置设置。必填。
redundancyConfiguration	microsoft.graph.networkaccess.redundancyConfiguration	设备链接的冗余选项指定与冗余相关的特定详细信息和配置设置。必填。

响应

如果成功，此方法在 201 Created 响应正文中返回响应代码和 microsoft.graph.networkaccess.deviceLink 对象。

示例 1：使用默认 IKE 策略添加设备链接

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/dc6a7efd-6b2b-4c6a-84e7-5dcf97e62e04/deviceLinks
Content-Type: application/json
{
    "name": "CPE3",
    "ipAddress": "20.55.91.42",
    "deviceVendor": "ciscoMeraki",
    "bandwidthCapacityInMbps": "mbps1000",
    "bgpConfiguration": {
        "localIpAddress": "192.168.1.2",
        "peerIpAddress": "10.2.2.2",
        "asn": 65533
    },
    "redundancyConfiguration": {
        "redundancyTier": "zoneRedundancy",
        "zoneLocalIpAddress": "192.168.1.3"
    },
    "tunnelConfiguration": {
        "@odata.type": "#microsoft.graph.networkaccess.tunnelConfigurationIKEv2Default",
        "preSharedKey": "test123"
    }
}

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 204 No Content

示例 2：使用自定义 IKE 策略添加设备链接

请求