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

# AWS::CodePipeline::Pipeline ArtifactStore
<a name="aws-properties-codepipeline-pipeline-artifactstore"></a>

The S3 bucket where artifacts for the pipeline are stored.

**Note**  
You must include either `artifactStore` or `artifactStores` in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use `artifactStores`.

## Syntax
<a name="aws-properties-codepipeline-pipeline-artifactstore-syntax"></a>

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

### JSON
<a name="aws-properties-codepipeline-pipeline-artifactstore-syntax.json"></a>

```
{
  "[EncryptionKey](#cfn-codepipeline-pipeline-artifactstore-encryptionkey)" : EncryptionKey,
  "[Location](#cfn-codepipeline-pipeline-artifactstore-location)" : String,
  "[Type](#cfn-codepipeline-pipeline-artifactstore-type)" : String
}
```

### YAML
<a name="aws-properties-codepipeline-pipeline-artifactstore-syntax.yaml"></a>

```
  [EncryptionKey](#cfn-codepipeline-pipeline-artifactstore-encryptionkey): 
    EncryptionKey
  [Location](#cfn-codepipeline-pipeline-artifactstore-location): String
  [Type](#cfn-codepipeline-pipeline-artifactstore-type): String
```

## Properties
<a name="aws-properties-codepipeline-pipeline-artifactstore-properties"></a>

`EncryptionKey`  <a name="cfn-codepipeline-pipeline-artifactstore-encryptionkey"></a>
The encryption key used to encrypt the data in the artifact store, such as an Amazon Key Management Service (Amazon KMS) key. If this is undefined, the default key for Amazon S3 is used. To see an example artifact store encryption key field, see the example structure here: [AWS::CodePipeline::Pipeline](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html).  
*Required*: No  
*Type*: [EncryptionKey](aws-properties-codepipeline-pipeline-encryptionkey.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Location`  <a name="cfn-codepipeline-pipeline-artifactstore-location"></a>
The S3 bucket used for storing the artifacts for a pipeline. You can specify the name of an S3 bucket but not a folder in the bucket. A folder to contain the pipeline artifacts is created for you based on the name of the pipeline. You can use any S3 bucket in the same Amazon Region as the pipeline to store your pipeline artifacts.  
*Required*: Yes  
*Type*: String  
*Pattern*: `[a-zA-Z0-9\-\.]+`  
*Minimum*: `3`  
*Maximum*: `63`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Type`  <a name="cfn-codepipeline-pipeline-artifactstore-type"></a>
The type of the artifact store, such as S3.  
*Required*: Yes  
*Type*: String  
*Allowed values*: `S3`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)