Class: Aws::EC2::Types::CreateSubnetRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb

Overview

Note:

When making an API call, you may pass CreateSubnetRequest data as a hash:

{
  tag_specifications: [
    {
      resource_type: "capacity-reservation", # accepts capacity-reservation, client-vpn-endpoint, customer-gateway, carrier-gateway, dedicated-host, dhcp-options, egress-only-internet-gateway, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, import-image-task, import-snapshot-task, instance, instance-event-window, internet-gateway, ipam, ipam-pool, ipam-scope, ipv4pool-ec2, ipv6pool-ec2, key-pair, launch-template, local-gateway, local-gateway-route-table, local-gateway-virtual-interface, local-gateway-virtual-interface-group, local-gateway-route-table-vpc-association, local-gateway-route-table-virtual-interface-group-association, natgateway, network-acl, network-interface, network-insights-analysis, network-insights-path, network-insights-access-scope, network-insights-access-scope-analysis, placement-group, prefix-list, replace-root-volume-task, reserved-instances, route-table, security-group, security-group-rule, snapshot, spot-fleet-request, spot-instances-request, subnet, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-connect-peer, transit-gateway-multicast-domain, transit-gateway-route-table, volume, vpc, vpc-endpoint, vpc-endpoint-service, vpc-peering-connection, vpn-connection, vpn-gateway, vpc-flow-log
      tags: [
        {
          key: "String",
          value: "String",
        },
      ],
    },
  ],
  availability_zone: "String",
  availability_zone_id: "String",
  cidr_block: "String",
  ipv_6_cidr_block: "String",
  outpost_arn: "String",
  vpc_id: "VpcId", # required
  dry_run: false,
  ipv_6_native: false,
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#availability_zoneString

The Availability Zone or Local Zone for the subnet.

Default: Amazon Web Services selects one for you. If you create more than one subnet in your VPC, we do not necessarily select a different zone for each subnet.

To create a subnet in a Local Zone, set this value to the Local Zone ID, for example us-west-2-lax-1a. For information about the Regions that support Local Zones, see Available Regions in the Amazon Elastic Compute Cloud User Guide.

To create a subnet in an Outpost, set this value to the Availability Zone for the Outpost and specify the Outpost ARN.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#availability_zone_idString

The AZ ID or the Local Zone ID of the subnet.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#cidr_blockString

The IPv4 network range for the subnet, in CIDR notation. For example, 10.0.0.0/24. We modify the specified CIDR block to its canonical form; for example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

This parameter is not supported for an IPv6 only subnet.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#dry_runBoolean

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.

Returns:

  • (Boolean)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#ipv_6_cidr_blockString

The IPv6 network range for the subnet, in CIDR notation. The subnet size must use a /64 prefix length.

This parameter is required for an IPv6 only subnet.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#ipv_6_nativeBoolean

Indicates whether to create an IPv6 only subnet.

Returns:

  • (Boolean)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#outpost_arnString

The Amazon Resource Name (ARN) of the Outpost. If you specify an Outpost ARN, you must also specify the Availability Zone of the Outpost subnet.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#tag_specificationsArray<Types::TagSpecification>

The tags to assign to the subnet.

Returns:



11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end

#vpc_idString

The ID of the VPC.

Returns:

  • (String)


11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 11672

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run,
  :ipv_6_native)
  SENSITIVE = []
  include Aws::Structure
end