华为云用户手册

涉及接口 创建伸缩配置时，需要进行token查询，云服务器规格查询，镜像列表查询，伸缩配置创建等操作，涉及的接口如下： 获取IAM用户Token：确定调用API鉴权时使用的token。 查询云服务器规格详情列表：确定待创建伸缩配置的规格。 查询镜像列表：确定待创建伸缩配置使用的镜像。 查询SSH密钥列表：设置密钥对登录方式。 创建弹性伸缩配置：使用规格和镜像等参数创建伸缩配置。 查询弹性伸缩配置详情：确认伸缩配置创建成功。

涉及接口 创建伸缩组时，需要进行token查询，安全组列表查询，伸缩配置列表查询等操作，涉及的接口如下： 获取IAM用户Token：确定调用API鉴权时使用的token。 查询VPC列表：确定待创建伸缩组使用的虚拟私有云。 查询安全组列表：确定待创建伸缩组使用的安全组。 查询子网列表：确定待创建伸缩组使用的子网。 查询弹性伸缩配置列表：确定待创建伸缩组的伸缩配置。 查询可用区列表：确定待创建伸缩组的可用区。 创建弹性伸缩组：使用VPC和伸缩配置等参数创建弹性伸缩组。 查询弹性伸缩组详情：确认伸缩组创建成功。

操作步骤 确定调用API鉴权时使用的token。 查询token，详情请参见获取用户Token。 获取响应Header参数中X-Subject-Token对应的值。 确定待创建伸缩组使用的虚拟私有云。 查询VPC虚拟私有云列表，详情请参见查询VPC列表。 根据实际需要选择虚拟私有云，并记录虚拟私有云的ID。 确定待创建伸缩组使用的安全组。 查询VPC安全组列表，详情请参见查询安全组列表。 根据实际需要选择安全组，并记录安全组ID。 确定待创建伸缩组使用的子网。 根据选定的虚拟私有云ID，查询指定VPC下的子网列表，详情请参见查询子网列表。 根据实际需要选择子网，并记录子网ID。 确定待创建伸缩组的伸缩配置。 查询伸缩配置列表。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_configuration 接口请求参数说明详情，请参见查询弹性伸缩配置列表。 请求示例 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_configuration?start_number=0&limit=10 {endpoint}信息请从地区和终端节点获取。 响应示例 { "limit": 20, "total_number": 2, "start_number": 0, "scaling_configurations": [ { "tenant": "ce061903a53545dcaddb300093b477d2", "scaling_configuration_id": "6afe46f9-7d3d-4046-8748-3b2a1085ad86", "scaling_configuration_name": " config_name_1", "instance_config": { "disk": [ { "size": 40, "volume_type": "SATA", "disk_type": "SYS" }, { "size": 100, "volume_type": "SATA", "disk_type": "DATA" } ], "personality": null, "instance_name": null, "instance_id": null, "flavorRef": "103", "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c", "key_name": "keypair01", "public_ip": null, "user_data": null, "metadate": {}, "security_groups": [{ "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be" }], }, "create_time": "2015-07-23T01:04:07Z" } ]} 根据实际需要选择伸缩配置，并记录伸缩配置ID。 确定待创建伸缩组的可用区。 查询可用域列表，详情请参见查询可用区列表。 根据实际需要选择可用区，并记录可用区名称。 使用VPC和伸缩配置等参数创建弹性伸缩组。 接口相关信息 URL格式：POST /autoscaling-api/v1/{project_id}/scaling_group 接口请求参数说明详情，请参见创建弹性伸缩组。 请求示例 POST: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group {endpoint}信息请从地区和终端节点获取。 Body： {"scaling_group_name": "GroupNameTest","scaling_configuration_id": "47683a91-93ee-462a-a7d7-484c006f4440","desire_instance_number": 0,"min_instance_number": 0,"max_instance_number": 10,"health_periodic_audit_method": "NOVA_AUDIT","vpc_id": "a8327883-6b07-4497-9c61-68d03ee193a","available_zones": ["XXXa","XXXb"],"networks": [ { "id": "3cd35bca-5a10-416f-8994-f79169559870" }],"enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413","multi_az_priority_policy": "PICK_FIRST"} 响应示例 { "scaling_group_id": "a8327883-6b07-4497-9c61-68d03ee193a1"} 确认伸缩组创建成功。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id} 接口请求参数说明详情，请参见查询弹性伸缩组详情。 请求示例 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group/a8327883-6b07-4497-9c61-68d03ee193a1 其中： a8327883-6b07-4497-9c61-68d03ee193a1为创建的伸缩配置UUID。 {endpoint}信息请从地区和终端节点获取。 响应示例 { "scaling_group": { "networks": [ { "id": "a8327883-6b07-4497-9c61-68d03ee193a ", "ipv6_enable": true, "ipv6_bandwidth": { "id": "076ee2ff-f23e-4338-b8ac-1bc7278532d5" } } ], "available_zones": [ "XXXa", "XXXb" ], "detail": null, "scaling_group_name": "api_gateway_modify", "scaling_group_id": "d4e50321-3777-4135-97f8-9f5e9714a4b0", "scaling_group_status": "INSERVICE", "scaling_configuration_id": "53579851-3841-418d-a97b-9cecdb663a90", "scaling_configuration_name": "press", "current_instance_number": 7, "desire_instance_number": 8, "min_instance_number": 0, "max_instance_number": 100, "cool_down_time": 900, "lb_listener_id": null, "security_groups": [ { "id": "23b7b999-0a30-4b48-ae8f-ee201a88a6ab" } ], "create_time": "2015-09-01T08:36:10Z", "vpc_id": "3e22f934-800d-4bb4-a588-0b9a76108190", "health_periodic_audit_method": "NOVA_AUDIT", "health_periodic_audit_time": 5, "health_periodic_audit_grace_period": 600, "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE", "is_scaling": true, "delete_publicip": false, "notifications": null, "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413", "activity_type": "MODIFY_ELB", "multi_az_priority_policy": "PICK_FIRST" }}

操作步骤 确定调用API鉴权时使用的token。 查询token，详情请参见获取用户Token。 获取响应Header参数中X-Subject-Token对应的值。 确定要创建伸缩策略的伸缩组。 查询伸缩组列表。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_group 详情请参见查询弹性伸缩组列表。 请求示例 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group {endpoint}信息请从地区和终端节点获取。 响应示例 { "limit": 20, "scaling_groups": [ { "networks": [ { "id": "a8327883-6b07-4497-9c61-68d03ee193a", "ipv6_enable": true, "ipv6_bandwidth": { "id": "076ee2ff-f23e-4338-b8ac-1bc7278532d5" } } ], "available_zones": [ "XXXa", "XXXb" ], "detail": null, "scaling_group_name": "as-group-test", "scaling_group_id": "77a7a397-7d2f-4e79-9da9-6a35e2709150", "scaling_group_status": "INSERVICE", "scaling_configuration_id": "1d281494-6085-4579-b817-c1f813be835f", "scaling_configuration_name": "healthCheck", "current_instance_number": 0, "desire_instance_number": 1, "min_instance_number": 0, "max_instance_number": 500, "cool_down_time": 300, "lb_listener_id": "f06c0112570743b51c0e8fbe1f235bab", "security_groups": [ { "id": "8a4b1d5b-0054-419f-84b1-5c8a59ebc829" } ], "create_time": "2015-07-23T02:46:29Z", "vpc_id": "863ccae2-ee85-4d27-bc5b-3ba2a198a9e2", "health_periodic_audit_method": "ELB_AUDIT", "health_periodic_audit_time": 5, "health_periodic_audit_grace_period": 600, "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE", "is_scaling": false, "delete_publicip": false, "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413", "multi_az_priority_policy": "PICK_FIRST" }],"total_number": 1,"start_number": 0} 选择要创建伸缩策略的伸缩组，并记录伸缩组ID。 为指定的伸缩组创建伸缩策略。 接口相关信息 URI格式：POST /autoscaling-api/v1/{project_id}/scaling_policy 详情请参见创建弹性伸缩策略。 请求示例 示例为创建一个名称为as-policy-7a75的周期策略，该策略的生效时间为2015-12-14T03:34Z到2015-12-27T03:34Z，每天16:00在ID为5bc3aa02-b83e-454c-aba1-4d2095c68f8b的伸缩组中增加一个实例。 POST: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_policy {endpoint}信息请从地区和终端节点获取。 Body： { "scaling_policy_name": "as-policy-7a75", "scaling_policy_action": { "operation": "ADD", "instance_number": 1 }, "cool_down_time": 900, "scheduled_policy": { "launch_time": "16:00", "recurrence_type": "Daily", "start_time": "2015-12-14T03:34Z", "end_time": "2015-12-27T03:34Z" }, "scaling_policy_type": "RECURRENCE", "scaling_group_id": "5bc3aa02-b83e-454c-aba1-4d2095c68f8b"} 响应示例 { "scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"} 确认伸缩策略创建成功。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id} 详情请参见查询弹性伸缩策略详情。 请求示例 本示例展示了查询ID为0h327883-324n-4dzd-9c61-68d03ee191dd的伸缩策略的详情信息。 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_policy/fd7d63ce-8f5c-443e-b9a0-bef9386b23b3 {endpoint}信息请从地区和终端节点获取。 响应示例 { "scaling_policy": { "scaling_policy_id": "fd7d63ce-8f5c-443e-b9a0-bef9386b23b3", "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a", "scaling_policy_name": "定时1", "scaling_policy_type": "SCHEDULED", "scheduled_policy": { "launch_time": "2015-07-24T01:21Z" }, "cool_down_time": 300, "scaling_policy_action": { "operation": "REMOVE", "instance_number": 1 }, "policy_status": "INSERVICE", "create_time": "2015-07-24T01:09:30Z" }}

操作步骤 确定调用API鉴权时使用的token。 查询token，详情请参见获取用户Token。 获取响应Header参数中X-Subject-Token对应的值。 确定要进行批量操作的伸缩组。 查询伸缩组列表。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_group 详情请参见查询弹性伸缩组列表。 请求示例 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group {endpoint}信息请从地区和终端节点获取。 响应示例 { "limit": 20, "scaling_groups": [ { "networks": [ { "id": "a8327883-6b07-4497-9c61-68d03ee193a", "ipv6_enable": true, "ipv6_bandwidth": { "id": "076ee2ff-f23e-4338-b8ac-1bc7278532d5" } } ], "available_zones": [ "XXXa", "XXXb" ], "detail": null, "scaling_group_name": "as-group-test", "scaling_group_id": "77a7a397-7d2f-4e79-9da9-6a35e2709150", "scaling_group_status": "INSERVICE", "scaling_configuration_id": "1d281494-6085-4579-b817-c1f813be835f", "scaling_configuration_name": "healthCheck", "current_instance_number": 0, "desire_instance_number": 1, "min_instance_number": 0, "max_instance_number": 500, "cool_down_time": 300, "lb_listener_id": "f06c0112570743b51c0e8fbe1f235bab", "security_groups": [ { "id": "8a4b1d5b-0054-419f-84b1-5c8a59ebc829" } ], "create_time": "2015-07-23T02:46:29Z", "vpc_id": "863ccae2-ee85-4d27-bc5b-3ba2a198a9e2", "health_periodic_audit_method": "ELB_AUDIT", "health_periodic_audit_time": 5, "health_periodic_audit_grace_period": 600, "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE", "is_scaling": false, "delete_publicip": false, "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413", "multi_az_priority_policy": "PICK_FIRST" }],"total_number": 1,"start_number": 0} 选择要操作实例的伸缩组，并记录伸缩组ID。 获取指定伸缩组实例列表。 查询弹性伸缩组中的实例列表。 接口相关信息 URI格式：GET /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/list 详情请参见查询弹性伸缩组中的实例列表。 请求示例 本示例展示了查询ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组下已启用且处于健康状态的实例。 GET: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/list?life_cycle_state=INSERVICE&health_status=NORMAL {endpoint}信息请从地区和终端节点获取。 响应示例 { "limit": 10, "total_number": 1, "start_number": 0, "scaling_group_instances": [ { "instance_id": "b25c1589-c96c-465b-9fef-d06540d1945c", "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a", "scaling_group_name": "discuz", "life_cycle_state": "INSERVICE", "health_status": "NORMAL", "scaling_configuration_name": "discuz", "scaling_configuration_id": "ca3dcd84-d197-4c4f-af2a-cf8ba39696ac", "create_time": "2015-07-23T06:47:33Z", "instance_name": "discuz_3D210808", "protect_from_scaling_down": false } ]} 选择需要操作的实例，并记录实例ID。 批量移出实例。 接口相关信息 URI格式：POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action 详情请参见批量操作实例。 请求示例 本示例展示将实例ID为instance_id_1和instance_id_2的两个实例批量从ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组移出并删除的操作。 POST: https://{Endpoint}/autoscaling-api/v1/0605767c2e80d5762fd0c0146a10aaf2/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action {endpoint}信息请从地区和终端节点获取。 Body： {"action": "REMOVE","instances_id": ["instance_id_1","instance_id_2"],"instance_delete": "yes"} 响应示例 HTTP状态码正常返回204。

返回值 正常 204 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

URI DELETE /autoscaling-api/v1/{project_id}/scaling_notification/{scaling_group_id}/{topic_urn} 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 项目ID scaling_group_id 是 String 伸缩组ID topic_urn 是 String SMN服务中Topic的唯一的资源标识。

请求示例 删除ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内topic_urn为urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh的通知。 DELETE https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_notification/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh

响应示例 { "lifecycle_hooks": [ { "lifecycle_hook_name": "test-hook1", "default_result": "ABANDON", "default_timeout": 3600, "notification_topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "notification_topic_name": "gsh", "lifecycle_hook_type": "INSTANCE_LAUNCHING", "notification_metadata": null, "create_time": "2016-11-18T04:01:34Z" }, { "lifecycle_hook_name": "test-hook2", "default_result": "CONTINUE", "default_timeout": 300, "notification_topic_urn": "urn:smn:regionId:a5b95554fad0494d94596fb84296510b:test", "notification_topic_name": "test", "lifecycle_hook_type": "INSTANCE_TERMINATING", "notification_metadata": null, "create_time": "2016-11-17T04:00:34Z" } ]}

返回值 正常 200 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

响应参数 表2 响应参数 参数 参数类型 描述 lifecycle_hooks Array of lifecycle_hooks objects 生命周期挂钩列表，详情见表 lifecycle_hooks字段数据结构说明。 表3 lifecycle_hooks字段数据结构说明 参数 参数类型 描述 lifecycle_hook_name String 生命周期挂钩名称。 lifecycle_hook_type String 生命周期挂钩类型。 INSTANCE_TERMINATING INSTANCE_LAUNCHING default_result String 生命周期挂钩默认回调操作。 ABANDON CONTINUE default_timeout Integer 生命周期挂钩超时时间，单位秒。 notification_topic_urn String SMN 服务中 Topic 的唯一的资源标识。 notification_topic_name String SMN 服务中 Topic 的资源名称。 notification_metadata String 自定义通知消息。 create_time String 创建生命周期挂钩时间，遵循UTC时间。

响应示例 { "lifecycle_hook_name": "test-hook1", "default_result": "ABANDON", "default_timeout": 3600, "notification_topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "notification_topic_name": "gsh", "lifecycle_hook_type": "INSTANCE_LAUNCHING", "notification_metadata": null, "create_time": "2019-03-18T16:00:11Z"}

响应参数 表3 响应参数 参数 参数类型 描述 lifecycle_hook_name String 生命周期挂钩名称 lifecycle_hook_type String 生命周期挂钩类型。 INSTANCE_TERMINATING INSTANCE_LAUNCHING default_result String 生命周期挂钩默认回调操作。 ABANDON CONTINUE default_timeout Integer 生命周期挂钩超时时间，单位秒。 notification_topic_urn String SMN 服务中 Topic 的唯一的资源标识。 notification_topic_name String SMN 服务中 Topic 的资源名称。 notification_metadata String 自定义通知消息 create_time String 生命周期挂钩创建时间，遵循UTC时间。

返回值 正常 200 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

请求示例 创建一个名称为test-hook1的生命周期挂钩，伸缩组ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a，回调操作为ABANDON，超时时间为3600秒，消息通知topic_urn为urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh，挂钩类型为在实例启动时挂起实例。 POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a{ "lifecycle_hook_name": "test-hook1", "default_result": "ABANDON", "default_timeout": 3600, "notification_topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "lifecycle_hook_type": "INSTANCE_LAUNCHING"}

URI GET /autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/{scaling_group_id}/{lifecycle_hook_name} 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 项目ID scaling_group_id 是 String 伸缩组ID lifecycle_hook_name 是 String 生命周期挂钩名称

响应参数 表2 响应参数 参数 参数类型 描述 lifecycle_hook_name String 生命周期挂钩名称。 lifecycle_hook_type String 生命周期挂钩类型。 INSTANCE_TERMINATING INSTANCE_LAUNCHING default_result String 生命周期挂钩默认回调操作。 ABANDON CONTINUE default_timeout Integer 生命周期挂钩超时时间，单位秒。 notification_topic_urn String SMN服务中Topic的唯一的资源标识。 notification_topic_name String SMN服务中Topic的资源名称。 notification_metadata String 自定义通知消息。 create_time String 创建生命周期挂钩时间，遵循UTC时间。

响应示例 { "lifecycle_hook_name": "test-hook1", "default_result": "CONTINUE", "default_timeout": 3600, "notification_topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "notification_topic_name": "gsh", "lifecycle_hook_type": "INSTANCE_LAUNCHING", "notification_metadata": null, "create_time": "2016-11-18T04:01:34Z"}

请求示例 查询ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内挂钩名称为test-hook1的生命周期挂钩详情。 GET https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/test-hook1

返回值 正常 200 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

请求参数 表2 请求参数 参数 是否必选 参数类型 描述 lifecycle_action_key 否 String 生命周期操作令牌，通过查询伸缩实例挂起信息接口获取。 指定生命周期回调对象，当不传入instance_id字段时，该字段为必选。当该字段与instance_id字段都传入时，优先使用该字段进行回调。 instance_id 否 String 实例ID。 指定生命周期回调对象，当不传入lifecycle_action_key字段时，该字段为必选。 lifecycle_hook_name 否 String 生命周期挂钩名称。 指定生命周期回调对象，当不传入lifecycle_action_key字段时，该字段为必选 lifecycle_action_result 是 String 生命周期回调操作。 ABANDON：终止。 CONTINUE：继续。 EXTEND：延长超时时间，每次延长1小时。

请求示例 在ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内通过生命周期操作令牌23880867-6288-4470-98a8-f8bda096b6c4进行ABANDON的回调操作。 PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_instance_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/callback{ "lifecycle_action_result": "ABANDON", "lifecycle_action_key":"23880867-6288-4470-98a8-f8bda096b6c4"}

返回值 正常 204 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

响应示例 { "lifecycle_hook_name": "test-hook1", "default_result": "CONTINUE", "default_timeout": 3600, "notification_topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh", "notification_topic_name": "gsh", "lifecycle_hook_type": "INSTANCE_LAUNCHING", "notification_metadata": null, "create_time": "2016-11-18T04:01:34Z"}

请求示例 修改ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内挂钩名称为test-hook1的生命周期挂钩，将其回调操作修改为CONTINUE。 PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/test-hook1{ "default_result": "CONTINUE"}

返回值 正常 200 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。

响应参数 表3 响应参数 参数 参数类型 描述 lifecycle_hook_name String 生命周期挂钩名称 lifecycle_hook_type String 生命周期挂钩类型。 INSTANCE_TERMINATING INSTANCE_LAUNCHING default_result String 生命周期挂钩默认回调操作。 ABANDON CONTINUE default_timeout Integer 生命周期挂钩超时时间，单位秒。 notification_topic_urn String SMN服务中Topic的唯一的资源标识。 notification_topic_name String SMN服务中Topic的资源名称。 notification_metadata String 自定义通知消息。 create_time String 创建生命周期挂钩时间，遵循UTC时间。

URI PUT /autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/{scaling_group_id}/{lifecycle_hook_name} 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 项目ID scaling_group_id 是 String 伸缩组ID lifecycle_hook_name 是 String 生命周期挂钩名称

请求示例 删除ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内名称为test-hook1的生命周期挂钩。 DELETE https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_lifecycle_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/test-hook1

返回值 正常 204 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求的页面访问禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。