# 更新边缘小站 - UpdateEdgeSite #### 功能介绍 更新边缘小站。 - 允许更新边缘小站描述或场地信息。 - 该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ies:edgeSite:update #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IES/doc?api=UpdateEdgeSite)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cloudpond/ies_05_0800.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ies:edgeSite:update | Write | edgeSite \* | g:EnterpriseProjectId | - | - | #### URI PUT /v1/{domain_id}/edge-sites/{site_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | String | path中租户的账号ID | | site_id | 是 | String | 边缘小站ID | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | edge_site | 是 | [UpdateEdgeSite] object | 待更新的边缘小站参数 | 表4UpdateEdgeSite | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | description | 否 | String | \](tag:hws)描述，最大支持长度为255个字节，不允许包含\<\> | | location | 否 | [UpdateLocation] object | 场地信息 | 表5UpdateLocation | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | 场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 | | country | 否 | String | 场地所在国家（逐步下线，使用zone_code替代），传入该参数不会再生效 | | province | 否 | String | 场地所在省/自治区/直辖市 | | city | 否 | String | 场地所在市/区 | | district | 否 | String | 场地所在区/县 | | condition | 否 | [UpdateCondition] object | 场地条件 | | description | 否 | String | 场地描述，最大支持长度为255个字节，不允许包含\<\> | 表6UpdateCondition | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | environment | 否 | Integer | 机房环境条件 取值范围： - 0：机房条件不属于上述任何一种情况 - 1：机房使用模块化数据中心方案进行建设 - 2：机房已通过国家级或行业级标准化认证 | | space | 否 | Integer | 机柜空间条件 - 0：暂无扩容计划，不考虑额外余量 - 1：机柜余量相对充裕，可放置空间超过3柜 - 2：机柜余量相对紧张，可放置空间3柜以内 | | transport | 否 | Integer | 运输条件 取值范围： - 0：运输通道和机房门的高度或宽度不满足要求 - 1：运输通道，货梯，机房门均可满足整机柜滚轮搬运 - 2：运输通道，货梯，机房门不能支持整机柜滚轮搬运，沿途有台阶 | | installation | 否 | String | 整柜安装评估 取值范围： - UNCLEAR：不清楚是否允许整柜安装，需要评估 - UNSUPPORT：不允许整柜安装，需将设备放入现有机柜 - SUPPORT：可支持整柜安装，并入现有机柜组 | #### 响应参数 **状态码：200** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | edge_site | [EdgeSiteDetail] object | 边缘小站详情 | 表8EdgeSiteDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 站点状态： - initial：待部署 - deploying：部署中 - available：可用 - unavailable：不可用 | | location | [LocationDetail] object | 场地详情 | | enterprise_project_id | String | 边缘小站所属企业项目ID | | created_at | String | 边缘小站创建时间 | | updated_at | String | 边缘小站更新时间 | 表9LocationDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 | | description | String | 场地描述 | | zone_code | String | 场地所在地区 | | address | String | 部署位置 | | country | String | 场地所在国家（逐步下线，使用zone_code替代） | | province | String | 场地所在省/自治区/直辖市 | | city | String | 场地所在市/区 | | district | String | 场地所在区/县 | | condition | [Condition] object | 场地条件 | 表10Condition | 参数 | 参数类型 | 描述 | |:---|:---|:---| | environment | Integer | 机房环境条件 取值范围： - 0：机房条件不属于上述任何一种情况 - 1：机房使用模块化数据中心方案进行建设 - 2：机房已通过国家级或行业级标准化认证 | | space | Integer | 机柜空间条件 取值范围： - 0：暂无扩容计划，不考虑额外余量 - 1：机柜余量相对充裕，可放置空间超过3柜 - 2：机柜余量相对紧张，可放置空间3柜以内 | | transport | Integer | 运输条件 取值范围： - 0：运输通道和机房门的高度或宽度不满足要求 - 1：运输通道，货梯，机房门均可满足整机柜滚轮搬运 - 2：运输通道，货梯，机房门不能支持整机柜滚轮搬运，沿途有台阶 | | installation | String | 整柜安装评估 取值范围： - UNCLEAR：不清楚是否允许整柜安装，需要评估 - UNSUPPORT：不允许整柜安装，需将设备放入现有机柜 - SUPPORT：可支持整柜安装，并入现有机柜组 | #### 请求示例 - 更新小站，部署位置为中国/安徽省/合肥市/瑶海区，机房暂不确定是否满足条件，机柜暂无扩容计划，运输通道和机房门的高度或宽度不满足要求，可支持整柜安装，并入现有机柜组 ``` PUT https://{ies_endpoint}/v1/{domain_id}/edge-sites/{site_id} { "application/json" : { "edge_site" : { "description" : "测试站点：位于安徽", "location" : { "description" : "测试站点场地信息", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } } } } } ``` #### 响应示例 **状态码：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, "status" : "initial", "location" : { "description" : "测试站点场地信息", "zone_code" : "CN", "address" : "安徽省 合肥市 瑶海区", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } }, "enterprise_project_id" : "06fb8917-442d-4d4d-bcdb-79eb3e7b7b5d", "created_at" : "2022-04-15T07:59:20.641Z", "updated_at" : "2022-04-15T08:59:20.641Z" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | successful operation | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cloudpond/ErrorCode.html)。