DeleteNatGateway - NAT Gateway - Centro de documentación de Alibaba Cloud

Elimina un gateway NAT de Internet especificado.

Descripción de la operación

DeleteNatGateway es una operación asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de solicitud. Sin embargo, el gateway NAT no se elimina de inmediato. La tarea de eliminación se ejecuta en segundo plano. Puede llamar a DescribeNatGateways para consultar el estado del gateway NAT:

Si el gateway NAT está en estado Deleting, significa que se está eliminando. En este estado, solo puede realizar operaciones de consulta.
Si no se encuentra el gateway NAT, significa que ya se eliminó.

Nota

La eliminación de un gateway NAT es irreversible. Proceda con precaución.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:DeleteNatGateway

delete

*NatGateway.

acs:vpc:{#regionId}:{#accountId}:natgateway/{#natgatewayid}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del gateway NAT. Puede llamar a DescribeRegions para consultar el ID de la región.	cn-hangzhou
NatGatewayId	string	Sí	El ID de instancia del gateway NAT que desea eliminar.	ngw-bp1uewa15k4iy5770****
Force	boolean	No	Especifica si se debe eliminar forzosamente el gateway NAT. Valores válidos: true: elimina forzosamente el gateway NAT. Si establece este parámetro en true: Si el gateway NAT tiene reglas SNAT, el sistema elimina forzosamente las reglas SNAT. Si el gateway NAT tiene reglas DNAT, el sistema elimina forzosamente las reglas DNAT. Si el gateway NAT tiene direcciones IP elásticas (EIP) asociadas, el sistema desasocia automáticamente las EIP. Si el gateway NAT tiene planes de servicio NAT no eliminados, el sistema elimina forzosamente los planes de servicio NAT. false (valor predeterminado): no elimina forzosamente el gateway NAT. Si establece este parámetro en false: Si el gateway NAT tiene planes de servicio NAT no eliminados, elimine primero los planes de servicio NAT. Si el gateway NAT tiene reglas SNAT, elimine primero las reglas SNAT. Si el gateway NAT tiene reglas DNAT, elimine primero las reglas DNAT. Si el gateway NAT tiene EIP asociadas, desasocie primero las EIP.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El ID de la solicitud.
RequestId	string	El ID de la solicitud.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	DependencyViolation.VpcEndpointService	The specified resource of %s depends on %s, so the operation cannot be completed.	La puerta de enlace NAT tiene servicios de endpoint dependientes. No se puede realizar la operación.
400	DependencyViolation.FullNatEntry	The specified resource of %s depends on %s, so the operation cannot be completed.
400	DependencyViolation.RouterEntry	The specified resource of %s depends on %s, so the operation cannot be completed.	La puerta de enlace NAT tiene entradas de ruta dependientes. No se puede realizar la operación.
400	DependencyViolation.BandwidthPackages	There are BandwidthPackages on specified NatGateway not deleted.
400	DependencyViolation.EIPS	There are Eips on specified NatGateway, please unbind it first.	La puerta de enlace NAT especificada ya está asociada con una dirección IP elástica.
400	Forbidden.PrePaidNatGateway	The specified NatGateway is PrePaid.
400	InvalidOperation.DeletionProtection	The instance cannnot delete because of deletion protecion.
400	DependencyViolation.SnatEntry	The specified resource of %s depends on %s, so the operation cannot be completed.	La dirección IP está referenciada por una regla SNAT. Elimine la regla correspondiente antes de realizar esta operación.
400	IncorrectStatus.SnatEntry	The status of %s [%s] is incorrect.
400	DependencyViolation.ForwardEntry	The specified resource of %s depends on %s, so the operation cannot be completed.
400	IncorrectStatus.ForwardEntry	The status of %s [%s] is incorrect.	El estado de la instancia de entrada DNAT que se va a eliminar no es válido.
400	DependencyViolation.NatIp	The specified resource of %s depends on %s, so the operation cannot be completed.	Existen direcciones IP NAT dependientes. No se puede realizar la operación.
400	IncorrectStatus.NatIp	The status of %s [%s] is incorrect.	NatIp se encuentra en un estado incorrecto.
400	DependencyViolation.NatIpCidr	The specified resource of %s depends on %s, so the operation cannot be completed.	La puerta de enlace NAT tiene bloques CIDR de IP NAT dependientes. No se puede realizar la operación.
400	IncorrectStatus.NatGateway	The NatGateway instance is being deleted and needs to wait until the process is complete.	La puerta de enlace NAT se encuentra en un estado no válido.
400	IncorrectStatus.RouterEntry	The status of %s [%s] is incorrect.	El estado actual de la entrada de ruta no es válido.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.	El vSwitch se encuentra en un estado anómalo.
404	INSTANCE_NOT_EXISTS	Instance not exists.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidNatGatewayId.NotFound	The specified NatGatewayId does not exist in our records.
404	ResourceNotFound.NatGateway	The specified resource of %s is not found.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.