全部产品
Search
文档中心

可观测监控 Prometheus 版:DescribeEnvironmentFeature - 查询Feature详情

更新时间:Nov 05, 2024

查询Feature详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
arms:DescribeEnvironmentFeaturenone
  • Environment
    acs:arms:{#regionId}:{#accountId}:environment/{#environmentId}

请求参数

名称类型必填描述示例值
EnvironmentIdstring

环境 ID。

env-xxx
RegionIdstring

地域 ID。

cn-hangzhou
FeatureNamestring

Feature 的名称。

枚举值:
  • app-agent-pilotApp Pilot 探针
  • arms-cmonitorARMS CMonitor 探针
  • metric-agentPrometheus 探针
metric-agent
AliyunLangstring

语言参数,en | zh。

zh

FeatureName 可通过ListEnvironmentFeatures查询可安装的 Feature 信息。

返回参数

名称类型描述示例值
object

response

RequestIdstring

Id of the request

01FF8DD9-A09C-47A1-895A-B6E321BE77B6
Codeinteger

状态码。200 表示成功。

200
Messagestring

返回结果的提示信息。

success
Successboolean

查询是否成功:true:成功。 false:失败。

true
Dataobject

返回结构体。

Featureobject

Feature 安装信息。

Aliasstring

Feature 别名。

Prometheus 探针
Configobject

Feature 配置。

string

Feature 配置信息。

{}
Descriptionstring

Feature 描述。

以 Prometheus 采集规范采集 Metric 数据。
EnvironmentIdstring

环境 ID。

env-xxxxx
Iconstring

图标地址。

http://xxx
Languagestring

语言。

zh
LatestVersionstring

最新版本号。

1.1.17
Namestring

Feature 名称。

metric-agent
Statusstring

安装状态。

  • Installing 正在安装
  • Success 安装成功
  • Failed 安装失败
  • UnInstall 已卸载或未安装
  • UnInstalling 正在卸载
  • UnInstallFailed 卸载失败
枚举值:
  • UnInstall未安装或已卸载
  • Failed安装失败
  • Installing正在安装
  • UnInstallFailed卸载失败
  • Success安装成功
  • UnInstalling正在卸载
Success
Versionstring

版本。

1.1.17
Managedboolean

是否为托管组件。

FeatureStatusobject

Feature 的运行状态。

FeatureContainersarray<object>

Feature 的容器列表。

featureContainersobject

Feature 的容器信息。

Argsarray

容器参数。

argsstring

参数值。

[ "--port=9335", "--yaml=/etc/config/prometheusDisk/prometheus.yaml", "--chartVersion=1.1.17" ]
Imagestring

容器镜像。

registry-cn-hangzhou-vpc.ack.aliyuncs.com/acs/arms-prometheus-agent:v4.0.0
Namestring

容器名称。

arms-prometheus-operator
Namestring

Feature 的 K8s 资源名称。

arms-prometheus-ack-arms-prometheus
Namespacestring

命名空间。

arms-prom
Statusstring

运行状态。

  • Success 运行正常
  • Failed 运行异常
  • Not Found 未安装
Success
SecurityGroupIdstring

安全组 ID。

sg-bp1gbhqh8b4dsgvopkry
VSwitchIdstring

交换机 ID。

vsw-uf6vc2e4ytv8vv05j3u09
BindResourceIdstring

绑定的资源 ID。

c013823b55e4b4d6bb6b6f28682bd38a7
Ipsarray

Pod 的 IP 地址。

ipsstring

对应的 IP。

10.178.176.187

示例

正常返回示例

JSON格式

{
  "RequestId": "01FF8DD9-A09C-47A1-895A-B6E321BE77B6",
  "Code": 200,
  "Message": "success",
  "Success": true,
  "Data": {
    "Feature": {
      "Alias": "Prometheus 探针",
      "Config": {
        "key": "{}"
      },
      "Description": "以 Prometheus 采集规范采集 Metric 数据。",
      "EnvironmentId": "env-xxxxx",
      "Icon": "http://xxx",
      "Language": "zh",
      "LatestVersion": "1.1.17",
      "Name": "metric-agent",
      "Status": "Success",
      "Version": "1.1.17",
      "Managed": true
    },
    "FeatureStatus": {
      "FeatureContainers": [
        {
          "Args": [
            "[\n    \"--port=9335\",\n    \"--yaml=/etc/config/prometheusDisk/prometheus.yaml\",\n    \"--chartVersion=1.1.17\"\n  ]"
          ],
          "Image": "registry-cn-hangzhou-vpc.ack.aliyuncs.com/acs/arms-prometheus-agent:v4.0.0",
          "Name": "arms-prometheus-operator"
        }
      ],
      "Name": "arms-prometheus-ack-arms-prometheus",
      "Namespace": "arms-prom",
      "Status": "Success",
      "SecurityGroupId": "sg-bp1gbhqh8b4dsgvopkry",
      "VSwitchId": "vsw-uf6vc2e4ytv8vv05j3u09",
      "BindResourceId": "c013823b55e4b4d6bb6b6f28682bd38a7",
      "Ips": [
        "10.178.176.187"
      ]
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-05-23OpenAPI 返回结构发生变更查看变更详情
2024-05-07OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-01-23OpenAPI 返回结构发生变更查看变更详情