Skip to content

Create Service Network Service Association

vpclattice_create_service_network_service_association R Documentation

Associates a service with a service network

Description

Associates a service with a 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 Amazon Resource Name (ARN) of the service.

serviceNetworkIdentifier

[required] The ID or Amazon Resource Name (ARN) of the service network. You must use the ARN if the resources specified in the operation 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"
  )
)