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

az ams account-filter

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

命令

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

az ams account-filter create

创建帐户筛选器。

az ams account-filter create --account-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 account-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 --tracks @C:\tracks.json

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--name -n

帐户筛选器的名称。

--resource-group -g

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

可选参数

--end-timestamp

适用于点播视频 (VoD)。 对于实时传送视频流演播，将以静默方式忽略该属性；当呈现内容结束并且流变为 VoD 时，将应用该属性。 这是一个长值，表示演播的绝对终点，舍入为最接近的下一个 GOP 起点。 单位是时间刻度，endTimestamp 1800000000 表示 3 分钟。 使用 startTimestamp 和 endTimestamp 来修剪将播放列表（清单）中的片段。 例如，在使用默认时间刻度的情况下指定 startTimestamp=40000000 和 endTimestamp=100000000 会生成一个播放列表，其中包含 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=1200000000 会应用 2 分钟的滑动窗口。 直播边缘 2 分钟内的媒体将包含在播放列表中。 如果某个段跨越边界，则整个段将包含在播放列表中。 最小呈现窗口持续时间为 60 秒。

--start-timestamp

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

--timescale

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

--tracks

表示曲目选择的 JSON。 使用 @{file} 从文件加载。 有关 JSON 结构的详细信息，请参阅有关 swagger 的文档 https://docs.microsoft.com/rest/api/media/accountfilters/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 account-filter delete

删除帐户筛选器。

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

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--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 account-filter list

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

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

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--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 account-filter show

显示帐户筛选器的详细信息。

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

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--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 account-filter update

更新帐户筛选器的详细信息。

az ams account-filter update [--account-name]
                             [--add]
                             [--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>。

默认值: []

--end-timestamp

适用于点播视频 (VoD)。 对于实时传送视频流演播，将以静默方式忽略该属性；当呈现内容结束并且流变为 VoD 时，将应用该属性。 这是一个长值，表示演播的绝对终点，舍入为最接近的下一个 GOP 起点。 单位是时间刻度，endTimestamp 1800000000 表示 3 分钟。 使用 startTimestamp 和 endTimestamp 来修剪将播放列表（清单）中的片段。 例如，在使用默认时间刻度的情况下指定 startTimestamp=40000000 和 endTimestamp=100000000 会生成一个播放列表，其中包含 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=1200000000 会应用 2 分钟的滑动窗口。 直播边缘 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

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

--tracks

表示曲目选择的 JSON。 使用 @{file} 从文件加载。 有关 JSON 结构的详细信息，请参阅有关 swagger 的文档 https://docs.microsoft.com/rest/api/media/accountfilters/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 获取完整的调试日志。