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: "client-vpn-endpoint", # accepts client-vpn-endpoint, customer-gateway, dedicated-host, dhcp-options, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, import-image-task, import-snapshot-task, instance, internet-gateway, key-pair, launch-template, local-gateway-route-table-vpc-association, natgateway, network-acl, network-interface, placement-group, reserved-instances, route-table, security-group, snapshot, spot-fleet-request, spot-instances-request, subnet, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-multicast-domain, transit-gateway-route-table, volume, vpc, 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", # required
  ipv_6_cidr_block: "String",
  outpost_arn: "String",
  vpc_id: "VpcId", # required
  dry_run: false,
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#availability_zoneString

The Availability Zone or Local Zone for the subnet.

Default: AWS 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)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

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

#availability_zone_idString

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

Returns:

  • (String)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run)
  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.

Returns:

  • (String)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run)
  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)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run)
  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.

Returns:

  • (String)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

class CreateSubnetRequest < Struct.new(
  :tag_specifications,
  :availability_zone,
  :availability_zone_id,
  :cidr_block,
  :ipv_6_cidr_block,
  :outpost_arn,
  :vpc_id,
  :dry_run)
  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)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

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

#tag_specificationsArray<Types::TagSpecification>

The tags to assign to the subnet.

Returns:



7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

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

#vpc_idString

The ID of the VPC.

Returns:

  • (String)


7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 7945

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