# 查看自动扩缩容策略 - ShowInferDeploymentHpa #### 功能介绍 本接口用于在已部署的服务上查看自动扩缩容策略。调用此接口前，确保服务已成功部署并获取了有效的服务ID。查询成功后，返回服务对应的策略信息，如规则ID，规则名称，扩缩容类型，扩缩容状态，扩缩容cron表达式，目标实例数等。如果提供的服务ID无效、参数配置错误或系统资源不足，将返回相应的异常信息，提示用户检查输入数据的有效性或联系技术支持。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowInferDeploymentHpa)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | modelarts:service:getHpa | Read | service \* | - | - | - | #### URI GET /v2/{project_id}/services/{service_id}/deployments/{deployment_id}/hpa 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制：** 不涉及。 **取值范围：** 账号的项目ID。 **默认取值：** 不涉及。 | | service_id | 是 | String | **参数解释：** 服务ID，在[创建服务](https://support.huaweicloud.com/api-modelarts/CreateInferService.html#ZH-CN_TOPIC_0000002723741846)时即可在返回体中获取，也可通过[查询服务列表](https://support.huaweicloud.com/api-modelarts/ListInferServices.html#ZH-CN_TOPIC_0000002723741848)获取当前用户拥有的服务，其中service_id字段即为服务ID。 **约束限制：** 不涉及。 **取值范围：** 服务ID。 **默认取值：** 不涉及。 | | deployment_id | 是 | String | **参数解释：** 部署ID，在[添加部署](https://support.huaweicloud.com/api-modelarts/CreateInferDeployment.html#ZH-CN_TOPIC_0000002723741832)时即可在返回体中获取，也可通过[查询服务部署列表](https://support.huaweicloud.com/api-modelarts/ListInferDeployments.html#ZH-CN_TOPIC_0000002723901750)获取当前用户拥有的部署，其中deployment_id字段即为部署ID。 **约束限制：** 不涉及。 **取值范围：** 部署ID。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。获取方法请参见[获取IAM用户Token（使用密码）](https://support.huaweicloud.com/api-modelarts/modelarts_03_0004.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及。 **取值范围：** - application/json - application/json;charset=utf-8 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 自动扩缩容策略ID **取值范围：** 不涉及。 | | name | String | **参数解释：** 自动扩缩容策略名称 **取值范围：** 不涉及。 | | target_resource_id | String | **参数解释：** 自动扩缩容策略绑定的目标ID **取值范围：** 实例组ID | | target_resource_type | String | **参数解释：** 自动扩缩容策略绑定的目标类型。 **取值范围：** - GROUP：实例组 | | min_replicas | Integer | **参数解释：** 自动扩缩容最小实例数。 **取值范围：** 1-128 | | max_replicas | Integer | **参数解释：** 自动扩缩容最大实例数。 **取值范围：** 1-128 | | status | String | 参数解释：\*\* 自动扩缩容策略状态。 **取值范围：** - INACTIVE：不启用 - ACTIVE：配置成功 - DELETED：已删除 | | workspace_id | String | **参数解释：** 工作空间ID。 **取值范围：** - 0：默认空间ID - 由数字和小写字母组成的32位字符：其他空间ID，可参考[工作空间创建](https://support.huaweicloud.com/api-modelarts/CreateWorkspace.html#ZH-CN_TOPIC_0000002753341517) | | hpa_rules | Array of [HpaRule] objects | **参数解释：** 自动扩缩容规则列表 | 表4HpaRule | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 自动扩缩容规则ID **取值范围：** 不涉及。 | | hpa_id | String | **参数解释：** 自动扩缩容规则关联的策略ID **取值范围：** 不涉及。 | | name | String | **参数解释：** 自动扩缩容规则名 **取值范围：** 支持4-64个字符，可以包含字母、汉字、数字、中划线和下划线。 | | type | String | **参数解释：** 自动扩缩容类型。 **取值范围：** - CRON_HPA：定时扩缩容策略 - METRIC_HPA：指标扩缩容策略 | | schedule | String | **参数解释：** 定时自动扩缩容执行的cron表达式，不支持秒，从分钟开始设定 **取值范围：** 不涉及。 | | target_replicas | Integer | **参数解释：** 自动扩缩容目标实例数。 **取值范围：** 1-128 | | disable | String | **参数解释：** 自动扩缩容规则是否启用。 **取值范围：** - false - true | | status | String | **参数解释：** 自动扩缩容规则状态。 **取值范围：** - CREATING：创建中 - CONFIG_SUCCESS：配置成功 - EXECUTE_SUCCESS：执行成功 - DELETED：已删除 - FAILED: 执行失败 | **状态码：404** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 | | error_msg | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。 | #### 请求示例 无 #### 响应示例 **状态码：200** ``` { "id" : "85b6562d-df8b-4fec-a646-a6c8fe348185", "name" : "hpa_test", "target_resource_id" : null, "target_resource_type" : null, "status" : "ACTIVE", "min_replicas" : 1, "max_replicas" : 10, "hpa_rules" : [ { "name" : "rule_test", "type" : "CRON_HPA", "status" : "CREATING", "schedule" : "string", "target_replicas" : 2, "disable" : false }, { "name" : "rule_test1", "type" : "CRON_HPA", "status" : "CONFIG_SUCCESS", "schedule" : "string", "target_replicas" : 2, "disable" : false } ], "workspace_id" : 0 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查看自动扩缩容策略。 | | 404 | 资源未找到。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。