You need to enable JavaScript to run this app.
导航

批量设置有序的实例名称或主机名称

最近更新时间2023.12.07 17:11:01

首次发布时间2021.12.27 20:39:22

本文介绍在云服务器控制台或调用OpenAPI批量创建实例时,如何为多台实例自定义设置有序的实例名称或主机名称,以便更好地管理实例。

配置规则

命名规则

实例名称或主机名称的命名规范如下表所示。

类型命名规则

实例名称

  • 以字母或中文开头。

  • 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。

  • 长度为1~128个字符。

主机名称

  • Linux实例:

    • 允许使用字母、数字、点号“.”或中划线“-”。

    • 不能以中划线、点号开头或结尾,且不能连续使用中划线和点号。

    • Linux系统长度限制在2~63个字符之间。

  • Windows实例:

    • 允许使用字母、数字或中划线“-”,不能完全是数字。

    • 不能以中划线开头或结尾,且不能连续使用中划线。

    • Windows系统长度限制在2~15个字符之间。

命名格式

格式

批量设置有序名称的参数格式为name_prefix[begin_number,bits]name_suffix,各字段说明如下表所示。

字段说明示例
name_prefix实例名称或主机名称的前缀,必填,需满足命名规则name

[begin_number,bits]

  • begin_number:实例名称或主机名称的起始数值。

    • 取值范围:[0,9999]

    • 默认值:0

  • bits:指定数值在实例名称或主机名称中所占的位数。

    • 取值范围:[1,4]

    • 默认值:4

说明

  • [begin_number,bits]之间的分隔只支持英文逗号(,),且中间不能有空格。
  • 如果您指定了[]或者[,],则begin_number从0开始取值,bits默认为4。
  • 如果begin_number与Count(实例数量)之和的位数大于指定bits,则以两者之和的位数为准进行创建,但不能超过最大bits,否则创建失败。

[99,3]

name_suffix实例名称或主机名称的后缀。ecs

示例

说明输入参数实例名称(3台实例)
标准格式name[1,3]ecsname001ecs、name002ecs、name003ecs
标准格式,且begin_number+Count的位数 > 指定bitsname[99,2]ecsname099ecs、name100ecs、name101ecs
未指定begin_number与bitsname[]ecs 或 name[,]ecsname0000ecs、name0001ecs、name0002ecs

操作步骤

云服务器控制台

以下主要介绍实例名称或主机名称的相关配置,更多实例配置说明请参见通过向导购买实例

  1. 登录云服务器控制台

  2. 单击“创建实例”按钮,开始选购云服务器。

  3. 完成 基础配置、网络和安全 配置。

  4. 高级配置 页签的“实例名称”(必填)或“主机名”处,输入name_prefix[begin_number,bits]name_suffix格式的指定排序,配置规则请参见命名格式,并完成其他配置。
    本实践输入的“实例名称”为name[1,3]ecs,“主机名”为name[1,3]host。

  5. 设置实例数量为3,并完成购买。

操作结果:
购买完成后您可以在实例列表页查看新创建的3台实例,实例名称依次为:name001ecs、name002ecs、name003ecs;登录实例后,使用hostnamectl命令查看主机名,主机名依次为name001host、name002host、name003host。

OpenAPI

调用 RunInstances 接口批量创建实例时,其有序命名还受到UniqueSuffix,即有序后缀参数的影响,具体情况如下所示。

说明

  • 本实践主要介绍配置有序名称的相关参数,其他参数信息请参见RunInstances
  • InstanceNameHostname指定排序的参数配置格式为name_prefix[begin_number,bits]name_suffix,配置规则请参见命名格式

关闭有序后缀(默认)仅指定[begin_number,bits]

关闭有序后缀(默认关闭)后,您可以指定[begin_number,bits]为批量创建的实例指定排序,具体参数配置如下:

  • UniqueSuffix:false(默认),即为InstanceNameHostname关闭有序后缀。

  • Count:3

  • InstanceName:name[1,3]ecs

  • Hostname:name[1,3]host

按照上述操作,新创建的3台实例名称依次为:name001ecs、name002ecs、name003ecs;主机名依次为:name001host、name002host、name003host。

开启有序后缀且不指定[begin_number,bits]

在创建多台实例时,您可以选择开启有序后缀功能,为实例名称和主机名称自动排序。具体参数配置如下:

  • UniqueSuffix:true,即为InstanceNameHostname自动排序,增加的后缀默认从1开始,按实例数量依次递增。

  • SuffixIndex(可选):1(默认),有序后缀的起始序号,取值范围1~999。

  • Count:3

  • InstanceName:ecs

  • Hostname:host

按照上述操作,新创建的3台实例的名称依次为:ecs-1、ecs-2、ecs-3;主机名依次为:host-1、host-2、host-3。

开启有序后缀且指定[begin_number,bits]

开启有序后缀后,如果您在InstanceNameHostname中指定[begin_number,bits] ,[begin_number,bits]优先级高于有序后缀UniqueSuffix,具体如下表所示。

开启有序后缀实例名/主机名是否指定[begin_number,bits]UniqueSuffix是否生效
示例

UniqueSuffix=true,且SuffixIndex取默认值1

均指定

均不生效

InstanceNameHostname均为name[666,3]ecs
最终生成结果:
实例名与主机名均为:name666ecs、name667ecs、name668ecs

InstanceName指定、Hostname未指定

仅对Hostname生效

InstanceName为name[666,3]ecs、Hostname为host
最终生成结果:

  • 实例名:name666cs、name667ecs、name668ecs

  • 主机名:host-1、host-2、host-3

Hostname指定、InstanceName未指定

仅对InstanceName生效

InstanceName为ecs、Hostname为name[666,3]host
最终生成结果:

  • 实例名:ecs-1、ecs-2、ecs-3

  • 主机名:name666host、name667host、name668host

相关文档