1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. ec2
  6. SecondaryNetwork

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.82.0
published on Monday, Oct 5, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.82.0
published on Monday, Oct 5, 2026 by Pulumi

    Resource Type definition for AWS::EC2::SecondaryNetwork. Creates a secondary network for RDMA (Remote Direct Memory Access) connectivity.

    Create SecondaryNetwork Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new SecondaryNetwork(name: string, args: SecondaryNetworkArgs, opts?: CustomResourceOptions);
    @overload
    def SecondaryNetwork(resource_name: str,
                         args: SecondaryNetworkArgs,
                         opts: Optional[ResourceOptions] = None)
    
    @overload
    def SecondaryNetwork(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         ipv4_cidr_block: Optional[str] = None,
                         network_type: Optional[SecondaryNetworkNetworkType] = None,
                         tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewSecondaryNetwork(ctx *Context, name string, args SecondaryNetworkArgs, opts ...ResourceOption) (*SecondaryNetwork, error)
    public SecondaryNetwork(string name, SecondaryNetworkArgs args, CustomResourceOptions? opts = null)
    public SecondaryNetwork(String name, SecondaryNetworkArgs args)
    public SecondaryNetwork(String name, SecondaryNetworkArgs args, CustomResourceOptions options)
    
    type: aws-native:ec2:SecondaryNetwork
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_ec2_secondary_network" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args SecondaryNetworkArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args SecondaryNetworkArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args SecondaryNetworkArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SecondaryNetworkArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SecondaryNetworkArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    SecondaryNetwork Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The SecondaryNetwork resource accepts the following input properties:

    Ipv4CidrBlock string
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    NetworkType Pulumi.AwsNative.Ec2.SecondaryNetworkNetworkType
    The type of secondary network.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags for the secondary network.
    Ipv4CidrBlock string
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    NetworkType SecondaryNetworkNetworkType
    The type of secondary network.
    Tags TagArgs
    The tags for the secondary network.
    ipv4_cidr_block string
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    network_type "rdma"
    The type of secondary network.
    tags list(object)
    The tags for the secondary network.
    ipv4CidrBlock String
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    networkType SecondaryNetworkNetworkType
    The type of secondary network.
    tags List<Tag>
    The tags for the secondary network.
    ipv4CidrBlock string
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    networkType SecondaryNetworkNetworkType
    The type of secondary network.
    tags Tag[]
    The tags for the secondary network.
    ipv4_cidr_block str
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    network_type SecondaryNetworkNetworkType
    The type of secondary network.
    tags Sequence[TagArgs]
    The tags for the secondary network.
    ipv4CidrBlock String
    The IPv4 CIDR block for the secondary network. The CIDR block size must be between /12 and /28.
    networkType "rdma"
    The type of secondary network.
    tags List<Property Map>
    The tags for the secondary network.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the SecondaryNetwork resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Ipv4CidrBlockAssociations List<Pulumi.AwsNative.Ec2.Outputs.SecondaryNetworkIpv4CidrBlockAssociation>
    Information about the IPv4 CIDR blocks associated with the secondary network.
    OwnerId string
    The ID of the Amazon Web Services account that owns the secondary network.
    SecondaryNetworkArn string
    The Amazon Resource Name (ARN) of the secondary network.
    SecondaryNetworkId string
    The ID of the secondary network.
    Id string
    The provider-assigned unique ID for this managed resource.
    Ipv4CidrBlockAssociations []SecondaryNetworkIpv4CidrBlockAssociation
    Information about the IPv4 CIDR blocks associated with the secondary network.
    OwnerId string
    The ID of the Amazon Web Services account that owns the secondary network.
    SecondaryNetworkArn string
    The Amazon Resource Name (ARN) of the secondary network.
    SecondaryNetworkId string
    The ID of the secondary network.
    id string
    The provider-assigned unique ID for this managed resource.
    ipv4_cidr_block_associations list(object)
    Information about the IPv4 CIDR blocks associated with the secondary network.
    owner_id string
    The ID of the Amazon Web Services account that owns the secondary network.
    secondary_network_arn string
    The Amazon Resource Name (ARN) of the secondary network.
    secondary_network_id string
    The ID of the secondary network.
    id String
    The provider-assigned unique ID for this managed resource.
    ipv4CidrBlockAssociations List<SecondaryNetworkIpv4CidrBlockAssociation>
    Information about the IPv4 CIDR blocks associated with the secondary network.
    ownerId String
    The ID of the Amazon Web Services account that owns the secondary network.
    secondaryNetworkArn String
    The Amazon Resource Name (ARN) of the secondary network.
    secondaryNetworkId String
    The ID of the secondary network.
    id string
    The provider-assigned unique ID for this managed resource.
    ipv4CidrBlockAssociations SecondaryNetworkIpv4CidrBlockAssociation[]
    Information about the IPv4 CIDR blocks associated with the secondary network.
    ownerId string
    The ID of the Amazon Web Services account that owns the secondary network.
    secondaryNetworkArn string
    The Amazon Resource Name (ARN) of the secondary network.
    secondaryNetworkId string
    The ID of the secondary network.
    id str
    The provider-assigned unique ID for this managed resource.
    ipv4_cidr_block_associations Sequence[SecondaryNetworkIpv4CidrBlockAssociation]
    Information about the IPv4 CIDR blocks associated with the secondary network.
    owner_id str
    The ID of the Amazon Web Services account that owns the secondary network.
    secondary_network_arn str
    The Amazon Resource Name (ARN) of the secondary network.
    secondary_network_id str
    The ID of the secondary network.
    id String
    The provider-assigned unique ID for this managed resource.
    ipv4CidrBlockAssociations List<Property Map>
    Information about the IPv4 CIDR blocks associated with the secondary network.
    ownerId String
    The ID of the Amazon Web Services account that owns the secondary network.
    secondaryNetworkArn String
    The Amazon Resource Name (ARN) of the secondary network.
    secondaryNetworkId String
    The ID of the secondary network.

    Supporting Types

    SecondaryNetworkIpv4CidrBlockAssociation, SecondaryNetworkIpv4CidrBlockAssociationArgs

    AssociationId string
    The association ID for the IPv4 CIDR block.
    CidrBlock string
    The IPv4 CIDR block.
    State Pulumi.AwsNative.Ec2.SecondaryNetworkIpv4CidrBlockAssociationState
    The state of the CIDR block association.
    AssociationId string
    The association ID for the IPv4 CIDR block.
    CidrBlock string
    The IPv4 CIDR block.
    State SecondaryNetworkIpv4CidrBlockAssociationState
    The state of the CIDR block association.
    association_id string
    The association ID for the IPv4 CIDR block.
    cidr_block string
    The IPv4 CIDR block.
    state "associating" | "associated" | "association-failed" | "disassociating" | "disassociated" | "disassociation-failed"
    The state of the CIDR block association.
    associationId String
    The association ID for the IPv4 CIDR block.
    cidrBlock String
    The IPv4 CIDR block.
    state SecondaryNetworkIpv4CidrBlockAssociationState
    The state of the CIDR block association.
    associationId string
    The association ID for the IPv4 CIDR block.
    cidrBlock string
    The IPv4 CIDR block.
    state SecondaryNetworkIpv4CidrBlockAssociationState
    The state of the CIDR block association.
    association_id str
    The association ID for the IPv4 CIDR block.
    cidr_block str
    The IPv4 CIDR block.
    state SecondaryNetworkIpv4CidrBlockAssociationState
    The state of the CIDR block association.
    associationId String
    The association ID for the IPv4 CIDR block.
    cidrBlock String
    The IPv4 CIDR block.
    state "associating" | "associated" | "association-failed" | "disassociating" | "disassociated" | "disassociation-failed"
    The state of the CIDR block association.

    SecondaryNetworkIpv4CidrBlockAssociationState, SecondaryNetworkIpv4CidrBlockAssociationStateArgs

    Associating
    associating
    Associated
    associated
    AssociationFailed
    association-failed
    Disassociating
    disassociating
    Disassociated
    disassociated
    DisassociationFailed
    disassociation-failed
    SecondaryNetworkIpv4CidrBlockAssociationStateAssociating
    associating
    SecondaryNetworkIpv4CidrBlockAssociationStateAssociated
    associated
    SecondaryNetworkIpv4CidrBlockAssociationStateAssociationFailed
    association-failed
    SecondaryNetworkIpv4CidrBlockAssociationStateDisassociating
    disassociating
    SecondaryNetworkIpv4CidrBlockAssociationStateDisassociated
    disassociated
    SecondaryNetworkIpv4CidrBlockAssociationStateDisassociationFailed
    disassociation-failed
    "associating"
    associating
    "associated"
    associated
    "association-failed"
    association-failed
    "disassociating"
    disassociating
    "disassociated"
    disassociated
    "disassociation-failed"
    disassociation-failed
    Associating
    associating
    Associated
    associated
    AssociationFailed
    association-failed
    Disassociating
    disassociating
    Disassociated
    disassociated
    DisassociationFailed
    disassociation-failed
    Associating
    associating
    Associated
    associated
    AssociationFailed
    association-failed
    Disassociating
    disassociating
    Disassociated
    disassociated
    DisassociationFailed
    disassociation-failed
    ASSOCIATING
    associating
    ASSOCIATED
    associated
    ASSOCIATION_FAILED
    association-failed
    DISASSOCIATING
    disassociating
    DISASSOCIATED
    disassociated
    DISASSOCIATION_FAILED
    disassociation-failed
    "associating"
    associating
    "associated"
    associated
    "association-failed"
    association-failed
    "disassociating"
    disassociating
    "disassociated"
    disassociated
    "disassociation-failed"
    disassociation-failed

    SecondaryNetworkNetworkType, SecondaryNetworkNetworkTypeArgs

    Rdma
    rdma
    SecondaryNetworkNetworkTypeRdma
    rdma
    "rdma"
    rdma
    Rdma
    rdma
    Rdma
    rdma
    RDMA
    rdma
    "rdma"
    rdma

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.82.0
    published on Monday, Oct 5, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial