すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:CreateHybridMonitorTask

    ドキュメントセンター

    Cloud Monitor:CreateHybridMonitorTask

    最終更新日:Jul 21, 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

    任意

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

    Alibaba Cloud サービスのデータインポートタスク。
    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 サービスの名前空間。名前空間のクエリ方法については、「 DescribeMetricMetaList 」をご参照ください。

    • metric_list: 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 サービスをハイブリッドクラウドモニタリングにインポートできます。これにより、リソースディレクトリを使用して CloudMonitor でクロスアカウントの Alibaba Cloud サービスをモニターできます。この特徴は 設定項目 で設定できます。

    説明

    このパラメーターは、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: 含まない。

    • >: より大きい。

    • <: より小さい。

    • =: 等しい。

    • !=: 等しくない。

    • >=: 以上。

    • <=: 以下。

    列挙値:

    • <= :

      小于等于

    • 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

    HTTP 状態コード。

    説明

    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

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

    変更履歴

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