全部产品
Search

搜索本产品

    云安全中心：DescribeClusterNetwork - 查询集群维度的网络拓扑边信息

    文档中心

    云安全中心：DescribeClusterNetwork - 查询集群维度的网络拓扑边信息

    更新时间：Nov 25, 2024

    查询集群维度的网络拓扑边信息。

    调试

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

    授权信息

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

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    yundun-sas:DescribeClusterNetworkget
    *全部资源
    *
      无
    		无

    请求参数

    名称类型必填描述示例值
    StartTimelong是

    开始时间的时间戳。单位：毫秒。

    说明 开始时间戳和结束时间戳不能超过 7 天。
    		1656038740435
    EndTimelong是

    结束时间的时间戳。单位：毫秒。

    说明 开始时间戳和结束时间戳相差不能超过 7 天。
    		1656038940435

    返回参数

    名称类型描述示例值
    object

    请求返回数据。

    RequestIdstring

    本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。

    		C286491D-4A2F-589A-B63B-D2AD3DA9BD71
    ClusterNetworkobject

    集群维度的网络拓扑边信息列表。

    Nodearray<object>

    节点信息列表。

    ClusterNodeobject

    节点信息。

    Typestring

    节点类型。取值：

    • cluster：集群。
    • internet：集群外部网络节点。
    		cluster
    RiskLevelstring

    风险等级。取值：

    • 3：高危。
    • 2：中危。
    • 1：低危。
    • 0：安全。
    • -1：未知。
    		3
    NetTopoSwitchstring

    网络拓扑开关。取值：

    • ON：开启。
    • OFF：关闭。
    		ON
    InterceptionTypeinteger

    网络类型。取值：

    • 0：经典网络。
    • 1：专有网络。
    		1
    CnnfSwitchinteger

    微隔离开关。取值：

    • 0：关闭。
    • 1：开启。
    		1
    Namestring

    节点名称。

    		testwww
    Idstring

    节点编号。

    		cfeb7a9f99ce740e98c5595d0fe37****
    Edgearray<object>

    拓扑边信息列表。

    BasicEdgeobject

    拓扑边信息。

    DstNodeIdstring

    目的节点 ID。

    		cfb41a869c71e4678a97021582dd8****
    Portstring

    拓扑边的端口号。

    		6164
    SrcNodeIdstring

    源节点 ID。

    		cfb41a869c71e4678a97021582dd8****
    SrcNodeTypestring

    源节点类型。

    • cluster：集群。
    • internet：外部网络节点。
    		cluster
    DstNodeTypestring

    目的节点类型。

    • cluster：集群。
    		cluster
    Idstring

    拓扑边的编号。

    		1

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "C286491D-4A2F-589A-B63B-D2AD3DA9BD71",
  "ClusterNetwork": {
    "Node": [
      {
        "Type": "cluster",
        "RiskLevel": "3",
        "NetTopoSwitch": "ON",
        "InterceptionType": 1,
        "CnnfSwitch": 1,
        "Name": "testwww",
        "Id": "cfeb7a9f99ce740e98c5595d0fe37****\n"
      }
    ],
    "Edge": [
      {
        "DstNodeId": "cfb41a869c71e4678a97021582dd8****",
        "Port": "6164",
        "SrcNodeId": "cfb41a869c71e4678a97021582dd8****",
        "SrcNodeType": "cluster",
        "DstNodeType": "cluster",
        "Id": "1"
      }
    ]
  }
}

    错误码

    HTTP status code错误码错误信息描述
    403NoPermissioncaller has no permission当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
    500ServerErrorServerError服务故障，请稍后重试！

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