HEX

File: //usr/lib/python3/dist-packages/boto/vpc/__pycache__/__init__.cpython-310.pyc

ckF[o�@s�dZddlmZddlmZddlmZddlmZddl m
Z
ddlmZddl
mZdd lmZmZdd
lmZddlmZddlmZdd
lmZddlmZddlmZmZddlmZdd�Z dd�Z!Gdd�de�Z"dS)z-
Represents a connection to the EC2 service.
�)�
EC2Connection)� ResultSet)�VPC)�CustomerGateway)�
NetworkAcl)�
RouteTable)�InternetGateway)�
VpnGateway�
Attachment)�DhcpOptions)�Subnet)�
VpnConnection)�VpcPeeringConnection)�
RegionData)�
RegionInfo�get_regions)�connectcKstdtd�S)a:
Get all available regions for the EC2 service.
You may pass any of the arguments accepted by the VPCConnection
object's constructor as keyword arguments and they will be
passed along to the VPCConnection object.

:rtype: list
:return: A list of :class:`boto.ec2.regioninfo.RegionInfo`
�ec2)�connection_cls)r�
VPCConnection)� kw_params�r�3/usr/lib/python3/dist-packages/boto/vpc/__init__.py�regions+s
rcKstd|fdti|��S)a�
Given a valid region name, return a
:class:`boto.vpc.VPCConnection`.
Any additional parameters after the region_name are passed on to
the connect method of the region object.

:type: str
:param region_name: The name of the region to connect to.

:rtype: :class:`boto.vpc.VPCConnection` or ``None``
:return: A connection to the given region, or None if an invalid region
name is given
rr)rr)�region_namerrrr�connect_to_region8s�rc@s�eZdZd{dd�Zd|dd�Zd}dd�Z d{d d
�Z d{dd�Zd}d
d�Zd}dd�Z d}dd�Z
d}dd�Z d}dd�Z d}dd�Z
d}dd�Z d~dd�Z d~dd�Z d}dd �Zdd!d"�Zd#d$�Zd�d%d&�Zd'd(�Zd)d*�Z d�d+d,�Z d�d-d.�Zd�d/d0�Z d{d1d2�Zd}d3d4�Zd}d5d6�Z d}d7d8�Z d}d9d:�Z d{d;d<�Zd}d=d>�Z d}d?d@�Z! d{dAdB�Z"d|dCdD�Z#d}dEdF�Z$d}dGdH�Z%d}dIdJ�Z&d{dKdL�Z' d|dMdN�Z(d}dOdP�Z)d{dQdR�Z* d�dSdT�Z+d}dUdV�Z,d}dWdX�Z- d{dYdZ�Z. d|d[d\�Z/d}d]d^�Z0 d}d_d`�Z1 d}dadb�Z2 d}dcdd�Z3 d}dedf�Z4 d{dgdh�Z5 d|didj�Z6d}dkdl�Z7d}dmdn�Z8d}dodp�Z9 d{dqdr�Z: d}dsdt�Z;d}dudv�Z<d}dwdx�Z=d}dydz�Z>dS)�rNFcC�Fi}|r|�||d�|r|�||�|rd|d<|�d|dtfg�S)a�
Retrieve information about your VPCs. You can filter results to
return information only about those VPCs that match your search
parameters. Otherwise, all VPCs associated with your account
are returned.

:type vpc_ids: list
:param vpc_ids: A list of strings with the desired VPC ID's

:type filters: list of tuples or dict
:param filters: A list of tuples or dict containing filters. Each tuple
or dict item consists of a filter key and a filter value.
Possible filter keys are:

* *state* - a list of states of the VPC (pending or available)
* *cidrBlock* - a list CIDR blocks of the VPC
* *dhcpOptionsId* - a list of IDs of a set of DHCP options

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: list
:return: A list of :class:`boto.vpc.vpc.VPC`
�VpcId�true�DryRun�DescribeVpcs�item��build_list_params�build_filter_params�get_listr��self�vpc_ids�filters�dry_run�paramsrrr�get_all_vpcsNszVPCConnection.get_all_vpcscC�.d|i}|r
||d<|rd|d<|�d|t�S)a
Create a new Virtual Private Cloud.

:type cidr_block: str
:param cidr_block: A valid CIDR block

:type instance_tenancy: str
:param instance_tenancy: The supported tenancy options for instances
launched into the VPC. Valid values are 'default' and 'dedicated'.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: The newly created VPC
:return: A :class:`boto.vpc.vpc.VPC` object
� CidrBlock�InstanceTenancyrr� CreateVpc)�
get_objectr)r'�
cidr_block�instance_tenancyr*r+rrr�
create_vpcpszVPCConnection.create_vpccC� d|i}|r
d|d<|�d|�S)a)
Delete a Virtual Private Cloud.

:type vpc_id: str
:param vpc_id: The ID of the vpc to be deleted.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
rrr� DeleteVpc��
get_status�r'�vpc_idr*r+rrr�
delete_vpc��
zVPCConnection.delete_vpccCs\d|i}|dur|rd|d<nd|d<|dur"|rd|d<nd|d<|r(d|d<|�d|�S) a�
Modifies the specified attribute of the specified VPC.
You can only modify one attribute at a time.

:type vpc_id: str
:param vpc_id: The ID of the vpc to be deleted.

:type enable_dns_support: bool
:param enable_dns_support: Specifies whether the DNS server
provided by Amazon is enabled for the VPC.

:type enable_dns_hostnames: bool
:param enable_dns_hostnames: Specifies whether DNS hostnames are
provided for the instances launched in this VPC. You can only
set this attribute to ``true`` if EnableDnsSupport
is also ``true``.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

rNrzEnableDnsSupport.Value�falsezEnableDnsHostnames.Valuer�ModifyVpcAttributer7)r'r:�enable_dns_support�enable_dns_hostnamesr*r+rrr�modify_vpc_attribute�s

z"VPCConnection.modify_vpc_attributecCr)a<
Retrieve information about your routing tables. You can filter results
to return information only about those route tables that match your
search parameters. Otherwise, all route tables associated with your
account are returned.

:type route_table_ids: list
:param route_table_ids: A list of strings with the desired route table
IDs.

:type filters: list of tuples or dict
:param filters: A list of tuples or dict containing filters. Each tuple
or dict item consists of a filter key and a filter value.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: list
:return: A list of :class:`boto.vpc.routetable.RouteTable`
�RouteTableIdrr�DescribeRouteTablesr!)r#r$r%r)r'�route_table_idsr)r*r+rrr�get_all_route_tables�s�z"VPCConnection.get_all_route_tablescCs*||d�}|rd|d<|�d|t�}|jS)a�
Associates a route table with a specific subnet.

:type route_table_id: str
:param route_table_id: The ID of the route table to associate.

:type subnet_id: str
:param subnet_id: The ID of the subnet to associate with.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: str
:return: The ID of the association created
)rB�SubnetIdrr�AssociateRouteTable)r1r�
associationId)r'�route_table_id� subnet_idr*r+�resultrrr�associate_route_table�s�z#VPCConnection.associate_route_tablecCr5)a�
Removes an association from a route table. This will cause all subnets
that would've used this association to now use the main routing
association instead.

:type association_id: str
:param association_id: The ID of the association to disassociate.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
�
AssociationIdrr�DisassociateRouteTabler7)r'�association_idr*r+rrr�disassociate_route_table�sz&VPCConnection.disassociate_route_tablecC�"d|i}|r
d|d<|�d|t�S)ai
Creates a new route table.

:type vpc_id: str
:param vpc_id: The VPC ID to associate this route table with.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: The newly created route table
:return: A :class:`boto.vpc.routetable.RouteTable` object
rrr�CreateRouteTable)r1rr9rrr�create_route_tables
z VPCConnection.create_route_tablecCr5)a3
Delete a route table.

:type route_table_id: str
:param route_table_id: The ID of the route table to delete.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
rBrr�DeleteRouteTabler7)r'rIr*r+rrr�delete_route_table"r<z VPCConnection.delete_route_tablecC�$||d�}|rd|d<|�d|t�S)aB
Helper function for replace_route_table_association and
replace_route_table_association_with_assoc. Should not be used directly.

:type association_id: str
:param association_id: The ID of the existing association to replace.

:type route_table_id: str
:param route_table_id: The route table to ID to be used in the
association.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: ResultSet
:return: ResultSet of Amazon resposne
)rMrBrr�ReplaceRouteTableAssociation)r1r)r'rOrIr*r+rrr� _replace_route_table_association4s��z.VPCConnection._replace_route_table_associationcC�|j|||d�jS)as
Replaces a route association with a new route table. This can be
used to replace the 'main' route table by using the main route
table association instead of the more common subnet type
association.

NOTE: It may be better to use replace_route_table_association_with_assoc
instead of this function; this function does not return the new
association ID. This function is retained for backwards compatibility.

:type association_id: str
:param association_id: The ID of the existing association to replace.

:type route_table_id: str
:param route_table_id: The route table to ID to be used in the
association.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
�r*)rX�status�r'rOrIr*rrr�replace_route_table_assocationPs
��z,VPCConnection.replace_route_table_assocationcCrY)a�
Replaces a route association with a new route table. This can be
used to replace the 'main' route table by using the main route
table association instead of the more common subnet type
association. Returns the new association ID.

:type association_id: str
:param association_id: The ID of the existing association to replace.

:type route_table_id: str
:param route_table_id: The route table to ID to be used in the
association.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: str
:return: New association ID
rZ)rX�newAssociationIdr\rrr�*replace_route_table_association_with_assocms
��z8VPCConnection.replace_route_table_association_with_assocc C�h||d�}|dur||d<n|dur||d<n|dur ||d<n|dur(||d<|r.d|d<|�d |�S)
aV
Creates a new route in the route table within a VPC. The route's target
can be either a gateway attached to the VPC or a NAT instance in the
VPC.

:type route_table_id: str
:param route_table_id: The ID of the route table for the route.

:type destination_cidr_block: str
:param destination_cidr_block: The CIDR address block used for the
destination match.

:type gateway_id: str
:param gateway_id: The ID of the gateway attached to your VPC.

:type instance_id: str
:param instance_id: The ID of a NAT instance in your VPC.

:type interface_id: str
:param interface_id: Allows routing to network interface attachments.

:type vpc_peering_connection_id: str
:param vpc_peering_connection_id: Allows routing to VPC peering
connection.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
�rB�DestinationCidrBlockN� GatewayId�
InstanceId�NetworkInterfaceId�VpcPeeringConnectionIdrr�CreateRouter7� r'rI�destination_cidr_block�
gateway_id�instance_id�interface_id�vpc_peering_connection_idr*r+rrr�create_route�s$�

zVPCConnection.create_routec Cr`)
a�
Replaces an existing route within a route table in a VPC.

:type route_table_id: str
:param route_table_id: The ID of the route table for the route.

:type destination_cidr_block: str
:param destination_cidr_block: The CIDR address block used for the
destination match.

:type gateway_id: str
:param gateway_id: The ID of the gateway attached to your VPC.

:type instance_id: str
:param instance_id: The ID of a NAT instance in your VPC.

:type interface_id: str
:param interface_id: Allows routing to network interface attachments.

:type vpc_peering_connection_id: str
:param vpc_peering_connection_id: Allows routing to VPC peering
connection.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
raNrcrdrerfrr�ReplaceRouter7rhrrr�
replace_route�s"�

zVPCConnection.replace_routecC�"||d�}|rd|d<|�d|�S)a�
Deletes a route from a route table within a VPC.

:type route_table_id: str
:param route_table_id: The ID of the route table with the route.

:type destination_cidr_block: str
:param destination_cidr_block: The CIDR address block used for
destination match.

:type dry_run: bool
:param dry_run: Set to True if the operation should not actually run.

:rtype: bool
:return: True if successful
rarr�DeleteRouter7)r'rIrir*r+rrr�delete_route���zVPCConnection.delete_routecCs:i}|r|�||d�|r|�||�|�d|dtfg�S)a�
Retrieve information about your network acls. You can filter results
to return information only about those network acls that match your
search parameters. Otherwise, all network acls associated with your
account are returned.

:type network_acl_ids: list
:param network_acl_ids: A list of strings with the desired network ACL
IDs.

:type filters: list of tuples or dict
:param filters: A list of tuples or dict containing filters. Each tuple
or dict item consists of a filter key and a filter value.

:rtype: list
:return: A list of :class:`boto.vpc.networkacl.NetworkAcl`
�NetworkAclId�DescribeNetworkAclsr!)r#r$r%r)r'�network_acl_idsr)r+rrr�get_all_network_acls
s�z"VPCConnection.get_all_network_aclscsN|jd�fgd�d}�fdd�|jD�d}|j|d�}|�d|t�}|jS)aT
Associates a network acl with a specific subnet.

:type network_acl_id: str
:param network_acl_id: The ID of the network ACL to associate.

:type subnet_id: str
:param subnet_id: The ID of the subnet to associate with.

:rtype: str
:return: The ID of the association created
zassociation.subnet-id�r)rcsg|] }|j�kr|�qSr�rJ)�.0�associationrzrr�
<listcomp>3sz7VPCConnection.associate_network_acl.<locals>.<listcomp>)rMru�ReplaceNetworkAclAssociation)rx�associations�idr1rr^)r'�network_acl_idrJ�aclr|r+rKrrzr�associate_network_acl$s�z#VPCConnection.associate_network_aclcCs@|s|�|g�dj}|jd|fdgd�}|dj}|�||�S)a�
Figures out what the default ACL is for the VPC, and associates
current network ACL with the default.

:type subnet_id: str
:param subnet_id: The ID of the subnet to which the ACL belongs.

:type vpc_id: str
:param vpc_id: The ID of the VPC to which the ACL/subnet belongs. Queries EC2 if omitted.

:rtype: str
:return: The ID of the association created
rzvpc-id)�defaultrry)�get_all_subnetsr:rxr�r�)r'rJr:�acls�default_acl_idrrr�disassociate_network_acl=s

z&VPCConnection.disassociate_network_aclcCsd|i}|�d|t�S)z�
Creates a new network ACL.

:type vpc_id: str
:param vpc_id: The VPC ID to associate this network ACL with.

:rtype: The newly created network ACL
:return: A :class:`boto.vpc.networkacl.NetworkAcl` object
r�CreateNetworkAcl)r1r)r'r:r+rrr�create_network_aclRs
z VPCConnection.create_network_aclcCsd|i}|�d|�S)z�
Delete a network ACL

:type network_acl_id: str
:param network_acl_id: The ID of the network_acl to delete.

:rtype: bool
:return: True if successful
ru�DeleteNetworkAclr7)r'r�r+rrr�delete_network_acl_s
z VPCConnection.delete_network_aclcC�|||||d�}|durt|t�rt|���}||d<|dur#||d<|dur+||d<| dur3| |d<|
dur;|
|d<|�d|�S) a�
Creates a new network ACL entry in a network ACL within a VPC.

:type network_acl_id: str
:param network_acl_id: The ID of the network ACL for this network ACL entry.

:type rule_number: int
:param rule_number: The rule number to assign to the entry (for example, 100).

:type protocol: int
:param protocol: Valid values: -1 or a protocol number
(http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml)

:type rule_action: str
:param rule_action: Indicates whether to allow or deny traffic that matches the rule.

:type cidr_block: str
:param cidr_block: The CIDR range to allow or deny, in CIDR notation (for example,
172.16.0.0/24).

:type egress: bool
:param egress: Indicates whether this rule applies to egress traffic from the subnet (true)
or ingress traffic to the subnet (false).

:type icmp_type: int
:param icmp_type: For the ICMP protocol, the ICMP type. You can use -1 to specify
all ICMP types.

:type icmp_code: int
:param icmp_code: For the ICMP protocol, the ICMP code. You can use -1 to specify
all ICMP codes for the given ICMP type.

:type port_range_from: int
:param port_range_from: The first port in the range.

:type port_range_to: int
:param port_range_to: The last port in the range.

:rtype: bool
:return: True if successful
�ru�
RuleNumber�Protocol�
RuleActionr.N�Egress� Icmp.Code� Icmp.Type�PortRange.From�PortRange.To�CreateNetworkAclEntry��
isinstance�bool�str�lowerr8�r'r��rule_number�protocol�rule_actionr2�egress� icmp_code� icmp_type�port_range_from�
port_range_tor+rrr�create_network_acl_entryl�&.�
z&VPCConnection.create_network_acl_entrycCr�) a�
Creates a new network ACL entry in a network ACL within a VPC.

:type network_acl_id: str
:param network_acl_id: The ID of the network ACL for the id you want to replace

:type rule_number: int
:param rule_number: The rule number that you want to replace(for example, 100).