Consulta os detalhes de uma elastic network interface (ENI).
Depuração
Parâmetros de solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Sim | DescribeNetworkInterfaceAttribute | A operação a ser executada. Defina o valor como DescribeNetworkInterfaceAttribute. |
| RegionId | String | Sim | cn-hangzhou | O ID da região da ENI. Chame a operação DescribeRegions para consultar a lista de regiões mais recente. |
| Tag.N.Key | String | Não | TestKey | Nota Este parâmetro não está disponível publicamente. |
| Tag.N.Value | String | Não | TestValue | Nota Este parâmetro não está disponível publicamente. |
| NetworkInterfaceId | String | Sim | eni-bp67acfmxazb4p**** | O ID da ENI. |
| Attribute | String | Não | test | O atributo da ENI. |
Parâmetros de resposta
Parâmetro |
Tipo |
Exemplo |
Descrição |
| CreationTime | String | 2019-12-25T12:31:31Z | O horário de criação da ENI. |
| VpcId | String | vpc-bp67acfmxazb4p**** | O ID da virtual private cloud (VPC) à qual a ENI pertence. |
| Type | String | Secondary | O tipo da ENI. Valores válidos:
|
| Status | String | Available | O estado da ENI. Valores válidos:
Por padrão, este parâmetro fica vazio, o que indica que ENIs em todos os estados são consultadas. |
| NetworkInterfaceTrafficMode | String | Standard | O modo de comunicação da ENI. Valores válidos:
Nota O parâmetro só pode ter o valor HighPerformance quando a ENI estiver associada a uma instância c7re aprimorada para RDMA residente na Zona K de Pequim. |
| NetworkInterfaceName | String | my-eni-name | O nome da ENI. |
| MacAddress | String | 00:16:3e:12:**:** | O endereço media access control (MAC) da ENI. |
| QueuePairNumber | Integer | 22 | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| NetworkInterfaceId | String | eni-bp125p95hhdhn3ot**** | O ID da ENI. |
| ServiceID | Long | 12345678910 | O ID do distribuidor ao qual a ENI pertence. |
| InstanceId | String | i-bp1e2l6djkndyuli**** | O ID da instância à qual a ENI está associada. Nota Se outros serviços da Alibaba Cloud gerenciarem e controlarem a ENI, nenhum ID de instância será retornado. |
| OwnerId | String | 123456**** | O ID da conta à qual a ENI pertence. |
| ServiceManaged | Boolean | true | Indica se o usuário da ENI é um serviço da Alibaba Cloud ou um distribuidor. |
| VSwitchId | String | vsw-bp1s5fnvk4gn2tws0**** | O ID do vSwitch ao qual a ENI está conectada. |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | O ID da solicitação. |
| Description | String | testDescription | A descrição da ENI. |
| ResourceGroupId | String | rg-bp67acfmxazb4p**** | O ID do grupo de recursos ao qual a instância associada pertence. Se este parâmetro for especificado para consultar recursos, até 1.000 recursos pertencentes ao grupo de recursos especificado serão retornados. Nota Os recursos no grupo de recursos padrão aparecem na resposta independentemente de como este parâmetro esteja configurado. |
| ZoneId | String | cn-hangzhou-g | O ID da zona da ENI. |
| PrivateIpAddress | String | 10.1.**.** | O endereço IP privado da ENI. |
| QueueNumber | Integer | 8 | O número de filas suportadas pela ENI.
|
| SecurityGroupIds | Array of String | sg-bp18kz60mefsicfg**** | Os IDs dos grupos de segurança aos quais a ENI pertence. |
| AssociatedPublicIp | Object | O elastic IP address (EIP) associado ao endereço IP privado secundário da ENI. |
|
| PublicIpAddress | String | 116.62.**.** | O EIP da ENI. |
| AllocationId | String | null | O ID do EIP. |
| Attachment | Object | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
|
| DeviceIndex | Integer | hide | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| InstanceId | String | hide | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| TrunkNetworkInterfaceId | String | hide | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| MemberNetworkInterfaceIds | Array of String | hide | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| NetworkCardIndex | Integer | 0 | O índice da placa de rede.
|
| PrivateIpSets | Array of PrivateIpSet | Os endereços IP privados. |
|
| PrivateIpSet | |||
| PrivateIpAddress | String | 172.17.**.** | O endereço IP privado da ENI. |
| Primary | Boolean | true | Indica se o endereço IP é o endereço IP privado primário. Valores válidos:
|
| AssociatedPublicIp | Object | Detalhes sobre o EIP associado ao endereço IP privado secundário da ENI. |
|
| PublicIpAddress | String | 116.62.**.** | O EIP. |
| AllocationId | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| Ipv6Sets | Array of Ipv6Set | Os endereços IPv6 da ENI. |
|
| Ipv6Set | |||
| Ipv6Address | String | 2001:db8:1234:1a00::**** | O endereço IPv6 atribuído à ENI. |
| Ipv4PrefixSets | Array of Ipv4PrefixSet | Os prefixos IPv4 da ENI. |
|
| Ipv4PrefixSet | |||
| Ipv4Prefix | String | 192.168.**.0/28 | O prefixo IPv4 atribuído à ENI. |
| Ipv6PrefixSets | Array of Ipv6PrefixSet | Os prefixos IPv6 da ENI. |
|
| Ipv6PrefixSet | |||
| Ipv6Prefix | String | 2001:db8:1234:1a00:****::/80 | O prefixo IPv6 atribuído à ENI. |
| Tags | Array of Tag | As tags da ENI. |
|
| Tag | |||
| TagValue | String | TestValue | O valor da tag da ENI. |
| TagKey | String | TestKey | A chave da tag da ENI. |
| BondInterfaceSpecification | Object | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
|
| BondMode | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| SlaveInterfaceSpecification | Array of SlaveInterfaceSpecificationSet | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
|
| SlaveInterfaceSpecificationSet | |||
| SlaveNetworkInterfaceId | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| WorkState | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| BondNetworkInterfaceId | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| SlaveInterfaceSpecification | Object | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
|
| SlaveNetworkInterfaceId | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| WorkState | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| BondNetworkInterfaceId | String | null | Nota Este parâmetro está em visualização por convite e não está disponível publicamente. |
| DeleteOnRelease | Boolean | true | Indica se a ENI deve ser mantida quando a instância associada for liberada. Valores válidos:
|
Exemplos
Exemplos de solicitações
http(s)://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Attribute=test
&<Common request parameters>
Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeNetworkInterfaceAttributeResponse>
<CreationTime>2019-12-25T12:31:31Z</CreationTime>
<VpcId>vpc-bp67acfmxazb4p****</VpcId>
<Type>Secondary</Type>
<Status>Available</Status>
<NetworkInterfaceTrafficMode>Standard</NetworkInterfaceTrafficMode>
<NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
<MacAddress>00:16:3e:12:**:**</MacAddress>
<QueuePairNumber>22</QueuePairNumber>
<NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
<ServiceID>12345678910</ServiceID>
<InstanceId>i-bp1e2l6djkndyuli****</InstanceId>
<OwnerId>123456****</OwnerId>
<ServiceManaged>true</ServiceManaged>
<VSwitchId>vsw-bp1s5fnvk4gn2tws0****</VSwitchId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<Description>testDescription</Description>
<ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
<ZoneId>cn-hangzhou-g</ZoneId>
<PrivateIpAddress>10.1.**.**</PrivateIpAddress>
<QueueNumber>8</QueueNumber>
<SecurityGroupIds>sg-bp18kz60mefsicfg****</SecurityGroupIds>
<AssociatedPublicIp>
<PublicIpAddress>116.62.**.**</PublicIpAddress>
<AllocationId>null</AllocationId>
</AssociatedPublicIp>
<Attachment>
<InstanceId>hide</InstanceId>
<TrunkNetworkInterfaceId>hide</TrunkNetworkInterfaceId>
<MemberNetworkInterfaceIds>hide</MemberNetworkInterfaceIds>
<NetworkCardIndex>0</NetworkCardIndex>
</Attachment>
<PrivateIpSets>
<PrivateIpAddress>172.17.**.**</PrivateIpAddress>
<Primary>true</Primary>
<AssociatedPublicIp>
<PublicIpAddress>116.62.**.**</PublicIpAddress>
<AllocationId>null</AllocationId>
</AssociatedPublicIp>
</PrivateIpSets>
<Ipv6Sets>
<Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
</Ipv6Sets>
<Ipv4PrefixSets>
<Ipv4Prefix>192.168.**.0/28</Ipv4Prefix>
</Ipv4PrefixSets>
<Ipv6PrefixSets>
<Ipv6Prefix>2001:db8:1234:1a00:****::/80</Ipv6Prefix>
</Ipv6PrefixSets>
<Tags>
<TagValue>TestValue</TagValue>
<TagKey>TestKey</TagKey>
</Tags>
<BondInterfaceSpecification>
<BondMode>null</BondMode>
<SlaveInterfaceSpecification>
<SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
<WorkState>null</WorkState>
<BondNetworkInterfaceId>null</BondNetworkInterfaceId>
</SlaveInterfaceSpecification>
</BondInterfaceSpecification>
<SlaveInterfaceSpecification>
<SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
<WorkState>null</WorkState>
<BondNetworkInterfaceId>null</BondNetworkInterfaceId>
<DeleteOnRelease>true</DeleteOnRelease>
</SlaveInterfaceSpecification>
</DescribeNetworkInterfaceAttributeResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"CreationTime" : "2019-12-25T12:31:31Z",
"VpcId" : "vpc-bp67acfmxazb4p****",
"Type" : "Secondary",
"Status" : "Available",
"NetworkInterfaceTrafficMode" : "Standard",
"NetworkInterfaceName" : "my-eni-name",
"MacAddress" : "00:16:3e:12:**:**",
"QueuePairNumber" : 22,
"NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****",
"ServiceID" : 12345678910,
"InstanceId" : "i-bp1e2l6djkndyuli****",
"OwnerId" : "123456****",
"ServiceManaged" : true,
"VSwitchId" : "vsw-bp1s5fnvk4gn2tws0****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"Description" : "testDescription",
"ResourceGroupId" : "rg-bp67acfmxazb4p****",
"ZoneId" : "cn-hangzhou-g",
"PrivateIpAddress" : "10.1.**.**",
"QueueNumber" : 8,
"SecurityGroupIds" : [ "sg-bp18kz60mefsicfg****" ],
"AssociatedPublicIp" : {
"PublicIpAddress" : "116.62.**.**",
"AllocationId" : "null"
},
"Attachment" : {
"InstanceId" : "hide",
"TrunkNetworkInterfaceId" : "hide",
"MemberNetworkInterfaceIds" : [ "hide" ],
"NetworkCardIndex" : 0
},
"PrivateIpSets" : [ {
"PrivateIpAddress" : "172.17.**.**",
"Primary" : true,
"AssociatedPublicIp" : {
"PublicIpAddress" : "116.62.**.**",
"AllocationId" : "null"
}
} ],
"Ipv6Sets" : [ {
"Ipv6Address" : "2001:db8:1234:1a00::****"
} ],
"Ipv4PrefixSets" : [ {
"Ipv4Prefix" : "192.168.**.0/28"
} ],
"Ipv6PrefixSets" : [ {
"Ipv6Prefix" : "2001:db8:1234:1a00:****::/80"
} ],
"Tags" : [ {
"TagValue" : "TestValue",
"TagKey" : "TestKey"
} ],
"BondInterfaceSpecification" : {
"BondMode" : "null",
"SlaveInterfaceSpecification" : [ {
"SlaveNetworkInterfaceId" : "null",
"WorkState" : "null",
"BondNetworkInterfaceId" : "null"
} ]
},
"SlaveInterfaceSpecification" : {
"SlaveNetworkInterfaceId" : "null",
"WorkState" : "null",
"BondNetworkInterfaceId" : "null",
"DeleteOnRelease" : "true"
}
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
MissingParameter |
%s |
Um parâmetro obrigatório não foi especificado. |
|
400 |
UnsupportedParameter |
%s |
Um parâmetro especificado não é suportado. |
|
400 |
InvalidParameter |
%s |
Valor de parâmetro inválido. |
|
400 |
InvalidInstanceID.Malformed |
%s |
Formato de InstanceId inválido. |
|
400 |
Forbidden.RegionId |
%s |
O serviço está indisponível na região no momento. |
|
400 |
InvalidRegionId.MalFormed |
The specified parameter RegionId is not valid. |
Valor de RegionId inválido. |
|
403 |
InvalidUserType.NotSupported |
%s |
A conta não suporta esta operação. |
|
403 |
Abs.InvalidAccount.NotFound |
%s |
Sua conta Alibaba Cloud não foi encontrada ou seu par AccessKey expirou. |
|
403 |
Forbidden.NotSupportRAM |
%s |
Usuários do Resource Access Management (RAM) não têm permissão para executar esta operação. |
|
403 |
Forbidden.SubUser |
%s |
Você não tem acesso ao recurso. Entre em contato com o proprietário da conta Alibaba Cloud. |
|
404 |
InvalidEniId.NotFound |
%s |
O ID da ENI não foi encontrado. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.