All Products
Search

This Product

    Application Real-Time Monitoring Service:UpdateIntegration

    Document Center

    Application Real-Time Monitoring Service:UpdateIntegration

    Last Updated:Jun 12, 2026

    Mengubah informasi terkait integrasi.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    IntegrationId

    integer

    Yes

    ID integrasi peringatan.

    1234
    IntegrationName

    string

    Yes

    Nama integrasi peringatan.

    云监控集成
    IntegrationProductType

    string

    Yes

    Tipe produk integrasi. Nilai valid:

    • CLOUD_MONITOR: CloudMonitor

    • LOG_SERVICE: Simple Log Service.

    CLOUD_MONITOR
    Description

    string

    No

    Deskripsi integrasi peringatan.

    测试
    AutoRecover

    boolean

    No

    Apakah event peringatan akan dipulihkan secara otomatis. Nilai valid:

    • true (default)

    • false.

    true
    RecoverTime

    integer

    No

    Pengatur waktu pemulihan otomatis untuk event peringatan. Nilai default: 300. Unit: seconds.

    300
    DuplicateKey

    string

    No

    Bidang deduplikasi.

    LABEL.dimensions::LABEL.ruleId
    State

    boolean

    No

    Apakah integrasi peringatan diaktifkan. Nilai valid:

    • true

    • false.

    true
    Stat

    string

    No

    Jumlah total dan jumlah pengecualian dalam satu jam terakhir.

    [0,0]
    Liveness

    string

    No

    Tingkat aktivitas integrasi peringatan.

    ready
    FieldRedefineRules

    string

    No

    Pemetaan event yang memetakan bidang sumber ke bidang tujuan. Pemetaan bidang tetap dibuat secara otomatis saat integrasi dibuat. Untuk informasi lebih lanjut, lihat deskripsi tambahan di bawah.

    [ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"alertname", "expression":null, "mappingRuleList":[ ], "name":"告警名称", "integrationId":1234, "jsonPath":"$.alertName", "id":10001, "fieldType":"LABEL" }, { "redefineType":"MAP", "matchExpression":null, "fieldName":"severity", "expression":null, "mappingRuleList":[ { "mappingValue":"critical", "mappingName":"P1", "mappingType":"MAP", "originValue":"CRITICAL" }, { "mappingValue":"error", "mappingName":"P2", "mappingType":"MAP", "originValue":"WARN" }, { "mappingValue":"warning", "mappingName":"P3", "mappingType":"MAP", "originValue":"INFO" } ], "name":"告警等级", "integrationId":1234, "jsonPath":"$.triggerLevel", "id":10002, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"message", "expression":"{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。", "mappingRuleList":[ ], "name":"告警描述", "integrationId":1234, "jsonPath":null, "id":10003, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"value", "expression":null, "mappingRuleList":[ ], "name":"告警样本值", "integrationId":1234, "jsonPath":"$.curValue", "id":10004, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"source", "expression":null, "mappingRuleList":[ ], "name":"来源", "integrationId":1234, "jsonPath":null, "id":10007, "fieldType":"LABEL" }, { "redefineType":"ADD", "matchExpression":null, "fieldName":"generatorUrl", "expression":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "mappingRuleList":[ ], "name":"事件地址", "integrationId":1234, "jsonPath":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "id":10012, "fieldType":"GENERATE_URL" } ]
    ExtendedFieldRedefineRules

    string

    No

    Pemetaan bidang event yang memetakan bidang sumber ke bidang tujuan, dengan bidang tambahan untuk meningkatkan pemetaan bidang. Untuk informasi lebih lanjut, lihat deskripsi tambahan di bawah.

    [ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"dimensions", "expression":null, "mappingRuleList":[ ], "name":"dimensions", "integrationId":1234, "jsonPath":"$.dimensions", "id":10013, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"expression", "expression":null, "mappingRuleList":[ ], "name":"expression", "integrationId":1234, "jsonPath":"$.expression", "id":10014, "fieldType":"LABEL" } ]
    InitiativeRecoverField

    string

    No

    Field pemulihan event peringatan. Setelah sistem menerima event pemulihan, sistem akan mengkueri event peringatan berdasarkan bidang dalam event pemulihan dan memulihkan event peringatan.

    Catatan

    Hanya Simple Log Service yang mendukung pengaturan parameter ini.

    $.status
    InitiativeRecoverValue

    string

    No

    Nilai field pemulihan event peringatan. Setelah sistem menerima event pemulihan, sistem akan mengkueri event peringatan berdasarkan bidang dalam event pemulihan dan memulihkan event peringatan.

    Catatan

    Hanya Simple Log Service yang mendukung pengaturan parameter ini.

    ok

    Deskripsi parameter untuk FieldRedefineRules dan ExtendedFieldRedefineRules

    Berikut adalah contoh lengkap:

    [
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"alertname",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警名称",
        "integrationId":1234,
        "jsonPath":"$.alertName",
        "id":10001,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"MAP",
        "matchExpression":null,
        "fieldName":"severity",
        "expression":null,
        "mappingRuleList":[
            {
                "mappingValue":"critical",
                "mappingName":"P1",
                "mappingType":"MAP",
                "originValue":"CRITICAL"
            },
            {
                "mappingValue":"error",
                "mappingName":"P2",
                "mappingType":"MAP",
                "originValue":"WARN"
            },
            {
                "mappingValue":"warning",
                "mappingName":"P3",
                "mappingType":"MAP",
                "originValue":"INFO"
            }
        ],
        "name":"告警等级",
        "integrationId":1234,
        "jsonPath":"$.triggerLevel",
        "id":10002,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"message",
        "expression":"{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。",
        "mappingRuleList":[

        ],
        "name":"告警描述",
        "integrationId":1234,
        "jsonPath":null,
        "id":10003,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"value",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警样本值",
        "integrationId":1234,
        "jsonPath":"$.curValue",
        "id":10004,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"imageUrl",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警图片",
        "integrationId":1234,
        "jsonPath":null,
        "id":10005,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"check",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"检查项",
        "integrationId":1234,
        "jsonPath":null,
        "id":10006,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"source",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"来源",
        "integrationId":1234,
        "jsonPath":null,
        "id":10007,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"class",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"分类",
        "integrationId":1234,
        "jsonPath":null,
        "id":10008,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"service",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"服务",
        "integrationId":1234,
        "jsonPath":null,
        "id":10009,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"startat",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"开始时间",
        "integrationId":1234,
        "jsonPath":null,
        "id":10010,
        "fieldType":"START_AT"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"endat",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"结束时间",
        "integrationId":1234,
        "jsonPath":null,
        "id":10011,
        "fieldType":"END_AT"
    },
    {
        "redefineType":"ADD",
        "matchExpression":null,
        "fieldName":"generatorUrl",
        "expression":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
        "mappingRuleList":[

        ],
        "name":"事件地址",
        "integrationId":1234,
        "jsonPath":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
        "id":10012,
        "fieldType":"GENERATE_URL"
    }
]

    Deskripsi bidang:

    BidangDeskripsi
    RedefineType- MAP: memetakan bidang melalui tabel pemetaan untuk pemetaan bidang, seperti pemetaan tingkat keparahan peringatan.
    - EXTRACT: mengurai bidang dari JSON menggunakan jsonPath dan memetakannya ke bidang tujuan.
    - ADD: menambahkan konten dan memetakannya ke bidang tujuan.
    - CONDITION: pemetaan bidang bersyarat. Ketika kondisi terpenuhi, mengurai bidang dari JSON menggunakan jsonPath dan memetakannya ke bidang tujuan.
    - CONCAT: pemetaan bidang penggabungan. Menggabungkan beberapa bidang dengan pembatas yang ditentukan dan memetakan hasilnya ke bidang template.
    MatchExpression- Jika RedefineType diatur ke CONCAT, nilai MatchExpression adalah pembatas untuk penggabungan.
    - Jika RedefineType diatur ke CONDITION, nilai MatchExpression adalah string JSON yang menentukan aturan kondisi.
    FieldType- LABEL: metadata peringatan. Sekumpulan label mengidentifikasi event secara unik. Event dengan label yang sama dianggap sebagai event yang sama, dan laporan duplikat digabungkan. Label umum adalah "alertname: nama peringatan".
    - ANNOTATION: anotasi adalah deskripsi tambahan dari event peringatan dan bukan bagian dari metadata. Anotasi umum adalah "message: konten peringatan".
    - GENERATE_URL: URL event.
    - START_AT: pengatur waktu mulai event peringatan.
    - END_AT: pengatur waktu berakhir event peringatan.
    ExpressionPola pemetaan bidang, disimpan sebagai nilai string yang di-escape di Expression.
    MappingRuleListAturan pendefinisian ulang bidang.
    NameNama.
    FieldNameNama bidang.
    JsonPathNama bidang sumber.
    IntegrationIdID integrasi.
    IdID kunci utama tabel penyimpanan pemetaan bidang.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    34ED024E-9E31-434A-9E4E-D9D15C3****
    Integration

    object

    Informasi integrasi.

    IntegrationId

    integer

    ID integrasi peringatan.

    1234
    IntegrationName

    string

    Nama integrasi peringatan.

    云监控集成
    IntegrationProductType

    string

    Tipe produk integrasi. Nilai valid:

    • CLOUD_MONITOR: CloudMonitor

    • LOG_SERVICE: Simple Log Service.

    CLOUD_MONITOR
    Description

    string

    Deskripsi integrasi peringatan.

    测试
    ApiEndpoint

    string

    Titik akhir integrasi.

    https://alerts.aliyuncs.com/api/v1/integrations/custom/ymQBN******
    ShortToken

    string

    Token integrasi.

    ymQBN******
    AutoRecover

    boolean

    Apakah event peringatan akan dipulihkan secara otomatis. Nilai valid:

    • true (default)

    • false.

    true
    RecoverTime

    integer

    Pengatur waktu pemulihan otomatis untuk event peringatan. Nilai default: 300. Unit: seconds.

    300
    DuplicateKey

    string

    Bidang deduplikasi.

    LABEL.dimensions::LABEL.ruleId
    State

    boolean

    Apakah integrasi peringatan diaktifkan. Nilai valid:

    • true

    • false.

    true
    Stat

    array

    Jumlah total dan jumlah pengecualian dalam satu jam terakhir.

    integer

    Jumlah total dan jumlah pengecualian dalam satu jam terakhir.

    [0,0]
    Liveness

    string

    Tingkat aktivitas integrasi peringatan.

    ready
    FieldRedefineRules

    array<object>

    Bidang pemetaan tetap.

    object

    Pemetaan event yang memetakan bidang sumber ke bidang tujuan. Pemetaan bidang tetap dibuat secara otomatis saat integrasi dibuat.

    [ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"alertname", "expression":null, "mappingRuleList":[ ], "name":"告警名称", "integrationId":1234, "jsonPath":"$.alertName", "id":10001, "fieldType":"LABEL" }, { "redefineType":"MAP", "matchExpression":null, "fieldName":"severity", "expression":null, "mappingRuleList":[ { "mappingValue":"critical", "mappingName":"P1", "mappingType":"MAP", "originValue":"CRITICAL" }, { "mappingValue":"error", "mappingName":"P2", "mappingType":"MAP", "originValue":"WARN" }, { "mappingValue":"warning", "mappingName":"P3", "mappingType":"MAP", "originValue":"INFO" } ], "name":"告警等级", "integrationId":1234, "jsonPath":"$.triggerLevel", "id":10002, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"message", "expression":"{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。", "mappingRuleList":[ ], "name":"告警描述", "integrationId":1234, "jsonPath":null, "id":10003, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"value", "expression":null, "mappingRuleList":[ ], "name":"告警样本值", "integrationId":1234, "jsonPath":"$.curValue", "id":10004, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"source", "expression":null, "mappingRuleList":[ ], "name":"来源", "integrationId":1234, "jsonPath":null, "id":10007, "fieldType":"LABEL" }, { "redefineType":"ADD", "matchExpression":null, "fieldName":"generatorUrl", "expression":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "mappingRuleList":[ ], "name":"事件地址", "integrationId":1234, "jsonPath":"https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "id":10012, "fieldType":"GENERATE_URL" } ]
    ExtendedFieldRedefineRules

    array<object>

    Bidang pemetaan tambahan.

    object

    Pemetaan bidang event yang memetakan bidang sumber ke bidang tujuan, dengan bidang tambahan untuk meningkatkan pemetaan bidang.

    [ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"dimensions", "expression":null, "mappingRuleList":[ ], "name":"dimensions", "integrationId":1234, "jsonPath":"$.dimensions", "id":10013, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"expression", "expression":null, "mappingRuleList":[ ], "name":"expression", "integrationId":1234, "jsonPath":"$.expression", "id":10014, "fieldType":"LABEL" } ]
    InitiativeRecoverField

    string

    Field pemulihan event peringatan. Setelah sistem menerima event pemulihan, sistem akan mengkueri event peringatan berdasarkan bidang dalam event pemulihan dan memulihkan event peringatan.

    Catatan

    Hanya Simple Log Service yang mendukung parameter ini.

    $.status
    InitiativeRecoverValue

    string

    Nilai field pemulihan event peringatan. Setelah sistem menerima event pemulihan, sistem akan mengkueri event peringatan berdasarkan bidang dalam event pemulihan dan memulihkan event peringatan.

    Catatan

    Hanya Simple Log Service yang mendukung parameter ini.

    ok

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "34ED024E-9E31-434A-9E4E-D9D15C3****",
  "Integration": {
    "IntegrationId": 1234,
    "IntegrationName": "云监控集成",
    "IntegrationProductType": "CLOUD_MONITOR",
    "Description": "测试",
    "ApiEndpoint": "https://alerts.aliyuncs.com/api/v1/integrations/custom/ymQBN******",
    "ShortToken": "ymQBN******",
    "AutoRecover": true,
    "RecoverTime": 300,
    "DuplicateKey": "LABEL.dimensions::LABEL.ruleId",
    "State": true,
    "Stat": [
      0
    ],
    "Liveness": "ready",
    "FieldRedefineRules": [
      [
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "alertname",
          "expression": null,
          "mappingRuleList": [],
          "name": "告警名称",
          "integrationId": 1234,
          "jsonPath": "$.alertName",
          "id": 10001,
          "fieldType": "LABEL"
        },
        {
          "redefineType": "MAP",
          "matchExpression": null,
          "fieldName": "severity",
          "expression": null,
          "mappingRuleList": [
            {
              "mappingValue": "critical",
              "mappingName": "P1",
              "mappingType": "MAP",
              "originValue": "CRITICAL"
            },
            {
              "mappingValue": "error",
              "mappingName": "P2",
              "mappingType": "MAP",
              "originValue": "WARN"
            },
            {
              "mappingValue": "warning",
              "mappingName": "P3",
              "mappingType": "MAP",
              "originValue": "INFO"
            }
          ],
          "name": "告警等级",
          "integrationId": 1234,
          "jsonPath": "$.triggerLevel",
          "id": 10002,
          "fieldType": "LABEL"
        },
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "message",
          "expression": "{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。",
          "mappingRuleList": [],
          "name": "告警描述",
          "integrationId": 1234,
          "jsonPath": null,
          "id": 10003,
          "fieldType": "ANNOTATION"
        },
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "value",
          "expression": null,
          "mappingRuleList": [],
          "name": "告警样本值",
          "integrationId": 1234,
          "jsonPath": "$.curValue",
          "id": 10004,
          "fieldType": "ANNOTATION"
        },
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "source",
          "expression": null,
          "mappingRuleList": [],
          "name": "来源",
          "integrationId": 1234,
          "jsonPath": null,
          "id": 10007,
          "fieldType": "LABEL"
        },
        {
          "redefineType": "ADD",
          "matchExpression": null,
          "fieldName": "generatorUrl",
          "expression": "https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
          "mappingRuleList": [],
          "name": "事件地址",
          "integrationId": 1234,
          "jsonPath": "https://cloudmonitor.console.alibabacloud.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
          "id": 10012,
          "fieldType": "GENERATE_URL"
        }
      ]
    ],
    "ExtendedFieldRedefineRules": [
      [
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "dimensions",
          "expression": null,
          "mappingRuleList": [],
          "name": "dimensions",
          "integrationId": 1234,
          "jsonPath": "$.dimensions",
          "id": 10013,
          "fieldType": "LABEL"
        },
        {
          "redefineType": "EXTRACT",
          "matchExpression": null,
          "fieldName": "expression",
          "expression": null,
          "mappingRuleList": [],
          "name": "expression",
          "integrationId": 1234,
          "jsonPath": "$.expression",
          "id": 10014,
          "fieldType": "LABEL"
        }
      ]
    ],
    "InitiativeRecoverField": "$.status",
    "InitiativeRecoverValue": "ok"
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.