DescribeNetworkInterfacePermissions - 查询授权给认证ISV或个人的弹性网卡权限-云服务器 ECS(ECS)-阿里云帮助中心

调用DescribeNetworkInterfacePermissions查询您授权给阿里云合作伙伴（认证ISV）或者个人用户的弹性网卡权限列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeNetworkInterfacePermissions

get

NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	弹性网卡权限的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
RegionId	string	是	弹性网卡权限的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
NetworkInterfaceId	string	否	弹性网卡 ID。您必须指定`NetworkInterfaceId`或`NetworkInterfacePermissionId.N`确定查询范围。	eni-bp17pdijfczax****
PageNumber	integer	否	弹性网卡权限列表的页码。起始值：1 默认值：1	1
PageSize	integer	否	分页查询时设置的每页行数。最大值：100 默认值：10	10
NetworkInterfacePermissionId	array	否	弹性网卡权限 ID 列表。列表元素数量：1~100。	eni-perm-bp1cs4lwn56lfb****
	string	否	弹性网卡权限 ID。	eni-perm-bp1cs4lwn56lfb****

返回参数

名称	类型	描述	示例值
	object
PageSize	integer	分页查询时的每页行数。	10
RequestId	string	请求 ID。	0FCD3DEF-63D3-4605-A818-805C8BD7DB87
PageNumber	integer	列表的页码。	1
TotalCount	integer	查询到的条目总数。	1
NetworkInterfacePermissions	object
NetworkInterfacePermission	array<object>	弹性网卡权限列表组成的信息集合。
	object
Permission	string	弹性网卡权限。	InstanceAttach
NetworkInterfaceId	string	弹性网卡 ID。	eni-bp14v2sdd3v8htln****
AccountId	integer	阿里云合作伙伴（认证 ISV）账号 ID 或个人用户 ID。	1234567890
NetworkInterfacePermissionId	string	弹性网卡权限 ID。	eni-perm-bp1cs4lwn56lfb****
ServiceName	string	阿里云服务名称。	Elastic Compute Service
PermissionState	string	弹性网卡权限状态。可能值： Pending：授权中 Granted：已授权 Revoking：撤销授权中 Revoked：已撤销授权	Granted

示例

正常返回示例

JSON格式

{
  "PageSize": 10,
  "RequestId": "0FCD3DEF-63D3-4605-A818-805C8BD7DB87",
  "PageNumber": 1,
  "TotalCount": 1,
  "NetworkInterfacePermissions": {
    "NetworkInterfacePermission": [
      {
        "Permission": "InstanceAttach",
        "NetworkInterfaceId": "eni-bp14v2sdd3v8htln****",
        "AccountId": 1234567890,
        "NetworkInterfacePermissionId": "eni-perm-bp1cs4lwn56lfb****",
        "ServiceName": "Elastic Compute Service",
        "PermissionState": "Granted"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingParameter	%s	缺失参数，请检查参数是否完整。
400	UnsupportedParameter	%s	不支持参数。
400	InvalidParameter	%s	无效的参数。
400	InvalidInstanceID.Malformed	%s	参数 InstanceId 格式错误。
400	InvalidOperation.InvalidEniState	%s	弹性网卡当前的状态不支持此操作。
400	NotBelongUser	%s	您没有权限操作此资源，请检查操作的资源是否正确。
400	InvalidOperation.PermissionExisted	%s	此网卡授权NetworkInterfacePermission已经存在。
403	InvalidUserType.NotSupported	%s	您当前的账号不支持此操作。
403	Abs.InvalidAccount.NotFound	%s	您的阿里云账号不存在，或者您的 AccessKey 已经过期。
403	Forbidden.NotSupportRAM	%s	暂不支持RAM用户执行该操作。
403	Forbidden.SubUser	%s	您的账号没有操作此资源的权限，请向主账号申请相关的权限。
404	InvalidOperation.PermissionNotExisted	%s	您的操作无效，请先申请相关权限。
404	InvalidEniId.NotFound	%s

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

变更历史

更多信息，参考变更详情。