華為云計(jì)算 云知識(shí) 查詢指定彈性伸縮策略詳情(V2版本)ShowScalingV2Policy
查詢指定彈性伸縮策略詳情(V2版本)ShowScalingV2Policy

 

功能介紹

根據(jù)伸縮策略ID查詢指定 彈性伸縮 策略信息。

查詢彈性伸縮策略詳情V2版本與V1版本的區(qū)別在于,V2版本響應(yīng)含伸縮資源類型。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id}

表1 參數(shù)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID

scaling_policy_id

String

伸縮策略ID

請(qǐng)求參數(shù)

無(wú)

請(qǐng)求示例

查詢ID為906f73ff-56e8-41b2-a005-8157d0c60361的伸縮策略的詳情信息。

GET https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy/906f73ff-56e8-41b2-a005-8157d0c60361

響應(yīng)參數(shù)

表2 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

scaling_policy

scaling_policy object

伸縮策略詳情。詳情請(qǐng)見(jiàn)表 scaling_policy字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明。

表3 scaling_policy字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

參數(shù)類型

描述

scaling_resource_id

String

伸縮資源ID

scaling_resource_type

string

伸縮資源類型

  • 伸縮組:SCALING_GROUP
  • 帶寬:BANDW IDT H

scaling_policy_name

String

伸縮策略名稱。

支持模糊匹配。

scaling_policy_id

String

伸縮策略ID

policy_status

String

伸縮策略狀態(tài)

  • INSERVICE:已啟用
  • PAUSED:已停用
  • EXECUTING:執(zhí)行中

scaling_policy_type

String

伸縮策略類型:

  • ALARM:告警策略,此時(shí)alarm_id有返回,scheduled_policy不會(huì)返回。
  • SCHEDULED:定時(shí)策略,此時(shí)alarm_id不會(huì)返回,scheduled_policy有返回,并且recurrence_type、recurrence_value、start_time和end_time不會(huì)返回。
  • RECURRENCE:周期策略,此時(shí)alarm_id不會(huì)返回,scheduled_policy有返回,并且recurrence_type、recurrence_value、start_time和end_time有返回。

alarm_id

String

告警ID

scheduled_policy

scheduled_policy object

定時(shí)、周期任務(wù)策略。詳情請(qǐng)見(jiàn)表 scheduled_policy字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明。

scaling_policy_action

scaling_policy_action object

策略執(zhí)行具體動(dòng)作。詳情請(qǐng)見(jiàn)表 scaling_policy_action字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明。

cool_down_time

Integer

冷卻時(shí)間,單位秒。

create_time

String

創(chuàng)建伸縮策略時(shí)間,遵循UTC時(shí)間。

meta_data

meta_data object

附加信息。詳情請(qǐng)見(jiàn)表 meta_data字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明。

description

String

伸縮策略描述。

表4 scheduled_policy字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

參數(shù)類型

描述

launch_time

String

觸發(fā)時(shí)間,遵循UTC時(shí)間。

  • 如果scaling_policy_type為SCHEDULED,則格式為:YYYY-MM-DDThh:mmZ。
  • 如果scaling_policy_type為RECURRENCE,則格式為:hh:mm。

recurrence_type

String

周期觸發(fā)類型。

  • Daily:每天執(zhí)行一次
  • Weekly:每周指定天執(zhí)行一次。
  • Monthly:每月指定天執(zhí)行一次。

recurrence_value

String

周期觸發(fā)任務(wù)數(shù)值:

  • 類型為Daily時(shí),該字段為null,表示每天執(zhí)行
  • 類型為Weekly時(shí),該字段取值范圍為1-7,1表示星期日,以此類推,以“,”分割,例如:1,3,5。
  • 類型為Monthly時(shí),該字段取值范圍為1-31,分別表示每月的日期,以“,”分割,例如:1,10,13,28。

start_time

String

周期策略重復(fù)執(zhí)行開(kāi)始時(shí)間,遵循UTC時(shí)間。

格式為:YYYY-MM-DDThh:mmZ。

end_time

String

周期策略重復(fù)執(zhí)行結(jié)束時(shí)間,遵循UTC時(shí)間。

格式為:YYYY-MM-DDThh:mmZ。

表5 scaling_policy_action字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

參數(shù)類型

描述

operation

String

操作選項(xiàng)。

  • ADD:增加
  • REDUCE:減少
  • SET:設(shè)置為

size

Integer

操作大小

percentage

Integer

操作百分比

limits

Integer

操作限制

表6 meta_data字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

參數(shù)類型

描述

metadata_bandwidth_share_type

String

伸縮帶寬策略中帶寬對(duì)應(yīng)的共享類型。

metadata_eip_id

String

伸縮帶寬策略中帶寬對(duì)應(yīng)的EIP的ID。

metadata_eip_address

String

伸縮帶寬策略中帶寬對(duì)應(yīng)的EIP地址。

響應(yīng)示例

{
    "scaling_policy": {
           "scaling_policy_id": "906f73ff-56e8-41b2-a005-8157d0c60361",
           "scaling_policy_name": "hth_aspolicy_1",
           "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
           "scaling_resource_type": "BANDWIDTH",
           "scaling_policy_type": "ALARM",
           "alarm_id": "al1513822380493GvlJKZwA8",
           "scheduled_policy": {
           },
           "cool_down_time": 900,
           "scaling_policy_action": {
                  "operation": "ADD",
                  "size": 1,
                  "limits": 111
           },
           "policy_status": "INSERVICE",
           "create_time": "2018-03-21T08:03:35Z",
           "meta_data": {
               "metadata_eip_id": "263f0886-de6a-4e21-ad83-814ca9f3844e",
               "metadata_eip_address": "255.255.255.255"
           }
    }
}

返回值

  • 正常

    200

  • 異常

    返回值

    說(shuō)明

    400 Bad Request

    服務(wù)器未能處理請(qǐng)求。

    401 Unauthorized

    被請(qǐng)求的頁(yè)面需要用戶名和密碼。

    403 Forbidden

    對(duì)被請(qǐng)求的頁(yè)面訪問(wèn)禁止。

    404 Not Found

    服務(wù)器無(wú)法找到被請(qǐng)求的頁(yè)面。

    405 Method Not Allowed

    請(qǐng)求中指定的方法不被允許。

    406 Not Acceptable

    服務(wù)器生成的響應(yīng)無(wú)法被客戶端所接受。

    407 Proxy Authentication Required

    用戶必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證,這樣請(qǐng)求才會(huì)被處理。

    408 Request Timeout

    請(qǐng)求超出了服務(wù)器的等待時(shí)間。

    409 Conflict

    由于沖突,請(qǐng)求無(wú)法被完成。

    500 Internal Server Error

    請(qǐng)求未完成。服務(wù)異常。

    501 Not Implemented

    請(qǐng)求未完成。服務(wù)器不支持所請(qǐng)求的功能。

    502 Bad Gateway

    請(qǐng)求未完成。服務(wù)器從上游服務(wù)器收到一個(gè)無(wú)效的響應(yīng)。

    503 Service Unavailable

    請(qǐng)求未完成。系統(tǒng)暫時(shí)異常。

    504 Gateway Timeout

    網(wǎng)關(guān)超時(shí)。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。