你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az ams asset-filter

管理Azure 媒体服务帐户的资产筛选器。

命令

名称	说明	类型	状态
az ams asset-filter create	创建资产筛选器。	核心	GA
az ams asset-filter delete	删除资产筛选器。	核心	GA
az ams asset-filter list	列出Azure 媒体服务帐户的所有资产筛选器。	核心	GA
az ams asset-filter show	显示资产筛选器的详细信息。	核心	GA
az ams asset-filter update	更新资产筛选器的详细信息。	核心	GA

az ams asset-filter create

创建资产筛选器。

az ams asset-filter create --account-name
                           --asset-name
                           --name
                           --resource-group
                           [--end-timestamp]
                           [--first-quality]
                           [--force-end-timestamp {false, true}]
                           [--live-backoff-duration]
                           [--presentation-window-duration]
                           [--start-timestamp]
                           [--timescale]
                           [--tracks]

示例

使用筛选器跟踪选择创建资产筛选器。

az ams asset-filter create -a amsAccount -g resourceGroup -n filterName --force-end-timestamp=False --end-timestamp 200000 --start-timestamp 100000 --live-backoff-duration 60 --presentation-window-duration 600000 --timescale 1000 --first-quality 720 --asset-name assetName --tracks @C:\tracks.json

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--asset-name

资产的名称。

--name -n

资产筛选器的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--end-timestamp

适用于点播视频（VoD）。对于实时传送视频流演示文稿，当演示文稿结束且流变为 VoD 时，它将被无提示地忽略并应用。这是一个长值，表示演示文稿的绝对终点，舍入到最近的下一个 GOP 开始。 该单位是时间刻度，因此 180000000000 的 endTimestamp 将为 3 分钟。使用 startTimestamp 和 endTimestamp 剪裁将位于播放列表（清单）中的片段。例如，startTimestamp=40000000 和 endTimestamp=10000000 使用默认时间刻度将生成包含 VoD 演示文稿 4 秒到 10 秒之间的片段的播放列表。 如果某个段跨越边界，则整个段将包含在清单中。

--first-quality

清单中包含的第一个质量（最低）比特率。

--force-end-timestamp

仅适用于实时传送视频流。 指示 endTimestamp 属性是否必须存在。 如果为 true，则必须指定 endTimestamp，否则会返回“错误的请求”代码。 允许的值：false、true。

接受的值: false, true

默认值: False

--live-backoff-duration

仅适用于实时传送视频流。 此值定义客户端可以搜寻的最新实时位置。 使用此属性可以延迟直播播放位置，并为播放器创建服务器端缓冲区。 此属性的单位为时间刻度（参阅下文）。 最大直播回退持续时间为 300 秒 (3000000000)。 例如，值 2000000000 表示最新可用内容从实际实时边缘延迟 20 秒。

--presentation-window-duration

仅适用于实时传送视频流。使用 presentationWindowDuration 应用片段滑动窗口以包含在播放列表中。此属性的单位为时间刻度（请参阅下文）。例如，将 presentationWindowDuration=120000000000 设置为应用两分钟的滑动窗口。 直播边缘 2 分钟内的媒体将包含在播放列表中。 如果某个段跨越边界，则整个段将包含在播放列表中。 最小呈现窗口持续时间为 60 秒。

--start-timestamp

适用于点播视频 (VoD) 或实时传送视频流。 这是一个长值，表示流的绝对起点。 该值将舍入为最接近的下一个 GOP 起点。 单位是时间刻度，startTimestamp 150000000 表示 15 秒。 使用 startTimestamp 和 endTimestampp 剪裁将位于播放列表（清单）中的片段。 例如，在使用默认时间刻度的情况下指定 startTimestamp=40000000 和 endTimestamp=100000000 会生成一个播放列表，其中包含 VoD 演播内容第 4 秒到第 10 秒的片段。 如果某个段跨越边界，则整个段将包含在清单中。

--timescale

应用于演示文稿时间范围内的所有时间戳和持续时间，指定为一秒的增量数。默认值为 1000000000 - 1 秒 1000 万增量，其中每个增量长度为 100 纳秒。 例如，若要将 startTimestamp 设置为 30 秒，则在使用默认时间刻度时，需使用值 300000000。

--tracks

表示曲目选择的 JSON。 使用 @{file} 从文件加载。 有关 JSON 结构的详细信息，请参阅有关 swagger 的文档 https://docs.microsoft.com/rest/api/media/assetfilters/createorupdate#filtertrackselection。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ams asset-filter delete

删除资产筛选器。

az ams asset-filter delete [--account-name]
                           [--asset-name]
                           [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--asset-name

资产的名称。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

资产筛选器的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ams asset-filter list

列出Azure 媒体服务帐户的所有资产筛选器。

az ams asset-filter list --account-name
                         --asset-name
                         --resource-group

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--asset-name

资产的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ams asset-filter show

显示资产筛选器的详细信息。

az ams asset-filter show [--account-name]
                         [--asset-name]
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--asset-name

资产的名称。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

资产筛选器的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ams asset-filter update

更新资产筛选器的详细信息。

az ams asset-filter update [--account-name]
                           [--add]
                           [--asset-name]
                           [--end-timestamp]
                           [--first-quality]
                           [--force-end-timestamp {false, true}]
                           [--force-string]
                           [--ids]
                           [--live-backoff-duration]
                           [--name]
                           [--presentation-window-duration]
                           [--remove]
                           [--resource-group]
                           [--set]
                           [--start-timestamp]
                           [--subscription]
                           [--timescale]
                           [--tracks]

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--asset-name

资产的名称。

--end-timestamp

适用于点播视频（VoD）。对于实时传送视频流演示文稿，当演示文稿结束且流变为 VoD 时，它将被无提示地忽略并应用。这是一个长值，表示演示文稿的绝对终点，舍入到最近的下一个 GOP 开始。 该单位是时间刻度，因此 180000000000 的 endTimestamp 将为 3 分钟。使用 startTimestamp 和 endTimestamp 剪裁将位于播放列表（清单）中的片段。例如，startTimestamp=40000000 和 endTimestamp=10000000 使用默认时间刻度将生成包含 VoD 演示文稿 4 秒到 10 秒之间的片段的播放列表。 如果某个段跨越边界，则整个段将包含在清单中。

--first-quality

清单中包含的第一个质量（最低）比特率。

--force-end-timestamp

仅适用于实时传送视频流。 指示 endTimestamp 属性是否必须存在。 如果为 true，则必须指定 endTimestamp，否则会返回“错误的请求”代码。 允许的值：false、true。

接受的值: false, true

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--live-backoff-duration

仅适用于实时传送视频流。 此值定义客户端可以搜寻的最新实时位置。 使用此属性可以延迟直播播放位置，并为播放器创建服务器端缓冲区。 此属性的单位为时间刻度（参阅下文）。 最大直播回退持续时间为 300 秒 (3000000000)。 例如，值 2000000000 表示最新可用内容从实际实时边缘延迟 20 秒。

--name -n

资产筛选器的名称。

--presentation-window-duration

仅适用于实时传送视频流。使用 presentationWindowDuration 应用片段滑动窗口以包含在播放列表中。此属性的单位为时间刻度（请参阅下文）。例如，将 presentationWindowDuration=120000000000 设置为应用两分钟的滑动窗口。 直播边缘 2 分钟内的媒体将包含在播放列表中。 如果某个段跨越边界，则整个段将包含在播放列表中。 最小呈现窗口持续时间为 60 秒。

--remove

从列表中删除属性或元素。 示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=<value>。

默认值: []

--start-timestamp

适用于点播视频 (VoD) 或实时传送视频流。 这是一个长值，表示流的绝对起点。 该值将舍入为最接近的下一个 GOP 起点。 单位是时间刻度，startTimestamp 150000000 表示 15 秒。 使用 startTimestamp 和 endTimestampp 剪裁将位于播放列表（清单）中的片段。 例如，在使用默认时间刻度的情况下指定 startTimestamp=40000000 和 endTimestamp=100000000 会生成一个播放列表，其中包含 VoD 演播内容第 4 秒到第 10 秒的片段。 如果某个段跨越边界，则整个段将包含在清单中。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--timescale

应用于演示文稿时间范围内的所有时间戳和持续时间，指定为一秒的增量数。默认值为 1000000000 - 1 秒 1000 万增量，其中每个增量长度为 100 纳秒。 例如，若要将 startTimestamp 设置为 30 秒，则在使用默认时间刻度时，需使用值 300000000。

--tracks

表示曲目选择的 JSON。 使用 @{file} 从文件加载。 有关 JSON 结构的详细信息，请参阅有关 swagger 的文档 https://docs.microsoft.com/rest/api/media/assetfilters/createorupdate#filtertrackselection。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。