メインコンテンツまでスキップ

グローバルクラスター CU を変更する (V2)

Modifies CU size or CU autoscaling policy at Global Cluster level. CU settings apply to all member clusters.

POST/v2/globalClusters/{globalClusterId}/modifyCU
接続エンドポイント

https://api.cloud.zilliz.com

shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンは、適切な権限を持つ API key である必要があります。

値の例： Bearer {{TOKEN}}
globalClusterIdstringpath必要

Global Cluster の ID。

値の例： glo-xxxxxxxxxxxxxxx
リクエスト・ボディapplication/json
cuSizeinteger

対象の CU サイズ。autoscaling.cu と相互排他的です。

値の例： 8
autoscalingobject

Global Cluster のオートスケーリングポリシー。

cuobject

CU オートスケーリングポリシー。動的スケーリングには min と max を設定するか、スケジュールスケーリングには schedules を設定します。

mininteger

動的スケーリングの最小 CU。max とあわせて設定する必要があります。

値の例： 4
maxinteger

動的スケーリングの最大 CU。min とあわせて設定する必要があります。

値の例： 16
schedulesarray

スケジュールスケーリングルール。

[]schedulesobject
cronstring必要

スケジュールスケーリング用の Cron 式。

値の例： 0 9 * * 1-4
targetinteger必要

このスケジュールの対象 CU サイズ。

値の例： 8
bash
export TOKEN="YOUR_API_KEY"
export globalClusterId="glo-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/globalClusters/${globalClusterId}/modifyCU" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "cuSize": 8
}'
bash
export TOKEN="YOUR_API_KEY"
export globalClusterId="glo-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/globalClusters/${globalClusterId}/modifyCU" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "autoscaling": {
        "cu": {
            "min": 4,
            "max": 16
        }
    }
}'
bash
export TOKEN="YOUR_API_KEY"
export globalClusterId="glo-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/globalClusters/${globalClusterId}/modifyCU" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "autoscaling": {
        "cu": {
            "schedules": [
                {
                    "cron": "0 9 * * 1-4",
                    "target": 8,
                    "timezone": "UTC"
                }
            ]
        }
    }
}'
レスポンス200 OK - application/json

CU 変更ジョブを返します。

jobIdstring

非同期操作の Job ID。

値の例： job-xxxxxxxxxxxxxxx

エラーメッセージを返します。

codeinteger

レスポンスコード。

値の例： 400
messagestring

エラーメッセージ。

値の例： Invalid request parameters.
Successjson
{
    "jobId": "job-xxxxxxxxxxxxxxx"
}
Ctrl I