AssociateNetworkAcl - Virtual Private Cloud - Centro de documentación de Alibaba Cloud

Asocia una lista de control de acceso (ACL) de red con un vSwitch.

Descripción de la operación

Descripción

AssociateNetworkAcl es una operación asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de solicitud y ejecuta la tarea en segundo plano. Puede llamar a la operación DescribeNetworkAclAttributes para consultar el estado de la tarea.
- Si la ACL de red está en estado BINDING, significa que se está asociando.
- Si la ACL de red está en estado BINDED, significa que ya está asociada.
No puede llamar repetidamente a la operación AssociateNetworkAcl para asociar una ACL de red dentro del período de tiempo especificado.

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:AssociateNetworkAcl

update

*NetworkAcl

acs:vpc:{#regionId}:{#accountId}:networkacl/{#NetworkAclId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Resource	array<object>	No	La información sobre los recursos asociados.
	object	No
ResourceType	string	Sí	El tipo de recurso con el que desea asociar la ACL de red. Establezca el valor en VSwitch. Valores válidos de N: 0 a 29. Puede asociar una ACL de red con hasta 30 vSwitches.	VSwitch
ResourceId	string	Sí	El ID del recurso asociado.	vsw-bp1de348lntdw****
NetworkAclId	string	Sí	El ID de la ACL de red.	nacl-a2do9e413e0sp****
RegionId	string	Sí	El ID de región de la ACL de red. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el ID de solicitud como token de cliente. El ID de solicitud puede ser diferente para cada solicitud.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Especifica si se debe realizar solo una ejecución de prueba (dry run), sin ejecutar la solicitud real.	false
RegionId	string	Sí	El ID de región de la ACL de red. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ParameterMissing.AliUid	ParameterMissing.AliUid
400	ParameterMissing.Bid	ParameterMissing.Bid
400	ParameterMissing.RegionId	ParameterMissing.RegionId
400	ParameterEmpty.RegionId	ParameterEmpty.RegionId
400	ParameterMissing.NetworkAclId	ParameterMissing.NetworkAclId
400	ParameterEmpty.NetworkAclId	ParameterEmpty.NetworkAclId
400	ParameterMissing.Resources	ParameterMissing.Resources
400	ParameterEmpty.Resources	ParameterEmpty.Resources
400	InvalidNetworkAcl.NotFound	The special Network Acl is not found.	The network ACL is not found.
400	NetworkStatus.Modifying	The special Network Acl is in modifying.	The network ACL is being modified.
400	ResourceStatus.Error	The binding instance is in middle status.	The status of the instance is invalid.
400	InvalidResource.NotFound	The binding instance is not found.
400	InvalidResource.VpcError	The network acl and resource not in same vpc.
400	InvalidResource.BindingExist	The binding instance has been binded.	The instance is already in the Associated state.
400	NotSupport.NetworkAcl	Network acl is not support now.
400	ParameterIllegal.ResourceType	The specified resource type is illegal.
400	MissingParam.Resource	Missing parameter Resource.	Missing parameter Resource
400	OperationDenied.NetworkAclAttachmentInMiddleStatus	The network ACL is being bound to or unbound from the switch.	The network ACL is being bound to or unbound from the switch.
500	InternalError	The request processing has failed due to some unknown error.

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.