DescribeAbnormalCloudResources - 查询防护异常状态的云产品接入

查询异常的云产品接入资源。

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-waf:DescribeAbnormalCloudResources

none

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

WAF 实例 ID。

说明

您可以通过调用 DescribeInstance 接口查看当前 WAF 实例 ID。

waf_v3prepaid_public_cn-***

RegionId

string

WAF 实例所属地域。取值:

  • cn-hangzhou:表示中国内地。

  • ap-southeast-1:表示非中国内地。

cn-hangzhou

ResourceManagerResourceGroupId

string

阿里云资源组 ID。

rg-acfm***q

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

66A98669-CC6E-4F3E-80A6-***

AbnormalCloudResources

array

异常状态的云产品接入信息

object

异常状态的云产品接入信息

ResourceInstanceId

string

已接入 WAF 的实例 ID。

lb-***

ResourceInstancePort

integer

已接入 WAF 的实例端口。

80

ResourceInstanceName

string

已接入 WAF 的实例名称。

test-name

ResourceProduct

string

资源所属云产品,默认返回 ALB、MSE、FC 和 SAE 产品的实例,取值:

  • alb:表示 ALB 产品。

  • mse:表示 MSE 产品。

  • fc:表示 FC 产品。

  • sae:表示 SAE 产品。

  • ecs:表示 ECS 产品。

  • clb4:表示 CLB(TCP)产品。

  • clb7:表示 CLB(HTTP/HTTPS)产品。

  • nlb:表示 NLB 产品。

说明

每个产品支持的地域不同,产品筛选字段有值时,需要参考地域支持的产品,否则可能导致筛选失败。

clb7

Reason

string

异常原因,取值:

  • InvalidCert:表示无效证书。

  • ClientCertOpend:表示开启了双向认证。

  • NetworkConfigLost:表示网络异常。

  • UserUploadCert:表示存在用户上传的证书。

  • CertNotExistInCertCenter:表示证书 ID 在数字证书管理服务不存在。

  • CertExpired:表示证书过期。

  • EmptyCertCN:表示 CommonName 空。

CertExpired

Details

array

异常的具体信息。

object

异常的具体信息。

Code

string

异常原因,取值:

InvalidCert:表示无效证书。

ClientCertOpend:表示开启了双向认证。

NetworkConfigLost:表示网络异常。

UserUploadCert:表示存在用户上传的证书。

CertNotExistInCertCenter:表示证书 ID 在数字证书管理服务不存在。

CertExpired:表示证书过期。

EmptyCertCN:表示 CommonName 空。

CertExpired

CertName

string

数字证书管理服务的证书名称。

test-name

ProductCertId

string

在云产品控制台配置的证书 ID。

123-cn-hangzhou

ProductCertName

string

在云产品控制台配置证书的证书名称。

test-cert-name

ProductDomainExtension

string

云产品控制台配置的扩展域名。

www.test.com

AppliedType

string

HTTPS 协议的证书类型。取值:

  • default:表示默认证书。

  • extension:表示拓展证书。

default

CommonName

string

通用名称(CN)。

www.test.com

ExpireTime

integer

证书的到期时间。使用时间戳表示,单位:毫秒。

1735009193

示例

正常返回示例

JSON格式

{
  "RequestId": "66A98669-CC6E-4F3E-80A6-***",
  "AbnormalCloudResources": [
    {
      "ResourceInstanceId": "lb-***",
      "ResourceInstancePort": 80,
      "ResourceInstanceName": "test-name",
      "ResourceProduct": "clb7",
      "Reason": "CertExpired",
      "Details": [
        {
          "Code": "CertExpired",
          "CertName": "test-name",
          "ProductCertId": "123-cn-hangzhou",
          "ProductCertName": "test-cert-name",
          "ProductDomainExtension": "www.test.com",
          "AppliedType": "default",
          "CommonName": "www.test.com\n",
          "ExpireTime": 1735009193
        }
      ]
    }
  ]
}

错误码

HTTP status code

错误码

错误信息

描述

400 Waf.Pullin.CertNotExist Certificate does not exist in SSL Certificate Center, certificate type:%s, certificate ID:%s. 证书在SSL证书中心不存在,证书类型:%s,证书ID:%s。
400 Waf.Pullin.ResourceNotExist The accessed resource already exists. Resource:%s. 接入的资源已存在,资源:%s.
400 Waf.Pullin.AlreadyAccessed The cloud product has been accessed. Instance ID:%s, Port:%s, Product Type:%s. 云产品已接入,实例ID:%s,端口:%s,产品类型:%s.

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

变更历史

更多信息,参考变更详情