Skip to content

/AWS1/IF_EC2=>CREATESECONDARYSUBNET()

About CreateSecondarySubnet

Creates a secondary subnet in a secondary network.

A secondary subnet CIDR block must not overlap with the CIDR block of an existing secondary subnet in the secondary network. After you create a secondary subnet, you can't change its CIDR block.

The allowed size for a secondary subnet CIDR block is between /28 netmask (16 IP addresses) and /12 netmask (1,048,576 IP addresses). Amazon reserves the first four IP addresses and the last IP address in each secondary subnet for internal use.

Method Signature

METHODS /AWS1/IF_EC2~CREATESECONDARYSUBNET
  IMPORTING
    !IV_CLIENTTOKEN TYPE /AWS1/EC2STRING OPTIONAL
    !IV_AVAILABILITYZONE TYPE /AWS1/EC2AVAILABILITYZONENAME OPTIONAL
    !IV_AVAILABILITYZONEID TYPE /AWS1/EC2AVAILABILITYZONEID OPTIONAL
    !IV_DRYRUN TYPE /AWS1/EC2BOOLEAN OPTIONAL
    !IV_IPV4CIDRBLOCK TYPE /AWS1/EC2STRING OPTIONAL
    !IV_SECONDARYNETWORKID TYPE /AWS1/EC2SECONDARYNETWORKID OPTIONAL
    !IT_TAGSPECIFICATIONS TYPE /AWS1/CL_EC2TAGSPECIFICATION=>TT_TAGSPECIFICATIONLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_ec2createsecsnetrslt
  RAISING
    /AWS1/CX_EC2CLIENTEXC
    /AWS1/CX_EC2SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_ipv4cidrblock TYPE /AWS1/EC2STRING /AWS1/EC2STRING

The IPv4 CIDR block for the secondary subnet. The CIDR block size must be between /12 and /28.

iv_secondarynetworkid TYPE /AWS1/EC2SECONDARYNETWORKID /AWS1/EC2SECONDARYNETWORKID

The ID of the secondary network in which to create the secondary subnet.

Optional arguments:

iv_clienttoken TYPE /AWS1/EC2STRING /AWS1/EC2STRING

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensure Idempotency.

iv_availabilityzone TYPE /AWS1/EC2AVAILABILITYZONENAME /AWS1/EC2AVAILABILITYZONENAME

The Availability Zone for the secondary subnet. You cannot specify both AvailabilityZone and AvailabilityZoneId in the same request.

iv_availabilityzoneid TYPE /AWS1/EC2AVAILABILITYZONEID /AWS1/EC2AVAILABILITYZONEID

The ID of the Availability Zone for the secondary subnet. This option is preferred over AvailabilityZone as it provides a consistent identifier across Amazon Web Services accounts. You cannot specify both AvailabilityZone and AvailabilityZoneId in the same request.

iv_dryrun TYPE /AWS1/EC2BOOLEAN /AWS1/EC2BOOLEAN

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

it_tagspecifications TYPE /AWS1/CL_EC2TAGSPECIFICATION=>TT_TAGSPECIFICATIONLIST TT_TAGSPECIFICATIONLIST

The tags to assign to the secondary subnet.

RETURNING

oo_output TYPE REF TO /aws1/cl_ec2createsecsnetrslt /AWS1/CL_EC2CREATESECSNETRSLT

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->createsecondarysubnet(
  it_tagspecifications = VALUE /aws1/cl_ec2tagspecification=>tt_tagspecificationlist(
    (
      new /aws1/cl_ec2tagspecification(
        it_tags = VALUE /aws1/cl_ec2tag=>tt_taglist(
          (
            new /aws1/cl_ec2tag(
              iv_key = |string|
              iv_value = |string|
            )
          )
        )
        iv_resourcetype = |string|
      )
    )
  )
  iv_availabilityzone = |string|
  iv_availabilityzoneid = |string|
  iv_clienttoken = |string|
  iv_dryrun = ABAP_TRUE
  iv_ipv4cidrblock = |string|
  iv_secondarynetworkid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_secondarysubnet = lo_result->get_secondarysubnet( ).
  IF lo_secondarysubnet IS NOT INITIAL.
    lv_secondarysubnetid = lo_secondarysubnet->get_secondarysubnetid( ).
    lv_string = lo_secondarysubnet->get_secondarysubnetarn( ).
    lv_secondarynetworkid = lo_secondarysubnet->get_secondarynetworkid( ).
    lv_secondarynetworktype = lo_secondarysubnet->get_secondarynetworktype( ).
    lv_string = lo_secondarysubnet->get_ownerid( ).
    lv_availabilityzoneid = lo_secondarysubnet->get_availabilityzoneid( ).
    lv_availabilityzonename = lo_secondarysubnet->get_availabilityzone( ).
    LOOP AT lo_secondarysubnet->get_ipv4cidrblockassocs( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_secondarysubnetcidrasso = lo_row_1->get_associationid( ).
        lv_string = lo_row_1->get_cidrblock( ).
        lv_secondarysubnetcidrbloc = lo_row_1->get_state( ).
        lv_string = lo_row_1->get_statereason( ).
      ENDIF.
    ENDLOOP.
    lv_secondarysubnetstate = lo_secondarysubnet->get_state( ).
    lv_string = lo_secondarysubnet->get_statereason( ).
    LOOP AT lo_secondarysubnet->get_tags( ) into lo_row_2.
      lo_row_3 = lo_row_2.
      IF lo_row_3 IS NOT INITIAL.
        lv_string = lo_row_3->get_key( ).
        lv_string = lo_row_3->get_value( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
  lv_string = lo_result->get_clienttoken( ).
ENDIF.

To create a secondary subnet

This example creates a secondary subnet with a /24 CIDR block in the specified secondary network and Availability Zone.

DATA(lo_result) = lo_client->createsecondarysubnet(
  it_tagspecifications = VALUE /aws1/cl_ec2tagspecification=>tt_tagspecificationlist(
    (
      new /aws1/cl_ec2tagspecification(
        it_tags = VALUE /aws1/cl_ec2tag=>tt_taglist(
          (
            new /aws1/cl_ec2tag(
              iv_key = |Name|
              iv_value = |Prod Secondary Subnet|
            )
          )
          (
            new /aws1/cl_ec2tag(
              iv_key = |Environment|
              iv_value = |Production|
            )
          )
        )
        iv_resourcetype = |secondary-subnet|
      )
    )
  )
  iv_availabilityzoneid = |use2-az1|
  iv_clienttoken = |550e8400-e29b-41d4-a716-446655440000|
  iv_ipv4cidrblock = |10.0.0.0/24|
  iv_secondarynetworkid = |sn-0123456789abcdef0|
).