Skip to content

associate_security_group_vpc

Operation

associate_security_group_vpc

associate_security_group_vpc(request: AssociateSecurityGroupVpcInput | AssociateSecurityGroupVpcInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateSecurityGroupVpcInputDict]) -> AssociateSecurityGroupVpcOutput

Associates a security group with another VPC in the same Region. This enables you to use the same security group with network interfaces and instances in the specified VPC.

Note
  • The VPC you want to associate the security group with must be in the same Region.

  • You can associate the security group with another VPC if your account owns the VPC or if the VPC was shared with you.

  • You must own the security group.

  • You cannot use this feature with default security groups.

  • You cannot use this feature with the default VPC.

Parameters:

Name Type Description Default
request AssociateSecurityGroupVpcInput | AssociateSecurityGroupVpcInputDict | 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[AssociateSecurityGroupVpcInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssociateSecurityGroupVpcOutput

An instance of AssociateSecurityGroupVpcOutput.

associate_security_group_vpc async

associate_security_group_vpc(request: AssociateSecurityGroupVpcInput | AssociateSecurityGroupVpcInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateSecurityGroupVpcInputDict]) -> AssociateSecurityGroupVpcOutput

Associates a security group with another VPC in the same Region. This enables you to use the same security group with network interfaces and instances in the specified VPC.

Note
  • The VPC you want to associate the security group with must be in the same Region.

  • You can associate the security group with another VPC if your account owns the VPC or if the VPC was shared with you.

  • You must own the security group.

  • You cannot use this feature with default security groups.

  • You cannot use this feature with the default VPC.

Parameters:

Name Type Description Default
request AssociateSecurityGroupVpcInput | AssociateSecurityGroupVpcInputDict | 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[AssociateSecurityGroupVpcInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssociateSecurityGroupVpcOutput

An instance of AssociateSecurityGroupVpcOutput.

Input

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

AssociateSecurityGroupVpcInputDict

Bases: TypedDict

Dictionary form of AssociateSecurityGroupVpcInput.

Attributes

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.

group_id instance-attribute
group_id: Required[str]

A security group ID.

vpc_id instance-attribute
vpc_id: Required[str]

A VPC ID.

AssociateSecurityGroupVpcInput dataclass

Bases: _SerdeShape

Dataclass for AssociateSecurityGroupVpcInput structure.

Attributes

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.

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

A security group ID.

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

A VPC ID.

Output

AssociateSecurityGroupVpcOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateSecurityGroupVpcOutput 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.

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

The state of the association.