Struct aws_sdk_lightsail::model::PortInfo [−][src]
#[non_exhaustive]pub struct PortInfo {
pub from_port: i32,
pub to_port: i32,
pub protocol: Option<NetworkProtocol>,
pub cidrs: Option<Vec<String>>,
pub ipv6_cidrs: Option<Vec<String>>,
pub cidr_list_aliases: Option<Vec<String>>,
}
Expand description
Describes ports to open on an instance, the IP addresses allowed to connect to the instance through the ports, and the protocol.
Fields (Non-exhaustive)
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.from_port: i32
The first port in a range of open ports on an instance.
Allowed ports:
-
TCP and UDP -
0
to65535
-
ICMP - The ICMP type for IPv4 addresses. For example, specify
8
as thefromPort
(ICMP type), and-1
as thetoPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia. -
ICMPv6 - The ICMP type for IPv6 addresses. For example, specify
128
as thefromPort
(ICMPv6 type), and0
astoPort
(ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.
to_port: i32
The last port in a range of open ports on an instance.
Allowed ports:
-
TCP and UDP -
0
to65535
-
ICMP - The ICMP code for IPv4 addresses. For example, specify
8
as thefromPort
(ICMP type), and-1
as thetoPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia. -
ICMPv6 - The ICMP code for IPv6 addresses. For example, specify
128
as thefromPort
(ICMPv6 type), and0
astoPort
(ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.
protocol: Option<NetworkProtocol>
The IP protocol name.
The name can be one of the following:
-
tcp
- Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead. -
all
- All transport layer protocol types. For more general information, see Transport layer on Wikipedia. -
udp
- With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead. -
icmp
- Internet Control Message Protocol (ICMP) is used to send error messages and operational information indicating success or failure when communicating with an instance. For example, an error is indicated when an instance could not be reached. When you specifyicmp
as theprotocol
, you must specify the ICMP type using thefromPort
parameter, and ICMP code using thetoPort
parameter.
cidrs: Option<Vec<String>>
The IPv4 address, or range of IPv4 addresses (in CIDR notation) that are allowed to connect to an instance through the ports, and the protocol.
The ipv6Cidrs
parameter lists the IPv6 addresses that are allowed to
connect to an instance.
Examples:
-
To allow the IP address
192.0.2.44
, specify192.0.2.44
or192.0.2.44/32
. -
To allow the IP addresses
192.0.2.0
to192.0.2.255
, specify192.0.2.0/24
.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
ipv6_cidrs: Option<Vec<String>>
The IPv6 address, or range of IPv6 addresses (in CIDR notation) that are allowed to connect to an instance through the ports, and the protocol. Only devices with an IPv6 address can connect to an instance through IPv6; otherwise, IPv4 should be used.
The cidrs
parameter lists the IPv4 addresses that are allowed to connect to
an instance.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
cidr_list_aliases: Option<Vec<String>>
An alias that defines access for a preconfigured range of IP addresses.
The only alias currently supported is lightsail-connect
, which allows IP
addresses of the browser-based RDP/SSH client in the Lightsail console to connect to your
instance.
Implementations
The first port in a range of open ports on an instance.
Allowed ports:
-
TCP and UDP -
0
to65535
-
ICMP - The ICMP type for IPv4 addresses. For example, specify
8
as thefromPort
(ICMP type), and-1
as thetoPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia. -
ICMPv6 - The ICMP type for IPv6 addresses. For example, specify
128
as thefromPort
(ICMPv6 type), and0
astoPort
(ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.
The last port in a range of open ports on an instance.
Allowed ports:
-
TCP and UDP -
0
to65535
-
ICMP - The ICMP code for IPv4 addresses. For example, specify
8
as thefromPort
(ICMP type), and-1
as thetoPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia. -
ICMPv6 - The ICMP code for IPv6 addresses. For example, specify
128
as thefromPort
(ICMPv6 type), and0
astoPort
(ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.
The IP protocol name.
The name can be one of the following:
-
tcp
- Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead. -
all
- All transport layer protocol types. For more general information, see Transport layer on Wikipedia. -
udp
- With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead. -
icmp
- Internet Control Message Protocol (ICMP) is used to send error messages and operational information indicating success or failure when communicating with an instance. For example, an error is indicated when an instance could not be reached. When you specifyicmp
as theprotocol
, you must specify the ICMP type using thefromPort
parameter, and ICMP code using thetoPort
parameter.
The IPv4 address, or range of IPv4 addresses (in CIDR notation) that are allowed to connect to an instance through the ports, and the protocol.
The ipv6Cidrs
parameter lists the IPv6 addresses that are allowed to
connect to an instance.
Examples:
-
To allow the IP address
192.0.2.44
, specify192.0.2.44
or192.0.2.44/32
. -
To allow the IP addresses
192.0.2.0
to192.0.2.255
, specify192.0.2.0/24
.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
The IPv6 address, or range of IPv6 addresses (in CIDR notation) that are allowed to connect to an instance through the ports, and the protocol. Only devices with an IPv6 address can connect to an instance through IPv6; otherwise, IPv4 should be used.
The cidrs
parameter lists the IPv4 addresses that are allowed to connect to
an instance.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
An alias that defines access for a preconfigured range of IP addresses.
The only alias currently supported is lightsail-connect
, which allows IP
addresses of the browser-based RDP/SSH client in the Lightsail console to connect to your
instance.
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for PortInfo
impl UnwindSafe for PortInfo
Blanket Implementations
Mutably borrows from an owned value. Read more
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more