华为云用户手册

cond_if If条件是一个三元表达式，主要用于对属性进行赋值，一般用于node_templates的属性结构中。 表5 cond_if 语法 参数说明 返回值 cond_if: [condition, value_true, value_false] condition：条件名称，需要定义在conditions段中。 value_true：条件满足时的赋值。 value_false：条件不满足时的赋值。 条件满足时，返回value_true；条件不满足时，返回value_false。

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: dcs-name: default: my-dcsinstance dcs-description: default: dcs service dcs-capacity: default: 2 dcs-vpcId: default: 09353759-e408-4b32-aeac-e2b9634eb281 dcs-securityGroupId: default: 07f01d47-11fc-4b9b-bce3-f0f47350ad7a dcs-subnetId: default: 85786d98-06ed-4d33-a85c-572238649029 dcs-password: default: "******" dcs-instanceMode: default: "ha" dcs-engineVersion: default: "5.0" dcs-availablityZone1: dcs-availablityZone2: dcs-specCode: default: "redis.single.xu1.large.2" node_templates: my-dcs: type: HuaweiCloud.D CS .Redis properties: name: {get_input: dcs-name} description: {get_input: dcs-description} capacity: {get_input: dcs-capacity} vpcId: {get_input: dcs-vpcId} securityGroupId: {get_input: dcs-securityGroupId} subnetId: {get_input: dcs-subnetId} password: {get_input: dcs-password} instanceMode: {get_input: dcs-instanceMode} engineVersion: {get_input: dcs-engineVersion} availablityZone1: {get_input: dcs-availablityZone1} availablityZone2: {get_input: dcs-availablityZone2} specCode: {get_input: dcs-specCode}

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: securityGroupId: description: 实例所属的安全组ID dbRootPassword: description: 实例的root用户密码 availabilityZone: description: 实例所属的可用区 subnetId: description: 实例所属的子网ID dbVersion: description: 数据库的版本 default: 5.7.21 HAEnable: description: 是否高可用 vpcId: description: 实例所属的VPC ID flavor: description: 实例规格 dataBaseName: description: 用户可访问的数据库名称 dbUserPassword: description: 数据库用户的密码 dbUserName: description: 用户名 node_templates: rds-ins: type: HuaweiCloud.RDS.MySQL properties: dbPort: 3306 backupStrategy: keepDays: 0 endTime: '02:00' startTime: '01:00' securityGroupId: get_input: securityGroupId dbRootPassword: get_input: dbRootPassword volume: volumetype: COMMON size: 100 availabilityZone: get_input: availabilityZone subnetId: get_input: subnetId dataStore: dbtype: MySQL version: get_input: dbVersion HA: replicationMode: semisync enable: get_input: HAEnable vpcId: get_input: vpcId flavor: get_input: flavor rds-db: type: HuaweiCloud.RDS.MySQL.DataBase properties: instanceId: get_reference: rds-ins dataBase: characterSet: utf8 collate: utf8_general_ci name: get_input: dataBaseName metadata: Designer: id: fd1ae0f5-ce98-487e-be2c-828c4b11e676 requirements: - instanceId: node: rds-ins rds-user: type: HuaweiCloud.RDS.MySQL.User properties: instanceId: get_reference: rds-ins dbUser: userPassword: get_input: dbUserPassword name: get_input: dbUserName userDatabase: - name: get_input: dataBaseName requirements: - instanceId: node: rds-ins - dependency: node: rds-db

模型属性 表1 模型定义属性说明 属性 是否必选 描述 instanceId 是 RDS实例ID 参数类型：string 取值约束：1. 需要填写RDS实例ID，即界面上显示的实例ID 2. 可以通过连接RDS实例自动生成get_reference关联关系获取 使用建议：用户自定义 dbUser 是 用户的配置 参数类型：MySQL.DBLinkedUser 默认值：{u'userPassword': u'unset', u'name': u'unset'} 使用建议：在“组成部分”中选择 dbUser 字段根据提示的字段进行扩充填写

关联关系 表2 关联关系说明 关系说明 关联节点 依赖关系 AOS.Batch 依赖关系 DCS.Redis 依赖关系 RDS.MySQL 依赖关系 CCE.Storage.EVS 依赖关系 OBS.Bucket 依赖关系 CCE.Storage.SFS 依赖关系 CCE.ConfigMap 依赖关系 CCE.Job 依赖关系 CCE.Storage.OBS 依赖关系 CCE.DaemonSet 依赖关系 CCE.Secret 依赖关系 CCE.Service 依赖关系 CCE.Ingress 依赖关系 CCE.StatefulSet 依赖关系 CCE.NodePool 依赖关系 CCE.Deployment 依赖关系 CCE.Pod 依赖关系 RDS.PostgreSQL 被包含关系 CCE.Cluster

输出 属性 参数类型 描述 chargeMode 否 按流量计费还是按带宽计费 参数类型：string 取值说明：bandwidth、traffic。不填或者为空时默认是bandwidth 默认值：bandwidth 取值约束：可选值为bandwidth，traffic refName string 所创建Deployment的名称 refLabelsApp string 有状态服务的标签app值

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: containername: default: deployment-123 type: string deploymentname: default: deploymenttest type: string image: default: nginx type: string imagePullPolicy: default: IfNotPresent type: string labels: default: mydeployment type: string node_templates: my-deployment: type: HuaweiCloud.CCE.Deployment properties: k8sManifest: apiVersion: 'apps/v1' kind: Deployment metadata: labels: 'cce/appgroup': get_input: labels name: get_input: deploymentname spec: 'replicas:{get_input': 'deploymentname}' selector: matchLabels: 'cce/appgroup': get_input: labels template: metadata: labels: 'cce/appgroup': get_input: labels spec: containers: - image: get_input: image name: get_input: containername imagePullPolicy: get_input: imagePullPolicy

模型属性 表1 模型定义属性说明 属性 是否必选 描述 namespace 否 资源在集群内所在的命名空间 参数类型：string 取值说明：需为集群下有效的namespace，示例：default 取值约束：由小写字母、数字和中划线组成，且必须以字母开头 使用建议：按需在CCE管理控制台-资源管理-命名空间查询选择 k8sManifest 是 用于描述CCE服务创建的kubernetes集群中的Deployment对象 参数类型：dict 取值说明：用户自定义，建议使用公开镜像（上传镜像到镜像仓库，设置类型为公开），建议更新时不要更改metadata下面的名称（name）和标签（labels），spec下面的replicas如果通过get_input获得，需要指定type为integer 使用建议：kubernetes对象原生的yaml文件内容 clusterId 否 资源所属的CCE集群的ID 参数类型：HuaweiCloud.CCE.Cluster.Id 取值说明：已有容器集群的ID或新建集群的ID 取值约束：满足UUID规则，最大64位 使用建议：1.直接填ID：进入CCE管理控制台-资源管理-集群管理，在集群详情页面查看集群ID。2.通过get_reference获取。通过连线到cluster对象以get_reference自动获取

关联关系 表2 关联关系说明 关系说明 关联节点 依赖关系 AOS.Batch 依赖关系 DCS.Redis 依赖关系 RDS.MySQL 依赖关系 CCE.Storage.EVS 依赖关系 OBS.Bucket 依赖关系 CCE.Storage.SFS 依赖关系 CCE.ConfigMap 依赖关系 CCE.Job 依赖关系 CCE.Storage.OBS 依赖关系 CCE.DaemonSet 依赖关系 CCE.Secret 依赖关系 CCE.Service 依赖关系 CCE.Ingress 依赖关系 CCE.StatefulSet 依赖关系 CCE.NodePool 依赖关系 CCE.Deployment 依赖关系 CCE.Pod 依赖关系 RDS.PostgreSQL 被包含关系 CCE.Cluster 关联关系 ULB.LoadBalancer CCE.Service与ULB.LoadBalancer的关联关系： 编写service.yaml时，在metadata中的annotations字段中添加如下语句：kubernetes.io/elb.class: union； spec中的loadBalancerIP需要填写ULB的私网IP，ULB的私网IP可以通过get_attribute方式获取，例如loadBalancerIP: {get_attribute: [ULB.LoadBalancer元素名称, vip_address]}。 通过负载均衡创建service具体可以参考公网访问-四层负载均衡。

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: labels: description: 应用实例标签，需和service中的selector参数下设置的标签一致 label: 工作负载 default: test deploymentName: description: 工作负载名称 label: 工作负载 default: deployment-test image: description: 应用镜像地址 label: 工作负载 ingressName: description: ingress名称 label: 入口信息 default: ingress-test host: description: ingress host 域名 信息 label: 入口信息 default: test.com secretName: description: 密钥名称 label: 入口信息 type: HuaweiCloud.ECS.KeyPair.Name serviceName: description: 服务名称 label: 网络服务 default: service-test servicePort: description: 服务端口 label: 网络服务 default: 8888 type: integer path: description: 应用路由 label: 网络服务 default: /test protocol: description: 服务协议，只能填写TCP或者UDP label: 网络服务 default: TCP targetPort: description: 应用本身开放服务端口 label: 网络服务 default: 8888 type: integer node_templates: my-deployment: properties: k8sManifest: apiVersion: apps/v1 kind: Deployment metadata: labels: app: get_input: labels name: get_input: deploymentName spec: replicas: 1 selector: matchLabels: app: get_input: labels strategy: rollingUpdate: maxSurge: 0 maxUnavailable: 1 type: RollingUpdate template: metadata: labels: app: get_input: labels spec: containers: - image: get_input: image imagePullPolicy: IfNotPresent name: nginx requirements: [] type: HuaweiCloud.CCE.Deployment my-ingress: properties: k8sManifest: apiVersion: extensions/v1beta1 kind: Ingress metadata: annotations: ingress.beta.kubernetes.io/role: data ingress.kubernetes.io/secure-backends: 'false' labels: isExternal: 'true' zone: data name: get_input: ingressName spec: rules: - host: get_input: host http: paths: - backend: serviceName: get_input: serviceName servicePort: get_input: servicePort path: get_input: path tls: - secretName: get_input: secretName hosts: - get_input: host requirements: - dependency: node: my-service type: HuaweiCloud.CCE.Ingress my-service: properties: k8sManifest: apiVersion: v1 kind: Service metadata: name: get_input: serviceName spec: ports: - name: get_input: serviceName port: get_input: servicePort protocol: get_input: protocol targetPort: get_input: targetPort selector: app: get_input: labels sessionAffinity: ClientIP type: ClusterIP requirements: - dependency: node: my-deployment type: HuaweiCloud.CCE.Service

模型属性 表1 模型定义属性说明 属性 是否必选 描述 cleaningAccessPos 是 清洗时访问限制分段ID 参数类型：integer 取值说明：可取1至8的整数。 默认值：8 取值约束：{u'in_range': [1, 8]} 使用建议：数值越大，则在清洗时允许单一源IP新建连接个数和单一源IP连接总个数越大 trafficPos 是 流量分段ID 参数类型：integer 取值说明：可取1至9的整数。 默认值：9 取值约束：{u'in_range': [1, 9]} 使用建议：数值越大，则每秒流量阈值和每秒报文数阈值越大 appType 是 应用类型ID 参数类型：integer 取值说明：可取0或1，使用UDP协议或通用应用的为类型0，使用TCP协议或web应用的类型为1 默认值：1 取值约束：{u'valid_values': [0, 1]} httpRequestPos 是 HTTP请求数分段ID 参数类型：integer 取值说明：可取1至15的整数。 默认值：1 取值约束：{u'in_range': [1, 15]} 使用建议：数值越大，则每秒HTTP请求数阈值越大 floatingIpId 是 用户EIP的ID 参数类型：string 取值说明：支持使用已有或新建弹性公网IP的ID，如果使用新建的，需在模板中的ECS.CloudServer元素中增加publicIP字段或CCE.NodePool元素增加publicIp字段，并增加依赖关系。 使用建议：1、通过get_attribute获取由此模板创建的弹性公网IP的ID 2、在弹性公网IP页面获取已经创建好的IP的ID（https://console.huaweicloud.com/vpc） enableL7 是 是否开启L7层防护 参数类型：boolean 取值说明：true 或 false，如果设置为true，则表示开启L7层防护 默认值：False 使用建议：根据规格按需填写

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: ecs-name: default: "my-cloudserver" label: ECS description: "虚机名称" ecs-image: default: "327946b5-e954-42c3-949a-3312688c9269" label: ECS description: "虚机镜像" ecs-flavor: default: "c1.medium" label: ECS description: "虚机规格" ecs-volumetype: default: SATA label: ECS description: "虚机磁盘类型" ecs-count: default: 1 label: ECS description: "虚机数量" az: default: "cn-north-1a" label: ECS description: "所在AZ" subnet-name: default: "my-ecs-subnet2" label: ECS description: "子网名称" subnet-gateway: default: "192.168.1.1" label: ECS description: "子网网关" vpc-name: default: "my-ecs-vpkvc2" label: ECS description: "VPC名称" vpc-cidr: default: "192.168.0.0/16" label: ECS description: "VPC cidr地址" ads-enableL7: type: boolean default: true label: AntiDDos description: "是否启用L7层防护" ads-trafficPos: type: integer default: 9 label: AntiDDos description: "流量分段ID" ads-httpRequestPos: type: integer default: 1 label: AntiDDos description: "HTTP请求数分段ID" ads-cleaningAccessPos: type: integer default: 8 label: AntiDDos description: "清洗时访问限制分段ID" ads-appType: type: integer default: 1 label: AntiDDos description: "应用类型ID" node_templates: my-ecs: type: HuaweiCloud.ECS.CloudServer properties: name: {get_input: ecs-name} instances: {get_input: ecs-count} imageId: {get_input: ecs-image} flavor: {get_input: ecs-flavor} vpcId: {get_attribute: [my-subnet, vpcId]} availabilityZone: {get_input: az} nics: - subnetId: {get_attribute: [my-subnet, refID]} rootVolume: volumeType: {get_input: ecs-volumetype} dataVolumes: - volumeType: SATA size: 100 publicIP: eip: ipType: 5_bgp bandwidth: size: 100 shareType: PER requirements: - nics.subnetId: node: my-subnet my-subnet: type: HuaweiCloud.VPC.Subnet properties: name: {get_input: subnet-name} cidr: {get_input: vpc-cidr} gateway: {get_input: subnet-gateway} dnsList: [114.114.114.115, 114.114.114.114] vpcId: {get_attribute: [my-vpc,refID]} availabilityZone: {get_input: az} requirements: - vpcId: node: my-vpc my-vpc: type: HuaweiCloud.VPC.VPC properties: name: {get_input: vpc-name} cidr: {get_input: vpc-cidr} policies: my-antiddos: type: HuaweiCloud.AntiDDos.Service # 对EIP启用 AntiDDos properties: enableL7: {get_input: ads-enableL7} trafficPos: {get_input: ads-trafficPos} httpRequestPos : {get_input: ads-httpRequestPos} cleaningAccessPos: {get_input: ads-cleaningAccessPos} appType: {get_input: ads-appType} floatingIpId: {get_attribute: [my-ecs, floatingIpId]} targets: [my-ecs] outputs: ecs-id: value: {get_attribute: [my-ecs, refID]} description: "ECS ID" vpc-id: value: {get_attribute: [my-vpc, refID]} description: "VPC ID" subnet-id: value: {get_attribute: [my-subnet, refID]} description: "SUBNET ID"

关联关系 表2 关联关系说明 关系说明 关联节点 包含关系 AOS.Stack 包含关系 CCE.Deployment 包含关系 CCE.Job 依赖关系 CCE.Service 依赖关系 EVS.NonSharedVolume 依赖关系 CCE.Deployment 依赖关系 ServiceStage.Agent 依赖关系 SMN .Topic 依赖关系 CCI.Storage.EVS 依赖关系 VPC.VIP 依赖关系 APM .AutoScaler 依赖关系 ServiceStage.AppGroup 依赖关系 FGS.DmsEventMap 依赖关系 VPC.FirewallPolicy.Ingress 依赖关系 VPC.EIP 依赖关系 CDN.Source 依赖关系 RDS.MySQL.User 依赖关系 CCE.Ingress 依赖关系 CDN.Cache 依赖关系 CCI.ConfigMap 依赖关系 DIS.Stream 依赖关系 CCI.Namespace 依赖关系 CCE.Addon.AutoScaler 依赖关系 VPC.FirewallRule 依赖关系 CCE.Cluster 依赖关系 SFS.FileSystem 依赖关系 CDN.RefreshJob 依赖关系 EVS.SharedVolume 依赖关系 CCI.Job 依赖关系 AOS.Stack 依赖关系 FGS.TimerEventMap 依赖关系 NAT.Instance 依赖关系 FGS.ObsEventMap 依赖关系 OBS.Bucket 依赖关系 APIG.ApiGroup 依赖关系 AOS.Batch 依赖关系 CCE.Secret 依赖关系 CCE.Storage.EVS 依赖关系 CCE.Storage.SFS 依赖关系 CCE.HelmRelease 依赖关系 FGS.ApigEventMap 依赖关系 RDS.MySQL.DataBase 依赖关系 CCE.NodePool 依赖关系 IAM .UserGroup 依赖关系 CCI.Deployment 依赖关系 CDN.Domain 依赖关系 MRS .Cluster 依赖关系 CCE.StatefulSet 依赖关系 VPCEndpoint.Endpoint 依赖关系 CCI.Ingress 依赖关系 CCE.Job 依赖关系 CCI.Secret 依赖关系 APIG.API 依赖关系 FGS.LtsEventMap 依赖关系 ServiceStage.ContainerComponent 依赖关系 CCI.Storage.SFS 依赖关系 VPC.FirewallGroup 依赖关系 CCI.StatefulSet 依赖关系 CCE.DaemonSet 依赖关系 RDS.PostgreSQL 依赖关系 ECS.KeyPair 依赖关系 ServiceStage.StatelessApplication 依赖关系 ServiceStage.StatefulApplication 依赖关系 IAM.Agency 依赖关系 FGS.CtsEventMap 依赖关系 DDS.CommunityReplicaSetOrSingle 依赖关系 FGS.DisEventMap 依赖关系 APIG.Throttle 依赖关系 CCE.Pod 依赖关系 DCS.Redis 依赖关系 CDN.Https 依赖关系 VPC.VPC 依赖关系 CDN.PreheatJob 依赖关系 CDN.Referer 依赖关系 ECS.CloudServer 依赖关系 SMN.Subscription 依赖关系 VPC.Subnet 依赖关系 CCE.ConfigMap 依赖关系 FGS.Function 依赖关系 VPC.FirewallPolicy.Egress 依赖关系 CCI.Service 依赖关系 CCE.Storage.OBS 依赖关系 ServiceStage.Job 依赖关系 CDN.Host 依赖关系 ECS.ServerGroup 依赖关系 RDS.MySQL 依赖关系 VPCEndpoint.EndpointService 依赖关系 FGS.SmnEventMap

模型属性 表1 模型定义属性说明 属性 是否必选 描述 items 是 定义包含的子元素模板 参数类型：AOS.BatchItem数组 取值说明：用户自定义 取值约束：数组格式，至少1个对象，最多10个 使用建议：用户自定义，可参照https://support.huaweicloud.com/tr-aos/datatypes-aos-batchitem.html step 否 最大并发数 参数类型：integer 取值说明：默认不定义步长，即按照最大并发情况进行对象的批量创建。如果指定步长，Batch的批量对象之间会分阶段按批次执行。例如，一个batch对象包含了1个job，定义了步长为5，此时batch批量创建的job6将会依赖job1完成后才会执行，从而实现5的并发数。 取值约束：{u'in_range': [1, 100]} 使用建议：根据规格按需选择 values 否 定义子元素模板中使用的变量 参数类型：dict 取值说明：用户自定义。Batch对象在执行实例化时，会使用values中的值替换items中定义的properties相应的变量内容，包括内置的变量item、limit、offset。 默认值：{} 使用建议：根据规格按需选择 limit 是 批量执行的总次数 参数类型：integer 取值说明：用户自定义，取值范围为[1, 500] 取值约束：{u'in_range': [1, 500]} 使用建议：根据规格按需选择

blueprint样例 tosca_definitions_version: huaweicloud_tosca_version_1_0 inputs: availabilityZone: default: az1.dc1 vpcId: default: ba6e4347-99d2-4649-b114-85c28d3d71b0 subnetId: default: 3be61f68-9bfc-41bf-8f5e-66c57122f270 clusterFlavor: default: cce.s1.small node_templates: cluster: type: HuaweiCloud.CCE.Cluster properties: availabilityZone: {get_input: availabilityZone} vpcId: {get_input: vpcId} subnetId: {get_input: subnetId} flavor: {get_input: clusterFlavor} outputs: cluster_id: value: {get_attribute: [cluster, clusterId]}

模型属性 表1 模型定义属性说明 属性 是否必选 描述 multiAZ 否 多AZ集群 参数类型：boolean 默认值：False 取值约束：仅使用高可用集群时才可以配置multiAZ为true，例如flavor设置为cce.s2系列的规格。 使用建议：multiAZ为true时，集群规格flavor要为可创建多AZ集群，例如为cce.s2系列的规格。 vpcId 是 虚拟私有云ID 参数类型：HuaweiCloud.VPC.VPC.Id 取值约束：支持使用已有或新建私有云ID。如果使用新建的，需在模板中定义vpc对象并建立依赖关系 使用建议：1. 将该字段通过get_input函数传入，在AOS界面创建堆栈填写输入参数时可自动选择 2. 通过get_reference获取由本堆栈创建的VPC.VPC元素，使用设计器建立依赖关系时会自动指定 3. 在VPC服务界面获取已经创建好的VPC的ID https://console.huaweicloud.com/vpc networkMode 否 容器网络类型 参数类型：string 默认值：overlay_l2 取值约束：当前支持overlay_l2, underlay_ipvlan, vpc-router，用户自定义选择，如果选择vpc-router时，要求所选VPC仅能包含一个子网 使用建议：使用默认值 description 否 集群的描述 参数类型：string 使用建议：用户自定义 name 否 集群名称 参数类型：string 取值约束：长度[4, 128]，由小写字母、数字、中划线“-”组成，且必须以字母开始，字母数字结尾。正则规范如下：(^$)|(^[a-z]([-a-z0-9]*[a-z0-9])?$) 使用建议：用户自定义 kubeProxyMode 否 服务转发模式 参数类型：string 默认值：iptables 取值约束：当前仅支持iptables, ipvs 使用建议：1.7版本集群推荐使用默认值“iptables”，1.9及以上版本集群推荐使用“ipvs”，可以获得更好的性能体验 highwaySubnetId 否 高速子网ID 参数类型：HuaweiCloud.VPC.Subnet.Id 取值约束：支持使用已有或创建的网速子网ID。如果使用新建的，需在模板中定义子网对象并建立依赖关系 使用建议：1. 将该字段通过get_input函数传入，在AOS界面创建堆栈填写输入参数时可自动选择 2. 通过get_reference获取由本堆栈创建的VPC.Subnet，使用设计器建立依赖关系时会自动指定 3. 在VPC服务界面中获取已创建好的子网的ID (https://console.huaweicloud.com/vpc) containerNetworkCIDR 否 容器网络网段 参数类型：string 默认值："" 取值约束：按照用户实际创建的网络进行配置，可设置的网段：172.16.0.0/16~172.31.0.0/16 10.0.0.0/16~10.255.0.0.0/16 192.168.0.0/16 使用建议：使用默认值 version 否 集群版本 参数类型：string 取值约束：目前支持v1.15, v1.13, v1.11 使用建议：请设置为CCE支持的集群版本号。建议通过get_input函数传入，在AOS界面创建堆栈填写输入参数时可自动选择。 namespaces 否 创建cluster时同时创建的namespace 参数类型：string数组 默认值：[] 取值约束：数组类型 subnetId 是 子网ID 参数类型：HuaweiCloud.VPC.Subnet.Id 取值约束：支持使用已有或创建的子网ID。如果使用新建的，需在模板中定义子网对象并建立依赖关系 使用建议：1. 将该字段通过get_input函数传入，在AOS界面创建堆栈填写输入参数时可自动选择 2. 通过get_reference获取由本堆栈创建的VPC.Subnet，使用设计器建立依赖关系时会自动指定 3. 在VPC服务界面中获取已创建好的子网的ID https://console.huaweicloud.com/vpc flavor 是 集群规格 参数类型：HuaweiCloud.CCE.Cluster.Flavor.Name 取值约束：需符合CCE的规格定义（可以在CCE服务页面查看支持创建的规格） 使用建议：在CCE创建集群页面查询可使用的集群规格名称，请参见：https://support.huaweicloud.com/api-cce/cce_02_0236.html type 否 集群类型 参数类型：HuaweiCloud.CCE.Cluster.Type 默认值：VirtualMachine 取值约束：目前支持VirtualMachine, BareMetal, Windows, ARM64 使用建议：使用默认值 nodes 否 创建包周期集群时的用户节点配置 参数类型：CCE.NodePool 默认值：{u'dataVolumes': [], u'availabilityZone': u'unset', u'instances': 1, u'rootVolume': {u'volumeType': u'unset', u'size': 40}, u'flavor': u'unset', u'sshKeyName': u'unset'} 取值约束：符合HuaweiCloud.CCE.NodePool属性的描述及约束 使用建议：根据规格按需配置 availabilityZone 否 可用区。创建包年包月集群时，该字段为必填字段。 参数类型：HuaweiCloud.ECS.AvailabilityZone.Name 取值约束：根据所属区域选择，参见https://developer.huaweicloud.com/endpoint。 使用建议：将该字段通过get_input函数传入，在AOS界面创建堆栈填写输入参数时可自动选择

响应消息 请求成功的响应消息 响应参数 表4 成功响应参数 参数 参数类型 描述 id String 模板ID 响应示例 { "id": "d078e49c-124c-7706-bcbb-81885661f431" } 请求失败的响应消息 响应参数 表5 失败响应参数 参数 参数类型 描述 message String 请求失败的原因 code String 请求失败的原因代码 extend String 请求失败的扩展原因，保留后续使用 如果无特殊说明，后续AOS API的错误返回均为此形式。 响应示例 { "message": "Parameters validate err, The name should not be empty.", "code": "02000005", "extend": "" }

使用 自定义镜像 的场景 用户可以依赖 DLI 提供的Spark或者Flink基础镜像，使用Dockerfile将作业运行需要的依赖（文件、jar包或者软件）打包到镜像中，生成自己的自定义镜像，然后将镜像发布到SWR（ 容器镜像服务 ）中，最后在DLI服务作业编辑页面选择自己生成的镜像，运行作业。用户可以将一些私有能力内置到自定义镜像中，从而增强作业的功能、性能。 用户使用自定义镜像功能需要具备Docker相关的基础知识。

操作场景 在实际作业运行中，由于作业的重要程度以及紧急程度不同，需要重点保障重要和紧急的作业正常运行，因此需要满足它们正常运行所需的计算资源。 DLI提供的设置作业优先级功能，可以对每个Spark作业、Spark SQL作业以及Flink作业设置作业优先级，当资源不充足时，可以优先满足优先级较高的作业的计算资源。 只有运行在弹性资源池上的作业支持设置作业优先级。 弹性资源池上的SQL作业支持作业优先级。 Spark 2.4.5及以上版本的作业支持设置作业优先级。 Flink 1.12及以上版本的作业支持设置作业优先级。

使用须知 对于每个作业都允许设置优先级，其取值为1-10，数值越大表示优先级越高。优先满足高优先级作业的计算资源，即如果高优先级作业计算资源不足，则会减少低优先级作业的计算资源 通用队列上运行的Flink作业优先级默认为5。 通用队列上运行的Spark作业的优先级默认为3。 SQL队列上运行的作业优先级默认为3。 作业优先级的调整需要停止作业进行编辑，并提交运行才能生效。 对于Flink作业，请参考开启Flink作业动态扩缩容设置flink.dli.job.scale.enable=true开启动态扩缩容功能，再设置作业优先级。 Flink作业优先级的调整需要停止编辑作业并重新提交才能生效。

云耀云服务器 L实例 新增数据盘 约束限制 云耀云服务器L实例仅支持挂载一个数据盘，如果已经有一块数据盘，则不能再增加数据盘。 新增数据盘时，仅支持新增加数据盘，不支持挂载已有数据盘。 增加的数据盘到期时间与所挂载的云耀云服务器L实例一致，已挂载的数据盘不支持单独卸载和退订。 云耀云服务器L实例处于“运行中”、“关机”状态时，才能进行增配操作。 新购买的数据盘不能直接使用，请登录云服务器初始化数据盘，初始化后的数据盘才可以正常使用（系统盘不需要初始化）。具体操作详见初始化数据盘。 操作步骤 登录L实例控制台，单击云耀云服务器L实例卡片，进入资源页面。 单击右上角“增配”，并进行相关配置。 勾选“增加 数据盘 EVS”，并设置数据盘容量。 阅读并勾选协议。 单击“立即购买”，根据界面提示完成购买。 购买后，在控制台查看增加的数据盘。 此时增加的数据盘不能直接使用，请登录云服务器初始化数据盘，初始化后的数据盘才可以正常使用。具体操作详见初始化数据盘。

旧版云耀云服务器新增数据盘 登录旧版HECS控制台，单击左上角的选择区域。 在旧版HECS列表中的右上角，输入云服务器名称、IP地址或ID，并进行搜索。 在待新增磁盘的云耀云服务器的操作中，单击“新增磁盘”。 系统跳转至购买磁盘页面。 根据界面提示，设置新添加云硬盘的参数信息。如表2所示。 表2 参数说明 参数名称 子参数名称 参数说明 计费模式 - 必选参数。 包年包月是预付费模式，按订单的购买周期计费，适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。 旧版HECS仅支持添加“包年/包月”方式的云硬盘，且新添加的云硬盘与云耀云服务器的到期时间相同。 区域 - 必选参数。 不同区域的资源之间内网不互通。请选择靠近您的区域，可以降低网络时延、提高访问速度。 新增磁盘默认与云耀云服务器位于同一区域。 数据源 选择数据源： 从备份创建 从快照创建 从镜像创建 可选参数。 从备份创建：选择备份数据来创建新的云硬盘。 在“选择数据源”下方， 单击“从备份创建”，会弹出云硬盘备份数据列表，选择云硬盘备份数据并单击“确定”。 说明： 对于同一个备份，不支持并发创建多个云硬盘。若此时正通过备份创建云硬盘A，那么需要等A创建完成后，才可以使用该备份创建新的云硬盘。 通过系统盘备份数据创建的云硬盘，只能用作数据盘，不支持用作系统盘。 从快照创建：选择快照数据来创建新的云硬盘。 在“选择数据源”下方，单击“从快照创建”，会弹出云硬盘快照列表，选择云硬盘快照并单击“确定”。 说明： 通过快照创建云硬盘时，磁盘模式和快照源云硬盘保持一致。 通过快照创建云硬盘时，云硬盘加密属性和快照源云硬盘保持一致。 从镜像创建：选择镜像来创建新的云硬盘。 在“选择数据源”下方，单击“从镜像创建”，会弹出镜像列表，选择镜像并单击“确定”。 说明： 通过镜像创建云硬盘时，磁盘模式和镜像源云硬盘保持一致。 通过镜像创建云硬盘时，云硬盘加密属性和镜像源云硬盘保持一致。 磁盘规格 磁盘类型 必选参数。 关于磁盘类型的详细信息，请参见磁盘类型及性能介绍。 容量 (GB) 必选参数。 云硬盘的容量。在“磁盘规格”右侧区域选择磁盘容量 (GB)。 更多 高级配置： 共享盘 SCSI 可选参数。 共享盘： 勾选“共享盘”，则创建的是共享云硬盘，共享云硬盘最多可同时挂载至16台。如果不勾选“共享盘”，则默认为非共享云硬盘，只能挂载至1台云服务器。 如果同时选择“SCSI”和“共享盘”，则创建的是SCSI共享云硬盘。 说明： 云硬盘的共享属性在创建完成后不支持更改。 SCSI： 勾选“SCSI”，则创建的是SCSI云硬盘。SCSI云硬盘允许器操作系统直接访问底层存储介质并将SCSI指令传输到云硬盘。如果不勾选“SCSI”，则磁盘模式默认为VBD。 说明： 云硬盘的磁盘模式在创建完成后不支持更改。 标签 可选参数。 您可以在创建云硬盘的时候为云硬盘绑定标签，标签用于标识云资源，可通过标签实现对云资源的分类和搜索。 标签由标签“键”和标签“值”组成。 键：如果要为云硬盘添加标签，则该项为必选参数。 标签的“键”最大长度不超过36个字符。由英文字母、数字、下划线、中划线、UNICODE字符（\u4E00-\u9FFF）组成。 值：如果要为云硬盘添加标签，则该项为可选参数。 标签的“值”最大长度不超过43个字符。由英文字母、数字、下划线、点、中划线、UNICODE字符（\u4E00-\u9FFF）组成。 说明： 同一个云硬盘的标签的“键”不允许重复。 磁盘名称 - 必选参数。 创建单个云硬盘：磁盘名称是云硬盘名称。 最大支持64个字符。 批量创建云硬盘：一次创建多个云硬盘时，磁盘名称为云硬盘名称的前缀，最终云硬盘名称组成为“磁盘名称-四位数字/字母”。 最大支持59个字符。 购买量 - 数量默认为“1”，表示只创建一个云硬盘。目前最多可批量创建100个云硬盘。 说明： 系统会显示您当前还可以购买的云硬盘数量。为了保证所有资源的合理分配，如果您需要的云硬盘数量超过当前您可以购买的最大数量值，您可以单击“申请扩大配额”。申请通过后，您可以购买到满足您需要的云硬盘数量。 绑定云服务器 - 购买完成后新增磁盘默认已挂载至选择的云耀云服务器。 到期时间 - 新添加的云硬盘与云耀云服务器的到期时间相同。 单击“立即购买”，确认订单详情并完成支付。

X实例切换VPC 登录X实例控制台，单击左上角的选择区域和项目。 在云服务器列表中，单击云服务器名称。 系统跳转至该云服务器详情页面。 选择“弹性网卡”页签，单击网卡的操作按钮“切换VPC”，为云服务器切换VPC。 根据界面提示，在下拉列表中选择可用的虚拟私有云、子网，设置私有IP地址和安全组。 您可以同时勾选多个安全组，此时，云服务器的访问规则遵循几个安全组规则的并集。 使用多个安全组可能会影响云服务器的网络性能，建议您选择安全组的数量不多于5个。 图1 切换VPC 单击“确定”。

旧版HECS约束限制 表3 旧版HECS约束限制 约束项 说明 区域 镜像是一种区域性资源，云服务器和私有镜像必须属于同一个区域，否则云服务器无法选用镜像。 云服务器架构 云耀云服务器仅支持X86架构的私有镜像，不支持ARM架构的私有镜像。 使用场景 旧版HECS仅支持在切换操作系统时使用私有镜像，不支持在创建时使用镜像。 镜像类型 通常使用市场镜像创建的“包年/包月”云服务器不支持切换操作系统。仅部分云商店Windows操作系统不同版本之间互相切换。 旧版HECS为x86架构，不支持切换到鲲鹏等ARM架构类型的操作系统。 Windows与Linux操作系统之间互相切换时： Windows系统更换为Linux系统：请安装读写Windows系统的NTFS分区工具，例如NTFS-3G等。 Linux系统更换为Windows系统：请安装可以识别ext3、ext4等分区的识别软件，例如Ext2Read、Ext2Fsd等。 说明： 云平台不推荐您将Linux系统更换为Windows系统，当Linux系统中存在LVM分区时，切换为Windows系统后可能会导致LVM逻辑分区无法识别。 使用私有镜像切换操作系统时，仅支持使用系统盘镜像或整机镜像。 不支持BIOS启动方式与UEFI启动方式的操作系统互相切换。

L实例约束限制 表1 L实例私有镜像约束限制 约束项 说明 区域 云服务器和私有镜像必须属于同一个区域，否则云服务器无法选用镜像。 云服务器架构 仅支持X86架构的私有镜像，不支持ARM架构的私有镜像。 镜像类型 私有镜像仅支持系统盘镜像，不支持数据盘镜像和整机镜像。 系统盘镜像仅支持以下几种类型： Linux系统盘镜像：当前仅支持镜像源为华为云提供的Linux公共免费镜像、L实例应用镜像的服务器，或者您导入的镜像。 Windows系统盘镜像：当前支持的镜像源仅为华为云商店Windows Server 2022/2019/2016/2012 R2 标准版、数据中心版。 如果您需要整机迁移，或将不支持的操作系统迁移到L实例，请使用 SMS 迁移服务。迁移指导详见使用 主机迁移服务 （SMS）迁移服务器。 规格 在您购买时选择私有镜像或切换到私有镜像时，请确保当前云服务器实例规格（vCPU、内存、系统盘容量）满足私有镜像使用，否则云服务器可能无法启动。 一键式密码重置插件 如果私有镜像的镜像源来自其他云平台的服务器或从第三放下载，此类私有镜像可能因未安装华为云提供的重置密码插件或缺少“onekey_resetpasswd”特性标签，而无法正常创建或切换L实例。请根据私有镜像未安装重置密码插件或缺少onekey_resetpasswd特性标签，无法使用镜像创建/切换L实例怎么办？处理。 主机安全 在您的云耀云服务器L实例包含HSS服务的情况下，如果您使用私用镜像创建云耀云服务器L实例或切换操作系统后，HSS为“未防护”异常状态请参考使用私有镜像创建/切换服务器后，主机安全（HSS）服务未启动怎么办？启用HSS。 套餐 云耀服务组合套餐（基础套餐和高可用套餐）不支持私有镜像。

准备工作 云服务器和私有镜像必须属于同一个区域，否则云服务器无法选用镜像。例如，如果您想在“华北-北京四”区域创建实例，则仅能选取“华北-北京四”的镜像。如需跨区域使用镜像，请先将其他区域的镜像复制到当前区域。请参见跨区域复制镜像。 在使用私有镜像前，请先创建私有镜像。请根据您的操作场景选择对应的操作。 表4 通过 镜像服务 创建或者导入镜像 镜像来源 相关操作 场景一 如果您的私有镜像由现有的华为云ECS、BMS等云服务器创建，通过镜像服务创建后即可在本区域使用。 如果您想在其他区域使用该私有镜像，请将镜像跨区域复制。 通过云服务器创建Windows系统盘镜像 通过云服务器创建Linux系统盘镜像 跨区域复制镜像 场景二 如果您的私有镜像由其他云平台创建或第三方下载，私有镜像需要通过镜像服务导入后才能使用。 请根据镜像文件格式选择对应的操作指导： 外部镜像格式支持：VMDK、VHD、QCOW2、RAW、VHDX、QED、VDI、QCOW、ZVHD2和ZVHD。 ISO文件格式为：iso。 通过外部镜像文件创建Windows系统盘镜像 通过ISO文件创建Windows系统盘镜像 说明： 对于Windows私有镜像，L实例不支持通过外部镜像文件或ISO文件创建Windows系统盘镜像。 通过外部镜像文件创建Linux系统盘镜像 通过ISO文件创建Linux系统盘镜像。 场景三 如果您需要使用其他账号的私有镜像，请先将镜像共享到您的账号中，并复制共享镜像为私有镜像。 共享镜像 复制共享镜像

扩容云耀云服务器L实例云备份 当前云备份只支持扩大容量，不支持缩小容量。 扩容量到期时间与所绑定的云耀云服务器L实例一致，且扩展容量无法单独退订。 登录L实例控制台，单击云耀云服务器L实例卡片，进入资源页面。 选择“云备份 CBR”菜单，单击“扩容”。 在扩容页面，输入云备份盘目标容量。 建议云备份的容量不小于所备份的服务器容量。当备份的总容量超出云备份的容量时，备份将会失败。例如，如果您的系统盘和数据盘总数据占用空间为80G，那么云备份容量应该超过80GB，否则将会备份失败。 单击“立即购买”，根据界面提示完成购买。 购买后，在控制台查看扩容后的云备份容量是否正常。

X实例修改私有IP地址 登录X实例控制台，单击左上角的选择区域和项目。 单击待修改私有IP地址的云服务器名称。 系统跳转至该云服务器详情页面。 选择“弹性网卡”页签，并单击主网卡所在行的“修改私有IP地址”。 系统打开“修改私有IP地址”窗口。 请根据需要修改主网卡的“子网”、“私有IP地址”。 只能在同一VPC下更换子网。 如果未填写修改后的“私有IP地址”，系统会自动分配一个新的私有IP地址给主网卡使用。

云耀云服务器L实例绑定云备份 如果您未随L实例购买云备份，后续请在云备份控制台创建云服务器备份并绑定L实例，不支持在L实例控制台绑定云备份。 L实例仅支持云服务器备份类型。 云备份绑定L实例。 您可以在云备份控制台创建云服务器备份，在创建云服务器备份时即选择并绑定L实例，具体操作详见 购买云服务器 备份存储库。 您也可以使用已有云服务器备份绑定L实例，具体操作详见绑定服务器。 查看云备份信息，具体操作详见查看存储库。

切换旧版云耀云服务器系统 登录旧版HECS控制台，单击左上角的选择区域。 在待切换操作系统的云耀云服务器的“操作”列下，单击“切换操作系统”。 进行切换操作系统的相关设置。 勾选“立即关机”。切换操作系统前请先将云服务器关机，或根据页面提示勾选“立即关机”。 选择切换的镜像类型、操作系统和版本。 设置密码。 如果使用公共镜像切换操作系统，您可以在切换操作系统时设置密码，也可以切换后设置密码。 如果使用私有镜像切换操作系统，您可以在切换操作系统时设置密码，或者使用镜像密码。镜像密码指所创建镜像的云服务器的密码。 图1 切换操作系统 单击“确定”。 如果提示系统盘容量不足，可能是由于系统盘容量小于您选择的待切换镜像的大小。此时，您需要先扩容系统盘，再执行切换操作。 扩容系统盘的操作指导，请参见“扩容云硬盘”章节。 在“确认切换操作系统”页面，确认切换的操作系统规格无误后，阅读并勾选声明，单击“确定”。 提交切换操作系统的申请后，云服务器的状态变为“关机（操作系统切换中）”，当状态再次变为“运行中”，表示切换结束。