create_secondary_subnet¶
Operation¶
create_secondary_subnet
async
¶
create_secondary_subnet(request: CreateSecondarySubnetInput | CreateSecondarySubnetInputDict, /, *, plugins: list[Plugin] | None = None) -> CreateSecondarySubnetOutput
create_secondary_subnet(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateSecondarySubnetInputDict]) -> CreateSecondarySubnetOutput
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.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
CreateSecondarySubnetOutput
|
An instance of |
Input¶
Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.
Model¶
CreateSecondarySubnetInput
dataclass
¶
Bases: _SerdeShape
Dataclass for CreateSecondarySubnetInput structure.
Attributes¶
availability_zone
class-attribute
instance-attribute
¶
availability_zone: str | None = ...
The Availability Zone for the secondary subnet. You cannot specify both
AvailabilityZone and AvailabilityZoneId in the same request.
availability_zone_id
class-attribute
instance-attribute
¶
availability_zone_id: str | None = ...
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.
client_token
class-attribute
instance-attribute
¶
client_token: str | None = ...
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensure Idempotency.
This field is autopopulated if not provided.
dry_run
class-attribute
instance-attribute
¶
dry_run: bool | None = ...
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.
ipv4_cidr_block
class-attribute
instance-attribute
¶
ipv4_cidr_block: str | None = ...
The IPv4 CIDR block for the secondary subnet. The CIDR block size must be between /12 and /28.
secondary_network_id
class-attribute
instance-attribute
¶
secondary_network_id: str | None = ...
The ID of the secondary network in which to create the secondary subnet.
tag_specifications
class-attribute
instance-attribute
¶
tag_specifications: list[TagSpecification] | None = ...
The tags to assign to the secondary subnet.
Dictionaries¶
CreateSecondarySubnetInputDict
¶
Bases: TypedDict
Dictionary form of CreateSecondarySubnetInput.
Attributes¶
availability_zone
instance-attribute
¶
availability_zone: str | None
The Availability Zone for the secondary subnet. You cannot specify both
AvailabilityZone and AvailabilityZoneId in the same request.
availability_zone_id
instance-attribute
¶
availability_zone_id: str | None
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.
client_token
instance-attribute
¶
client_token: str | None
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensure Idempotency.
This field is autopopulated if not provided.
dry_run
instance-attribute
¶
dry_run: bool | None
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.
ipv4_cidr_block
instance-attribute
¶
The IPv4 CIDR block for the secondary subnet. The CIDR block size must be between /12 and /28.
secondary_network_id
instance-attribute
¶
The ID of the secondary network in which to create the secondary subnet.
tag_specifications
instance-attribute
¶
tag_specifications: Sequence[TagSpecification | TagSpecificationDict] | None
The tags to assign to the secondary subnet.
Output¶
CreateSecondarySubnetOutput
dataclass
¶
Bases: _SerdeShape
Dataclass for CreateSecondarySubnetOutput structure.
Attributes¶
client_token
class-attribute
instance-attribute
¶
client_token: str | None = ...
Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.
response_metadata
class-attribute
instance-attribute
¶
Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.
secondary_subnet
class-attribute
instance-attribute
¶
secondary_subnet: SecondarySubnet | None = ...
Information about the secondary subnet.