DescribeNetworkInterfaceAttribute - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeNetworkInterfaceAttribute	Opération à effectuer. Définissez la valeur sur DescribeNetworkInterfaceAttribute.
RegionId	String	Oui	cn-hangzhou	ID de région de l'ENI. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
Tag.N.Key	String	Non	TestKey	Remarque Ce paramètre n'est pas disponible publiquement.
Tag.N.Value	String	Non	TestValue	Remarque Ce paramètre n'est pas disponible publiquement.
NetworkInterfaceId	String	Oui	eni-bp67acfmxazb4p****	ID de l'ENI.
Attribute	String	Non	test	Attribut de l'ENI.

Paramètres de réponse

Paramètre	Type	Exemple	Description
CreationTime	String	2019-12-25T12:31:31Z	Heure de création de l'ENI.
VpcId	String	vpc-bp67acfmxazb4p****	ID du VPC auquel appartient l'ENI.
Type	String	Secondary	Type de l'ENI. Valeurs possibles : Primary Secondary
Status	String	Available	État de l'ENI. Valeurs possibles : Available : L'ENI n'est attachée à aucune instance. Attaching : L'ENI est en cours d'attachement à une instance. InUse : L'ENI est attachée à une instance. Detaching : L'ENI est en cours de détachement d'une instance. Deleting : L'ENI est en cours de suppression. Ce paramètre est vide par défaut, ce qui signifie que les ENI dans tous les états sont interrogées.
NetworkInterfaceTrafficMode	String	Standard	Mode de communication de l'ENI. Valeurs possibles : Standard : utilise le mode de communication TCP. HighPerformance : utilise le mode de communication RDMA (Remote Direct Memory Access) avec ERI (Elastic RDMA Interface) activé. Remarque Le paramètre ne peut prendre la valeur HighPerformance que si l'ENI est attachée à une instance c7re optimisée pour RDMA située dans la zone K de Pékin.
NetworkInterfaceName	String	my-eni-name	Nom de l'ENI.
MacAddress	String	00:16:3e:12::	Adresse MAC (Media Access Control) de l'ENI.
QueuePairNumber	Integer	22	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
NetworkInterfaceId	String	eni-bp125p95hhdhn3ot****	ID de l'ENI.
ServiceID	Long	12345678910	ID du distributeur auquel appartient l'ENI.
InstanceId	String	i-bp1e2l6djkndyuli****	ID de l'instance à laquelle l'ENI est attachée. Remarque Si l'ENI est gérée et contrôlée par d'autres services Alibaba Cloud, aucun ID d'instance n'est renvoyé.
OwnerId	String	123456****	ID du compte auquel appartient l'ENI.
ServiceManaged	Boolean	true	Indique si l'utilisateur de l'ENI est un service Alibaba Cloud ou un distributeur.
VSwitchId	String	vsw-bp1s5fnvk4gn2tws0****	ID du vSwitch auquel l'ENI est connectée.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID de la requête.
Description	String	testDescription	Description de l'ENI.
ResourceGroupId	String	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel appartient l'instance associée. Si ce paramètre est spécifié pour interroger des ressources, jusqu'à 1 000 ressources appartenant au groupe de ressources spécifié sont renvoyées. Remarque Les ressources du groupe de ressources par défaut sont affichées dans la réponse, quelle que soit la valeur de ce paramètre.
ZoneId	String	cn-hangzhou-g	ID de zone de l'ENI.
PrivateIpAddress	String	10.1..	Adresse IP privée de l'ENI.
QueueNumber	Integer	8	Nombre de files d'attente prises en charge par l'ENI. Pour une ENI principale : le nombre par défaut de files d'attente pris en charge par le type d'instance pour l'ENI est renvoyé. Pour une ENI secondaire : Si l'ENI est dans l'état InUse : Si le nombre de files d'attente prises en charge par l'ENI n'a pas été modifié, le nombre par défaut de files d'attente pris en charge par le type d'instance pour l'ENI est renvoyé. Si le nombre de files d'attente prises en charge par l'ENI a été modifié, le nouveau nombre de files d'attente est renvoyé. Si l'ENI est dans l'état Available : Si le nombre de files d'attente prises en charge par l'ENI n'a pas été modifié, la valeur de retour est vide. Si le nombre de files d'attente prises en charge par l'ENI a été modifié, le nouveau nombre de files d'attente est renvoyé.
SecurityGroupIds	Array of String	sg-bp18kz60mefsicfg****	ID des groupes de sécurité auxquels appartient l'ENI.
AssociatedPublicIp	Object		Adresse IP élastique (EIP) associée à l'adresse IP privée secondaire de l'ENI.
PublicIpAddress	String	116.62..	EIP de l'ENI.
AllocationId	String	null	ID de l'EIP.
Attachment	Object		Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
DeviceIndex	Integer	hide	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
InstanceId	String	hide	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
TrunkNetworkInterfaceId	String	hide	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
MemberNetworkInterfaceIds	Array of String	hide	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
NetworkCardIndex	Integer	0	Index de la carte réseau. Si l'ENI est dans l'état Available ou si aucun index de carte réseau n'a été spécifié lors de l'attachement de l'ENI, ce paramètre est vide. Si l'ENI est dans l'état InUse et qu'un index de carte réseau a été spécifié lors de l'attachement de l'ENI, l'index de carte réseau spécifié est renvoyé comme valeur de ce paramètre.
PrivateIpSets	Array of PrivateIpSet		Adresses IP privées.
PrivateIpSet
PrivateIpAddress	String	172.17..	Adresse IP privée de l'ENI.
Primary	Boolean	true	Indique si l'adresse IP est l'adresse IP privée principale. Valeurs possibles : true : adresse IP privée principale false : adresse IP privée secondaire
AssociatedPublicIp	Object		Détails sur l'EIP associée à l'adresse IP privée secondaire de l'ENI.
PublicIpAddress	String	116.62..	EIP.
AllocationId	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
Ipv6Sets	Array of Ipv6Set		Adresses IPv6 de l'ENI.
Ipv6Set
Ipv6Address	String	2001:db8:1234:1a00::****	Adresse IPv6 attribuée à l'ENI.
Ipv4PrefixSets	Array of Ipv4PrefixSet		Préfixes IPv4 de l'ENI.
Ipv4PrefixSet
Ipv4Prefix	String	192 168.**.0/28	Préfixe IPv4 attribué à l'ENI.
Ipv6PrefixSets	Array of Ipv6PrefixSet		Préfixes IPv6 de l'ENI.
Ipv6PrefixSet
Ipv6Prefix	String	2001:db8:1234:1a00:****::/80	Préfixe IPv6 attribué à l'ENI.
Tags	Array of Tag		Tags de l'ENI.
Tag
TagValue	String	TestValue	Valeur du tag de l'ENI.
TagKey	String	TestKey	Clé du tag de l'ENI.
BondInterfaceSpecification	Object		Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
BondMode	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
SlaveInterfaceSpecification	Array of SlaveInterfaceSpecificationSet		Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
SlaveInterfaceSpecificationSet
SlaveNetworkInterfaceId	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
WorkState	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
BondNetworkInterfaceId	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
SlaveInterfaceSpecification	Object		Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
SlaveNetworkInterfaceId	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
WorkState	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
BondNetworkInterfaceId	String	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
DeleteOnRelease	Boolean	true	Indique s'il faut conserver l'ENI lors de la libération de l'instance associée. Valeurs possibles : true false

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Attribute=test
&<Common request parameters>

Exemples de réponses réussies

XML format

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>

JSON format

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"
  }
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	%s	Un paramètre obligatoire n'est pas spécifié.
400	UnsupportedParameter	%s	Un paramètre spécifié n'est pas pris en charge.
400	InvalidParameter	%s	Valeur de paramètre non valide.
400	InvalidInstanceID.Malformed	%s	Format InstanceId non valide.
400	Forbidden.RegionId	%s	Le service n'est pas disponible dans la région pour le moment.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Valeur RegionId non valide.
403	InvalidUserType.NotSupported	%s	Le compte ne prend pas en charge cette opération.
403	Abs.InvalidAccount.NotFound	%s	Votre compte Alibaba Cloud est introuvable ou votre paire AccessKey a expiré.
403	Forbidden.NotSupportRAM	%s	Les utilisateurs RAM (Resource Access Management) n'ont pas les autorisations nécessaires pour effectuer cette opération.
403	Forbidden.SubUser	%s	Vous n'avez pas accès à la ressource. Contactez le propriétaire du compte Alibaba Cloud.
404	InvalidEniId.NotFound	%s	L'ID de l'ENI est introuvable.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.