Skip to content

associate_ipam_byoasn

Operation

associate_ipam_byoasn

associate_ipam_byoasn(request: AssociateIpamByoasnInput | AssociateIpamByoasnInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateIpamByoasnInputDict]) -> AssociateIpamByoasnOutput

Associates your Autonomous System Number (ASN) with a BYOIP CIDR that you own in the same Amazon Web Services Region. For more information, see Tutorial: Bring your ASN to IPAM in the Amazon VPC IPAM guide.

After the association succeeds, the ASN is eligible for advertisement. You can view the association with DescribeByoipCidrs. You can advertise the CIDR with AdvertiseByoipCidr.

Parameters:

Name Type Description Default
request AssociateIpamByoasnInput | AssociateIpamByoasnInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[AssociateIpamByoasnInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssociateIpamByoasnOutput

An instance of AssociateIpamByoasnOutput.

associate_ipam_byoasn async

associate_ipam_byoasn(request: AssociateIpamByoasnInput | AssociateIpamByoasnInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateIpamByoasnInputDict]) -> AssociateIpamByoasnOutput

Associates your Autonomous System Number (ASN) with a BYOIP CIDR that you own in the same Amazon Web Services Region. For more information, see Tutorial: Bring your ASN to IPAM in the Amazon VPC IPAM guide.

After the association succeeds, the ASN is eligible for advertisement. You can view the association with DescribeByoipCidrs. You can advertise the CIDR with AdvertiseByoipCidr.

Parameters:

Name Type Description Default
request AssociateIpamByoasnInput | AssociateIpamByoasnInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[AssociateIpamByoasnInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssociateIpamByoasnOutput

An instance of AssociateIpamByoasnOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

AssociateIpamByoasnInputDict

Bases: TypedDict

Dictionary form of AssociateIpamByoasnInput.

Attributes

asn instance-attribute
asn: Required[str]

A public 2-byte or 4-byte ASN.

cidr instance-attribute
cidr: Required[str]

The BYOIP CIDR you want to associate with an ASN.

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.

AssociateIpamByoasnInput dataclass

Bases: _SerdeShape

Dataclass for AssociateIpamByoasnInput structure.

Attributes

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

A public 2-byte or 4-byte ASN.

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

The BYOIP CIDR you want to associate with an ASN.

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.

Output

AssociateIpamByoasnOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateIpamByoasnOutput structure.

Attributes

asn_association class-attribute instance-attribute
asn_association: AsnAssociation | None = ...

The ASN and BYOIP CIDR association.

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.