az ams streaming-policy

Manage streaming policies for an Azure Media Services account.

Commands

Name	Description	Type	Status
az ams streaming-policy create	Create a streaming policy.	Core	GA
az ams streaming-policy delete	Delete a Streaming Policy.	Core	GA
az ams streaming-policy list	List all the streaming policies within an Azure Media Services account.	Core	GA
az ams streaming-policy show	Show the details of a streaming policy.	Core	GA

az ams streaming-policy create

Create a streaming policy.

az ams streaming-policy create --account-name
                               --name
                               --resource-group
                               [--cbcs-clear-tracks]
                               [--cbcs-default-key-label]
                               [--cbcs-default-key-policy-name]
                               [--cbcs-fair-play-allow-persistent-license {false, true}]
                               [--cbcs-fair-play-template]
                               [--cbcs-key-to-track-mappings]
                               [--cbcs-protocols]
                               [--cenc-clear-tracks]
                               [--cenc-default-key-label]
                               [--cenc-default-key-policy-name]
                               [--cenc-disable-play-ready {false, true}]
                               [--cenc-disable-widevine {false, true}]
                               [--cenc-key-to-track-mappings]
                               [--cenc-play-ready-attributes]
                               [--cenc-play-ready-template]
                               [--cenc-protocols]
                               [--cenc-widevine-template]
                               [--default-content-key-policy-name]
                               [--envelope-clear-tracks]
                               [--envelope-default-key-label]
                               [--envelope-default-key-policy-name]
                               [--envelope-key-to-track-mappings]
                               [--envelope-protocols]
                               [--envelope-template]
                               [--no-encryption-protocols]

Examples

Create a streaming policy.

az ams streaming-policy create -a ams -n mypolicy -g rg --no-encryption-protocols HLS

Required Parameters

--account-name -a

The name of the Azure Media Services account.

--name -n

The name of the streaming policy.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cbcs-clear-tracks

The JSON representing which tracks should not be encrypted. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#trackselection.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cbcs-default-key-label

Label to specify Default Content Key for an encryption scheme.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cbcs-default-key-policy-name

Policy used by Default Content Key.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cbcs-fair-play-allow-persistent-license

Allows the license to be persistent or not.

Property	Value
Parameter group:	Common Encryption CBCS Arguments
Default value:	False
Accepted values:	false, true

--cbcs-fair-play-template

The custom license acquisition URL template for a customer service to deliver keys to end users. Not needed when using Azure Media Services for issuing keys.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cbcs-key-to-track-mappings

The JSON representing a list of StreamingPolicyContentKey. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#streamingpolicycontentkey.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cbcs-protocols

Space-separated list of enabled protocols for Common Encryption CBCS. Allowed values: Download, Dash, HLS, SmoothStreaming.

Property	Value
Parameter group:	Common Encryption CBCS Arguments

--cenc-clear-tracks

The JSON representing which tracks should not be encrypted. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#trackselection.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-default-key-label

Label to specify Default Content Key for an encryption scheme.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-default-key-policy-name

Policy used by Default Content Key.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-disable-play-ready

If specified, no PlayReady cenc DRM will be configured. If --cenc-disable-play-ready is set, --cenc-disable-widevine cannot also be set.

Property	Value
Parameter group:	Common Encryption CENC Arguments
Accepted values:	false, true

--cenc-disable-widevine

If specified, no Widevine cenc DRM will be configured. If --cenc-disable-widevine is set, --cenc-disable-play-ready cannot also be set.

Property	Value
Parameter group:	Common Encryption CENC Arguments
Accepted values:	false, true

--cenc-key-to-track-mappings

The JSON representing a list of StreamingPolicyContentKey. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#streamingpolicycontentkey.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-play-ready-attributes

Custom attributes for PlayReady.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-play-ready-template

The custom license acquisition URL template for a customer service to deliver keys to end users. Not needed when using Azure Media Services for issuing keys.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-protocols

Space-separated list of enabled protocols for Common Encryption CENC. Allowed values: Download, Dash, HLS, SmoothStreaming.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--cenc-widevine-template

The custom license acquisition URL template for a customer service to deliver keys to end users. Not needed when using Azure Media Services for issuing keys.

Property	Value
Parameter group:	Common Encryption CENC Arguments

--default-content-key-policy-name

Default Content Key used by current streaming policy.

--envelope-clear-tracks

The JSON representing which tracks should not be encrypted. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#trackselection.

Property	Value
Parameter group:	Envelope Encryption Arguments

--envelope-default-key-label

Label used to specify Content Key when creating a streaming locator.

Property	Value
Parameter group:	Envelope Encryption Arguments

--envelope-default-key-policy-name

Policy used by Default Key.

Property	Value
Parameter group:	Envelope Encryption Arguments

--envelope-key-to-track-mappings

The JSON representing a list of StreamingPolicyContentKey. Use @{file} to load from a file. For further information about the JSON structure please refer to swagger documentation on https://learn.microsoft.com/rest/api/media/streamingpolicies/create#streamingpolicycontentkey.

Property	Value
Parameter group:	Envelope Encryption Arguments

--envelope-protocols

Space-separated list of enabled protocols for Envelope Encryption. Allowed values: Download, Dash, HLS, SmoothStreaming.

Property	Value
Parameter group:	Envelope Encryption Arguments

--envelope-template

The KeyAcquistionUrlTemplate is used to point to user specified service to delivery content keys.

Property	Value
Parameter group:	Envelope Encryption Arguments

--no-encryption-protocols

Space-separated list of enabled protocols for NoEncryption. Allowed values: Download, Dash, HLS, SmoothStreaming.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az ams streaming-policy delete

Delete a Streaming Policy.

Deletes a Streaming Policy in the Media Services account.

az ams streaming-policy delete [--account-name]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

The name of the Azure Media Services account.

Property	Value
Parameter group:	Resource Id Arguments

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

The name of the streaming policy.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az ams streaming-policy list

List all the streaming policies within an Azure Media Services account.

az ams streaming-policy list --account-name
                             --resource-group
                             [--filter]
                             [--orderby]
                             [--top]

Required Parameters

--account-name -a

The name of the Azure Media Services account.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter

Restricts the set of items returned.

--orderby

Specifies the key by which the result collection should be ordered.

--top

Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az ams streaming-policy show

Show the details of a streaming policy.

az ams streaming-policy show [--account-name]
                             [--ids]
                             [--name]
                             [--resource-group]
                             [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

The name of the Azure Media Services account.

Property	Value
Parameter group:	Resource Id Arguments

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

The name of the streaming policy.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False