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::GameLiftStreams::StreamGroup
<a name="aws-resource-gameliftstreams-streamgroup"></a>

 Stream groups manage how Amazon GameLift Streams allocates resources and handles concurrent streams, allowing you to effectively manage capacity and costs. Within a stream group, you specify an application to stream, streaming locations and their capacity, and the stream class you want to use when streaming applications to your end-users. A stream class defines the hardware configuration of the compute resources that Amazon GameLift Streams will use when streaming, such as the CPU, GPU, and memory. 

Stream capacity represents the number of concurrent streams that can be active at a time. You set stream capacity per location, per stream group. The following capacity settings are available:
+ **Always-on capacity**: This setting, if non-zero, indicates minimum streaming capacity which is allocated to you and is never released back to the service. You pay for this base level of capacity at all times, whether used or idle.
+ **Maximum capacity**: This indicates the maximum capacity that the service can allocate for you. Newly created streams may take a few minutes to start. Capacity is released back to the service when idle. You pay for capacity that is allocated to you until it is released.
+ **Target-idle capacity**: This indicates idle capacity which the service pre-allocates and holds for you in anticipation of future activity. This helps to insulate your users from capacity-allocation delays. You pay for capacity which is held in this intentional idle state.

Values for capacity must be whole number multiples of the tenancy value of the stream group's stream class.

**Note**  
Application association is not currently supported in CloudFormation. To link additional applications to a stream group, use the Amazon GameLift Streams console or the AWS CLI.

## Syntax
<a name="aws-resource-gameliftstreams-streamgroup-syntax"></a>

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

### JSON
<a name="aws-resource-gameliftstreams-streamgroup-syntax.json"></a>

```
{
  "Type" : "AWS::GameLiftStreams::StreamGroup",
  "Properties" : {
      "[DefaultApplication](#cfn-gameliftstreams-streamgroup-defaultapplication)" : DefaultApplication,
      "[Description](#cfn-gameliftstreams-streamgroup-description)" : String,
      "[LocationConfigurations](#cfn-gameliftstreams-streamgroup-locationconfigurations)" : [ LocationConfiguration, ... ],
      "[StreamClass](#cfn-gameliftstreams-streamgroup-streamclass)" : String,
      "[Tags](#cfn-gameliftstreams-streamgroup-tags)" : {Key: Value, ...}
    }
}
```

### YAML
<a name="aws-resource-gameliftstreams-streamgroup-syntax.yaml"></a>

```
Type: AWS::GameLiftStreams::StreamGroup
Properties:
  [DefaultApplication](#cfn-gameliftstreams-streamgroup-defaultapplication): 
    DefaultApplication
  [Description](#cfn-gameliftstreams-streamgroup-description): String
  [LocationConfigurations](#cfn-gameliftstreams-streamgroup-locationconfigurations): 
    - LocationConfiguration
  [StreamClass](#cfn-gameliftstreams-streamgroup-streamclass): String
  [Tags](#cfn-gameliftstreams-streamgroup-tags): 
    Key: Value
```

## Properties
<a name="aws-resource-gameliftstreams-streamgroup-properties"></a>

`DefaultApplication`  <a name="cfn-gameliftstreams-streamgroup-defaultapplication"></a>
Object that identifies the Amazon GameLift Streams application to stream with this stream group.  
*Required*: No  
*Type*: [DefaultApplication](aws-properties-gameliftstreams-streamgroup-defaultapplication.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Description`  <a name="cfn-gameliftstreams-streamgroup-description"></a>
A descriptive label for the stream group.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-_.!+@/][a-zA-Z0-9-_.!+@/ ]*$`  
*Minimum*: `1`  
*Maximum*: `80`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LocationConfigurations`  <a name="cfn-gameliftstreams-streamgroup-locationconfigurations"></a>
 A set of one or more locations and the streaming capacity for each location. One of the locations MUST be your primary location, which is the AWS Region where you are specifying this resource.   
*Required*: Yes  
*Type*: Array of [LocationConfiguration](aws-properties-gameliftstreams-streamgroup-locationconfiguration.md)  
*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)

`StreamClass`  <a name="cfn-gameliftstreams-streamgroup-streamclass"></a>
The target stream quality for sessions that are hosted in this stream group. Set a stream class that is appropriate to the type of content that you're streaming. Stream class determines the type of computing resources Amazon GameLift Streams uses and impacts the cost of streaming. The following options are available:   
A stream class can be one of the following:  
+ **`gen6n_pro_win2022` (NVIDIA, pro)** Supports applications with extremely high 3D scene complexity which require maximum resources. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.6, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 16 vCPUs, 64 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen6n_pro` (NVIDIA, pro)** Supports applications with extremely high 3D scene complexity which require maximum resources. Uses dedicated NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 16 vCPUs, 64 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen6n_ultra_win2022` (NVIDIA, ultra)** Supports applications with high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.6, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen6n_ultra` (NVIDIA, ultra)** Supports applications with high 3D scene complexity. Uses dedicated NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen6n_high` (NVIDIA, high)** Supports applications with moderate to high 3D scene complexity. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 4 vCPUs, 16 GB RAM, 12 GB VRAM
  + Tenancy: Supports up to 2 concurrent stream sessions
+ **`gen6n_medium` (NVIDIA, medium)** Supports applications with moderate 3D scene complexity. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 2 vCPUs, 8 GB RAM, 6 GB VRAM
  + Tenancy: Supports up to 4 concurrent stream sessions
+ **`gen6n_small` (NVIDIA, small)** Supports applications with lightweight 3D scene complexity and low CPU usage. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 1 vCPUs, 4 GB RAM, 2 GB VRAM
  + Tenancy: Supports up to 12 concurrent stream sessions
+ **`gen6n_medium_win2022` (NVIDIA, medium)** Supports applications with low 3D scene complexity. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 6 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen6n_small_win2022` (NVIDIA, small)** Supports applications with low 3D scene complexity. Uses NVIDIA L4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 2 vCPUs, 8 GB RAM, 3 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen5n_win2022` (NVIDIA, ultra)** Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.6, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA A10G Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen5n_high` (NVIDIA, high)** Supports applications with moderate to high 3D scene complexity. Uses NVIDIA A10G Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 4 vCPUs, 16 GB RAM, 12 GB VRAM
  + Tenancy: Supports up to 2 concurrent stream sessions
+ **`gen5n_ultra` (NVIDIA, ultra)** Supports applications with extremely high 3D scene complexity. Uses dedicated NVIDIA A10G Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen4n_win2022` (NVIDIA, ultra)** Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.6, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA T4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
+ **`gen4n_high` (NVIDIA, high)** Supports applications with moderate to high 3D scene complexity. Uses NVIDIA T4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 4 vCPUs, 16 GB RAM, 8 GB VRAM
  + Tenancy: Supports up to 2 concurrent stream sessions
+ **`gen4n_ultra` (NVIDIA, ultra)** Supports applications with high 3D scene complexity. Uses dedicated NVIDIA T4 Tensor Core GPU.
  + Reference resolution: 1080p
  + Reference frame rate: 60 fps
  + Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
  + Tenancy: Supports 1 concurrent stream session
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `20`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Tags`  <a name="cfn-gameliftstreams-streamgroup-tags"></a>
A list of labels to assign to the new stream group resource. Tags are developer-defined key-value pairs. Tagging AWS resources is useful for resource management, access management and cost allocation. See [ Tagging AWS Resources](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) in the *AWS General Reference*.  
*Required*: No  
*Type*: Object of String  
*Pattern*: `.+`  
*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)

## Return values
<a name="aws-resource-gameliftstreams-streamgroup-return-values"></a>

### Ref
<a name="aws-resource-gameliftstreams-streamgroup-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns an [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) that uniquely identifies the stream group resource across all AWS Regions. For example:

 `arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4` 

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-gameliftstreams-streamgroup-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-gameliftstreams-streamgroup-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
An [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) that uniquely identifies the stream group resource. For example: `arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4`. 

`Id`  <a name="Id-fn::getatt"></a>
 An ID that uniquely identifies the stream group resource. For example: `sg-1AB2C3De4`. 

## See also
<a name="aws-resource-gameliftstreams-streamgroup--seealso"></a>
+ [Manage streaming with an Amazon GameLift Streams stream group](https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/stream-groups.html) in the *Amazon GameLift Streams Developer Guide*
+ [CreateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateStreamGroup.html) in the *Amazon GameLift Streams API Reference*



# AWS::GameLiftStreams::StreamGroup DefaultApplication
<a name="aws-properties-gameliftstreams-streamgroup-defaultapplication"></a>

Represents the default Amazon GameLift Streams application that a stream group hosts.

## Syntax
<a name="aws-properties-gameliftstreams-streamgroup-defaultapplication-syntax"></a>

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

### JSON
<a name="aws-properties-gameliftstreams-streamgroup-defaultapplication-syntax.json"></a>

```
{
  "[Arn](#cfn-gameliftstreams-streamgroup-defaultapplication-arn)" : String,
  "[Id](#cfn-gameliftstreams-streamgroup-defaultapplication-id)" : String
}
```

### YAML
<a name="aws-properties-gameliftstreams-streamgroup-defaultapplication-syntax.yaml"></a>

```
  [Arn](#cfn-gameliftstreams-streamgroup-defaultapplication-arn): String
  [Id](#cfn-gameliftstreams-streamgroup-defaultapplication-id): String
```

## Properties
<a name="aws-properties-gameliftstreams-streamgroup-defaultapplication-properties"></a>

`Arn`  <a name="cfn-gameliftstreams-streamgroup-defaultapplication-arn"></a>
An [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) that uniquely identifies the application resource. Example ARN: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`.   
*Required*: No  
*Type*: String  
*Pattern*: `^arn:aws:gameliftstreams:([^: ]*):([0-9]{12}):([^: ]*)$`  
*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)

`Id`  <a name="cfn-gameliftstreams-streamgroup-defaultapplication-id"></a>
An ID that uniquely identifies the application resource. Example ID: `a-9ZY8X7Wv6`.   
*Required*: No  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-]+$`  
*Minimum*: `1`  
*Maximum*: `32`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

# AWS::GameLiftStreams::StreamGroup LocationConfiguration
<a name="aws-properties-gameliftstreams-streamgroup-locationconfiguration"></a>

Configuration settings that define a stream group's stream capacity for a location. When configuring a location for the first time, you must specify a numeric value for at least one of the two capacity types.

## Syntax
<a name="aws-properties-gameliftstreams-streamgroup-locationconfiguration-syntax"></a>

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

### JSON
<a name="aws-properties-gameliftstreams-streamgroup-locationconfiguration-syntax.json"></a>

```
{
  "[AlwaysOnCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-alwaysoncapacity)" : Integer,
  "[LocationName](#cfn-gameliftstreams-streamgroup-locationconfiguration-locationname)" : String,
  "[MaximumCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-maximumcapacity)" : Integer,
  "[OnDemandCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-ondemandcapacity)" : Integer,
  "[TargetIdleCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-targetidlecapacity)" : Integer,
  "[VpcTransitConfiguration](#cfn-gameliftstreams-streamgroup-locationconfiguration-vpctransitconfiguration)" : VpcTransitConfiguration
}
```

### YAML
<a name="aws-properties-gameliftstreams-streamgroup-locationconfiguration-syntax.yaml"></a>

```
  [AlwaysOnCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-alwaysoncapacity): Integer
  [LocationName](#cfn-gameliftstreams-streamgroup-locationconfiguration-locationname): String
  [MaximumCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-maximumcapacity): Integer
  [OnDemandCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-ondemandcapacity): Integer
  [TargetIdleCapacity](#cfn-gameliftstreams-streamgroup-locationconfiguration-targetidlecapacity): Integer
  [VpcTransitConfiguration](#cfn-gameliftstreams-streamgroup-locationconfiguration-vpctransitconfiguration): 
    VpcTransitConfiguration
```

## Properties
<a name="aws-properties-gameliftstreams-streamgroup-locationconfiguration-properties"></a>

`AlwaysOnCapacity`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-alwaysoncapacity"></a>
This setting, if non-zero, indicates minimum streaming capacity which is allocated to you and is never released back to the service. You pay for this base level of capacity at all times, whether used or idle.  
*Required*: No  
*Type*: Integer  
*Minimum*: `0`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LocationName`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-locationname"></a>
 A location's name. For example, `us-east-1`. For a complete list of locations that Amazon GameLift Streams supports, refer to [Regions, quotas, and limitations](https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/regions-quotas.html) in the *Amazon GameLift Streams Developer Guide*.   
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-]+$`  
*Minimum*: `1`  
*Maximum*: `20`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`MaximumCapacity`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-maximumcapacity"></a>
This indicates the maximum capacity that the service can allocate for you. Newly created streams may take a few minutes to start. Capacity is released back to the service when idle. You pay for capacity that is allocated to you until it is released.  
*Required*: No  
*Type*: Integer  
*Minimum*: `0`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`OnDemandCapacity`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-ondemandcapacity"></a>
This field is deprecated. Use MaximumCapacity instead. This parameter is ignored when MaximumCapacity is specified.  
The streaming capacity that Amazon GameLift Streams can allocate in response to stream requests, and then de-allocate when the session has terminated. This offers a cost control measure at the expense of a greater startup time (typically under 5 minutes). Default is 0 when you create a stream group or add a location.  
*Required*: No  
*Type*: Integer  
*Minimum*: `0`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TargetIdleCapacity`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-targetidlecapacity"></a>
This indicates idle capacity which the service pre-allocates and holds for you in anticipation of future activity. This helps to insulate your users from capacity-allocation delays. You pay for capacity which is held in this intentional idle state.  
*Required*: No  
*Type*: Integer  
*Minimum*: `0`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`VpcTransitConfiguration`  <a name="cfn-gameliftstreams-streamgroup-locationconfiguration-vpctransitconfiguration"></a>
Configuration for connecting the stream group to resources in your Amazon VPC using a Transit Gateway. This setting is optional. If specified, Amazon GameLift Streams creates a Transit Gateway to enable private network connectivity between the service VPC and your VPC. The VPC ID cannot be changed after the stream group is created, but you can update the CIDR blocks.  
*Required*: No  
*Type*: [VpcTransitConfiguration](aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::GameLiftStreams::StreamGroup VpcTransitConfiguration
<a name="aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration"></a>

Configuration for connecting a stream group location to resources in your Amazon VPC using a Transit Gateway. When you specify a VPC transit configuration, Amazon GameLift Streams creates a Transit Gateway and shares it with your account using Resource Access Manager. After the stream group is active, you must complete the setup by accepting the resource share, creating a VPC attachment, and configuring routing.

## Syntax
<a name="aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration-syntax"></a>

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

### JSON
<a name="aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration-syntax.json"></a>

```
{
  "[Ipv4CidrBlocks](#cfn-gameliftstreams-streamgroup-vpctransitconfiguration-ipv4cidrblocks)" : [ String, ... ],
  "[VpcId](#cfn-gameliftstreams-streamgroup-vpctransitconfiguration-vpcid)" : String
}
```

### YAML
<a name="aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration-syntax.yaml"></a>

```
  [Ipv4CidrBlocks](#cfn-gameliftstreams-streamgroup-vpctransitconfiguration-ipv4cidrblocks): 
    - String
  [VpcId](#cfn-gameliftstreams-streamgroup-vpctransitconfiguration-vpcid): String
```

## Properties
<a name="aws-properties-gameliftstreams-streamgroup-vpctransitconfiguration-properties"></a>

`Ipv4CidrBlocks`  <a name="cfn-gameliftstreams-streamgroup-vpctransitconfiguration-ipv4cidrblocks"></a>
A list of IPv4 CIDR blocks in your VPC that you want the stream group to be able to access. You can specify up to 5 CIDR blocks. The CIDR blocks must be valid subsets of the VPC's CIDR blocks and cannot overlap with the service VPC CIDR block.  
*Required*: Yes  
*Type*: Array of String  
*Minimum*: `1`  
*Maximum*: `5`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`VpcId`  <a name="cfn-gameliftstreams-streamgroup-vpctransitconfiguration-vpcid"></a>
The ID of the Amazon VPC that you want to connect to the stream group. The VPC must be in the same AWS account as the stream group. This value cannot be changed after the stream group is created.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `32`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)