다음을 통해 공유

az ams transform

Azure Media Services 계정에 대한 변환을 관리합니다.

명령

Name Description 형식 상태
az ams transform create

변환을 만듭니다.

 Core GA
az ams transform delete

변환을 삭제합니다.

 Core GA
az ams transform list

Azure Media Services 계정의 모든 변환을 나열합니다.

 Core GA
az ams transform output

Azure Media Services 계정에 대한 변환 출력을 관리합니다.

 Core GA
az ams transform output add

기존 변환에 출력을 추가합니다.

 Core GA
az ams transform output remove

기존 변환에서 출력을 제거합니다.

 Core GA
az ams transform show

변환의 세부 정보를 표시합니다.

 Core GA
az ams transform update

변환의 세부 정보를 업데이트합니다.

 Core 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 Media Services 계정의 이름입니다.

--name -n

변환의 이름입니다.

--preset

변환 출력을 생성하기 위해 원본 파일에서 인사이트를 수정, 코드 변환 또는 추출하는 데 사용할 작업을 설명하는 사전 설정입니다. 허용되는 값: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. 허용되는 값 외에도 사용자 지정 표준 인코더 미리 설정된 JSON 파일에 대한 경로를 전달할 수도 있습니다. 사용자 지정 사전 설정을 빌드하는 데 사용할 설정에 대한 자세한 내용은 https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset 참조하세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--audio-analysis-mode

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. 허용되는 값: Standard, Basic.

속성 값
매개 변수 그룹: Audio/Video Analyzer Arguments
--audio-language

BCP-47 형식의 "language tag-region"(예: en-US)을 사용하는 입력의 오디오 페이로드에 대한 언어입니다. 지정하지 않으면 자동 언어 검색이 사용됩니다. 이 기능은 현재 영어, 중국어, 프랑스어, 독일어, 이탈리아어, 일본어, 스페인어, 러시아어 및 포르투갈어를 지원합니다. 자동 검색은 명확하게 식별 가능한 음성을 사용하여 오디오 녹음에 가장 적합합니다. 자동 검색에서 언어를 찾지 못하면 전사가 영어로 대체됩니다. 허용되는 값: 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.

속성 값
매개 변수 그룹: Audio/Video Analyzer Arguments
--blur-type

허용되는 값: Box, Low, Med, High, Black.

속성 값
매개 변수 그룹: Face Detector Arguments
--description

변환에 대한 설명입니다.

--face-detector-mode

이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐림) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다. 허용되는 값: 분석, 편집, 결합

속성 값
매개 변수 그룹: Face Detector Arguments
--insights-to-extract

추출할 인사이트의 유형입니다. 설정하지 않으면 콘텐츠 형식에 따라 형식이 선택됩니다. 콘텐츠가 오디오 전용인 경우 오디오 인사이트만 추출되고 비디오인 경우 비디오 인사이트만 추출됩니다.

속성 값
매개 변수 그룹: Video Analyzer Arguments
허용되는 값: 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.

속성 값
매개 변수 그룹: Face Detector Arguments
--video-analysis-mode

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. 허용되는 값: Standard, Basic.

속성 값
매개 변수 그룹: Video Analyzer Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az ams transform delete

편집

변환을 삭제합니다.

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-name -a

Azure Media Services 계정의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

변환의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az ams transform list

편집

Azure Media Services 계정의 모든 변환을 나열합니다.

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

필수 매개 변수

--account-name -a

Azure Media Services 계정의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--filter

반환된 항목 집합을 제한합니다.

--orderby

결과 컬렉션을 정렬할 키를 지정합니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az ams transform show

편집

변환의 세부 정보를 표시합니다.

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-name -a

Azure Media Services 계정의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

변환의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az ams transform update

편집

변환의 세부 정보를 업데이트합니다.

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

예제

상대적 우선 순위를 High로 설정하여 변환의 첫 번째 변환 출력을 업데이트합니다.

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-name -a

Azure Media Services 계정의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--description

변환에 대한 설명입니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--name -n

변환의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>.

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False