Skip to content

/AWS1/CL_LSAINSTANCEPORTSTATE

Describes open ports on an instance, the IP addresses allowed to connect to the instance through the ports, and the protocol.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_fromport TYPE /AWS1/LSAPORT /AWS1/LSAPORT

The first port in a range of open ports on an instance.

Allowed ports:

  • TCP and UDP - 0 to 65535

  • ICMP - The ICMP type for IPv4 addresses. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort (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 the fromPort (ICMPv6 type), and 0 as toPort (ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.

iv_toport TYPE /AWS1/LSAPORT /AWS1/LSAPORT

The last port in a range of open ports on an instance.

Allowed ports:

  • TCP and UDP - 0 to 65535

  • ICMP - The ICMP code for IPv4 addresses. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort (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 the fromPort (ICMPv6 type), and 0 as toPort (ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.

iv_protocol TYPE /AWS1/LSANETWORKPROTOCOL /AWS1/LSANETWORKPROTOCOL

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 specify icmp as the protocol, you must specify the ICMP type using the fromPort parameter, and ICMP code using the toPort parameter.

  • icmp6 - Internet Control Message Protocol (ICMP) for IPv6. When you specify icmp6 as the protocol, you must specify the ICMP type using the fromPort parameter, and ICMP code using the toPort parameter.

iv_state TYPE /AWS1/LSAPORTSTATE /AWS1/LSAPORTSTATE

Specifies whether the instance port is open or closed.

The port state for Lightsail instances is always open.

it_cidrs TYPE /AWS1/CL_LSASTRINGLIST_W=>TT_STRINGLIST TT_STRINGLIST

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.

For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.

it_ipv6cidrs TYPE /AWS1/CL_LSASTRINGLIST_W=>TT_STRINGLIST TT_STRINGLIST

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.

it_cidrlistaliases TYPE /AWS1/CL_LSASTRINGLIST_W=>TT_STRINGLIST TT_STRINGLIST

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.

Queryable Attributes

fromPort

The first port in a range of open ports on an instance.

Allowed ports:

  • TCP and UDP - 0 to 65535

  • ICMP - The ICMP type for IPv4 addresses. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort (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 the fromPort (ICMPv6 type), and 0 as toPort (ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.

Accessible with the following methods

Method Description
GET_FROMPORT() Getter for FROMPORT

toPort

The last port in a range of open ports on an instance.

Allowed ports:

  • TCP and UDP - 0 to 65535

  • ICMP - The ICMP code for IPv4 addresses. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort (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 the fromPort (ICMPv6 type), and 0 as toPort (ICMPv6 code). For more information, see Internet Control Message Protocol for IPv6.

Accessible with the following methods

Method Description
GET_TOPORT() Getter for TOPORT

protocol

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 specify icmp as the protocol, you must specify the ICMP type using the fromPort parameter, and ICMP code using the toPort parameter.

  • icmp6 - Internet Control Message Protocol (ICMP) for IPv6. When you specify icmp6 as the protocol, you must specify the ICMP type using the fromPort parameter, and ICMP code using the toPort parameter.

Accessible with the following methods

Method Description
GET_PROTOCOL() Getter for PROTOCOL, with configurable default
ASK_PROTOCOL() Getter for PROTOCOL w/ exceptions if field has no value
HAS_PROTOCOL() Determine if PROTOCOL has a value

state

Specifies whether the instance port is open or closed.

The port state for Lightsail instances is always open.

Accessible with the following methods

Method Description
GET_STATE() Getter for STATE, with configurable default
ASK_STATE() Getter for STATE w/ exceptions if field has no value
HAS_STATE() Determine if STATE has a value

cidrs

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.

For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.

Accessible with the following methods

Method Description
GET_CIDRS() Getter for CIDRS, with configurable default
ASK_CIDRS() Getter for CIDRS w/ exceptions if field has no value
HAS_CIDRS() Determine if CIDRS has a value

ipv6Cidrs

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.

Accessible with the following methods

Method Description
GET_IPV6CIDRS() Getter for IPV6CIDRS, with configurable default
ASK_IPV6CIDRS() Getter for IPV6CIDRS w/ exceptions if field has no value
HAS_IPV6CIDRS() Determine if IPV6CIDRS has a value

cidrListAliases

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.

Accessible with the following methods

Method Description
GET_CIDRLISTALIASES() Getter for CIDRLISTALIASES, with configurable default
ASK_CIDRLISTALIASES() Getter for CIDRLISTALIASES w/ exceptions if field has no val
HAS_CIDRLISTALIASES() Determine if CIDRLISTALIASES has a value

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_INSTANCEPORTSTATELIST

TYPES TT_INSTANCEPORTSTATELIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_LSAINSTANCEPORTSTATE WITH DEFAULT KEY
.