更新时间:2025-11-17 GMT+08:00
分享

创建RoCE网络

功能介绍

创建RoCE网络。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/dev-servers/networks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

network_type

String

参数解释:RoCE网络类型。

约束限制:不涉及。

取值范围

  • vxlan_roce

  • roce_v2

默认取值:不涉及。

physical_network

String

参数解释:物理网络名称。

约束限制:^[-_.a-zA-Z0-9]{1,64}$。

取值范围:不涉及。

默认取值:不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

network

ServerRoceNetwork object

参数解释:网络详细信息。

表4 ServerRoceNetwork

参数

参数类型

描述

id

String

参数解释:RoCE网络id。

取值范围:不涉及。

name

String

参数解释:RoCE网络名称。

取值范围:不涉及。

project_id

String

参数解释:项目ID。

取值范围:不涉及。

status

String

参数解释:状态。

参数解释:不涉及。

tenant_id

String

参数解释:租户id。

取值范围:不涉及。

subnets

String

参数解释:子网。

取值范围:不涉及。

provider:network_type

String

参数解释:RoCE网络类型。

取值范围:不涉及。

provider:physical_network

String

参数解释:实际物理网络。

取值范围:不涉及。

请求示例

POST https://{endpoint}/v1/{project_id}/dev-servers/networks

{
  "network_type" : "vxlan_roce",
  "physical_network" : "roce_pod101"
}

响应示例

状态码:200

参数解释:网络详细信息。

{
  "network" : {
    "id" : "11111cfe-7234-4105-8307-0f7eb8a0244c",
    "name" : "devserver_roce_pod101_0b15",
    "project_id" : "11111583c880d2362fd1c012d7bb14bf",
    "provider:network_type" : "vxlan_roce",
    "provider:physical_network" : "roce_pod101",
    "status" : "ACTIVE",
    "tenant_id" : "11111583c880d2362fd1c012d7bb14bf",
    "subnets" : "[\"11111d19-8a52-417e-9fef-aa88e68ac4a5\"]"
  }
}

状态码

状态码

描述

200

参数解释:网络详细信息。

错误码

请参见错误码

相关文档