创建边缘小站 - CreateEdgeSite
功能介绍
创建边缘小站。
-
一个边缘小站关联一个华为云指定的区域。
-
该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ies:edgeSite:create
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/{domain_id}/edge-sites
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
domain_id |
是 |
String |
path中租户的账号ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
edge_site |
是 |
CreateEdgeSite object |
边缘小站参数 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
边缘小站名称，最大支持长度为64个字节。只包含中文字符、英文字母（a-z、A-Z）、数字（0-9）、下划线（_）、中划线（-） |
|
region_id |
是 |
String |
边缘小站所属区域ID，最大长度为64个字节。只包含英文字母（a-z、A-Z）、数字（0-9）、下划线（_）、中划线（-） |
|
project_id |
否 |
String |
边缘小站所属项目ID |
|
description |
否 |
String |
边缘小站描述，最大支持长度为255个字节，不允许包含<> |
|
location |
是 |
CreateLocation object |
场地信息 |
|
enterprise_project_id |
否 |
String |
企业项目Id |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
场地名称（已废弃）,该参数不会再持久化存储，新建站点也不会再返回该字段 |
|
address |
否 |
String |
场地所在省/自治区/直辖市 |
|
zone_code |
否 |
String |
场地所在地区 |
|
province |
否 |
String |
场地所在省/自治区/直辖市 |
|
city |
否 |
String |
场地所在市/区 |
|
district |
否 |
String |
场地所在区/县 |
|
country |
否 |
String |
场地所在国家（逐步下线，使用zone_code替代） |
|
condition |
是 |
Condition object |
场地条件 |
|
description |
否 |
String |
场地描述，最大支持长度为255个字节，不允许包含<> |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
environment |
否 |
Integer |
机房环境条件 取值范围：
|
|
space |
否 |
Integer |
机柜空间条件 取值范围：
|
|
transport |
否 |
Integer |
运输条件 取值范围：
|
|
installation |
否 |
String |
整柜安装评估 取值范围：
|
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
edge_site |
EdgeSiteDetail object |
边缘小站详情 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
边缘小站ID |
|
domain_id |
String |
边缘小站所属账号ID |
|
name |
String |
边缘小站名称 |
|
description |
String |
边缘小站描述 |
|
region_id |
String |
边缘小站所属区域ID |
|
project_id |
String |
边缘小站所属项目ID |
|
availability_zone_id |
String |
边缘小站的可用区ID |
|
status |
String |
边缘小站的部署状态 |
|
location |
LocationDetail object |
场地详情 |
|
enterprise_project_id |
String |
边缘小站所属企业项目ID |
|
created_at |
String |
边缘小站创建时间 |
|
updated_at |
String |
边缘小站更新时间 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 |
|
description |
String |
场地描述 |
|
zone_code |
String |
场地所在地区 |
|
address |
String |
部署位置 |
|
country |
String |
场地所在国家（逐步下线，使用zone_code替代） |
|
province |
String |
场地所在省/自治区/直辖市 |
|
city |
String |
场地所在市/区 |
|
district |
String |
场地所在区/县 |
|
condition |
Condition object |
场地条件 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
environment |
Integer |
机房环境条件 取值范围：
|
|
space |
Integer |
机柜空间条件 取值范围：
|
|
transport |
Integer |
运输条件 取值范围：
|
|
installation |
String |
整柜安装评估 取值范围：
|
请求示例
创建边缘小站，区域为cn-north-4（北京四），部署位置为中国/安徽省/合肥市/瑶海区，机房暂不确定是否满足条件，机柜暂无扩容计划，运输通道和机房门的高度或宽度不满足要求，可支持整柜安装，并入现有机柜组
POST https://{ies_endpoint}/v1/{domain_id}/edge-sites
{
"edge_site" : {
"name" : "测试站点",
"description" : "测试站点：位于安徽",
"region_id" : "cn-north-4",
"location" : {
"description" : "站点场地信息",
"zone_code" : "CN",
"address" : "安徽省 合肥市 瑶海区",
"country" : "CN",
"province" : "安徽省",
"city" : "合肥市",
"district" : "瑶海区",
"condition" : {
"environment" : 0,
"space" : 0,
"transport" : 0
}
}
}
}
响应示例
状态码：200
successful operation
{
"edge_site" : {
"id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e",
"domain_id" : "2b76febbe5d34eac85d26435c1f15809",
"name" : "测试站点",
"description" : "测试站点：位于安徽",
"region_id" : "cn-north-4",
"project_id" : "060576838600d5762f2dc000470eb164",
"availability_zone_id" : null,
"enterprise_project_id" : "0",
"status" : "initial",
"location" : {
"description" : "站点场地信息",
"zone_code" : "CN",
"address" : "安徽省 合肥市 瑶海区",
"country" : "CN",
"province" : "安徽省",
"city" : "合肥市",
"district" : "瑶海区",
"condition" : {
"environment" : 0,
"space" : 0,
"transport" : 0,
"installation" : "SUPPORT"
}
},
"created_at" : "2022-04-15T07:59:20.641Z",
"updated_at" : null
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
successful operation |
错误码
请参见错误码。
