華為云計(jì)算 云知識(shí) 保護(hù)實(shí)例變更規(guī)格ResizeProtectedInstance
保護(hù)實(shí)例變更規(guī)格ResizeProtectedInstance

 

功能介紹

變更指定保護(hù)實(shí)例中彈性 云服務(wù)器 的規(guī)格,包括:同時(shí)變更生產(chǎn)站點(diǎn)云服務(wù)器和容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格。 僅變更生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格,容災(zāi)站點(diǎn)云服務(wù)器規(guī)格不變。 生產(chǎn)站點(diǎn)云服務(wù)器規(guī)格不變,僅變更容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格。 當(dāng)且僅當(dāng)待變更規(guī)格的云服務(wù)器處于關(guān)機(jī)狀態(tài)時(shí),才能執(zhí)行此操作。 說明:不同規(guī)格的云服務(wù)器在性能上存在差異,可能會(huì)對(duì)云服務(wù)器上運(yùn)行的應(yīng)用產(chǎn)生影響。 為保證切換/故障切換后云服務(wù)器的性能,建議容災(zāi)站點(diǎn)服務(wù)器的規(guī)格(CPU、內(nèi)存)不低于生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格(CPU、內(nèi)存)。

接口約束

保護(hù)組的狀態(tài)為available或者protected。 保護(hù)實(shí)例的狀態(tài)為available或者protected或者error-resizing。 待變更規(guī)格的云服務(wù)器已關(guān)機(jī)。

調(diào)試

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

URI

POST /v1/{project_id}/protected-instances/{protected_instance_id}/resize

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。

protected_instance_id

String

保護(hù)實(shí)例的ID。

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

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

resize

ResizeProtectedInstanceRequestParams object

表示保護(hù)實(shí)例變更規(guī)格的操作。

表4 ResizeProtectedInstanceRequestParams

參數(shù)

是否必選

參數(shù)類型

描述

flavorRef

String

變更規(guī)格后,生產(chǎn)站點(diǎn)云服務(wù)器和容災(zāi)站點(diǎn)云服務(wù)器的flavor ID。可通過查詢?cè)品?wù)器規(guī)格變更支持列表接口獲取。 說明:系統(tǒng)支持同時(shí)變更生產(chǎn)站點(diǎn)云服務(wù)器和容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格。如需同時(shí)變更,請(qǐng)使用flavorRef參數(shù),變更規(guī)格后,生產(chǎn)站點(diǎn)云服務(wù)器和容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格相同。

production_flavorRef

String

變更規(guī)格后,生產(chǎn)站點(diǎn)云服務(wù)器的flavor ID??赏ㄟ^查詢?cè)品?wù)器規(guī)格變更支持列表接口獲取。 說明:系統(tǒng)支持僅變更生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格。此時(shí),請(qǐng)使用production_flavorRef參數(shù)。當(dāng)flavorRef參數(shù)有值時(shí),production_flavorRef參數(shù)不生效。

dr_flavorRef

String

變更規(guī)格后,容災(zāi)站點(diǎn)云服務(wù)器的flavor ID。可通過查詢?cè)品?wù)器規(guī)格變更支持列表接口獲取。 說明:系統(tǒng)支持僅變更容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格。此時(shí),請(qǐng)使用dr_flavorRef參數(shù)。當(dāng)flavorRef參數(shù)有值時(shí),dr_flavorRef參數(shù)不生效。

production_dedicated_host_id

String

新生產(chǎn)站點(diǎn) 專屬主機(jī) ID。 說明:生產(chǎn)站點(diǎn)云服務(wù)器在專屬主機(jī)上時(shí),變更規(guī)格需要指定此參數(shù)??梢灾付樯a(chǎn)站點(diǎn)云服務(wù)器當(dāng)前所在專屬主機(jī)ID或其他專屬主機(jī)ID。

dr_dedicated_host_id

String

新容災(zāi)站點(diǎn)專屬主機(jī)ID。 說明:容災(zāi)站點(diǎn)云服務(wù)器在專屬主機(jī)上時(shí),變更規(guī)格需要指定此參數(shù)??梢灾付槿轂?zāi)站點(diǎn)云服務(wù)器當(dāng)前所在專屬主機(jī)ID或其他專屬主機(jī)ID。

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

job_id

String

成功返回jobId信息

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表7 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表9 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表11 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表13 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表15 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表17 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表19 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表21 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表23 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表25 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表27 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 502

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表29 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表31 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表33 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

請(qǐng)求示例

  • 變更生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格為e2.small,容災(zāi)站點(diǎn)云服務(wù)器規(guī)格不變

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "production_flavorRef" : "e2.small"
      }
    }
  • 生產(chǎn)站點(diǎn)云服務(wù)器規(guī)格不變,變更容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格為e2.small

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "dr_flavorRef" : "e2.small"
      }
    }
  • 容災(zāi)站點(diǎn)云服務(wù)器為DeH,生產(chǎn)站點(diǎn)云服務(wù)器規(guī)格不變,變更容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格為e2.small。

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "dr_flavorRef" : "e2.small",
        "dr_dedicated_host_id" : "59f82ad6-6fc9-4bae-8621-aef2194e112c"
      }
    }
  • 變更規(guī)格后,生產(chǎn)站點(diǎn)云服務(wù)器和容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格為e2.small

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "flavorRef" : "e2.small"
      }
    }
  • 生產(chǎn)站點(diǎn)云服務(wù)器為DeH,變更生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格為e2.small,容災(zāi)站點(diǎn)云服務(wù)器規(guī)格不變。

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "production_flavorRef" : "e2.small",
        "production_dedicated_host_id" : "59f82ad6-6fc9-4bae-8621-aef2194e112c"
      }
    }
  • 變更規(guī)格后,生產(chǎn)站點(diǎn)云服務(wù)器的規(guī)格為s3.small.1,容災(zāi)站點(diǎn)云服務(wù)器的規(guī)格為s3.large.2。

    POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize
    
    {
      "resize" : {
        "production_flavorRef" : "s3.small.1",
        "dr_flavorRef" : "s3.large.2"
      }
    }

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "job_id" : "0000000011db92d70162db9d20df32ch"
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

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

錯(cuò)誤碼

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