Skip to content

Create Service Network Service Association

vpclattice_create_service_network_service_association R Documentation

Associates the specified service with the specified service network

Description

Associates the specified service with the specified service network. For more information, see Manage service associations in the Amazon VPC Lattice User Guide.

You can't use this operation if the service and service network are already associated or if there is a disassociation or deletion in progress. If the association fails, you can retry the operation by deleting the association and recreating it.

You cannot associate a service and service network that are shared with a caller. The caller must own either the service or the service network.

As a result of this operation, the association is created in the service network account and the association owner account.

Usage

vpclattice_create_service_network_service_association(clientToken,
  serviceIdentifier, serviceNetworkIdentifier, tags)

Arguments

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token and parameters, the retry succeeds without performing any actions. If the parameters aren't identical, the retry fails.

serviceIdentifier

[required] The ID or ARN of the service.

serviceNetworkIdentifier

[required] The ID or ARN of the service network. You must use an ARN if the resources are in different accounts.

tags

The tags for the association.

Value

A list with the following syntax: 

list(
  arn = "string",
  createdBy = "string",
  customDomainName = "string",
  dnsEntry = list(
    domainName = "string",
    hostedZoneId = "string"
  ),
  id = "string",
  status = "CREATE_IN_PROGRESS"|"ACTIVE"|"DELETE_IN_PROGRESS"|"CREATE_FAILED"|"DELETE_FAILED"
)

Request syntax

svc$create_service_network_service_association(
  clientToken = "string",
  serviceIdentifier = "string",
  serviceNetworkIdentifier = "string",
  tags = list(
    "string"
  )
)