ModifyNetworkInterfaceAttribute - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyNetworkInterfaceAttribute	Operação a ser executada. Defina o valor como ModifyNetworkInterfaceAttribute.
RegionId	String	Sim	cn-hangzhou	ID da região da ENI. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
NetworkInterfaceName	String	Não	eniTestName	Nome da ENI. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com http:// ou https://. Pode conter dígitos, letras, dois pontos (:), sublinhados (_) e hifens (-). Por padrão, este parâmetro está vazio.
NetworkInterfaceId	String	Sim	eni-bp67acfmxazb4p****	ID da ENI.
QueueNumber	Integer	Não	8	Número de filas compatíveis com a ENI. Valores válidos: 1 a 2048. Altere apenas o número de filas de ENIs secundárias. A alteração do número de filas de uma ENI secundária só é permitida quando a ENI está no estado `Available` ou anexada (`InUse`) a uma instância no estado `Stopped`. O número de filas da ENI secundária não pode exceder o máximo permitido pelo tipo de instância para cada ENI. O total de filas em todas as ENIs da instância também não pode ultrapassar a cota de filas do tipo de instância. Para consultar o número máximo de filas por ENI e a cota de filas de um tipo de instância, chame a operação DescribeInstanceTypes e verifique os valores de `MaximumQueueNumberPerEni` e `TotalEniQueueQuantity` na resposta.
Description	String	Não	testDescription	Descrição da ENI. Deve ter de 2 a 255 caracteres e não pode começar com http:// ou https://. Por padrão, este parâmetro está vazio.
SecurityGroupId.N	String	Não	sg-bp67acfmxazb4p****	ID do grupo de segurança N ao qual adicionar a ENI. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma ENI pode pertencer. Para mais informações, consulte Limites. Altere apenas os grupos de segurança de uma ENI secundária. Ao especificar este parâmetro, a ENI secundária é adicionada aos novos grupos de segurança e removida dos grupos originais. Os novos grupos de segurança entram em vigor após um breve atraso.
DeleteOnRelease	Boolean	Não	true	Define se a ENI deve ser mantida quando a instância associada for liberada. Valores válidos: true false

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyNetworkInterfaceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNetworkInterfaceAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

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	InvalidOperation.InvalidEcsState	%s	Esta operação não pode ser executada na instância no estado atual.
400	InvalidOperation.InvalidEniState	%s	Esta operação não pode ser executada na ENI no estado atual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	A ENI não pode ser desanexada da instância.
400	InvalidParams.EniId	%s	ID da ENI inválido.
400	Forbidden.RegionId	%s	O serviço está indisponível na região no momento.
400	JoinedGroupLimitExceed	%s	O número máximo de grupos de segurança aos quais o recurso especificado pode ser adicionado foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
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.
403	MaxEniCountExceeded	%s	O número máximo de ENIs que podem ser gerenciadas foi excedido.
403	EniPerInstanceLimitExceeded	%s	O número máximo de ENIs que podem ser anexadas à instância foi excedido.
403	InvalidOperation.AvailabilityZoneMismatch	%s	A operação é inválida.
403	InvalidOperation.VpcMismatch	%s	A operação é inválida. Verifique se a Virtual Private Cloud (VPC) na operação corresponde aos outros parâmetros.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança foi atingido.
403	InvalidSecurityGroupId.NotVpc	%s	ID do grupo de segurança inválido. O tipo de rede do grupo de segurança especificado não é VPC.
403	InvalidOperation.InvalidEniType	%s	Esta operação não pode ser executada neste tipo de ENI.
403	InvalidOperation.EniServiceManaged	%s	A operação é inválida.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber inválido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número máximo de filas na ENI foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número máximo de filas em todas as ENIs de uma instância foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	AclLimitExceed	%s	O número máximo de regras de grupo de segurança aplicáveis à ENI ou à instância foi excedido.
404	InvalidEcsId.NotFound	%s	O ID da instância não foi encontrado.
404	InvalidEniId.NotFound	%s	O ID da ENI não foi encontrado.
404	InvalidVSwitchId.NotFound	%s	O ID do vSwitch não foi encontrado.
404	InvalidSecurityGroupId.NotFound	%s	O ID do grupo de segurança não foi encontrado.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	Apenas o nome e a descrição das ENIs primárias podem ser modificados.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.