裸金属服务器 BMS裸金属服务器 BMS

计算
弹性云服务器 ECS
裸金属服务器 BMS
云手机 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器 HECS
VR云渲游平台 CVR
特惠算力专区
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属企业存储服务
云存储网关 CSG
专属分布式存储服务 DSS
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘小站 IES
智能边缘平台 IEF
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
园区智能体 CampusGo
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
视频分析服务 VAS
语音交互服务 SIS
知识图谱 KG
人证核身服务 IVS
IoT物联网
设备接入 IoTDA
设备管理 IoTDM(联通用户专用)
全球SIM联接 GSL
IoT开发者服务
IoT数据分析
车联网服务 IoV
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
开发与运维
软件开发平台 DevCloud
项目管理 ProjectMan
代码托管 CodeHub
流水线 CloudPipeline
代码检查 CodeCheck
编译构建 CloudBuild
部署 CloudDeploy
云测 CloudTest
发布 CloudRelease
移动应用测试 MobileAPPTest
CloudIDE
Classroom
开源镜像站 Mirrors
应用魔方 AppCube
云性能测试服务 CPTS
应用管理与运维平台 ServiceStage
云应用引擎 CAE
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
资源管理服务 RMS
应用身份管理服务 OneAccess
区块链
区块链服务 BCS
可信跨链服务 TCS
智能协作
IdeaHub
开发者工具
SDK开发指南
API签名指南
DevStar
HCloud CLI
Terraform
Ansible
API问题定位指导
云生态
云市场
合作伙伴中心
华为云培训中心
其他
管理控制台
消息中心
产品价格详情
系统权限
我的凭证
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
应用编排服务 AOS
多云容器平台 MCP
基因容器 GCS
容器洞察引擎 CIE
云原生服务中心 OSC
容器批量计算 BCE
容器交付流水线 ContainerOps
应用服务网格 ASM
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB (for openGauss)
云数据库 GaussDB(for MySQL)
云数据库 GaussDB NoSQL
数据管理服务 DAS
数据库和应用迁移 UGO
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据湖治理中心 DGC
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
API网关 APIG
分布式缓存服务 DCS
分布式消息服务RocketMQ版
企业应用
域名注册服务 Domains
云解析服务 DNS
云速建站 CloudSite
网站备案
华为云WeLink
会议
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMAExchange
API全生命周期管理 ROMA API
安全与合规
安全技术与应用
DDoS防护 ADS
Web应用防火墙 WAF
云防火墙 CFW
应用信任中心 ATC
企业主机安全 HSS
容器安全服务 CGS
云堡垒机 CBH
数据库安全服务 DBSS
数据加密服务 DEW
数据安全中心 DSC
云证书管理服务 CCM
SSL证书管理 SCM
漏洞扫描服务 VSS
态势感知 SA
威胁检测服务 MTD
管理检测与响应 MDR
安全治理云图 Compass
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
专属云
专属计算集群 DCC
解决方案
高性能计算 HPC
SAP
游戏云
混合云灾备
华为工业云平台 IMC
价格
成本优化最佳实践
专属云商业逻辑
用户服务
帐号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
更新时间:2021-11-30 GMT+08:00
分享

修改裸金属服务器名称

功能介绍

修改裸金属服务器名称。

约束

裸金属服务器名称取值范围:

只能由中文字符、英文字母(a~z,A~Z)、数字(0~9)、下划线(_)、中划线(-)、点(.)组成,且长度为[1-63]个字符。

本接口只修改裸金属服务器的实例名称,但hostname不能同步修改。重启裸金属服务器后生效。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/{project_id}/baremetalservers/{server_id}

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方式请参见获取项目ID

server_id

裸金属服务器ID。

可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    server

    Object

    裸金属服务器数据结构。详情请参见表2

    表2 server字段数据结构说明

    参数

    是否必选

    参数类型

    描述

    name

    String

    修改后的裸金属服务器名称。

  • 请求样例
    1
    PUT https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/95bf2490-5428-432c-ad9b-5e3406f869dd
    
    1
    2
    3
    4
    5
    6
    {
      "server":
        {
          "name": "new-server-test"
        }
    }
    

响应消息

  • 响应参数

    参数

    参数类型

    描述

    server

    Object

    裸金属服务器信息。详情请参见表3

    表3 server字段数据结构说明

    参数

    参数类型

    描述

    name

    String

    裸金属服务器名称。

    id

    String

    裸金属服务器唯一标识ID。

    status

    String

    裸金属服务器当前状态。

    • ACTIVE:运行中/正在关机/删除中
    • BUILD:创建中
    • ERROR:故障
    • HARD_REBOOT:强制重启中
    • REBOOT:重启中
    • DELETED:实例已被正常删除
    • SHUTOFF:关机/正在开机/删除中/重建中/重装操作系统中/重装操作系统失败/冻结

    created

    String

    裸金属服务器创建时间。

    时间戳格式为ISO 8601:YYYY-MM-DDTHH:MM:SSZ,例如:2019-05-22T03:30:52Z

    updated

    String

    裸金属服务器上一次更新时间。

    时间戳格式为ISO 8601:YYYY-MM-DDTHH:MM:SSZ,例如:2019-05-22T04:30:52Z

    flavor

    Object

    裸金属服务器规格信息。详情请参见表6

    image

    Object

    裸金属服务器镜像信息。详情请参见表7

    tenant_id

    String

    裸金属服务器所属租户ID,格式为UUID。

    该参数和project_id表示相同的概念。

    key_name

    String

    SSH密钥名称。

    user_id

    String

    裸金属服务器所属用户ID。

    metadata

    Object

    裸金属服务器元数据。详情请参见表9

    hostId

    String

    裸金属服务器的主机ID。

    addresses

    Object

    裸金属服务器对应的网络地址信息。详情请参见表10

    security_groups

    Array of objects

    裸金属服务器所属安全组列表。详情请参见表12

    links

    Array of objects

    裸金属服务器相关信息快捷链接。详情请参见表8

    OS-DCF:diskConfig

    String

    扩展属性,磁盘配置方式,取值为如下两种:

    • MANUAL:API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大,则API不会对剩余磁盘空间进行分区。
    • AUTO:API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器,API会自动调整文件系统以适应整个分区。

    OS-EXT-AZ:availability_zone

    String

    扩展属性,裸金属服务器所在可用区名称。

    OS-EXT-SRV-ATTR:host

    String

    扩展属性,裸金属服务器宿主机名称。

    OS-EXT-SRV-ATTR:hypervisor_hostname

    String

    扩展属性,裸金属服务器所在虚拟化主机名。

    OS-EXT-SRV-ATTR:instance_name

    String

    扩展属性,裸金属服务器别名。

    OS-EXT-STS:power_state

    Integer

    扩展属性,裸金属服务器电源状态。例如:

    • 0表示“NO STATE”
    • 1表示“RUNNING”
    • 4表示“SHUTDOWN”

    OS-EXT-STS:task_state

    String

    扩展属性,裸金属服务器任务状态。例如:

    • rebooting:重启中
    • reboot_started:普通重启
    • reboot_started_hard:强制重启
    • powering-off:关机中
    • powering-on:开机中
    • rebuilding:重建中
    • scheduling:调度中
    • deleting:删除中

    OS-EXT-STS:vm_state

    String

    扩展属性,裸金属服务器状态。例如:

    • active:运行中
    • shutoff:关机
    • suspended:暂停
    • reboot:重启

    OS-SRV-USG:launched_at

    String

    扩展属性,裸金属服务器启动时间。

    时间戳格式为ISO 8601,例如:2019-05-25T03:40:25.000000

    OS-SRV-USG:terminated_at

    String

    扩展属性,裸金属服务器关闭时间。

    时间戳格式为ISO 8601,例如:2019-06-25T03:40:25.000000

    os-extended-volumes:volumes_attached

    Array of objects

    裸金属服务器挂载的云硬盘信息。详情请参见表13

    accessIPv4

    String

    预留属性。

    accessIPv6

    String

    预留属性。

    fault

    Object

    裸金属服务器故障原因。详情请参见表14

    config_drive

    String

    预留属性。

    progress

    Integer

    预留属性。

    description

    String

    裸金属服务器的描述信息。

    host_status

    String

    裸金属服务器宿主机状态。

    • UP:服务正常
    • UNKNOWN:状态未知
    • DOWN:服务异常
    • MAINTENANCE:维护状态
    • 空字符串:裸金属服务器无主机信息

    OS-EXT-SRV-ATTR:hostname

    String

    裸金属服务器的主机名。

    OS-EXT-SRV-ATTR:reservation_id

    String

    批量创建场景,裸金属服务器的预留ID。

    当批量创建裸金属服务器时,这些服务器将拥有相同的reservation_id。

    OS-EXT-SRV-ATTR:launch_index

    Integer

    批量创建场景,裸金属服务器的启动顺序。

    OS-EXT-SRV-ATTR:kernel_id

    String

    若使用AMI格式的镜像,则表示kernel image的UUID;否则,留空。

    OS-EXT-SRV-ATTR:ramdisk_id

    String

    若使用AMI格式镜像,则表示ramdisk image的UUID;否则,留空。

    OS-EXT-SRV-ATTR:root_device_name

    String

    裸金属服务器系统盘的设备名称,例如“/dev/sdb”。

    OS-EXT-SRV-ATTR:user_data

    String

    创建裸金属服务器时指定的user_data。取值为base64编码后的结果或空字符串。

    locked

    Boolean

    裸金属服务器实例是否为锁定状态。

    • true:锁定
    • false:未锁定

    tags

    Array of strings

    裸金属服务器标签。

    sys_tags

    Array of objects

    裸金属服务器系统标签。

    enterprise_project_id

    String

    企业项目id。

    os:scheduler_hints

    Object

    云服务器调度信息。

    表4 sys_tags字段数据结构说明

    参数

    参数类型

    描述

    key

    String

    系统标签的Key值。

    value

    String

    系统标签的value值。

    表5 os:scheduler_hints字段数据结构说明(响应参数)

    参数

    参数类型

    描述

    group

    Array of strings

    云服务器组ID,UUID格式。

    表6 flavor字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    规格ID。

    links

    Array of objects

    规格相关信息快捷链接。详情请参见表8

    表7 image字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    裸金属服务器镜像ID。

    links

    Array of objects

    裸金属服务器镜像相关快捷链接信息。详情请参见表8

    表8 links字段数据结构说明

    参数

    参数类型

    描述

    rel

    String

    快捷链接标记名称。取值为:

    • self:包含版本号的资源链接,需要立即跟踪时使用此类链接。
    • bookmark:提供了适合长期存储的资源链接。

    href

    String

    对应快捷链接。

    表9 metadata字段数据结构说明

    参数

    参数类型

    描述

    key

    String

    metadata键、值。

    键、值长度均不大于255字节。

    表10 addresses字段数据结构说明

    参数

    参数类型

    描述

    vpc_id

    Array of objects

    裸金属服务器所属网络信息。

    • key:表示裸金属服务器使用的虚拟私有云的ID。
    • value:网络详细信息,具体请参见表11
    表11 address字段数据结构说明

    参数

    参数类型

    描述

    addr

    String

    IP地址信息。

    version

    Integer

    IP地址类型,值为4或6。

    • 4:IP地址类型是IPv4
    • 6:IP地址类型是IPv6

    OS-EXT-IPS-MAC:mac_addr

    String

    扩展属性,MAC地址。

    OS-EXT-IPS:type

    String

    扩展属性,分配IP地址方式。

    OS-EXT-IPS:port_id

    String

    IP地址对应的端口ID。

    表12 security_groups字段数据结构说明

    参数

    参数类型

    描述

    name

    String

    • 创建裸金属服务器时未指定安全组,该值为default。
    • 创建裸金属服务器时,需要指定已有安全组的ID(UUID格式)。
    表13 os-extended-volumes:volumes_attached字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    云硬盘ID。

    delete_on_termination

    Boolean

    删除裸金属服务器时是否一并删除该卷。

    • true:是
    • false:否
    表14 fault字段数据结构说明

    参数

    参数类型

    描述

    message

    String

    故障信息。

    code

    Integer

    故障code。

    details

    String

    故障详情。

    created

    String

    故障时间。

    时间戳格式为ISO 8601:YYYY-MM-DDTHH:MM:SSZ,例如:2019-05-22T03:30:52Z

  • 响应样例
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    { 
         "server": { 
             "tenant_id": "c685484a8cc2416b97260938705deb65", 
             "addresses": { 
                 "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ 
                     { 
                         "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4:77", 
                         "OS-EXT-IPS:type": "fixed",
                         "OS-EXT-IPS:port_id": "0c111191-9785-49e6-8b42-66ef2802bd8f",
                         "addr": "192.168.0.107", 
                         "version": 4 
                     } 
                 ] 
             }, 
             "metadata": { 
                 "op_svc_userid": "1311c433dd9b408886f57d695c229cbe" 
             }, 
             "OS-EXT-STS:task_state": null, 
             "OS-DCF:diskConfig": "MANUAL", 
             "OS-EXT-AZ:availability_zone": "az-dc-1", 
             "links": [ 
                 { 
                     "rel": "self", 
                     "href": "https://bms.az0.dc1.domainname.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" 
                 }, 
                 { 
                     "rel": "bookmark", 
                     "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" 
                 } 
             ], 
             "OS-EXT-STS:power_state": 1, 
             "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", 
             "os-extended-volumes:volumes_attached": [ 
                 { 
                     "id": "dfa375b5-9856-44ad-a937-a4802b6434c3" 
                 }, 
                 { 
                     "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417" 
                 }, 
                 { 
                     "id": "86e801c3-acc6-465d-890c-d43ba493f553" 
                 }, 
                 { 
                     "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6" 
                 } 
             ], 
             "OS-EXT-SRV-ATTR:host": "bms.az-dc-1", 
             "image": { 
                 "links": [ 
                     { 
                         "rel": "bookmark", 
                         "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" 
                     } 
                 ], 
                 "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" 
             }, 
             "OS-SRV-USG:terminated_at": null, 
             "accessIPv4": "", 
             "accessIPv6": "", 
             "created": "2017-05-24T06:14:05Z", 
             "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", 
             "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2", 
             "key_name": "KeyPair-JX", 
             "flavor": { 
                 "links": [ 
                     { 
                         "rel": "bookmark", 
                         "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" 
                     } 
                 ], 
                 "id": "physical.83.medium" 
             }, 
             "security_groups": [ 
                 { 
                     "name": "0011b620-4982-42e4-ad12-47c95ca495c4" 
                 } 
             ], 
             "config_drive": "", 
             "OS-EXT-STS:vm_state": "active", 
             "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3", 
             "user_id": "1311c433dd9b408886f57d695c229cbe", 
             "name": "bms-83", 
             "progress": 0, 
             "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078", 
             "updated": "2017-05-25T03:40:25Z", 
             "status": "ACTIVE" 
         } 
     }
    

返回值

正常返回值:

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码

错误码

请参考错误码

分享:

    相关文档

    相关产品

关闭导读