# CreateTransitGatewayMulticastDomain


Creates a multicast domain using the specified transit gateway.

The transit gateway must be in the available state before you create a domain. Use [DescribeTransitGateways](https://docs.amazonaws.cn/AWSEC2/latest/APIReference/API_DescribeTransitGateways.html) to see the state of transit gateway.

## Request Parameters


The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see [Common Query Parameters](CommonParameters.md).

 **DryRun**   
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.  
Type: Boolean  
Required: No

 **Options**   
The options for the transit gateway multicast domain.  
Type: [CreateTransitGatewayMulticastDomainRequestOptions](API_CreateTransitGatewayMulticastDomainRequestOptions.md) object  
Required: No

 **TagSpecification.N**   
The tags for the transit gateway multicast domain.  
Type: Array of [TagSpecification](API_TagSpecification.md) objects  
Required: No

 **TransitGatewayId**   
The ID of the transit gateway.  
Type: String  
Required: Yes

## Response Elements


The following elements are returned by the service.

 **requestId**   
The ID of the request.  
Type: String

 **transitGatewayMulticastDomain**   
Information about the transit gateway multicast domain.  
Type: [TransitGatewayMulticastDomain](API_TransitGatewayMulticastDomain.md) object

## Errors


For information about the errors that are common to all actions, see [Common client error codes](errors-overview.md#CommonErrors).

## Examples


### Example 1


This example creates a multicast domain for the specified transit gateway.

#### Sample Request


```
https://ec2.amazonaws.com/?Action=CreateTransitMulticastDomain
&TransitGatewayId=tgw-0d88d2d0d5EXAMPLE
&AUTHPARAMS
```

#### Sample Response


```
<CreateTransitGatewayMulticastDomainResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
    <requestId>763fb04b-258f-4710-8f91-b202aEXAMPLE</requestId>
    <transitGatewayMulticastDomain>
        <creationTime>2019-11-20T22:02:03.000Z</creationTime>
        <state>pending</state>
        <transitGatewayId>tgw-0d88d2d0d5EXAMPLE</transitGatewayId>
        <transitGatewayMulticastDomainId>tgw-mcast-domain-02bb79002EXAMPLE</transitGatewayMulticastDomainId>
    </transitGatewayMulticastDomain>
</CreateTransitGatewayMulticastDomainResponse>
```

## See Also


For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/ec2-2016-11-15/CreateTransitGatewayMulticastDomain) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/ec2-2016-11-15/CreateTransitGatewayMulticastDomain)