1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. vpclattice
  5. ServiceNetworkVpcAssociation

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

AWS Cloud Control v1.46.0 published on Monday, Dec 29, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.vpclattice.ServiceNetworkVpcAssociation

aws-native logo

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

AWS Cloud Control v1.46.0 published on Monday, Dec 29, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Associates a VPC with a service network.

    Create ServiceNetworkVpcAssociation Resource

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

    Constructor syntax

    new ServiceNetworkVpcAssociation(name: string, args?: ServiceNetworkVpcAssociationArgs, opts?: CustomResourceOptions);
    @overload
def ServiceNetworkVpcAssociation(resource_name: str,
                                 args: Optional[ServiceNetworkVpcAssociationArgs] = None,
                                 opts: Optional[ResourceOptions] = None)

@overload
def ServiceNetworkVpcAssociation(resource_name: str,
                                 opts: Optional[ResourceOptions] = None,
                                 dns_options: Optional[ServiceNetworkVpcAssociationDnsOptionsArgs] = None,
                                 private_dns_enabled: Optional[bool] = None,
                                 security_group_ids: Optional[Sequence[str]] = None,
                                 service_network_identifier: Optional[str] = None,
                                 tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                                 vpc_identifier: Optional[str] = None)
    func NewServiceNetworkVpcAssociation(ctx *Context, name string, args *ServiceNetworkVpcAssociationArgs, opts ...ResourceOption) (*ServiceNetworkVpcAssociation, error)
    public ServiceNetworkVpcAssociation(string name, ServiceNetworkVpcAssociationArgs? args = null, CustomResourceOptions? opts = null)
    public ServiceNetworkVpcAssociation(String name, ServiceNetworkVpcAssociationArgs args)
public ServiceNetworkVpcAssociation(String name, ServiceNetworkVpcAssociationArgs args, CustomResourceOptions options)

    type: aws-native:vpclattice:ServiceNetworkVpcAssociation
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args ServiceNetworkVpcAssociationArgs
    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 ServiceNetworkVpcAssociationArgs
    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 ServiceNetworkVpcAssociationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ServiceNetworkVpcAssociationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ServiceNetworkVpcAssociationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    ServiceNetworkVpcAssociation 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 ServiceNetworkVpcAssociation resource accepts the following input properties:

    DnsOptions Pulumi.AwsNative.VpcLattice.Inputs.ServiceNetworkVpcAssociationDnsOptions
    The DNS options for the service network VPC association.
    PrivateDnsEnabled bool
    Indicates if private DNS is enabled for the service network VPC association.
    SecurityGroupIds List<string>
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    ServiceNetworkIdentifier string
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags for the association.
    VpcIdentifier string
    The ID of the VPC.
    DnsOptions ServiceNetworkVpcAssociationDnsOptionsArgs
    The DNS options for the service network VPC association.
    PrivateDnsEnabled bool
    Indicates if private DNS is enabled for the service network VPC association.
    SecurityGroupIds []string
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    ServiceNetworkIdentifier string
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    Tags TagArgs
    The tags for the association.
    VpcIdentifier string
    The ID of the VPC.
    dnsOptions ServiceNetworkVpcAssociationDnsOptions
    The DNS options for the service network VPC association.
    privateDnsEnabled Boolean
    Indicates if private DNS is enabled for the service network VPC association.
    securityGroupIds List<String>
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    serviceNetworkIdentifier String
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    tags List<Tag>
    The tags for the association.
    vpcIdentifier String
    The ID of the VPC.
    dnsOptions ServiceNetworkVpcAssociationDnsOptions
    The DNS options for the service network VPC association.
    privateDnsEnabled boolean
    Indicates if private DNS is enabled for the service network VPC association.
    securityGroupIds string[]
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    serviceNetworkIdentifier string
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    tags Tag[]
    The tags for the association.
    vpcIdentifier string
    The ID of the VPC.
    dns_options ServiceNetworkVpcAssociationDnsOptionsArgs
    The DNS options for the service network VPC association.
    private_dns_enabled bool
    Indicates if private DNS is enabled for the service network VPC association.
    security_group_ids Sequence[str]
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    service_network_identifier str
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    tags Sequence[TagArgs]
    The tags for the association.
    vpc_identifier str
    The ID of the VPC.
    dnsOptions Property Map
    The DNS options for the service network VPC association.
    privateDnsEnabled Boolean
    Indicates if private DNS is enabled for the service network VPC association.
    securityGroupIds List<String>
    The IDs of the security groups. Security groups aren't added by default. You can add a security group to apply network level controls to control which resources in a VPC are allowed to access the service network and its services. For more information, see Control traffic to resources using security groups in the Amazon VPC User Guide .
    serviceNetworkIdentifier String
    The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.
    tags List<Property Map>
    The tags for the association.
    vpcIdentifier String
    The ID of the VPC.

    Outputs

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

    Arn string
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    AwsId string
    The ID of the specified association between the service network and the VPC.
    CreatedAt string
    The date and time that the association was created, specified in ISO-8601 format.
    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceNetworkArn string
    The Amazon Resource Name (ARN) of the service network.
    ServiceNetworkId string
    The ID of the service network.
    ServiceNetworkName string
    The name of the service network.
    Status Pulumi.AwsNative.VpcLattice.ServiceNetworkVpcAssociationStatus
    The status of the association.
    VpcId string
    The ID of the VPC.
    Arn string
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    AwsId string
    The ID of the specified association between the service network and the VPC.
    CreatedAt string
    The date and time that the association was created, specified in ISO-8601 format.
    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceNetworkArn string
    The Amazon Resource Name (ARN) of the service network.
    ServiceNetworkId string
    The ID of the service network.
    ServiceNetworkName string
    The name of the service network.
    Status ServiceNetworkVpcAssociationStatus
    The status of the association.
    VpcId string
    The ID of the VPC.
    arn String
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    awsId String
    The ID of the specified association between the service network and the VPC.
    createdAt String
    The date and time that the association was created, specified in ISO-8601 format.
    id String
    The provider-assigned unique ID for this managed resource.
    serviceNetworkArn String
    The Amazon Resource Name (ARN) of the service network.
    serviceNetworkId String
    The ID of the service network.
    serviceNetworkName String
    The name of the service network.
    status ServiceNetworkVpcAssociationStatus
    The status of the association.
    vpcId String
    The ID of the VPC.
    arn string
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    awsId string
    The ID of the specified association between the service network and the VPC.
    createdAt string
    The date and time that the association was created, specified in ISO-8601 format.
    id string
    The provider-assigned unique ID for this managed resource.
    serviceNetworkArn string
    The Amazon Resource Name (ARN) of the service network.
    serviceNetworkId string
    The ID of the service network.
    serviceNetworkName string
    The name of the service network.
    status ServiceNetworkVpcAssociationStatus
    The status of the association.
    vpcId string
    The ID of the VPC.
    arn str
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    aws_id str
    The ID of the specified association between the service network and the VPC.
    created_at str
    The date and time that the association was created, specified in ISO-8601 format.
    id str
    The provider-assigned unique ID for this managed resource.
    service_network_arn str
    The Amazon Resource Name (ARN) of the service network.
    service_network_id str
    The ID of the service network.
    service_network_name str
    The name of the service network.
    status ServiceNetworkVpcAssociationStatus
    The status of the association.
    vpc_id str
    The ID of the VPC.
    arn String
    The Amazon Resource Name (ARN) of the association between the service network and the VPC.
    awsId String
    The ID of the specified association between the service network and the VPC.
    createdAt String
    The date and time that the association was created, specified in ISO-8601 format.
    id String
    The provider-assigned unique ID for this managed resource.
    serviceNetworkArn String
    The Amazon Resource Name (ARN) of the service network.
    serviceNetworkId String
    The ID of the service network.
    serviceNetworkName String
    The name of the service network.
    status "CREATE_IN_PROGRESS" | "ACTIVE" | "UPDATE_IN_PROGRESS" | "DELETE_IN_PROGRESS" | "CREATE_FAILED" | "DELETE_FAILED"
    The status of the association.
    vpcId String
    The ID of the VPC.

    Supporting Types

    ServiceNetworkVpcAssociationDnsOptions, ServiceNetworkVpcAssociationDnsOptionsArgs

    PrivateDnsPreference Pulumi.AwsNative.VpcLattice.ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    PrivateDnsSpecifiedDomains List<string>
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .
    PrivateDnsPreference ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    PrivateDnsSpecifiedDomains []string
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .
    privateDnsPreference ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    privateDnsSpecifiedDomains List<String>
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .
    privateDnsPreference ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    privateDnsSpecifiedDomains string[]
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .
    private_dns_preference ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    private_dns_specified_domains Sequence[str]
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .
    privateDnsPreference "VERIFIED_DOMAINS_ONLY" | "ALL_DOMAINS" | "VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS" | "SPECIFIED_DOMAINS_ONLY"
    The preference for which private domains have a private hosted zone created for and associated with the specified VPC. Only supported when private DNS is enabled and when the VPC endpoint type is ServiceNetwork or Resource.
    privateDnsSpecifiedDomains List<String>
    Indicates which of the private domains to create private hosted zones for and associate with the specified VPC. Only supported when private DNS is enabled and the private DNS preference is VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS or SPECIFIED_DOMAINS_ONLY .

    ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreference, ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreferenceArgs

    VerifiedDomainsOnly
    VERIFIED_DOMAINS_ONLY
    AllDomains
    ALL_DOMAINS
    VerifiedDomainsAndSpecifiedDomains
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    SpecifiedDomainsOnly
    SPECIFIED_DOMAINS_ONLY
    ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreferenceVerifiedDomainsOnly
    VERIFIED_DOMAINS_ONLY
    ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreferenceAllDomains
    ALL_DOMAINS
    ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreferenceVerifiedDomainsAndSpecifiedDomains
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    ServiceNetworkVpcAssociationDnsOptionsPrivateDnsPreferenceSpecifiedDomainsOnly
    SPECIFIED_DOMAINS_ONLY
    VerifiedDomainsOnly
    VERIFIED_DOMAINS_ONLY
    AllDomains
    ALL_DOMAINS
    VerifiedDomainsAndSpecifiedDomains
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    SpecifiedDomainsOnly
    SPECIFIED_DOMAINS_ONLY
    VerifiedDomainsOnly
    VERIFIED_DOMAINS_ONLY
    AllDomains
    ALL_DOMAINS
    VerifiedDomainsAndSpecifiedDomains
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    SpecifiedDomainsOnly
    SPECIFIED_DOMAINS_ONLY
    VERIFIED_DOMAINS_ONLY
    VERIFIED_DOMAINS_ONLY
    ALL_DOMAINS
    ALL_DOMAINS
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    SPECIFIED_DOMAINS_ONLY
    SPECIFIED_DOMAINS_ONLY
    "VERIFIED_DOMAINS_ONLY"
    VERIFIED_DOMAINS_ONLY
    "ALL_DOMAINS"
    ALL_DOMAINS
    "VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS"
    VERIFIED_DOMAINS_AND_SPECIFIED_DOMAINS
    "SPECIFIED_DOMAINS_ONLY"
    SPECIFIED_DOMAINS_ONLY

    ServiceNetworkVpcAssociationStatus, ServiceNetworkVpcAssociationStatusArgs

    CreateInProgress
    CREATE_IN_PROGRESS
    Active
    ACTIVE
    UpdateInProgress
    UPDATE_IN_PROGRESS
    DeleteInProgress
    DELETE_IN_PROGRESS
    CreateFailed
    CREATE_FAILED
    DeleteFailed
    DELETE_FAILED
    ServiceNetworkVpcAssociationStatusCreateInProgress
    CREATE_IN_PROGRESS
    ServiceNetworkVpcAssociationStatusActive
    ACTIVE
    ServiceNetworkVpcAssociationStatusUpdateInProgress
    UPDATE_IN_PROGRESS
    ServiceNetworkVpcAssociationStatusDeleteInProgress
    DELETE_IN_PROGRESS
    ServiceNetworkVpcAssociationStatusCreateFailed
    CREATE_FAILED
    ServiceNetworkVpcAssociationStatusDeleteFailed
    DELETE_FAILED
    CreateInProgress
    CREATE_IN_PROGRESS
    Active
    ACTIVE
    UpdateInProgress
    UPDATE_IN_PROGRESS
    DeleteInProgress
    DELETE_IN_PROGRESS
    CreateFailed
    CREATE_FAILED
    DeleteFailed
    DELETE_FAILED
    CreateInProgress
    CREATE_IN_PROGRESS
    Active
    ACTIVE
    UpdateInProgress
    UPDATE_IN_PROGRESS
    DeleteInProgress
    DELETE_IN_PROGRESS
    CreateFailed
    CREATE_FAILED
    DeleteFailed
    DELETE_FAILED
    CREATE_IN_PROGRESS
    CREATE_IN_PROGRESS
    ACTIVE
    ACTIVE
    UPDATE_IN_PROGRESS
    UPDATE_IN_PROGRESS
    DELETE_IN_PROGRESS
    DELETE_IN_PROGRESS
    CREATE_FAILED
    CREATE_FAILED
    DELETE_FAILED
    DELETE_FAILED
    "CREATE_IN_PROGRESS"
    CREATE_IN_PROGRESS
    "ACTIVE"
    ACTIVE
    "UPDATE_IN_PROGRESS"
    UPDATE_IN_PROGRESS
    "DELETE_IN_PROGRESS"
    DELETE_IN_PROGRESS
    "CREATE_FAILED"
    CREATE_FAILED
    "DELETE_FAILED"
    DELETE_FAILED

    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 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

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

    AWS Cloud Control v1.46.0 published on Monday, Dec 29, 2025 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Meet Neo: Your AI Platform Teammate