有奖征文:轻量对象存储LighthouseCOS用户实践> HOT

1. 接口描述

接口请求域名: monitor.tencentcloudapi.com 。

创建集成中心 exporter 集成,因集成较多,建议控制台创建集成。(前提:已授权创建托管 EKS 集群,验证方式:1. 控制台界面确认,未提示授权则表示已授权创建;2. 通过 DescribePrometheusInstanceInitStatus 接口查询集群状态,如果托管集群不存在,可通过 RunPrometheusInstance 接口创建)

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateExporterIntegration。
Version String 公共参数,本接口取值:2018-07-24。
Region String 公共参数,详见产品支持的 地域列表
InstanceId String 实例 ID
示例值:prom-xx
Kind String 类型(可通过 DescribePrometheusIntegrations 接口获取,取每一项中的 ExporterType 字段)
示例值:mysql-exporter
Content String 集成配置
示例值:{"name":"test","kind":"blackbox-exporter","spec":{"instanceSpec":{"module":"http_get","urls":["http://abc"]}}}
KubeType Integer Kubernetes 集群类型,可不填,取值如下:
  • 1= 容器集群(TKE)
  • 2=弹性集群(EKS)
  • 3= Prometheus管理的弹性集群(MEKS)

  • 示例值:3
    ClusterId String 集群 ID,可不填
    示例值:cls-xx

    3. 输出参数

    参数名称 类型 描述
    Names Array of String 返回创建成功的集成名称列表
    RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 创建 blackbox-exporter 集成

    输入示例

    POST / HTTP/1.1
    Host: monitor.tencentcloudapi.com
    Content-Type: application/json
    X-TC-Action: CreateExporterIntegration
    <公共请求参数>
    
    {
        "InstanceId": "prom-1",
        "Kind": "blackbox-exporter",
        "Content": "{\"name\":\"test\",\"kind\":\"blackbox-exporter\",\"spec\":{\"instanceSpec\":{\"module\":\"http_get\",\"urls\":[\"http://abc\"]}}}"
    }

    输出示例

    {
        "Response": {
            "Names": [
                "test"
            ],
            "RequestId": "xyz"
        }
    }

    5. 开发者资源

    腾讯云 API 平台

    腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

    API Inspector

    用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

    SDK

    云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

    命令行工具

    6. 错误码

    以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

    错误码 描述
    AuthFailure CAM签名/鉴权错误。
    AuthFailure.UnauthorizedOperation 请求未授权。请参考 CAM 文档对鉴权的说明。
    FailedOperation 操作失败。
    FailedOperation.AccessTKEFail 访问用户TKE集群失败。
    FailedOperation.ClusterNotFound 集群不存在。
    FailedOperation.DbQueryFailed 数据库查询失败。
    FailedOperation.InstanceNotRunning 实例没有运行。
    FailedOperation.ResourceExist 资源已经存在。
    FailedOperation.ResourceNotFound 资源不存在。
    FailedOperation.ResourceOperating 资源正在被操作。
    FailedOperation.TKEResourceConflict 更新TKE资源时出现冲突。
    InternalError 内部错误。