AWS::MediaConnect::FlowEntitlement
The AWS::MediaConnect::FlowEntitlement resource defines the permission that an AWS account grants to another AWS account to allow access to the content in a specific AWS Elemental MediaConnect flow. The content originator grants an entitlement to a specific AWS account (the subscriber). When an entitlement is granted, the subscriber can create a flow using the originator's flow as the source. Each flow can have up to 50 entitlements.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "Type" : "AWS::MediaConnect::FlowEntitlement", "Properties" : { "DataTransferSubscriberFeePercent" :
Integer
, "Description" :String
, "Encryption" :Encryption
, "EntitlementStatus" :String
, "FlowArn" :String
, "Name" :String
, "Subscribers" :[ String, ... ]
} }
YAML
Type: AWS::MediaConnect::FlowEntitlement Properties: DataTransferSubscriberFeePercent:
Integer
Description:String
Encryption:Encryption
EntitlementStatus:String
FlowArn:String
Name:String
Subscribers:- String
Properties
DataTransferSubscriberFeePercent
-
The percentage of the entitlement data transfer fee that you want the subscriber to be responsible for.
Required: No
Type: Integer
Update requires: Replacement
Description
-
A description of the entitlement. This description appears only on the MediaConnect console and is not visible outside of the current AWS account.
Required: Yes
Type: String
Update requires: No interruption
Encryption
-
The type of encryption that MediaConnect will use on the output that is associated with the entitlement.
Required: No
Type: Encryption
Update requires: No interruption
EntitlementStatus
-
An indication of whether the new entitlement should be enabled or disabled as soon as it is created. If you don’t specify the entitlementStatus field in your request, MediaConnect sets it to ENABLED.
Required: No
Type: String
Allowed values:
ENABLED | DISABLED
Update requires: No interruption
FlowArn
-
The Amazon Resource Name (ARN) of the flow.
Required: Yes
Type: String
Update requires: No interruption
Name
-
The name of the entitlement. This value must be unique within the current flow.
Required: Yes
Type: String
Update requires: Replacement
Subscribers
-
The AWS account IDs that you want to share your content with. The receiving accounts (subscribers) will be allowed to create their own flows using your content as the source.
Required: Yes
Type: Array of String
Update requires: No interruption
Return values
Ref
When you pass the logical ID of this resource to the intrinsic Ref
function, Ref
returns the entitlement ARN. For example:
{ "Ref":
"arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement"
}
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
.
EntitlementArn
-
The entitlement ARN.