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

az ams transform

管理Azure 媒体服务帐户的转换。

命令

名称 说明 类型 Status
az ams transform create

创建转换。

核心 GA
az ams transform delete

删除转换。

核心 GA
az ams transform list

列出Azure 媒体服务帐户的所有转换。

核心 GA
az ams transform output

管理Azure 媒体服务帐户的转换输出。

核心 GA
az ams transform output add

将输出添加到现有转换。

核心 GA
az ams transform output remove

从现有转换中删除输出。

核心 GA
az ams transform show

显示转换的详细信息。

核心 GA
az ams transform update

更新转换的详细信息。

核心 GA

az ams transform create

创建转换。

az ams transform create --account-name
                        --name
                        --preset
                        --resource-group
                        [--audio-analysis-mode]
                        [--audio-language]
                        [--blur-type]
                        [--description]
                        [--face-detector-mode]
                        [--insights-to-extract {AllInsights, AudioInsightsOnly, VideoInsightsOnly}]
                        [--on-error {ContinueJob, StopProcessingJob}]
                        [--relative-priority {High, Low, Normal}]
                        [--resolution]
                        [--video-analysis-mode]

示例

使用 AdaptiveStreaming 内置预设和高相对优先级创建转换。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset AdaptiveStreaming --relative-priority High

使用 JSON 文件和低相对优先级的自定义标准编码器预设创建转换。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json" --relative-priority Low

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--name -n

转换的名称。

--preset

描述将用于修改、转码或从源文件中提取见解以生成转换输出的操作的预设。 允许的值:H264SingleBitrateSD、H264SingleBitrate720p、H264SingleBitrate1080p、AdaptiveStreaming、AACGoodQualityAudio、ContentAwareEncodingExperimental、ContentAwareEncoding、CopyAllBitrateNonInterleaved、H264MultipleBitrate1080p、 H264MultipleBitrate720p、H264MultipleBitrateSD、H265ContentAwareEncoding、H265AdaptiveStreaming、H265SingleBitrate720p、H265SingleBitrate1080p、H265SingleBitrate4K、AudioAnalyzer、VideoAnalyzer、FaceDetector。 除了允许的值,还可以将路径传递给自定义标准编码器预设 JSON 文件。 有关用于生成自定义预设的设置的更多详细信息,请参阅 https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset

--resource-group -g

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

可选参数

--audio-analysis-mode

确定要执行的音频分析操作集。 如果未指定,则会选择标准 AudioAnalysisMode。 允许的值:标准值、基本值。

--audio-language

使用“语言标记区域”(例如 en-US)格式的 BCP-47 格式输入中的音频有效负载的语言。 如果未指定,将采用自动语言检测。 此功能目前支持英语、中文、法语、德语、意大利语、日语、西班牙语、俄语和葡萄牙语。 自动检测最适用于具有清晰辨别语音的录音。 如果自动检测找不到语言,则听录将回退到英语。 允许的值:en-US、en-GB、es-ES、es-MX、fr-FR、it-IT、ja-JP、pt-BR、zh-CN、de-DE、ar-EG、ru-RU、hi-IN。

--blur-type

允许的值:Box、Low、Med、High、Black。

--description

转换的说明。

--face-detector-mode

此模式提供在以下设置之间进行选择的功能:1) 分析 - 仅用于检测。此模式生成元数据 JSON 文件,用于标记整个视频中人脸的外观。如果可能,同一人的外观将分配相同的 ID。2) 组合 - 此外,检测到人脸的编辑(模糊)。 3) 修订 - 这可实现 2 次传递过程,允许选择性地编辑检测到的人脸子集。它采用先前分析传递中的元数据文件以及源视频,以及需要修订的用户选择的 ID 子集。 允许的值:分析、修订、组合。

--insights-to-extract

要提取的见解类型。 如果未设置,则将根据内容类型选择类型。 如果仅内容为音频,则仅提取音频见解,并且仅提取视频见解。

接受的值: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

转换可以定义多个输出。 此属性定义服务在一个输出失败时应执行的操作 - 继续生成其他输出,或者停止其他输出。 总体作业状态不会反映使用“ContinueJob”指定的输出失败。 默认值为“StopProcessingJob”。

接受的值: ContinueJob, StopProcessingJob
--relative-priority

设置转换输出在转换中的相对优先级。 这会设置服务用于处理 TransformOutputs 的优先级。 默认优先级为 Normal。

接受的值: High, Low, Normal
--resolution

指定分析视频的最大分辨率。 默认行为为“SourceResolution”,在分析时将输入视频保留为其原始分辨率。 使用 StandardDefinition 会将输入视频的大小调整为标准定义,同时保留适当的纵横比。 仅当视频分辨率较高时,它才会调整大小。 例如,在处理之前,1920x1080 输入将缩放为 640x360。 切换到“StandardDefinition”可以减少处理高分辨率视频所需的时间。 它还可能会降低使用此组件的成本(有关详细信息 https://azure.microsoft.com/pricing/details/media-services/#analytics )。 但是,可能无法检测到在调整大小的视频中最终太小的人脸。 允许的值:StandardDefinition、SourceResolution。

--video-analysis-mode

确定要执行的音频分析操作集。 如果未指定,则会选择标准 AudioAnalysisMode。 允许的值:标准值、基本值。

全局参数
--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 transform delete

删除转换。

az ams transform 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 transform list

列出Azure 媒体服务帐户的所有转换。

az ams transform list --account-name
                      --resource-group
                      [--filter]
                      [--orderby]

必需参数

--account-name -a

Azure 媒体服务帐户的名称。

--resource-group -g

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

可选参数

--filter

限制返回的项集。

--orderby

指定结果集合的排序依据的键。

全局参数
--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 transform show

显示转换的详细信息。

az ams transform 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 transform update

更新转换的详细信息。

az ams transform update [--account-name]
                        [--add]
                        [--description]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

示例

通过将转换的相对优先级设置为“高”来更新转换的第一个转换输出。

az ams transform update -a myAmsAccount -n transformName -g myResourceGroup --set outputs[0].relativePriority=High

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--add

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

默认值: []
--description

转换的说明。

--force-string

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

默认值: False
--ids

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

--name -n

转换的名称。

--remove

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

默认值: []
--resource-group -g

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

--set

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

默认值: []
--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 获取完整的调试日志。