すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:CreateHybridMonitorTask

    ドキュメントセンター

    Cloud Monitor:CreateHybridMonitorTask

    最終更新日:Jul 10, 2026

    ハイブリッドクラウドモニタリングで Alibaba Cloud サービスまたは Simple Log Service (SLS) ログのモニタリングタスクを作成します。

    操作説明

    操作の説明

    • この操作を呼び出す前に、ハイブリッドクラウドモニタリングが有効化されていることを確認してください。

    • SLS ログのメトリックを作成するには、SLS が有効化されており、プロジェクトと Logstore が作成されていることを確認してください。

    • TaskType の値に応じて、一部のパラメーターが必須となります。たとえば、TaskType が aliyun_fc に設定されている場合は YARMConfig を構成する必要があります。TaskType が aliyun_sls に設定されている場合は、CollectInterval などのパラメーターを構成する必要があります。

    • クロスアカウント操作の場合、TargetUserId または TargetUserIdList を指定して、他のメンバーのリソースをハイブリッドクラウドモニタリングに接続します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cms:CreateHybridMonitorTask

    create

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Namespace

    string

    必須

    名前空間の名前。

    名前空間の名前の取得方法については、「 DescribeHybridMonitorNamespaceList 」をご参照ください。

    aliyun
    Description

    string

    任意

    モニタリングタスクの説明。

    阿里云产品数据接入任务。
    TaskName

    string

    任意

    モニタリングタスクの名前。

    • TaskType が aliyun_fc に設定されている場合、Alibaba Cloud サービスのデータインポートタスク名を入力します。

    • TaskType が aliyun_sls に設定されている場合、SLS ログのメトリック名を入力します。

    aliyun_task
    TaskType

    string

    必須

    モニタリングタスクのタイプ。有効な値:

    • aliyun_fc: Alibaba Cloud サービスのデータインポートタスク。

    • aliyun_sls: SLS ログのメトリック。

    列挙値:

    • aliyun_fc :

      aliyun_fc。

    • aliyun_sls :

      aliyun_sls。

    aliyun_fc
    CollectTargetType

    string

    必須

    モニタリングデータのコレクション対象のタイプ。

    • TaskType が aliyun_fc に設定されている場合、aliyun_fc と入力します。

    • TaskType が aliyun_sls に設定されている場合、SLS ログの Logstore グループ名を入力します。

    aliyun_fc
    CollectInterval

    string

    任意

    メトリックのコレクション期間。有効な値:

    • 15

    • 60 (デフォルト)

    単位: 秒。

    説明

    このパラメーターは、TaskType が aliyun_sls に設定されている場合にのみ必須です。

    列挙値:

    • 15 :

      15

    • 60 :

      60

    60
    GroupId

    string

    任意

    アプリケーショングループの ID。

    アプリケーショングループ ID の取得方法については、「 DescribeMonitorGroups 」をご参照ください。

    説明

    このパラメーターは、TaskType が aliyun_sls に設定されている場合にのみ必須です。

    3607****
    YARMConfig

    string

    任意

    ハイブリッドクラウドモニタリングに接続された Alibaba Cloud サービスの設定ファイル。

    • namespace: Alibaba Cloud サービスの名前空間。Alibaba Cloud サービスの名前空間のクエリ方法については、「 DescribeMetricMetaList 」をご参照ください。

    • metric_list: Alibaba Cloud サービスのメトリックのリスト。Alibaba Cloud サービスのメトリックのクエリ方法については、「 DescribeMetricMetaList 」をご参照ください。

    設定ファイルの例を以下に示します。

    products:
- namespace: acs_ecs_dashboard
  metric_info:
  - metric_list:
    - cpu_total
    - cpu_idle
    - diskusage_utilization
    - CPUUtilization
    - DiskReadBPS
    - InternetOut
    - IntranetOut
    - cpu_system
- namespace: acs_rds_dashboard
  metric_info:
  - metric_list:
    - MySQL_QPS
    - MySQL_TPS
    説明

    このパラメーターは、TaskType が aliyun_fc に設定されている場合にのみ必須です。

    products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total
    TargetUserId

    string

    任意

    メンバー ID。

    管理アカウントを使用してこの操作を呼び出す際、ネイティブモードを使用してリソースフォルダ内の任意のメンバーの Alibaba Cloud サービスをハイブリッドクラウドモニタリングに接続できます。これにより、リソースフォルダを通じて Alibaba Cloud サービスのクロスアカウント統合モニタリングを実装できます。CloudMonitor コンソールの 設定項目 に移動して、この特徴を設定します。

    説明

    このパラメーターは、TaskType が aliyun_fc に設定されている場合にのみ必須です。

    120886317861****
    AttachLabels

    array<object>

    任意

    メトリックのラベル。

    説明

    このパラメーターは、TaskType が aliyun_sls に設定されている場合にのみ必須です。

    object

    任意

    なし。

    Value

    string

    任意

    メトリックのラベル値。

    testValue
    Name

    string

    任意

    メトリックのラベルキー。

    app_service
    TargetUserIdList

    string

    任意

    メンバー ID。複数のメンバー ID はコンマ (,) で区切ります。

    説明

    このパラメーターは、管理アカウントを使用してこの操作を呼び出す場合にのみ必須です。

    120886317861****
    SLSProcessConfig

    object

    任意

    SLS ログの構成。

    説明

    このパラメーターは、TaskType が aliyun_sls に設定されている場合にのみ必須です。

    Filter

    object

    任意

    SLS ログ内のパラメーターのフィルター条件。

    Relation

    string

    任意

    複数のフィルター条件間の関係。有効な値:

    • and (デフォルト): すべてのフィルター条件が満たされた場合にのみログが処理されます。

    • or: いずれかのフィルター条件が満たされた場合にログが処理されます。

    列挙値:

    • or :

      or

    • and :

      and。

    and
    Filters

    array<object>

    任意

    SLS ログ内のパラメーターのフィルター条件のリスト。

    object

    任意

    なし。

    SLSKeyName

    string

    任意

    SLS ログ内でフィルターするパラメーターの名前。

    code
    Operator

    string

    任意

    SLS ログ内のパラメーター値のフィルターメソッド。有効な値:

    • contain: 含む。

    • notContain: 含まない。

    • >: より大きい。

    • <: より小さい。

    • =: 等しい。

    • !=: 等しくない。

    • >=: 以上。

    • <=: 以下。

    =
    Value

    string

    任意

    SLS ログ内のパラメーターのフィルター値。

    200
    Statistics

    array<object>

    任意

    SLS ログの統計メソッド。

    object

    任意

    なし。

    SLSKeyName

    string

    任意

    SLS ログ統計のパラメーター名。

    name
    Function

    string

    任意

    選択した統計メソッドに基づいて、統計期間内のログデータを聚合します。有効な値:

    • count: 出現回数をカウントします。

    • sum: 合計を計算します。

    • avg: 平均を計算します。

    • max: 最大値を返します。

    • min: 最小値を返します。

    • value: 期間内のサンプリング値。

    • countps: 統計期間内の指定フィールドのカウントの秒間平均を計算します。

    • sumps: 統計期間内の指定フィールドの合計の秒間平均を計算します。

    • distinct: 統計期間内の重複排除後の指定フィールドの出現回数を計算します。

    • distribution: 指定されたディストリビューション内のフィールド値の出現回数を計算します。

    • percentile: P50 などのフィールド値のパーセンタイル値を計算します。

    count
    Alias

    string

    任意

    SLS ログ統計結果のエイリアス。

    level_count
    Parameter1

    string

    任意

    SLS ログの統計値。

    • Function が distribution に設定されている場合、このパラメーターは統計の有効値の下限を指定します。たとえば、2XX HTTP 状態コードの数をカウントするには、このパラメーターを 200 に設定します。

    • Function が percentile に設定されている場合、このパラメーターは統計ディストリビューションのパーセンタイルを指定します。たとえば、0.5 は P50 を示します。

    200
    Parameter2

    string

    任意

    SLS ログの統計値。

    説明

    このパラメーターは、Function が distribution に設定されている場合にのみ必須です。このパラメーターは統計ディストリビューションの上限を指定します。たとえば、2XX HTTP 状態コードの数をカウントするには、このパラメーターを 299 に設定します。

    299
    GroupBy

    array<object>

    任意

    空間ディメンションごとにデータを聚合します。SQL の Group By に相当します。

    object

    任意

    なし。

    SLSKeyName

    string

    任意

    SLS ログ統計のパラメーター名。

    code
    Alias

    string

    任意

    SLS ログ統計結果のエイリアス。

    ApiResult
    Express

    array<object>

    任意

    SLS ログ統計結果の拡張フィールドの算術演算操作の結果。

    object

    任意

    なし。

    Express

    string

    任意

    SLS ログ統計結果の拡張フィールドの算術演算操作の結果。

    success_count
    Alias

    string

    任意

    SLS ログ統計結果の拡張フィールドの算術演算操作の結果のエイリアス。

    SuccRate
    CloudAccessId

    array

    任意

    CloudMonitor に接続された他のクラウドプロバイダーのプライマリアカウント ID のリスト。

    string

    任意

    CloudMonitor に接続された他のクラウドプロバイダーのプライマリアカウント ID。

    n5n9ik1b****

    共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    Code

    string

    状態コード。

    説明

    200 は成功を示します。

    200
    Message

    string

    エラーメッセージ。

    yamlConfigFail
    RequestId

    string

    リクエスト ID。

    28CEA2E0-3E90-51B2-A7E8-B1ED75534E49
    Success

    string

    操作が成功したかどうかを示します。有効な値:

    • true: 成功。

    • false: 失敗。

    true
    TaskId

    integer

    モニタリングタスクの ID。

    36****

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "yamlConfigFail",
  "RequestId": "28CEA2E0-3E90-51B2-A7E8-B1ED75534E49",
  "Success": "true",
  "TaskId": 0
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 %s %s
    500 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    403 %s %s
    404 %s %s
    409 %s %s

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。