Skip to content

Creates a service

Description

Creates a service. A service is any software application that can run on instances containers, or serverless functions within an account or virtual private cloud (VPC).

For more information, see Services in the Amazon VPC Lattice User Guide.

Usage

vpclattice_create_service(clientToken, name, tags, customDomainName,
  certificateArn, authType, idleTimeoutSeconds)

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.

  • name

[required] The name of the service. The name must be unique within the account. The valid characters are a-z, 0-9, and hyphens (-). You can't use a hyphen as the first or last character, or immediately after another hyphen.

  • tags

The tags for the service.

  • customDomainName

The custom domain name of the service.

  • certificateArn

The Amazon Resource Name (ARN) of the certificate.

  • authType

The type of IAM policy.

  • NONE: The resource does not use an IAM policy. This is the default.
  • AWS_IAM: The resource uses an IAM policy. When this type is used, auth is enabled and an auth policy is required.

  • idleTimeoutSeconds

The amount of time, in seconds, that a connection can remain idle (no data sent) before VPC Lattice closes it. The valid range is 60 to 600 seconds. If you don't specify a value, the default is 60 seconds. This setting does not change the maximum connection duration of 10 minutes; connections are still closed when they reach that limit.

Value

A list with the following syntax:

list(
  id = "string",
  arn = "string",
  name = "string",
  customDomainName = "string",
  certificateArn = "string",
  status = "ACTIVE"|"CREATE_IN_PROGRESS"|"DELETE_IN_PROGRESS"|"CREATE_FAILED"|"DELETE_FAILED",
  authType = "NONE"|"AWS_IAM",
  idleTimeoutSeconds = 123,
  dnsEntry = list(
    domainName = "string",
    hostedZoneId = "string"
  )
)

Request syntax

svc$create_service(
  clientToken = "string",
  name = "string",
  tags = list(
    "string"
  ),
  customDomainName = "string",
  certificateArn = "string",
  authType = "NONE"|"AWS_IAM",
  idleTimeoutSeconds = 123
)