すべてのプロダクト
Search

このプロダクト

    Quota Center:クラウドサービスのすべての API レート制限に対するグローバルアラートルールを作成する

    ドキュメントセンター

    Quota Center:クラウドサービスのすべての API レート制限に対するグローバルアラートルールを作成する

    最終更新日:Nov 16, 2025

    グローバルアラートルールを作成して、クラウドサービス内のすべての API のレート制限をモニターできます。サービス内のいずれかの API のレート制限の使用量または利用可能な割合がしきい値に達すると、アラート通知がアラート連絡先に送信されます。通知は、クォータの引き上げをリクエストするように促します。

    シナリオ

    ユーザー A は、OpenAPI を統合してサービス管理の自動化を向上させることで、クラウドリソースを管理しています。しかし、API の数が多く、呼び出し頻度が高いため、API スロットリングが頻繁に発生し、ビジネスの安定性に影響を与えています。この問題を解決するために、運用保守 (O&M) チームは、各クラウドプロダクトの API のリアルタイムの使用状況とクォータをモニターすることを計画しています。これにより、事前に計画を立ててビジネスの安定性を確保できます。API の数が多いため、各 API のモニタリングを個別に設定することは困難です。お客様は、グローバル API モニタリング機能を使用してこれを管理できます。

    コンソールから、または OpenAPI を使用して、グローバル API のリアルタイムの使用状況とクォータをモニターできます。

    課金

    API レート制限のアラートは、CloudMonitor のアラート機能を使用します。作成したアラートルールは、CloudMonitor の通知クォータを消費します。さまざまな通知方法の課金の詳細は次のとおりです。

    • 電話: 無料クォータは提供されません。従量課金方法を有効にするか、リソースプランを購入する必要があります。詳細については、「従量課金」および「リソースプラン」をご参照ください。

    • SMS メッセージ: 無料クォータは月あたり 1,000 メッセージです。無料クォータを使い切った場合は、従量課金方法を有効にするか、リソースプランを購入する必要があります。詳細については、「無料クォータ」、「従量課金」、および「リソースプラン」をご参照ください。

    • メールとアラートコールバック: これらの 2 つの通知方法はどちらも無料です。

    準備

    • アラート通知を受信するには、CloudMonitor コンソールでアラート連絡先とアラートグループを作成する必要があります。詳細については、「アラート連絡先またはアラートグループの作成」をご参照ください。

      image

    • RAM ユーザーとしてクォータアラートルールを作成する場合、AliyunQuotasFullAccess ポリシーを RAM ユーザーにアタッチし、CloudMonitor でクォータアイテムのアラートルールを作成および削除する権限を RAM ユーザーに付与する必要があります。

      RAM ユーザーに次の権限を付与します。詳細については、「カスタムポリシーの作成」および「RAM ユーザーへの権限付与」をご参照ください。

      {
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cms:PutMetricRuleTargets",
        "cms:PutResourceMetricRules",
        "cms:DeleteMetricRules",
        "cms:DeleteMetricRuleTargets"
      ],
      "Resource": "*"
    }
  ],
  "Version": "1"
}

    コンソールで API レート制限のグローバルアラートルールを作成する

    このトピックでは、Compute Nest のすべての API レート制限に対してグローバルアラートルールを作成する方法の例を示します。アラート条件は次のとおりです。クォータ使用量が 80% に達するか超えた場合、指定されたアラートグループのアラート連絡先に、ショートメッセージとメールで警告レベルのアラートが送信されます。

    この操作は、Quota Center コンソールまたは CloudMonitor コンソールで実行できます。

    Quota Center コンソール

    1. [Quota Center コンソール] の [API レート制限] ページで、[Compute Nest] を選択します。image

    2. 右上隅にある [グローバルアラート] をクリックして、Compute Nest の API レート制限のアラートルールを作成します。

      アラートルールのパラメーターの設定方法の詳細については、「クォータアイテムのアラートルールを作成する」をご参照ください。imageimage

    3. ルールが作成されたら、API レート制限のグローバルアラートを表示できます。

      • 新しく作成されたアラートルールを表示します。

        image

      • 使用量がある各 API のモニタリング詳細を表示します。

        image

    CloudMonitor コンソール

    1. [CloudMonitor コンソール] の [クラウドサービスモニタリング] ページで、[Compute Nest] > [クォータモニタリング] > [Compute Nest] を選択し、[Compute Nest] の [API レート制限] モニタリングタブに移動します。

      image

    2. 右上隅にある [グローバルアラートルール] をクリックします。[グローバルアラートルール] ページで、Compute Nest の API レート制限のアラートルールを作成します。

      アラートルールのパラメーターの設定方法の詳細については、「クォータアイテムのアラートルールを作成する」をご参照ください。

      image

      image

    3. ルールが作成されたら、API レート制限のグローバルアラートを表示できます。

      image

    OpenAPI を使用して API レート制限のグローバルアラートルールを作成する

    このトピックでは、Compute Nest のすべての API レート制限に対してグローバルアラートルールを作成する方法の例を示します。アラート条件は次のとおりです。クォータ使用量が 80% に達するか超えた場合、指定されたアラートグループのアラート連絡先に、ショートメッセージとメールで警告レベルのアラートが送信されます。

    1. まず、ターゲットクラウドプロダクト (Compute Nest) の API レート制限がグローバルアラートをサポートしているかどうかを確認します。

      Quota Center で ListProductQuotas API 操作を呼び出し、応答の UsageMetric パラメーターを確認します。UsageMetric の値が空でない場合、Compute Nest は API レート制限のグローバルアラートをサポートしています。

      • リクエストパラメーター: ProductCode を computenest に、QuotaCategory を FlowControl に設定します。他のパラメーターはデフォルト値のままにします。

      • 応答パラメーター: UsageMetric パラメーターは、CloudMonitor の API レート制限のモニタリング情報を表示します。MetricNamespace (この場合は acs_quotas_flowcontrol) を取得できます。各 API レート制限について、次の情報が返されます。

        {
      "QuotaDescription": "GetServiceTemplateParameterConstraints",
      "Consumable": false,
      "ProductCode": "computenest",
      "UsageMetric": {
        "MetricName": "Usage",
        "MetricDimensions": {
          "productCode": "computenest",
          "metricKey": "GetServiceTemplateParameterConstraints/2021-06-01",
          "regionId": "ap-southeast-1",
          "label": "none"
        },
        "MetricNamespace": "acs_quotas_flowcontrol"
      },
      "Dimensions": {
        "apiName": "GetServiceTemplateParameterConstraints",
        "apiVersion": "2021-06-01",
        "regionId": "ap-southeast-1"
      },
      "GlobalQuota": false,
      "Period": {
        "PeriodValue": 1,
        "PeriodUnit": "second"
      },
      "Adjustable": true,
      "QuotaActionCode": "f_4w8uhd",
      "QuotaName": "GetServiceTemplateParameterConstraints",
      "QuotaArn": "acs:quotas:ap-southeast-1:14133977********:quota/computenest/f_4w8uhd",
      "TotalQuota": 50,
      "QuotaCategory": "FlowControl"
    }
        説明

        metricKey は、特定の API レート制限 (個別クォータアラート) のアラートルールを作成するために使用されます。

    2. CloudMonitor で DescribeMetricList API 操作を呼び出して、API レート制限のモニタリングデータをクエリします。クォータ使用量の傾向に基づいてクォータアラートを設定します。

      • リクエストパラメーター: Namespace を acs_quotas_flowcontrol に、MetricName を UsagePercentage に、Dimensions を [{"productCode":"computenest"}] に設定します。他のパラメーターはデフォルト値のままにします。

        説明

        Quota Center の MetricName パラメーターの値には、Quota (クォota値)、Usage (クォota使用量)、UsagePercentage (クォota使用率)、AvailablePercentage (利用可能クォota率) があります。

      • 応答パラメーター: Datapoints で、アラートしきい値のリファレンスとして使用する Value の値を取得できます。次の情報が返されます。

        {
  "RequestId": "2A7DB5BF-825C-51BB-AD91-D728857792F9",
  "Period": "60",
  "Datapoints": "[{\"timestamp\":1727337180000,\"productCode\":\"computenest\",\"metricKey\":\"GetServiceTemplateParameterConstraints/2021-05-21\",\"regionId\":\"cn-hangzhou\",\"label\":\"none\",\"userId\":\"14133977********\",\"Value\":2.0}]",
  "Code": "200",
  "Success": true
}

    3. CloudMonitor で PutResourceMetricRules API 操作を呼び出して、クォータアラートルール (グローバルアラート) を作成します。

      • リクエストパラメーター: 次の表に、必須パラメーターとその例を示します。

        パラメーター

        説明

        例

        MetricName

        メトリックの名前。有効な値:

        • Quota: クォータ値。

        • Usage: クォータ使用量。

        • UsagePercentage: クォータ使用率。

        • AvailablePercentage: 利用可能クォータ率。

        説明

        グローバルアラートは UsagePercentage と AvailablePercentage のみをサポートします。

        UsagePercentage

        Escalations.Warn.Threshold

        警告レベルのアラートのしきい値。

        80

        EffectiveInterval

        アラートルールの有効期間。

        00:00-23:59 +0800 dayofweek 1,2,3,4,5,6,7

        RuleId

        アラートルールの ID。

        quota-computenest-ruleid-test

        Escalations.Warn.ComparisonOperator

        警告レベルのしきい値の比較演算子。有効な値:

        • GreaterThanOrEqualToThreshold: 以上。

        • GreaterThanThreshold: より大きい。

        • LessThanOrEqualToThreshold: 以下。

        • LessThanThreshold: より小さい。

        • NotEqualToThreshold: 等しくない。

        • GreaterThanYesterday: 昨日の同時刻の値より大きい。

        • LessThanYesterday: 昨日の同時刻の値より小さい。

        • GreaterThanLastWeek: 先週の同時刻の値より大きい。

        • LessThanLastWeek: 先週の同時刻の値より小さい。

        • GreaterThanLastPeriod: 前回の値より大きい。

        • LessThanLastPeriod: 前回の値より小さい。

        GreaterThanOrEqualToThreshold

        Resources

        リソース情報。

        説明

        単一の API のアラートを作成する場合、Resources の例は次のようになります: [{"productCode":"computenest","metricKey":"GetServiceTemplateParameterConstraints/2021-06-01"}]。

        [{"productCode":"computenest"}]

        ContactGroups

        アラートグループ。

        CloudMonitor

        Namespace

        クラウドサービスのデータ名前空間。

        acs_quotas_flowcontrol

        RuleName

        アラートルールの名前。

        quota-computenest-rulename-test

        Escalations.Warn.Times

        警告レベルのアラートの再試行回数。

        3

        Escalations.Warn.Statistics

        警告レベルのアラートの統計メソッド。

        Value

      • 次の情報が返され、アラートルールが正常に作成されたことを示します。

        {
  "Message": "",
  "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
  "FailedListResult": {
    "Target": []
  },
  "Code": "200",
  "Success": true
}

    4. CloudMonitor で DescribeMetricRuleList API 操作を呼び出し、RuleName または RuleId を使用して作成されたアラートルールを表示します。

    リファレンス