Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::IVS::PlaybackKeyPair

Focus mode
AWS::IVS::PlaybackKeyPair - AWS CloudFormation
Filter View

The AWS::IVS::PlaybackKeyPair resource specifies an Amazon IVS playback key pair. Amazon IVS uses a public playback key to validate playback tokens that have been signed with the corresponding private key. For more information, see Setting Up Private Channels in the Amazon IVS Low-Latency Streaming User Guide.

Syntax

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

JSON

{ "Type" : "AWS::IVS::PlaybackKeyPair", "Properties" : { "Name" : String, "PublicKeyMaterial" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::IVS::PlaybackKeyPair Properties: Name: String PublicKeyMaterial: String Tags: - Tag

Properties

Name

Playback-key-pair name. The value does not need to be unique.

Required: No

Type: String

Pattern: ^[a-zA-Z0-9-_]*$

Minimum: 0

Maximum: 128

Update requires: Replacement

PublicKeyMaterial

The public portion of a customer-generated key pair. Note that this field is required to create the AWS::IVS::PlaybackKeyPair resource.

Required: No

Type: String

Update requires: Replacement

Tags

An array of key-value pairs to apply to this resource.

For more information, see Tag.

Required: No

Type: Array of Tag

Maximum: 50

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the playback key pair ARN. For example:

{ "Ref": "myPlaybackKeyPair" }

For the Amazon IVS playback key pair myPlaybackKeyPair, Ref returns the playback key pair ARN.

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

Key-pair ARN. For example: arn:aws:ivs:us-west-2:693991300569:playback-key/f99cde61-c2b0-4df3-8941-ca7d38acca1a

Fingerprint

Key-pair identifier. For example: 98:0d:1a:a0:19:96:1e:ea:0a:0a:2c:9a:42:19:2b:e7

Examples

Playback Key Pair Template Examples

The following examples specify an Amazon IVS playback key pair.

JSON

{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "PlaybackKeyPair": { "Type": "AWS::IVS::PlaybackKeyPair", "Properties": { "PublicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEwOR43ETwEoWif1i14aL8GtDMNkT/kBQm\nh4sas9P//bjCU988rmQQXVBfftKT9xngg+W6hzOEpeUlCRlAtz6b6U79naYYRaSk\nK/UhYGWkXlbJlc9zn13imYWgVGe/BMFp\n-----END PUBLIC KEY-----\n", "Name": "MyPlaybackKeyPair", "Tags": [ { "Key": "MyKey", "Value": "MyValue" } ] } } }, "Outputs": { "PlaybackKeyPairArn": { "Value": {"Ref": "PlaybackKeyPair"} }, "PlaybackKeyPairFingerprint": { "Value": { "Fn::GetAtt": [ "PlaybackKeyPair", "Fingerprint" ] } } } }

YAML

AWSTemplateFormatVersion: 2010-09-09 Resources: PlaybackKeyPair: Type: AWS::IVS::PlaybackKeyPair Properties: PublicKeyMaterial: | -----BEGIN PUBLIC KEY----- MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEwOR43ETwEoWif1i14aL8GtDMNkT/kBQm h4sas9P//bjCU988rmQQXVBfftKT9xngg+W6hzOEpeUlCRlAtz6b6U79naYYRaSk K/UhYGWkXlbJlc9zn13imYWgVGe/BMFp -----END PUBLIC KEY----- Name: MyPlaybackKeyPair Tags: - Key: MyKey Value: MyValue Outputs: PlaybackKeyPairArn: Value: !Ref PlaybackKeyPair PlaybackKeyPairFingerprint: Value: !GetAtt PlaybackKeyPair.Fingerprint

See also

Next topic:

Tag

Previous topic:

Tag
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.