Skip to content

EC2  >  Operations  >  create_subnet_cidr_reservation

create_subnet_cidr_reservation

Operation

create_subnet_cidr_reservation async

create_subnet_cidr_reservation(request: CreateSubnetCidrReservationInput | CreateSubnetCidrReservationInputDict, /, *, plugins: list[Plugin] | None = None) -> CreateSubnetCidrReservationOutput
create_subnet_cidr_reservation(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateSubnetCidrReservationInputDict]) -> CreateSubnetCidrReservationOutput

Creates a subnet CIDR reservation. For more information, see Subnet CIDR reservations in the Amazon VPC User Guide and Manage prefixes for your network interfaces in the Amazon EC2 User Guide.

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
CreateSubnetCidrReservationOutput

An instance of CreateSubnetCidrReservationOutput.

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

CreateSubnetCidrReservationInput dataclass

Bases: _SerdeShape

Dataclass for CreateSubnetCidrReservationInput structure.

Attributes
cidr class-attribute instance-attribute
cidr: str | None = ...

The IPv4 or IPV6 CIDR range to reserve.

description class-attribute instance-attribute
description: str | None = ...

The description to assign to the subnet CIDR reservation.

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.

reservation_type class-attribute instance-attribute
reservation_type: str | None = ...

The type of reservation. The reservation type determines how the reserved IP addresses are assigned to resources.

  • prefix - Amazon Web Services assigns the reserved IP addresses to network interfaces.

  • explicit - You assign the reserved IP addresses to network interfaces.

subnet_id class-attribute instance-attribute
subnet_id: str | None = ...

The ID of the subnet.

tag_specifications class-attribute instance-attribute
tag_specifications: list[TagSpecification] | None = ...

The tags to assign to the subnet CIDR reservation.

Dictionaries

CreateSubnetCidrReservationInputDict

Bases: TypedDict

Dictionary form of CreateSubnetCidrReservationInput.

Attributes
cidr instance-attribute
cidr: Required[str]

The IPv4 or IPV6 CIDR range to reserve.

description instance-attribute
description: str | None

The description to assign to the subnet CIDR reservation.

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.

reservation_type instance-attribute
reservation_type: Required[str]

The type of reservation. The reservation type determines how the reserved IP addresses are assigned to resources.

  • prefix - Amazon Web Services assigns the reserved IP addresses to network interfaces.

  • explicit - You assign the reserved IP addresses to network interfaces.

subnet_id instance-attribute
subnet_id: Required[str]

The ID of the subnet.

tag_specifications instance-attribute
tag_specifications: Sequence[TagSpecification | TagSpecificationDict] | None

The tags to assign to the subnet CIDR reservation.

Output

CreateSubnetCidrReservationOutput dataclass

Bases: _SerdeShape

Dataclass for CreateSubnetCidrReservationOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

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.

subnet_cidr_reservation class-attribute instance-attribute
subnet_cidr_reservation: SubnetCidrReservation | None = ...

Information about the created subnet CIDR reservation.