機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. 自動スケール

自動スケール・ポリシーの更新

put

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/JaaS/instances/{serviceId}/autoscaling/policies

このエンドポイントはOracle Public Cloudでのみ使用できます。

Oracle Java Cloud Serviceインスタンスの既存の自動スケール・ポリシーのルールおよび条件の詳細を更新します。

サービス・インスタンスで自動スケールを有効にするには、少なくとも1つのルール(操作)を定義する必要があります。 両方のルール(操作)を更新する場合は、条件が相互に競合しないようにしてください。

Oracle Java Cloud Serviceの使用の自動スケールに関する項を参照してください。

リクエスト

サポートされているメディア・タイプ
  • application/json
パス・パラメータ
identityDomainId
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID。
serviceId
型: string
必須: true
Oracle Java Cloud Serviceインスタンスの名前。
ヘッダー・パラメータ
X-ID-TENANT-NAME
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID。
本文パラメータ
リクエスト本文では、サービス・インスタンスの自動スケール・ポリシーの詳細を定義します。
ルート・スキーマ: autoscalingpolicy-request
ネストされたスキーマ: policies
型: array
自動スケール・ポリシーの詳細をグループ化します。
ネストされたスキーマ: policies-request
ネストされたスキーマ: alarm
タイプ: object
アラームをトリガーするルールの条件をグループ化します。

レスポンス

サポートされているメディア・タイプ
  • application/json
202 Response
Accepted.
本文
自動スケール・ポリシーを作成、更新または表示する場合、レスポンス本文には自動スケール・ポリシーの詳細が含まれています。
ルート・スキーマ: autoscalingpolicy-response
自動スケール・ポリシーを作成、更新または表示する場合、レスポンス本文には自動スケール・ポリシーの詳細が含まれています。
ネストされたスキーマ: policies
型: array
自動スケール・ポリシーの詳細をグループ化します。
ネストされたスキーマ: policy-details
ネストされたスキーマ: alarm
タイプ: object
アラームをトリガーするルールの条件をグループ化します。
400 Response
検証でエラーが発生しました。 1つ以上のソースからのエラーのレスポンスを参照してください。 修正して再試行してください。
本文
ルート・スキーマ: validationfailed-response

例

次の例では、cURLを使用してRESTリソースに対するPUTリクエストを発行することによってOracle Java Cloud Serviceインスタンスの自動スケール・ポリシーを更新する方法を示しています。

注意:

  • この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインを問い合せるためのOracle Public CloudのRESTサーバーです。 Oracle Public Cloudに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。

  • リソース・パスのサービス・タイプ../JaaS/..では大文字小文字が区別されます。

cURLコマンド

curl -i -X PUT -u username:userPassword1! -d @updatepolicy.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/JaaS/instances/ExampleInstance/autoscaling/policies

リクエスト本文の例

次の例に、JSON形式のリクエスト本文のコンテンツを示します。

{
    "name": "JCSPolicy",
    "description": "JCS1 Auto Scaling Policy",
    "policies": [
    {
        "operation": "scaleOut",
        "alarm": {
            "metricName": "CPUUtilization",
            "metricUnit": "percent",
            "statistic": "AVG",
            "comparisonOperator": "GreaterThanOrEqualToThreshold",
            "threshold": 90,
            "sampleCount": 3,
            "sampleFrequency": 10,
            "breachedOnInstance": "ALL"
        },
        "coolDownPeriod": 30,
        "maxClusterSize": 4
    },
    {
        "operation": "scaleIn",
        "alarm": {
            "metricName": "CPUUtilization",
            "metricUnit": "percent",
            "statistic": "AVG",
            "comparisonOperator": "LessThanOrEqualToThreshold",
            "threshold": 40,
            "sampleCount": 3,
            "sampleFrequency": "10",
            "breachedOnInstance": "ANY"
        },       
        "coolDownPeriod": 30,
        "minClusterSize": 2
    }
    ]
}

レスポンス・ヘッダーの例

次にレスポンス・ヘッダーの例を示します。

HTTP/1.1 202 Accepted
Date: Thu, 19 May 2016 00:53:16 GMT
Content-Length: 0
Content-Type: application/json

レスポンス本文の例

レスポンス本文の例を次に示します。

{
    "name": "JCSPolicy",
    "description": "JCS1 Auto Scaling Policy",
    "policies": [
    {
        "operation": "scaleOut",
        "alarm": {
            "metricName": "CPUUtilization",
            "metricUnit": "percent",
            "statistic": "AVG",
            "comparisonOperator": "GreaterThanOrEqualToThreshold",
            "threshold": "90",
            "sampleCount": "3",
            "sampleFrequency": "10",
            "breachedOnInstance": "ALL"
        },
        "coolDownPeriod": "30",
        "maxClusterSize": "4"
    },
    {
        "operation": "scaleIn",
        "alarm": {
            "metricName": "CPUUtilization",
            "metricUnit": "percent",
            "statistic": "AVG",
            "comparisonOperator": "LessThanOrEqualToThreshold",
            "threshold": "40",
            "sampleCount": "3",
            "sampleFrequency": "10",
            "breachedOnInstance": "ANY"
        },
        "coolDownPeriod": "30",
        "minClusterSize": "2"
    }
    ],
    "version": 2,
    "status": "Active",
    "startTime": "2016-05-19T07:39:03.576+0000"
}