ListNetworkAccessEndpoints - 查询网络端点列表

更新时间:
复制 MD 格式

查询IDaaS EIAM实例下的网络端点列表。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eiam:ListNetworkAccessEndpoints

get

*NetworkAccessEndpoint

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/networkaccessendpoint/*

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

NextToken

string

查询凭证(Token),取值为上一次 API 调用返回的 NextToken 参数值。首次查询为空。

NTxxxxxexample

MaxResults

integer

分页查询时每页行数。最大值为 100。

20

NetworkAccessEndpointType

string

网络端点的类型,取值可选范围:

  • shared:共享网络端点;

  • private:专属网络端点;

默认值为 private。

private

VpcId

string

专属网络端点连接的 VPC ID。NetworkAccessEndpointType 取值为 shared 时不生效。

vpc-examplexxx

VpcRegionId

string

专属网络端点连接的 VPC 所属地域,该地域取值必须在 ListNetworkAccessEndpointAvailableRegions 接口中返回。NetworkAccessEndpointType 取值为 shared 时不生效。

cn-hangzhou

NetworkAccessEndpointStatus

string

网络端点的状态,取值可选范围:

  • pending:待初始化。

  • creating:创建中。

  • running:运行中。

  • deleting:删除中。

NetworkAccessEndpointType 取值为 shared 时,当前筛选参数不生效。

running

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

0441BD79-92F3-53AA-8657-F8CE4A2B912A

TotalCount

integer

列表总条数目。

100

NextToken

string

本次调用返回的查询凭证(Token)值。

NTxxxexample

NetworkAccessEndpoints

array<object>

网络端点集合。

array<object>

网络端点信息。

InstanceId

string

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

NetworkAccessEndpointId

string

网络端点 ID。

nae_examplexxx

NetworkAccessEndpointName

string

网络端点名称。xx 业务 VPC 访问端点。

VPC access endpoint for xx service

VpcId

string

专属网络端点连接的 VPC ID。

vpc-examplexxx

VpcRegionId

string

专属网络端点连接的 VPC 所属地域。

cn-hangzhou

VSwitchIds

array

专属网络端点连接的指定 vSwitch 列表。

vsw-examplexxx

string

交换机 ID。

vsw-2vc8z0f90z4k6xxxxx

SecurityGroupId

string

专属网络端点使用的安全组 ID。

sg-examplexxx

Status

string

网络端点的状态,取值可选范围:

  • pending:待初始化。

  • creating:创建中。

  • running:运行中。

  • deleting:删除中。

running

NetworkAccessEndpointType

string

网络端点的类型,取值可选范围:

  • shared:共享网络端点。

  • private:专属网络端点。

private

CreateTime

integer

网络端点创建时间。Unix 时间戳格式,单位为毫秒。

1649830226000

UpdateTime

integer

网络端点最近更新时间。Unix 时间戳格式,单位为毫秒。

1649830226000

BackupVpcEndpoint

object

BackupVpcRegionId

string

BackupVpcId

string

BackupVSwitchIds

array

string

BackupSecurityGroupId

string

BackupEgressPublicIpAddresses

array

string

BackupEgressPrivateIpAddresses

array

string

示例

正常返回示例

JSON格式

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 100,
  "NextToken": "NTxxxexample",
  "NetworkAccessEndpoints": [
    {
      "InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "NetworkAccessEndpointId": "nae_examplexxx",
      "NetworkAccessEndpointName": "VPC access endpoint for xx service",
      "VpcId": "vpc-examplexxx",
      "VpcRegionId": "cn-hangzhou",
      "VSwitchIds": [
        "vsw-2vc8z0f90z4k6xxxxx"
      ],
      "SecurityGroupId": "sg-examplexxx",
      "Status": "running",
      "NetworkAccessEndpointType": "private",
      "CreateTime": 1649830226000,
      "UpdateTime": 1649830226000,
      "BackupVpcEndpoint": {
        "BackupVpcRegionId": "",
        "BackupVpcId": "",
        "BackupVSwitchIds": [
          ""
        ],
        "BackupSecurityGroupId": "",
        "BackupEgressPublicIpAddresses": [
          ""
        ],
        "BackupEgressPrivateIpAddresses": [
          ""
        ]
      }
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情