Copies network ACL rules.
Operation description
- The CopyNetworkAclEntries operation is asynchronous. After you invoke this operation, the system returns a request ID, but the network ACL rules are not immediately replicated. The background replication node is still running. You can invoke the DescribeNetworkAclAttributes operation to query the replication status of the network ACL rules:
When the network ACL rules are in the Modifying state, the rules are being replicated.
When the network ACL rules are in the Available state, it indicates Copy succeeded.
The CopyNetworkAclEntries operation does not support concurrent replication of the same network ACL rules.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vpc:CopyNetworkAclEntries |
update |
*NetworkAcl
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region where the network ACL resides. You can call the DescribeRegions operation to query region IDs. |
cn-hangzhou |
| NetworkAclId |
string |
Yes |
The ID of the network ACL. |
nacl-a2do9e413e0spxxxxxxxx |
| SourceNetworkAclId |
string |
Yes |
The ID of the network ACL to be copied. |
nacl-ghuo9ehg3e0spxxxxxxxx |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that the value is unique among different requests. The client token can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId of each API request may be different. |
123 |
| DryRun |
boolean |
No |
Specifies whether to precheck this request. Valid values:
|
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
6608E72F-F276-440F-ABEF-419971CEC4D1 |
Examples
Success response
JSON format
{
"RequestId": "6608E72F-F276-440F-ABEF-419971CEC4D1"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 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.SourceNetworkAclId | ParameterMissing.SourceNetworkAclId | |
| 400 | ParameterEmpty.SourceNetworkAclId | ParameterEmpty.SourceNetworkAclId | |
| 400 | InvalidNetworkAcl.NotFound | The special Network Acl is not found. | The network ACL is not found. |
| 400 | InvalidSourceNetworkAcl.NotFound | The special source network Acl is not found. | |
| 500 | InternalError | The request processing has failed due to some unknown error. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.