华为云用户手册

  • 响应示例 { "count":4, "servers":[ { "fault":null, "id":"b37fd80e-ac67-4d02-b9f1-9891c9c0fabf", "name":"ecs-5e70", "addresses":{ "164489f6-cbf7-45b4-b6d0-d407c48cf7fc":[ { "version":"4", "addr":"192.168.0.206", "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:95:88:3f", "OS-EXT-IPS:port_id":"7b5d615c-186d-4646-9cb8-444addfe9b92", "OS-EXT-IPS:type":"fixed" }, { "version":"4", "addr":"192.168.0.8", "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:1d:88:43", "OS-EXT-IPS:port_id":"dda2027b-2f03-497b-8d42-620da2baacc3", "OS-EXT-IPS:type":"fixed" } ] }, "flavor":{ "disk":"0", "vcpus":"2", "ram":"1024", "id":"c3.large.2", "name":"c3.large.2" }, "accessIPv4":"", "accessIPv6":"", "status":"SHUTOFF", "image":{ "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b" }, "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4", "updated":"2018-08-14T07:26:49Z", "created":"2018-08-13T13:46:09Z", "metadata":{ "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692", "metering.resourcespeccode":"c3.large.2.linux", "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit", "metering.product_id":"00301-253164-0--0", "os_bit":"64", "lockSourceId":"", "lockScene":"", "metering.order_id":"CS1808132145NRVRE", "lockCheckEndpoint":"", "metering.imagetype":"gold", "lockSource":"", "metering.resourcetype":"1", "vpc_id":"164489f6-cbf7-45b4-b6d0-d407c48cf7fc", "os_type":"Linux", "charging_mode":"1" }, "tags":[ ], "description":"ecs-4cff", "locked":false, "config_drive":"", "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da", "user_id":"bb7f23e27e7e46f3aaceb5f53a158bdc", "os-extended-volumes:volumes_attached":[ { "device":"/dev/sda", "bootIndex":"0", "id":"2edc879f-022e-4bd6-b079-95a27564d449", "delete_on_termination":"false" } ], "OS-EXT-STS:task_state":null, "OS-EXT-STS:power_state":4, "OS-EXT-STS:vm_state":"stopped", "OS-EXT-SRV-ATTR:host":"az1.dc1", "OS-EXT-SRV-ATTR:instance_name":"instance-00137941", "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248", "OS-DCF:diskConfig":"MANUAL", "OS-EXT-AZ:availability_zone":"az1-dc1", "os:scheduler_hints":{ "dec_baremetal":[ "share" ], "guestos_product_name":[ "KVM Virtual Machine" ] }, "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda", "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4014-89be-1743ff3a5daf", "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095", "OS-EXT-SRV-ATTR:user_data":"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRKQ2FzUWQkbm5wVmhJUFZlNVMwc3pXbnJGLnZVZ1FCWk4xTEo5Vy8wd09WTmFZaWpBRXdtRnhuQmZaTllVZXhBWktVWFVTeVhEeERuSUMzV2JjZEJyQUVBZkZvLy8nIHwgY2hwYXNzd2QgLWU7", "OS-SRV-USG:launched_at":"2018-08-13T13:46:46.000000", "OS-EXT-SRV-ATTR:kernel_id":"", "OS-EXT-SRV-ATTR:launch_index":0, "host_status":"UP", "OS-EXT-SRV-ATTR:reservation_id":"r-a8mg9vwr", "OS-EXT-SRV-ATTR:hostname":"ecs-4cff", "sys_tags":[ { "key":"_sys_enterprise_project_id", "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095" } ], "security_groups":[ { "id":"71846bf6-1cda-4515-8590-3707be295e76", "name":"Sys-FullAccess" }, { "id":"b1786350-da65-11e7-b312-0255ac101b03", "name":"default" } ] }, { "fault":null, "id":"8380dcc9-0eac-4407-9f9e-df8c9eddeacd", "name":"ecs-f680", "addresses":{ "164489f6-cbf7-45b4-b6d0-d407c48cf7fc":[ { "version":"4", "addr":"192.168.0.218", "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:bb:b3:fe", "OS-EXT-IPS:port_id":"240c696f-68d8-4f3f-941d-fecf2b375132", "OS-EXT-IPS:type":"fixed" } ] }, "flavor":{ "disk":"0", "vcpus":"2", "ram":"1024", "id":"c3.large.2", "name":"c3.large.2" }, "accessIPv4":"", "accessIPv6":"", "status":"SHUTOFF", "image":{ "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b" }, "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4", "updated":"2018-08-14T03:01:00Z", "created":"2018-08-13T13:38:29Z", "metadata":{ "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692", "metering.imagetype":"gold", "metering.resourcespeccode":"c3.large.2.linux", "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit", "metering.resourcetype":"1", "os_bit":"64", "vpc_id":"164489f6-cbf7-45b4-b6d0-d407c48cf7fc", "os_type":"Linux", "charging_mode":"0" }, "tags":[ "_sys_root_resource_id=9d81b37c-455f-4528-b0ab-a6abcd0a330b", "_sys_root_resource_type=xxx.resource.type.vm" ], "description":"ecs-f680", "locked":false, "config_drive":"", "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da", "user_id":"61ee747d36bf421fa25c51a3b9565046", "os-extended-volumes:volumes_attached":[ { "device":"/dev/sda", "bootIndex":"0", "id":"3721b948-9c2f-4980-90ad-b2a16811f58c", "delete_on_termination":"false" } ], "OS-EXT-STS:task_state":null, "OS-EXT-STS:power_state":4, "OS-EXT-STS:vm_state":"stopped", "OS-EXT-SRV-ATTR:host":"az1.dc1", "OS-EXT-SRV-ATTR:instance_name":"instance-00137937", "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248", "OS-DCF:diskConfig":"MANUAL", "OS-EXT-AZ:availability_zone":"az1-dc1", "os:scheduler_hints":{ "guestos_product_name":[ "KVM Virtual Machine" ] }, "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda", "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4026-92be-1743ff3a5daf", "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095", "OS-EXT-SRV-ATTR:user_data":"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR5aG9aeFIkVE00OWlwSGQ2OEFWcjlTMTFXNEZrZmFYTENVbEkvd0xVTmdSVjhOb0dCem5WOWFsU1lEN0ZNSHc0VmtwdU9GOERyLncudGUzVmRHLnVmY005elVZSDEnIHwgY2hwYXNzd2QgLWU7", "OS-SRV-USG:launched_at":"2018-08-13T13:38:53.000000", "OS-EXT-SRV-ATTR:kernel_id":"", "OS-EXT-SRV-ATTR:launch_index":0, "host_status":"UP", "OS-EXT-SRV-ATTR:reservation_id":"r-7e2g78rq", "OS-EXT-SRV-ATTR:hostname":"ecs-f680", "sys_tags":[ { "key":"_sys_enterprise_project_id", "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095" } ], "security_groups":[ { "name":"test" } ] }, { "fault":null, "id":"fb70fed9-5774-44a7-ad4a-af3ea2c2da61", "name":"ecs-3993", "addresses":{ "00159d7d-b3c3-4108-8bc4-6658814e6422":[ { "version":"4", "addr":"192.168.20.83", "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:a9:8d:88", "OS-EXT-IPS:port_id":"579ab762-bf89-435e-80ad-a8bdd25119c5", "OS-EXT-IPS:type":"fixed" } ] }, "flavor":{ "disk":"0", "vcpus":"2", "ram":"1024", "id":"c3.large.2", "name":"c3.large.2" }, "accessIPv4":"", "accessIPv6":"", "status":"SHUTOFF", "image":{ "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b" }, "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4", "updated":"2018-08-14T03:01:03Z", "created":"2018-08-13T13:38:02Z", "metadata":{ "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692", "metering.imagetype":"gold", "metering.resourcespeccode":"c3.large.2.linux", "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit", "metering.resourcetype":"1", "os_bit":"64", "vpc_id":"00159d7d-b3c3-4108-8bc4-6658814e6422", "os_type":"Linux", "charging_mode":"0" }, "tags":[ "combined_order_id=CBRCS231010102024YL8962" ], "description":"ecs-3993", "locked":false, "config_drive":"", "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da", "user_id":"eb4698fe015848e9a3e86cc9956e54fa", "key_name":"KeyPair-3b38", "os-extended-volumes:volumes_attached":[ { "device":"/dev/sda", "bootIndex":"0", "id":"85bfbc4f-7733-419a-b171-c00585abf926", "delete_on_termination":"false" } ], "OS-EXT-STS:task_state":null, "OS-EXT-STS:power_state":4, "OS-EXT-STS:vm_state":"stopped", "OS-EXT-SRV-ATTR:host":"az1.dc1", "OS-EXT-SRV-ATTR:instance_name":"instance-00137936", "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248", "OS-DCF:diskConfig":"MANUAL", "OS-EXT-AZ:availability_zone":"az1-dc1", "os:scheduler_hints":{ "guestos_product_name":[ "KVM Virtual Machine" ] }, "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda", "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a25-4014-92be-1743ff3a5daf", "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095", "OS-SRV-USG:launched_at":"2018-08-13T13:38:24.000000", "OS-EXT-SRV-ATTR:kernel_id":"", "OS-EXT-SRV-ATTR:launch_index":0, "host_status":"UP", "OS-EXT-SRV-ATTR:reservation_id":"r-uzsewxii", "OS-EXT-SRV-ATTR:hostname":"ecs-3993", "sys_tags":[ { "key":"_sys_enterprise_project_id", "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095" } ], "security_groups":[ { "name":"test" }, { "name":"default" } ] }, { "fault":null, "id":"e3d3f219-b445-4a7a-8f00-e31412481f8c", "name":"ecs-1f30", "addresses":{ "00159d7d-b3c3-4108-8bc4-6658814e6422":[ { "version":"4", "addr":"192.168.20.197", "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:41:5a:32", "OS-EXT-IPS:port_id":"cfa2e055-54fb-427a-bde4-128bda47ae5c", "OS-EXT-IPS:type":"fixed" } ] }, "flavor":{ "disk":"0", "vcpus":"2", "ram":"1024", "id":"c3.large.2", "name":"c3.large.2" }, "accessIPv4":"", "accessIPv6":"", "status":"ACTIVE", "image":{ "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b" }, "progress":0, "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4", "updated":"2018-08-15T08:16:01Z", "created":"2018-08-13T11:57:29Z", "metadata":{ "sadfasfasf":"sdffffd", "metering.order_id":"CS180813193577ORO", "metering.imagetype":"gold", "metering.resourcespeccode":"c3.large.2.win", "metering.image_id":"65cb40e6-f67e-4bef-a1e7-808166a5999d", "image_name":"HEC_Public_Windows2008R2_Ent_64bit40G_English", "aaaaaa":"0", "metering.resourcetype":"1", "aaaa":"0", "metering.product_id":"00301-146042-0--0", "os_bit":"64", "vpc_id":"00159d7d-b3c3-4108-8bc4-6658814e6422", "os_type":"Windows", "charging_mode":"1" }, "tags":[ "_sys_root_resource_id=4514d9b0-d611-4744-bdf9-60802fd5198a", "_sys_root_resource_type=xxx.resource.type.vm" ], "description":"ecs-1f30", "locked":false, "config_drive":"", "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da", "user_id":"bb7f23e27e7e46f3aaceb5f53a158bdc", "key_name":"Autotest_Init_TC_OriginalAPI_Create_Keypairs_02_keypair", "os-extended-volumes:volumes_attached":[ { "device":"/dev/sda", "bootIndex":"0", "id":"5043f66b-a0d8-4eb2-8c48-49976bcdc253", "delete_on_termination":"false" } ], "OS-EXT-STS:task_state":null, "OS-EXT-STS:power_state":1, "OS-EXT-STS:vm_state":"active", "OS-EXT-SRV-ATTR:host":"az1.dc1", "OS-EXT-SRV-ATTR:instance_name":"instance-0013772d", "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248", "OS-DCF:diskConfig":"MANUAL", "OS-EXT-AZ:availability_zone":"az1-dc1", "os:scheduler_hints":{ "guestos_product_name":[ "KVM Virtual Machine" ] }, "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda", "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4014-92be-1743ff3a5daf", "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095", "OS-SRV-USG:launched_at":"2018-08-13T11:57:53.576640", "OS-EXT-SRV-ATTR:kernel_id":"", "OS-EXT-SRV-ATTR:launch_index":0, "host_status":"UP", "OS-EXT-SRV-ATTR:reservation_id":"r-xmjj4pnm", "OS-EXT-SRV-ATTR:hostname":"ecs-1f30", "sys_tags":[ { "key":"_sys_enterprise_project_id", "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095" } ], "security_groups":[ { "name":"default" } ] } ] }
  • URI GET /v1/{project_id}/cloudservers/detail?flavor={flavor}&name={name}&status={status}&limit={limit}&offset={offset}¬-tags={not-tags}&reservation_id={reservation_id}&enterprise_project_id={enterprise_project_id}&tags={tags}&ip={ip} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。
  • 响应示例 { "servers": [ { "addresses": { "68269e6e-4a27-441b-8029-35373ad50bd9": [ { "addr": "192.168.0.3", "version": 4 } ] }, "created": "2012-09-07T16:56:37Z", "flavor": { "id": "s3.xlarge.2", "links": [ { "href": "http://openstack.example.com/openstack/flavors/s3.xlarge.2", "rel": "bookmark" } ] }, "hostId": "16d193736a5cfdb60c697ca27ad071d6126fa13baeb670fc9d10645e", "id": "05184ba3-00ba-4fbc-b7a2-03b62b884931", "image": "", "links": [ { "href": "http://openstack.example.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931", "rel": "self" }, { "href": "http://openstack.example.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931", "rel": "bookmark" } ], "metadata": {}, "name": "new-server-test", "progress": 0, "status": "ACTIVE", "tenant_id": "openstack", "updated": "2012-09-07T16:56:37Z", "user_id": "fake" } ] }
  • URI GET /v2.1/{project_id}/servers/detail?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}¬-tags={not-tags}&reservation_id={reservation_id}&ip={ip} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。
  • 请求示例 变更专属主机上的云服务器的规格为“s3.large.2”,自动支付且支持开机状态下变更规格。 POST https://{endpoint}/v1.1/{project_id}/cloudservers/{server_id}/resize { "resize": { "flavorRef": "s3.large.2", "dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc", "extendparam":{ "isAutoPay": "true" }, "mode": "withStopServer" } }
  • 响应示例 { "job_id": "ff80808288d41e1b018990260955686a" } 或 { "order_id": "CS1711152257C60TL", "job_id": "ff80808288d41e1b018990260955686a" } 或 { "error": { "message": "XXXX", "code": "XXX" } }
  • 请求消息 表2 参数说明 名称 是否必选 参数类型 描述 resize 是 Object 标记为云服务器变更规格操作,详情参见 表3。 dry_run 否 Boolean 是否只预检此次请求。 true:发送检查请求,不会变更云服务器规格。检查项包括是否填写了必需参数、请求格式等。 如果检查不通过,则返回对应错误。 如果检查通过,则返回202状态码。 false:发送正常请求,通过检查后并且执行变更云服务器规格请求。 表3 resize数据结构说明 名称 是否必选 参数类型 描述 flavorRef 是 String 变更后的云服务器规格ID。 可以通过 查询云服务器规格变更支持列表 接口查询允许变更的规格列表。 说明: 不支持变更至同一规格。 dedicated_host_id 否 String 新专属主机ID。 仅对于部署在专属主机上的弹性云服务器,该参数必选。 extendparam 否 Object 变更云服务器扩展信息,详情参见 表4。 mode 否 String 取值为withStopServer ,支持开机状态下变更规格。 mode取值为withStopServer时,对开机状态的云服务器执行变更规格操作,系统自动对云服务器先执行关机,再变更规格,变更成功后再执行开机。 cpu_options 否 Object 自定义CPU选项。 详情请参见表5。 表4 extendparam数据结构说明 名称 是否必选 参数类型 描述 isAutoPay 否 String 下单订购后,是否自动从客户的账户中支付,而不需要客户手动去进行支付。 “true”:是(自动支付) “false”:否(需要客户手动支付) 说明: 当弹性云服务器是按包年包月计费时生效,该值为空时默认为客户手动支付。 表5 cpu_options数据结构说明 参数 是否必选 参数类型 描述 hw:cpu_threads 否 integer 用于控制CPU是否开启超线程。 取值范围:1,2。 1: 关闭超线程。 2: 打开超线程。 需要同时满足如下条件,才能设置为“关闭超线程”: 只能在实例创建或者resize时指定。 只有目标flavor的extra_specs参数: 存在“hw:cpu_policy”并取值为“dedicated”。 存在“hw:cpu_threads”并取值为“2”。
  • 响应消息 响应参数如表4所示。 表3 响应参数 参数 参数类型 描述 flavors Array of objects 云服务器规格列表,详情请参见表4。 flavors_links Array of objects 分页查询时,查询下一页数据链接 ,详情请参见表5 flavors_links字段数据结构说明。 表4 flavors数据结构说明 参数 参数类型 描述 id String 规格ID。 links Array of objects 规格相关快捷链接地址。 详情请参见表5。 name String 规格名称。 表5 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。
  • 响应示例 { "flavors": [ { "id": "s3.xlarge.1", "links": [ { "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.1", "rel": "self" }, { "href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.1", "rel": "bookmark" } ], "name": "s3.xlarge.1" }, { "id": "s3.xlarge.2", "links": [ { "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.2", "rel": "self" }, { "href": "https://compute.region.x.com/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.2", "rel": "bookmark" } ], "name": "s3.xlarge.2" } ] }
  • 功能介绍 当您创建的弹性云服务器规格无法满足业务需要时,可以变更云服务器规格,升级vCPU、内存。具体接口的使用,请参见本节内容。 本接口为异步接口,当前变更弹性云服务器规格请求下发成功后会返回job_id,此时变更弹性云服务器规格并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表云服务器规格变更成功。 变更规格时,部分规格的之间不能互相变更。您可以参见查询云服务器规格变更支持列表查询支持列表。
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 resize 是 Object 标记为云服务器变更规格操作,详情请参见表3。 dry_run 否 Boolean 是否只预检此次请求。 true:发送检查请求,不会变更云服务器规格。检查项包括是否填写了必需参数、请求格式等。 如果检查不通过,则返回对应错误。 如果检查通过,则返回202状态码。 false:发送正常请求,通过检查后并且执行变更云服务器规格请求。 表3 resize数据结构说明 参数 是否必选 参数类型 描述 flavorRef 是 String 变更后的云服务器规格ID。 可能通过 查询云服务器规格变更支持列表 接口查询允许变更的规格列表。 mode 否 String 取值为withStopServer ,支持开机状态下变更规格。 mode取值为withStopServer时,对开机状态的云服务器执行变更规格操作,系统自动对云服务器先执行关机,再变更规格,变更成功后再执行开机。 cpu_options 否 Object 自定义CPU选项。 详情请参见表4。 表4 cpu_options数据结构说明 参数 是否必选 参数类型 描述 hw:cpu_threads 否 integer 用于控制CPU是否开启超线程。 取值范围:1,2。 1: 关闭超线程。 2: 打开超线程。 需要同时满足如下条件,才能设置为“关闭超线程”: 只能在实例创建或者resize时指定。 只有目标flavor的extra_specs参数: 存在“hw:cpu_policy”并取值为“dedicated”。 存在“hw:cpu_threads”并取值为“2”。
  • 创建AI应用操作步骤 登录ModelArts管理控制台,在左侧导航栏中选择“AI应用”,进入AI应用列表页面。 单击左上角的“创建”,进入“创建AI应用”页面。 在“创建AI应用”页面,填写相关参数。 填写AI应用基本信息,详细参数说明请参见表1。 表1 AI应用基本信息参数说明 参数名称 说明 名称 AI应用名称。支持1~64位可见字符(含中文),名称可以包含字母、中文、数字、中划线、下划线。 版本 设置所创建AI应用的版本。第一次导入时,默认为0.0.1。 说明: AI应用创建完成后,可以通过创建新版本,导入不同的元模型进行调优。 描述 AI应用的简要描述。 填写元模型来源及其相关参数。当“元模型来源”选择“从训练中选择”时,其相关的参数配置请参见表2。 图1 从训练中选择元模型 表2 元模型来源参数说明 参数 说明 “元模型来源” 选择“从训练中选择”。 在“选择训练作业”右侧下拉框中选择当前账号下已完成运行的训练作业。 “动态加载”:用于实现快速部署和快速更新模型。若勾选动态加载,则模型文件和运行时依赖仅在实际部署时拉取。当单个模型文件大小超过5GB时,必须配置“动态加载”。 “AI引擎” 元模型使用的推理引擎,选择训练作业后会自动匹配。 “推理代码” 推理代码自定义AI应用的推理处理逻辑。显示推理代码URL,您可以直接复制此URL使用。 “运行时依赖” 罗列选中模型对环境的依赖。例如依赖“tensorflow”,安装方式为“pip”,其版本必须为1.8.0及以上版本。 “AI应用说明” 为了帮助其他AI应用开发者更好的理解及使用您的AI应用,建议您提供AI应用的说明文档。单击“添加AI应用说明”,设置“文档名称”及其“URL”。AI应用说明最多支持3条。 “部署类型” 选择此AI应用支持部署服务的类型,部署上线时只支持部署为此处选择的部署类型,例如此处只选择在线服务,那您导入后只能部署为在线服务。当前支持“在线服务”、“批量服务”和“边缘服务”。 确认信息填写无误,单击“立即创建”,完成AI应用的创建。 在AI应用列表中,您可以查看刚创建的AI应用及其对应的版本。当AI应用状态变更为“正常”时,表示AI应用导入成功。在此页面,您还可以创建新版本、快速部署服务、发布AI应用等操作。
  • 监控指标 表1 ModelArts支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期 cpu_usage CPU使用率 该指标用于统计ModelArts用户服务的CPU使用率。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 mem_usage 内存使用率 该指标用于统计ModelArts用户服务的内存使用率。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 gpu_util GPU使用率 该指标用于统计ModelArts用户服务的GPU使用情况。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 gpu_mem_usage GPU显存使用率 该指标用于统计ModelArts用户服务的GPU显存使用情况。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 npu_util NPU使用率 该指标用于统计ModelArts用户服务的NPU使用情况。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 npu_mem_usage NPU显存使用率 该指标用于统计ModelArts用户服务的NPU显存使用情况。 单位:百分比。 ≥ 0% ModelArts模型负载 1分钟 successfully_called_times 调用成功次数 统计ModelArts用户调用服务的成功次数。 单位:次/分钟。 ≥Count/min ModelArts模型负载 ModelArts在线服务 1分钟 failed_called_times 调用失败次数 统计ModelArts用户调用服务的失败次数。 单位:次/分钟。 ≥Count/min ModelArts模型负载 ModelArts在线服务 1分钟 total_called_times 调用总次数 统计ModelArts用户调用服务的次数。 单位:次/分钟。 ≥Count/min ModelArts模型负载 ModelArts在线服务 1分钟 disk_read_rate 磁盘读取速率 统计ModelArts用户服务的磁盘读取速率 单位:bit/min ≥bit/min ModelArts模型负载 1分钟 disk_write_rate 磁盘写入速率 统计ModelArts用户服务的磁盘写入速率 单位:bit/min ≥bit/min ModelArts模型负载 1分钟 send_bytes_rate 上行速率 统计ModelArts用户服务的 出方向网络流速。 单位:bit/min ≥bit/min ModelArts模型负载 1分钟 recv_bytes_rate 下行速率 统计ModelArts用户服务的 入方向网络流速。 ≥bit/min ModelArts模型负载 1分钟 req_count_2xx 2xx响应次数 统计api接口2xx响应的次数 ≥Count/min ModelArts在线服务 1分钟 req_count_4xx 4xx异常次数 统计api接口返回4xx错误的次数 ≥Count/min ModelArts在线服务 1分钟 req_count_5xx 5xx异常次数 统计api接口返回5xx错误的次数 ≥Count/min ModelArts在线服务 1分钟 avg_latency 平均延迟毫秒数 统计api接口平均响应延时时间 ≥ms ModelArts在线服务 1分钟 对于有多个测量维度的测量对象,使用接口查询监控指标时,所有测量维度均为必选。 查询单个监控指标时,多维度dim使用样例:dim.0=service_id,530cd6b0-86d7-4818-837f-935f6a27414d&dim.1="model_id,3773b058-5b4f-4366-9035-9bbd9964714a。 批量查询监控指标时,多维度dim使用样例: "dimensions": [ { "name": "service_id", "value": "530cd6b0-86d7-4818-837f-935f6a27414d" } { "name": "model_id", "value": "3773b058-5b4f-4366-9035-9bbd9964714a" } ]
  • SSE在线服务调用 SSE协议本身不提供额外的认证方式,和HTTP请求方式一致。 可以使用ModelArts提供的以下认证方式: token认证 AK/SK APP认证 SSE服务调用如下(以图形界面的软件Postman进行预测,token认证为例): 图1 SSE服务调用 图2 响应头Content-Type 正常情况下,可以观察到响应头Content-Type为text/event-stream;charset=UTF-8。
  • 步骤4:查看与执行操作命令 本节以Windows为例介绍eihealth-toolkit的使用过程,Linux和macOS环境使用方法基本相同,可参考。配置信息导入后,即可查询命令行工具支持的操作,并执行相关命令,使用EIHealth平台。 详细的操作命令请参见其他章节。 查询操作命令列表。 执行health --help查询支持的操作命令。Linux系统下,需添加./指定当前路径。 执行操作命令,获取项目信息。 执行health get project命令查询当前账号下所拥有的项目和项目信息。Linux系统下,需添加./指定当前路径。 使用数据、应用、流程、作业命令时,需先使用switch命令进入待操作的项目中。使用逻辑与EIHealth平台一致,进入项目,再对项目内的数据等内容进行操作。 命令行的参数缩写支持合并使用,例如,-r -s 可以写成-rs。 父主题: 获取并使用命令行工具eihealth-toolkit
  • 获取AK/SK AK/SK(Access Key ID/Secret Access Key)即访问密钥,包含访问密钥ID(AK)和秘密访问密钥(SK)两部分,华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。 登录华为云管理控制台,鼠标指向页面右上角的用户名,在下拉列表中单击“我的凭证”。 图1 我的凭证入口 在“我的凭证”页面中选择“访问密钥”页签。单击“新增访问密钥”,按操作指引获取认证账号的AK/SK,请妥善保管AK/SK信息。 图2 访问密钥 每个用户仅允许新增两个访问密钥。 为保证访问密钥的安全,访问密钥仅在初次生成时自动下载,后续不可再次通过管理控制台页面获取。请在生成后妥善保管。
  • 安装eihealth-toolkit 本示例中以Windows系统为例,介绍安装命令行工具的方法。 获取Windows版本的命令行工具,得到health.exe文件,health文件无需安装,放置在任一文件夹中即可。 图1 下载命令行工具 使用win键+R,输入cmd打开windows的cmd窗口。进入工具所在的目录,输入health命令,即可使用。 如果cmd窗口显示目录不是health文件所在目录,请使用cd命令切换路径。例如,切换至D盘: cd /d d: 图2 客户端 本示例中以Linux系统为例,介绍安装命令行工具的方法。 获取Linux版本的命令行工具,得到health文件,health文件无需安装,放置在任一文件夹中即可。 假设health存放在/home/user-name/test/client目录,请使用cd命令进入health所在目录。 cd /home/user-name/test/client/ 图3 客户端 使用Linux版本命令行工具时,您需要在本地搭建Linux环境,并将下载的health文件放至所需的目录下。macOS执行命令和linux一致, 如果当前目录为health所在目录,可以使用./health命令使用命令行工具。 如果当前目录不是health所在目录,需要使用绝对路径。如当前目录为/opt,假设health存放在/root/health-toolkit/下,需要指定/root/health-toolkit/health路径进行使用。 如果无法运行,提示Permission denied,使用chmod 755 health命令设置执行权限。
  • 下载命令行工具eihealth-toolkit 针对不同操作系统,eihealth-toolkit下载地址如下所示。 表1 下载列表 支持平台 下载地址 Windows 64位 health-windows-x86_64.zip、health-windows-x86_64.zip.sha256 Linux ARM 64位 health-linux-aarch64.tar、health-linux-aarch64.tar.sha256 Linux AMD 64位 health-linux-x86_64.tar、health-linux-x86_64.tar.sha256 macOS health-macOS-x86_64.tar、health-macOS-x86_64.tar.sha256 本页面命令行工具下载后,在使用时,需用到您注册华为账号并开通华为云时提供的用户名等信息,用于登录并操作EIHealth平台的项目、数据等资产。这些信息的处理将遵循您已接收的《华为云用户协议》及《隐私政策声明》约束。 下载地址中带有sha256后缀的链接,指的是对应软件包的校验文件。例如:Windows x64版本的下载链接是health-windows-x86_64 ,它的校验文件下载链接则是health-windows-x86_64.zip.sha256。
  • 命令结构 health edit compute-resources [flags] 表1 参数说明 参数 简写 是否必选 描述 --force -f 否 是否强制操作。 --labels -l 否 需要添加或删除的标签列表。json数组格式。如:-l "[\"h1\",\"h2\"]" --node -n 是 计算资源节点id --operation-type -t 是 对计算资源的操作:[add-labels \| delete-labels \| stop \| reboot \| start \| schedulable \| non-schedule]。add-labels:添加计算节点标签。delete-labels:删除计算节点标签。stop:停止节点。reboot:重启节点。start:启动节点。schedulable:设置节点可被调度。non-schedule:设置节点不可被调度
  • 命令示例 删除计算节点标签 health edit compute-resources -t delete-labels -l "[\"h1\",\"h2\"]" -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac edit compute resources using the delete-labels mode is successful 添加计算节点标签 health edit compute-resources -t add-labels -l "[\"h1\",\"h2\"]" -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac the edit compute-resources using add-labels mode is successful 设置节点可调度 health edit compute-resources -t schedulable -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac the edit compute-resources using schedulable mode is successful 停止计算节点 health edit compute-resources -t stop -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac The stop operation is started successfully...
  • 下载命令行工具eihealth-toolkit 针对不同操作系统,eihealth-toolkit下载地址如下所示。 表1 下载列表 支持平台 下载地址 Windows 64位 health-windows-x86_64.zip、health-windows-x86_64.zip.sha256 Linux ARM 64位 health-linux-aarch64.tar、health-linux-aarch64.tar.sha256 Linux AMD 64位 health-linux-x86_64.tar、health-linux-x86_64.tar.sha256 macOS health-macOS-x86_64.tar、health-macOS-x86_64.tar.sha256 本页面命令行工具下载后,在使用时,需用到您注册华为账号并开通华为云时提供的用户名等信息,用于登录并操作EIHealth平台的项目、数据等资产。这些信息的处理将遵循您已接收的《华为云用户协议》及《隐私政策声明》约束。 下载地址中带有sha256后缀的链接,指的是对应软件包的校验文件。例如:Windows x64版本的下载链接是health-windows-x86_64 ,它的校验文件下载链接则是health-windows-x86_64.zip.sha256。
  • 产品功能 eihealth-toolkit提供了以下功能: 系统设置 您可以使用该工具获取系统标签、系统资源、系统配额信息、消息列表,查询和修改消息及完成作业保留配置,也可以获取和修改供应商logo、名称设置。 项目管理 您可以使用该工具获取、切换、创建、更新、删除和转移项目,也可以添加、修改、移除项目成员角色。 数据管理 您可以使用该工具查看、上传、下载、复制、导入、引入、创建和删除项目中的数据,创建、获取、删除、恢复归档数据,也可以对数据作业执行获取、删除、重试、取消操作。 数据库管理 您可以使用该工具创建、获取、删除和导入数据库模板,创建、获取和删除数据库实例,也可以引用数据库。 镜像管理 您可以使用该工具对镜像执行标记、上传、下载、查询、导入、更新和删除标签等操作。 应用管理 应用是生物信息学软件和运行该软件所依赖的运行环境的镜像封装。 您可以使用该工具创建应用,并进行修改、删除、查询、导入操作。 流程管理 流程包含分析过程中所需应用的执行信息和数据的输入、输出等参数定义,流程至少由一个应用组成。 您可以使用该工具创建流程,并进行修改、删除、查询、导入操作。对于由多个应用构成的流程,可通过设置不同应用的输入、输出关系搭建为流程。 作业管理 您可以使用该工具启动分析作业,并进行查询、删除、重试、取消操作。 notebook 您可以使用该工具创建notebook,并进行查询、编辑、删除和启停等操作。
  • 命令示例 本节以Windows为例介绍eihealth-toolkit的使用过程,Linux和macOS环境使用方法基本相同,可参考。 获取计算资源列表 health get resource -t computing # 执行成功返回结果如下 Id Name Specifications Billing Mode Data Disk Status Purchased Schedulable 8a178a22-38ca-4707-bab3-e12324cdc96d health-ef0ec0fb-4022-46c9-898e-fbd440b44c09 eihealth.cpu.spec.cpu4.4xlarge.2 Pay-per-use SAS|200GB ACTIVE 2024-01-02 17:30:28 true 获取性能加速资源列表 health get resource -t performance # 执行成功返回结果如下 ID Name Specifications Billing Mode Used Capacity Used Capacity Percent Max.Capacity Job Quota Status Purchased Running Jobs 01c24e2f-2038-4718-acb0-a0c388a2f93c sfs-turbo-218766ac-5855-4ad4-a5fd-67130951afdd eihealth.storage.ioacc.spec.ioacc xxx 0.00GB 0.00% 100GB 1 ACTIVE / Schedulable 2023-01-19 21:57:51 0 获取数据库资源列表 health get resource -t database # 执行成功返回结果如下 Name Specifications Billing Mode Usage Data Disk Status Purchased 医疗智能体数据库标准版 200 GB eihealth.dbm.spec.standard.200g(4vCPUS|8GB) Pay-per-use 2.36GB 40GB NORMAL 2023-12-27 16:07:12 获取存储资源列表 health get resource -t storage # 执行成功返回结果如下 Name Specifications Billing Mode Usage Purchased EIHealthSingleAZStoragePackage eihealth.storage.spec.singleaz xxx 4.06TB 2021-09-10 20:58:03 获取计算资源节点标签 health get resource -t computing -a get-labels -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac 1 111 123 copy-in 获取计算资源规格列表 health get resource -t computing -a flavors -z cn-north-7c Flavor Name vCPUs | Memory Assured/Maximum Bandwidth Packets per Second(PPS) Sold Out eihealth.cpu.spec.cpu1.8xlarge.2 32vCPUS/64GB 8/15 Gbit/s 2600000 pps true eihealth.cpu.spec.cpu1.8xlarge.4 32vCPUS/128GB 8/15 Gbit/s 2600000 pps true eihealth.cpu.spec.cpu1.15xlarge.2 60vCPUS/128GB 16/16 Gbit/s 5000000 pps true eihealth.cpu.spec.cpu1.15xlarge.4 60vCPUS/256GB 16/16 Gbit/s 5000000 pps true eihealth.cpu.spec.cpu3.xlarge.2 4vCPUS/8GB 2.4/8 Gbit/s 800000 pps false eihealth.cpu.spec.cpu3.2xlarge.2 8vCPUS/16GB 4.5/15 Gbit/s 1500000 pps false eihealth.cpu.spec.cpu3.4xlarge.2 16vCPUS/32GB 9/20 Gbit/s 2800000 pps true eihealth.cpu.spec.cpu3.8xlarge.2 32vCPUS/64GB 18/30 Gbit/s 5500000 pps true eihealth.cpu.spec.cpu3.8xlarge.4 32vCPUS/128GB 18/30 Gbit/s 5500000 pps true
  • 命令结构 health get resource [flags] 表1 参数说明 参数 简写 是否必选 说明 --type -t 是 名称,支持computing、performance、database、storage,分别代表计算资源、性能加速资源、数据库资源和存储资源。 --action -a 否 查询计算节点方式。 取值范围: get-labels:获取计算资源标签列表。get-labels要和--node一起组合使用。 list:获取计算资源列表。 flavors:获取可用区下的计算节点规格列表。 默认值:list。 --node -n 否 计算节点id。设置了--label后使用,获取某个计算资源节点下的标签列表。 --zone -z 否 可用区id。如:cn-north-7c。
  • 命令示例 health nextflow create job -n "j1" -w "113b2ee6-bcb3-11ed-b7f6-fa163e504fdd" -d "htest" -l "a,b,c" -a "hello" -p "/param1.json"​ 输出结果: { "id": "fe88c9fe-2623-4b08-8f75-df60bb216072" } ​create nextflow job j1 successful
  • 命令示例 初始化配置 health config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -o obs.cn-north-4.myhuaweicloud.com -a xxx -s xxx -D https://xxx -q xxx –f -m xxx -e xxx -t xxx # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add obs-endpoint successfully! add obs_install_path successfully! add obs_down_load_url successfully! add iam-endpoint successfully! add health-endpoint successfully! add swr-endpoint successfully! 初始化配置 health config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -a xxx -s xxx -D https://xxx -q xxx # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add obs_install_path successfully! add obs_down_load_url successfully! 图1 命令示例 初始化配置并设置日志存储路径 health config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -o obs.cn-north-4.myhuaweicloud.com -a xxx -s xxx -D https://xxx -q xxx --log-path D:\log\eihealth.log –f -m xxx -e xxx -t xxx # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add obs-endpoint successfully! add obs_install_path successfully! add obs_down_load_url successfully! add log-path successfully! add iam-endpoint successfully! add health-endpoint successfully! add swr-endpoint successfully! 初始化配置并设置日志存储路径 health config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -a xxx -s xxx -D https://xxx -q xxx --log-path D:\log\eihealth.log # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add obs_install_path successfully! add obs_down_load_url successfully! add log-path successfully! 清空配置请执行health config clear命令 在Notebook中使用命令行工具 在EIHealth开发环境Notebook中使用命令行工具时,请依据以下步骤配置代理。 打开Notebook,并选择Terminal,打开Notebook的命令行界面。 执行以下命令下载命令行工具,并获取配置Notebook代理所需的域名和端口信息。 示例中下载的版本为Linux ARM 64位。 wget https://eihealth-cli.obs.cn-north-4.myhuaweicloud.com/current/health-linux-aarch64.tar 初始化配置时,添加--http-proxy命令,用于配置代理。 health config add --http-proxy http://域名:端口号 执行以上命令,会在系统所在的用户目录下自动生成“.health”文件夹,文件夹中包含config.ini配置文件,用于存储任务执行所涉及到的配置,如密钥、区域、当前项目等信息。 生成的配置文件不建议直接修改,如需改动请使用命令行工具修改。 配置文件中保存有用户的AK、SK信息,为了避免密钥泄露,会对文件中的SK进行加密以保护密钥安全。 初始化配置时,如果命令同时填写了AK/SK和密码,默认AK/SK方式登录。 初始化配置命令会在history中暴露ak、sk,建议使用set +o history命令关闭history再执行。执行后可使用set -o history命令恢复。
  • 清理命令记录 为防止配置文件中的敏感信息泄露,建议使用health config clear命令定时清除本地配置文件。 对于执行的历史命令,可通过以下方法清除。 Linux:执行history -c命令清除历史记录,重新登录命令行工具后,记录可恢复。执行rm -f $HOME/.bash_history命令,可删除记录文件,清空历史。 macOS系统:执行ps -p $$命令检查shell类型。 类型为bash:操作与Linux系统相同。 类型为zsh:执行history -p命令清除历史记录,重新登录命令行工具后,记录可恢复。执行rm -rf ~/.zsh_history命令,退出终端后再次执行history -p命令可删除记录文件,清空历史。 windows系统:对于当前执行的命令,可通过关闭cmd窗口实现历史命令的清理。
  • 命令结构 执行health config add命令进行初始化配置。 health config add [flags] 表1 参数说明 参数 简写 是否必选 说明 --domain-name -d 是 与管理员(购买平台的账户)的账号名一致。 --user-name -u 是 子用户的用户名。 管理员(购买平台的账户)登录时,user-name和domain-name一致。 --password -w 是 密码。 --ak -a 是 AK(Access Key ID):访问密钥ID。 --sk -s 是 SK(Secret Access Key):与访问密钥ID结合使用的密钥。 --region -r 是 服务区域名称。依据购买服务所在的区域进行选择,可选cn-north-4、cn-east-3、cn-south-1 --platform-id -i 是 平台ID,获取方法请参见获取认证信息。 --iam-endpoint -m 否 IAM终端节点名称,请在地区与终端节点中获取。 --health-endpoint -e 否 EIHealth终端节点名称,请在地区与终端节点中获取。 --swr-endpoint -t 否 SWR镜像仓库地址。 获取方式: 登录容器镜像服务管理控制台。 单击界面右侧“登录指令”,获取内网登录指令末尾的SWR镜像仓库地址。例如100.78.15.50:20202。 --log-path -l 否 日志路径,不填写时默认为命令行工具当前路径下healthcli.log文件。 路径设置格式: Windows系统为“路径\文件名”。 Linux系统格式为“路径/文件名”。 --http-proxy -p 否 HTTP代理配置,格式为“http://username:password@your-proxy:your-port”。 --obs-endpoint -o 否 OBS终端节点名称,请在地区与终端节点中获取。 --obs-install-path -q 否 设置obsutil安装路径,默认安装在当前运行目录。 设置时,该路径必须为obsutil运行文件名,如/home/path/obsutil、/home/path/obsutil-1.1.1 --obs_down_load_url -D 否 obsutil下载链接,obsutil将下载到obs-install-path上。 参数有改动时才会触发下载。 下载链接的内容可以是zip、tar.gz文件、二进制文件,如果是压缩文件,文件夹内的obsutil必须命名为obsutil(和obsutil官方链接保持一致)。 --force -f 否 强制操作。如果下载obsutil时,指定的obs-install-path上已经有同名文件,不带-f时会提示用户,带上-f会直接覆盖原文件。
  • 命令结构 health get app ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 否 不选此参数时,列出当前所在项目的所有应用信息。 指定app-id或app-name:version:srcproject,列出具体应用的信息,srcproject为源项目名称,可选。不指定srcproject时,默认为当前项目。例如GATK:4.0:projectname。 --sample -s 否 获取应用模板,模板为yaml格式。 --downloadPath -d 否 获取应用详情时,将内容下载到的指定文件夹路径(文件夹需要存在)。 --project 无 否 指定项目名。未填写则使用配置文件中的项目名。 --label -l 否 根据label标签搜索应用。
  • 命令结构 health get workflow ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 否 不选此参数时,列出当前所在项目的所有流程信息。 指定workflow-id或workflow-name:version:srcproject,列出具体应用的信息,srcproject为源项目名称,可选。不指定srcproject时,默认为当前项目。 --sample -s 否 获取流程模板,模板为yaml格式。 --downloadPath -d 否 获取workflow详情时,将内容下载到的指定文件夹路径(文件夹需要存在)。 --project 无 否 指定项目名。未填写则使用配置文件中的项目名。 --label -l 否 根据label标签搜索workflow
共100000条