Creates a Dataflow Endpoint Group request.
Dataflow endpoint groups contain a list of endpoints. When the name of a dataflow endpoint group is specified in a mission profile, the Ground Station service will connect to the endpoints and flow data during a contact.
For more information about dataflow endpoint groups, see Dataflow Endpoint Groups.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{
"Type" : "AWS::GroundStation::DataflowEndpointGroup",
"Properties" : {
"ContactPostPassDurationSeconds" : Integer
,
"ContactPrePassDurationSeconds" : Integer
,
"EndpointDetails" : [ EndpointDetails, ... ]
,
"Tags" : [ Tag, ... ]
}
}
YAML
Type: AWS::GroundStation::DataflowEndpointGroup
Properties:
ContactPostPassDurationSeconds: Integer
ContactPrePassDurationSeconds: Integer
EndpointDetails:
- EndpointDetails
Tags:
- Tag
Properties
ContactPostPassDurationSeconds
-
Amount of time, in seconds, after a contact ends that the Ground Station Dataflow Endpoint Group will be in a
POSTPASS
state. A Ground Station Dataflow Endpoint Group State Change event will be emitted when the Dataflow Endpoint Group enters and exits thePOSTPASS
state.Required: No
Type: Integer
Minimum:
120
Maximum:
480
Update requires: Replacement
ContactPrePassDurationSeconds
-
Amount of time, in seconds, before a contact starts that the Ground Station Dataflow Endpoint Group will be in a
PREPASS
state. A Ground Station Dataflow Endpoint Group State Change event will be emitted when the Dataflow Endpoint Group enters and exits thePREPASS
state.Required: No
Type: Integer
Minimum:
120
Maximum:
480
Update requires: Replacement
EndpointDetails
-
List of Endpoint Details, containing address and port for each endpoint.
Required: Yes
Type: Array of EndpointDetails
Minimum:
1
Update requires: Replacement
-
Tags assigned to a resource.
Required: No
Type: Array of Tag
Update requires: No interruption
Return values
Ref
When you pass the logical ID of this resource to the intrinsic Ref
function, Ref
returns the ARN of the dataflow endpoint group. For example:
{ "Ref": "DataflowEndpointGroup" }
For the Ground Station dataflow endpoint group, Ref
returns the ARN of the dataflow endpoint group.
For more information about using the Ref
function, see Ref
.
Fn::GetAtt
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 Fn::GetAtt
.
Arn
-
The ARN of the dataflow endpoint group, such as
arn:aws:groundstation:us-east-2:1234567890:dataflow-endpoint-group/9940bf3b-d2ba-427e-9906-842b5e5d2296
. Id
-
UUID of a dataflow endpoint group.
Examples
Create a DataflowEndpointGroup
The following example creates a Ground Station DataflowEndpointGroup
JSON
{
"Resources": {
"myDataflowEndpointGroup": {
"Type": "AWS::GroundStation::DataflowEndpointGroup",
"Properties": {
"EndpointDetails": [
{
"SecurityDetails": {
"SubnetIds": [
"subnet-6782e71e"
],
"SecurityGroupIds": [
"sg-6979fe18"
],
"RoleArn": "arn:aws:iam::012345678910:role/groundstation-service-role-AWSServiceRoleForAmazonGroundStation-EXAMPLEBQ4PI"
},
"Endpoint": {
"Name": "myEndpoint",
"Address": {
"Name": "172.10.0.2",
"Port": 44720
},
"Mtu": 1500
}
}
]
}
}
}
}
YAML
Resources:
myDataflowEndpointGroup:
Type: AWS::GroundStation::DataflowEndpointGroup
Properties:
EndpointDetails:
- SecurityDetails:
SubnetIds:
- subnet-12345678
SecurityGroupIds:
- sg-87654321
RoleArn: arn:aws:iam::012345678910:role/groundstation-service-role-AWSServiceRoleForAmazonGroundStation-EXAMPLEABCDE
Endpoint:
Name: myEndpoint
Address:
Name: 172.10.0.2
Port: 44720
Mtu: 1500