This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS Proton
<a name="AWS_Proton"></a>

**Resource types**
+ [AWS::Proton::EnvironmentAccountConnection](aws-resource-proton-environmentaccountconnection.md)
+ [AWS::Proton::EnvironmentTemplate](aws-resource-proton-environmenttemplate.md)
+ [AWS::Proton::ServiceTemplate](aws-resource-proton-servicetemplate.md)

# AWS::Proton::EnvironmentAccountConnection
<a name="aws-resource-proton-environmentaccountconnection"></a>

Detailed data of an AWS Proton environment account connection resource.

## Syntax
<a name="aws-resource-proton-environmentaccountconnection-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-proton-environmentaccountconnection-syntax.json"></a>

```
{
  "Type" : "AWS::Proton::EnvironmentAccountConnection",
  "Properties" : {
      "[CodebuildRoleArn](#cfn-proton-environmentaccountconnection-codebuildrolearn)" : String,
      "[ComponentRoleArn](#cfn-proton-environmentaccountconnection-componentrolearn)" : String,
      "[EnvironmentAccountId](#cfn-proton-environmentaccountconnection-environmentaccountid)" : String,
      "[EnvironmentName](#cfn-proton-environmentaccountconnection-environmentname)" : String,
      "[ManagementAccountId](#cfn-proton-environmentaccountconnection-managementaccountid)" : String,
      "[RoleArn](#cfn-proton-environmentaccountconnection-rolearn)" : String,
      "[Tags](#cfn-proton-environmentaccountconnection-tags)" : [ Tag, ... ]
    }
}
```

### YAML
<a name="aws-resource-proton-environmentaccountconnection-syntax.yaml"></a>

```
Type: AWS::Proton::EnvironmentAccountConnection
Properties:
  [CodebuildRoleArn](#cfn-proton-environmentaccountconnection-codebuildrolearn): String
  [ComponentRoleArn](#cfn-proton-environmentaccountconnection-componentrolearn): String
  [EnvironmentAccountId](#cfn-proton-environmentaccountconnection-environmentaccountid): String
  [EnvironmentName](#cfn-proton-environmentaccountconnection-environmentname): String
  [ManagementAccountId](#cfn-proton-environmentaccountconnection-managementaccountid): String
  [RoleArn](#cfn-proton-environmentaccountconnection-rolearn): String
  [Tags](#cfn-proton-environmentaccountconnection-tags): 
    - Tag
```

## Properties
<a name="aws-resource-proton-environmentaccountconnection-properties"></a>

`CodebuildRoleArn`  <a name="cfn-proton-environmentaccountconnection-codebuildrolearn"></a>
The Amazon Resource Name (ARN) of an IAM service role in the environment account. AWS Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account.  
*Required*: No  
*Type*: String  
*Pattern*: `^arn:(aws|aws-cn|aws-us-gov):iam::\d{12}:role/([\w+=,.@-]{1,512}[/:])*([\w+=,.@-]{1,64})$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ComponentRoleArn`  <a name="cfn-proton-environmentaccountconnection-componentrolearn"></a>
The Amazon Resource Name (ARN) of the IAM service role that AWS Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account.  
The environment account connection must have a `componentRoleArn` to allow directly defined components to be associated with any environments running in the account.  
For more information about components, see [AWS Proton components](https://docs.aws.amazon.com/proton/latest/userguide/ag-components.html) in the *AWS Proton User Guide*.  
*Required*: No  
*Type*: String  
*Pattern*: `^arn:(aws|aws-cn|aws-us-gov):iam::\d{12}:role/([\w+=,.@-]{1,512}[/:])*([\w+=,.@-]{1,64})$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EnvironmentAccountId`  <a name="cfn-proton-environmentaccountconnection-environmentaccountid"></a>
The environment account that's connected to the environment account connection.  
*Required*: No  
*Type*: String  
*Pattern*: `^\d{12}$`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EnvironmentName`  <a name="cfn-proton-environmentaccountconnection-environmentname"></a>
The name of the environment that's associated with the environment account connection.  
*Required*: No  
*Type*: String  
*Pattern*: `^[0-9A-Za-z]+[0-9A-Za-z_\-]*$`  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ManagementAccountId`  <a name="cfn-proton-environmentaccountconnection-managementaccountid"></a>
The ID of the management account that's connected to the environment account connection.  
*Required*: No  
*Type*: String  
*Pattern*: `^\d{12}$`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RoleArn`  <a name="cfn-proton-environmentaccountconnection-rolearn"></a>
The IAM service role that's associated with the environment account connection.  
*Required*: No  
*Type*: String  
*Pattern*: `^arn:(aws|aws-cn|aws-us-gov):iam::\d{12}:role/([\w+=,.@-]{1,512}[/:])*([\w+=,.@-]{1,64})$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-proton-environmentaccountconnection-tags"></a>
An optional list of metadata items that you can associate with the AWS Proton environment account connection. A tag is a key-value pair.  
For more information, see [AWS Proton resources and tagging](https://docs.aws.amazon.com/proton/latest/userguide/resources.html) in the *AWS Proton User Guide*.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-proton-environmentaccountconnection-tag.md)  
*Minimum*: `0`  
*Maximum*: `50`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-proton-environmentaccountconnection-return-values"></a>

### Ref
<a name="aws-resource-proton-environmentaccountconnection-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the ARN of the environment account connection.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-proton-environmentaccountconnection-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-proton-environmentaccountconnection-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
Returns the environment account connection ARN.

`Id`  <a name="Id-fn::getatt"></a>
Returns the environment account connection ID.

`Status`  <a name="Status-fn::getatt"></a>
Returns the environment account connection status.

# AWS::Proton::EnvironmentAccountConnection Tag
<a name="aws-properties-proton-environmentaccountconnection-tag"></a>

A description of a resource tag.

## Syntax
<a name="aws-properties-proton-environmentaccountconnection-tag-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-proton-environmentaccountconnection-tag-syntax.json"></a>

```
{
  "[Key](#cfn-proton-environmentaccountconnection-tag-key)" : String,
  "[Value](#cfn-proton-environmentaccountconnection-tag-value)" : String
}
```

### YAML
<a name="aws-properties-proton-environmentaccountconnection-tag-syntax.yaml"></a>

```
  [Key](#cfn-proton-environmentaccountconnection-tag-key): String
  [Value](#cfn-proton-environmentaccountconnection-tag-value): String
```

## Properties
<a name="aws-properties-proton-environmentaccountconnection-tag-properties"></a>

`Key`  <a name="cfn-proton-environmentaccountconnection-tag-key"></a>
The key of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-proton-environmentaccountconnection-tag-value"></a>
The value of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::Proton::EnvironmentTemplate
<a name="aws-resource-proton-environmenttemplate"></a>

Create an environment template for AWS Proton. For more information, see [Environment Templates](https://docs.aws.amazon.com/proton/latest/userguide/ag-templates.html) in the *AWS Proton User Guide*.

You can create an environment template in one of the two following ways:
+ Register and publish a *standard* environment template that instructs AWS Proton to deploy and manage environment infrastructure.
+ Register and publish a *customer managed* environment template that connects AWS Proton to your existing provisioned infrastructure that you manage. AWS Proton*doesn't* manage your existing provisioned infrastructure. To create an environment template for customer provisioned and managed infrastructure, include the `provisioning` parameter and set the value to `CUSTOMER_MANAGED`. For more information, see [Register and publish an environment template](https://docs.aws.amazon.com/proton/latest/userguide/template-create.html) in the *AWS Proton User Guide*.

## Syntax
<a name="aws-resource-proton-environmenttemplate-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-proton-environmenttemplate-syntax.json"></a>

```
{
  "Type" : "AWS::Proton::EnvironmentTemplate",
  "Properties" : {
      "[Description](#cfn-proton-environmenttemplate-description)" : String,
      "[DisplayName](#cfn-proton-environmenttemplate-displayname)" : String,
      "[EncryptionKey](#cfn-proton-environmenttemplate-encryptionkey)" : String,
      "[Name](#cfn-proton-environmenttemplate-name)" : String,
      "[Provisioning](#cfn-proton-environmenttemplate-provisioning)" : String,
      "[Tags](#cfn-proton-environmenttemplate-tags)" : [ Tag, ... ]
    }
}
```

### YAML
<a name="aws-resource-proton-environmenttemplate-syntax.yaml"></a>

```
Type: AWS::Proton::EnvironmentTemplate
Properties:
  [Description](#cfn-proton-environmenttemplate-description): String
  [DisplayName](#cfn-proton-environmenttemplate-displayname): String
  [EncryptionKey](#cfn-proton-environmenttemplate-encryptionkey): String
  [Name](#cfn-proton-environmenttemplate-name): String
  [Provisioning](#cfn-proton-environmenttemplate-provisioning): String
  [Tags](#cfn-proton-environmenttemplate-tags): 
    - Tag
```

## Properties
<a name="aws-resource-proton-environmenttemplate-properties"></a>

`Description`  <a name="cfn-proton-environmenttemplate-description"></a>
A description of the environment template.  
*Required*: No  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `500`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DisplayName`  <a name="cfn-proton-environmenttemplate-displayname"></a>
The name of the environment template as displayed in the developer interface.  
*Required*: No  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EncryptionKey`  <a name="cfn-proton-environmenttemplate-encryptionkey"></a>
The customer provided encryption key for the environment template.  
*Required*: No  
*Type*: String  
*Pattern*: `^arn:(aws|aws-cn|aws-us-gov):[a-zA-Z0-9-]+:[a-zA-Z0-9-]*:\d{12}:([\w+=,.@-]+[/:])*[\w+=,.@-]+$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-proton-environmenttemplate-name"></a>
The name of the environment template.  
*Required*: No  
*Type*: String  
*Pattern*: `^[0-9A-Za-z]+[0-9A-Za-z_\-]*$`  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Provisioning`  <a name="cfn-proton-environmenttemplate-provisioning"></a>
When included, indicates that the environment template is for customer provisioned and managed infrastructure.  
*Required*: No  
*Type*: String  
*Allowed values*: `CUSTOMER_MANAGED`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Tags`  <a name="cfn-proton-environmenttemplate-tags"></a>
An optional list of metadata items that you can associate with the AWS Proton environment template. A tag is a key-value pair.  
For more information, see [AWS Proton resources and tagging](https://docs.aws.amazon.com/proton/latest/userguide/resources.html) in the *AWS Proton User Guide*.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-proton-environmenttemplate-tag.md)  
*Minimum*: `0`  
*Maximum*: `50`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-proton-environmenttemplate-return-values"></a>

### Ref
<a name="aws-resource-proton-environmenttemplate-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the ARN of the environment template.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-proton-environmenttemplate-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-proton-environmenttemplate-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
Returns the ARN of the environment template.

# AWS::Proton::EnvironmentTemplate Tag
<a name="aws-properties-proton-environmenttemplate-tag"></a>

A description of a resource tag.

## Syntax
<a name="aws-properties-proton-environmenttemplate-tag-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-proton-environmenttemplate-tag-syntax.json"></a>

```
{
  "[Key](#cfn-proton-environmenttemplate-tag-key)" : String,
  "[Value](#cfn-proton-environmenttemplate-tag-value)" : String
}
```

### YAML
<a name="aws-properties-proton-environmenttemplate-tag-syntax.yaml"></a>

```
  [Key](#cfn-proton-environmenttemplate-tag-key): String
  [Value](#cfn-proton-environmenttemplate-tag-value): String
```

## Properties
<a name="aws-properties-proton-environmenttemplate-tag-properties"></a>

`Key`  <a name="cfn-proton-environmenttemplate-tag-key"></a>
The key of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-proton-environmenttemplate-tag-value"></a>
The value of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::Proton::ServiceTemplate
<a name="aws-resource-proton-servicetemplate"></a>

Create a service template. The administrator creates a service template to define standardized infrastructure and an optional CI/CD service pipeline. Developers, in turn, select the service template from AWS Proton. If the selected service template includes a service pipeline definition, they provide a link to their source code repository. AWS Proton then deploys and manages the infrastructure defined by the selected service template. For more information, see [AWS Proton templates](https://docs.aws.amazon.com/proton/latest/userguide/ag-templates.html) in the *AWS Proton User Guide*.

## Syntax
<a name="aws-resource-proton-servicetemplate-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-proton-servicetemplate-syntax.json"></a>

```
{
  "Type" : "AWS::Proton::ServiceTemplate",
  "Properties" : {
      "[Description](#cfn-proton-servicetemplate-description)" : String,
      "[DisplayName](#cfn-proton-servicetemplate-displayname)" : String,
      "[EncryptionKey](#cfn-proton-servicetemplate-encryptionkey)" : String,
      "[Name](#cfn-proton-servicetemplate-name)" : String,
      "[PipelineProvisioning](#cfn-proton-servicetemplate-pipelineprovisioning)" : String,
      "[Tags](#cfn-proton-servicetemplate-tags)" : [ Tag, ... ]
    }
}
```

### YAML
<a name="aws-resource-proton-servicetemplate-syntax.yaml"></a>

```
Type: AWS::Proton::ServiceTemplate
Properties:
  [Description](#cfn-proton-servicetemplate-description): String
  [DisplayName](#cfn-proton-servicetemplate-displayname): String
  [EncryptionKey](#cfn-proton-servicetemplate-encryptionkey): String
  [Name](#cfn-proton-servicetemplate-name): String
  [PipelineProvisioning](#cfn-proton-servicetemplate-pipelineprovisioning): String
  [Tags](#cfn-proton-servicetemplate-tags): 
    - Tag
```

## Properties
<a name="aws-resource-proton-servicetemplate-properties"></a>

`Description`  <a name="cfn-proton-servicetemplate-description"></a>
A description of the service template.  
*Required*: No  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `500`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DisplayName`  <a name="cfn-proton-servicetemplate-displayname"></a>
The service template name as displayed in the developer interface.  
*Required*: No  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EncryptionKey`  <a name="cfn-proton-servicetemplate-encryptionkey"></a>
The customer provided service template encryption key that's used to encrypt data.  
*Required*: No  
*Type*: String  
*Pattern*: `^arn:(aws|aws-cn|aws-us-gov):[a-zA-Z0-9-]+:[a-zA-Z0-9-]*:\d{12}:([\w+=,.@-]+[/:])*[\w+=,.@-]+$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-proton-servicetemplate-name"></a>
The name of the service template.  
*Required*: No  
*Type*: String  
*Pattern*: `^[0-9A-Za-z]+[0-9A-Za-z_\-]*$`  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`PipelineProvisioning`  <a name="cfn-proton-servicetemplate-pipelineprovisioning"></a>
If `pipelineProvisioning` is `true`, a service pipeline is included in the service template. Otherwise, a service pipeline *isn't* included in the service template.  
*Required*: No  
*Type*: String  
*Allowed values*: `CUSTOMER_MANAGED`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Tags`  <a name="cfn-proton-servicetemplate-tags"></a>
An object that includes the template bundle S3 bucket path and name for the new version of a service template.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-proton-servicetemplate-tag.md)  
*Minimum*: `0`  
*Maximum*: `50`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-proton-servicetemplate-return-values"></a>

### Ref
<a name="aws-resource-proton-servicetemplate-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the ARN of the service template.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-proton-servicetemplate-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-proton-servicetemplate-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
Returns the service template ARN.

# AWS::Proton::ServiceTemplate Tag
<a name="aws-properties-proton-servicetemplate-tag"></a>

A description of a resource tag.

## Syntax
<a name="aws-properties-proton-servicetemplate-tag-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-proton-servicetemplate-tag-syntax.json"></a>

```
{
  "[Key](#cfn-proton-servicetemplate-tag-key)" : String,
  "[Value](#cfn-proton-servicetemplate-tag-value)" : String
}
```

### YAML
<a name="aws-properties-proton-servicetemplate-tag-syntax.yaml"></a>

```
  [Key](#cfn-proton-servicetemplate-tag-key): String
  [Value](#cfn-proton-servicetemplate-tag-value): String
```

## Properties
<a name="aws-properties-proton-servicetemplate-tag-properties"></a>

`Key`  <a name="cfn-proton-servicetemplate-tag-key"></a>
The key of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-proton-servicetemplate-tag-value"></a>
The value of the resource tag.  
*Required*: Yes  
*Type*: String  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)