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

az ams asset-filter

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

命令

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

az ams asset-filter create

创建资产筛选器。

az ams asset-filter create --account-name
                           --asset-name
                           --name
                           --resource-group
                           [--bitrate]
                           [--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>配置默认组。

可选参数

--bitrate

已放弃

选项“--bitrate”已弃用，将在将来的版本中删除。 请改用“--first-quality”。

第一个质量比特率。

--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 秒（30000000000）。 例如，值为 2000000000 表示最新可用内容延迟 20 秒，从实际实时边缘延迟。

--presentation-window-duration

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

--start-timestamp

适用于点播视频（VoD）或实时传送视频流。 这是一个长值，表示流的绝对起点。 该值将舍入到最接近的下一个 GOP 开始。 该单位是时间刻度，因此 startTimestamp 为 150000000 将 15 秒。 使用 startTimestamp 和 endTimestampp 剪裁将位于播放列表（清单）中的片段。 例如，startTimestamp=40000000 和 endTimestamp=10000000 使用默认时间刻度将生成包含 VoD 演示文稿 4 秒到 10 秒之间的片段的播放列表。 如果片段跨越边界，整个片段将包含在清单中。

--timescale

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

--tracks

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

全局参数

--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]
                           [--bitrate]
                           [--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

资产的名称。

--bitrate

已放弃

选项“--bitrate”已弃用，将在将来的版本中删除。 请改用“--first-quality”。

第一个质量比特率。

--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 秒（30000000000）。 例如，值为 2000000000 表示最新可用内容延迟 20 秒，从实际实时边缘延迟。

--name -n

资产筛选器的名称。

--presentation-window-duration

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

--remove

从列表中删除属性或元素。 示例：--remove property.list <indexToRemove> 或 --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=10000000 使用默认时间刻度将生成包含 VoD 演示文稿 4 秒到 10 秒之间的片段的播放列表。 如果片段跨越边界，整个片段将包含在清单中。

--subscription

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

--timescale

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

--tracks

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

全局参数

--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。