共用方式為


az ams live-event

管理 Azure 媒體服務帳戶的即時活動。

命令

名稱 Description 類型 狀態
az ams live-event create

建立實況活動。

核心 GA
az ams live-event delete

刪除實況活動。

核心 GA
az ams live-event list

列出 Azure 媒體服務 帳戶的所有實時活動。

核心 GA
az ams live-event reset

重設即時活動。

核心 GA
az ams live-event show

顯示即時活動的詳細數據。

核心 GA
az ams live-event standby

配置稍後要啟動的實時活動。

核心 GA
az ams live-event start

啟動即時活動。

核心 GA
az ams live-event stop

停止即時活動。

核心 GA
az ams live-event update

更新即時活動的詳細數據。

核心 GA
az ams live-event wait

將 CLI 置於等候狀態,直到符合即時活動的條件為止。

核心 GA

az ams live-event create

建立實況活動。

az ams live-event create --account-name
                         --ips
                         --name
                         --resource-group
                         --streaming-protocol {FragmentedMP4, RTMP}
                         [--access-token]
                         [--alternative-media-id]
                         [--auto-start]
                         [--client-access-policy]
                         [--cross-domain-policy]
                         [--description]
                         [--encoding-type]
                         [--hostname-prefix]
                         [--key-frame-interval]
                         [--key-frame-interval-duration]
                         [--no-wait]
                         [--preset-name]
                         [--preview-ips]
                         [--preview-locator]
                         [--stream-options {Default, LowLatency, LowLatencyV2}]
                         [--streaming-policy-name]
                         [--stretch-mode]
                         [--tags]
                         [--transcription-lang]
                         [--use-static-hostname]

必要參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ips

訪問控制的空間分隔IP位址。 允許的IP位址可以指定為單一IP位址(例如 “10.0.0.0.1”)或使用IP位址和 CIDR 子網掩碼作為IP範圍(例如 “10.0.0.1/22” )。 使用 「清除現有的清單」。 使用 「AllowAll」 允許所有 IP 位址。 不建議針對生產環境允許所有IP。

--name -n

即時活動的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--streaming-protocol

即時活動的串流通訊協定。 此值會在建立時指定,而且無法更新。

接受的值: FragmentedMP4, RTMP

選擇性參數

--access-token

數據流的唯一標識碼。 這可以在建立時指定,但無法更新。 如果省略,服務將會產生唯一值。

--alternative-media-id

與針對預覽建立的 StreamingLocator 相關聯的替代媒體標識碼。 此值會在建立時指定,而且無法更新。 標識符可用於 StreamingPolicyName 欄位中所指定之 StreamingPolicy 的 CustomLicenseAcquisitionUrlTemplate 或 CustomKeyAcquisitionUrlTemplate。

--auto-start

旗標指出資源是否應該在建立時自動啟動。

預設值: False
--client-access-policy

Microsoft Silverlight 和 Adobe Flash 所使用的clientaccesspolicy.xml檔案路徑。 使用 @{file} 從檔案載入。

--cross-domain-policy

Microsoft Silverlight 和 Adobe Flash 所使用之crossdomain.xml的 Filepath。 使用 @{file} 從檔案載入。

--description

即時活動描述。

--encoding-type

即時事件的編碼類型。 此值會在建立時指定,而且無法更新。 允許的值:進階版 1080p、None、Standard。

--hostname-prefix

當 useStaticHostname 設定為 true 時,hostname_prefix指定指派給即時事件預覽和內嵌端點之主機名的第一個部分。 最後的主機名會是這個前置詞、媒體服務帳戶名稱和 Azure 媒體服務 數據中心的簡短程式代碼的組合。

--key-frame-interval

使用介於 0.5 到 20 秒之間的 ISO 8601 時間值,指定編碼即時事件的視訊和音軌輸出片段長度。 例如,使用 PT2S 表示 2 秒。 針對視訊播放軌,它也會定義主要畫面格間隔,或 GoP 的長度(圖片群組)。 如果未針對即時事件設定此值,片段持續時間預設為 2 秒。 無法為傳遞即時事件設定值。

--key-frame-interval-duration

以秒為單位主要畫面格間隔持續時間的 ISO 8601 時間範圍持續時間。 此值應該是介於 1(PT1S 或 00:00:01) 到 30 秒 (PT30S 或 00:00:30) 秒之間的交錯器。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--preset-name

編碼預設名稱。 此值會在建立時指定,而且無法更新。

--preview-ips

訪問控制的空間分隔IP位址。 允許的IP位址可以指定為單一IP位址(例如 “10.0.0.0.1”)或使用IP位址和 CIDR 子網掩碼作為IP範圍(例如 “10.0.0.1/22” )。 使用 「清除現有的清單」。 使用 「AllowAll」 允許所有 IP 位址。 不建議針對生產環境允許所有IP。

--preview-locator

預覽定位器的識別碼,格式為 Guid。 在建立期間指定此專案可讓呼叫者在建立事件之前知道預覽定位器 URL。 如果省略,服務將會產生隨機標識符。 建立即時事件之後,就無法更新此值。

--stream-options

用於 LiveEvent 的選項。 此值會在建立時指定,而且無法更新。

接受的值: Default, LowLatency, LowLatencyV2
--streaming-policy-name

用於即時活動預覽的串流原則名稱。 這可以在建立時指定,但無法更新。

--stretch-mode

指定如何調整輸入視訊的大小,以符合所需的輸出解析度。 預設值為 None。 允許的值:None、AutoSize、AutoFit。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--transcription-lang

即時活動的即時轉譯語言。 允許的值:ca-ES、da-DK、de-DE、en-AU、en-CA、en-GB、en-IN、en-NZ、en-US、es-ES、es-MX、fi-FI、fr-CA、fr-FR、it-IT、nl-NL、pt-BR、pt-PT、sv-SE 如需實時轉譯功能的詳細資訊,請參閱 https://go.microsoft.com/fwlink/?linkid=2133742

--use-static-hostname

指定是否將靜態主機名指派給即時事件預覽和內嵌端點。 只有在即時事件處於待命狀態時,才能更新此值。 如果未指定hostname_prefix,即時事件名稱將會作為主機名前置詞。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event delete

刪除實況活動。

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

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event list

列出 Azure 媒體服務 帳戶的所有實時活動。

az ams live-event list --account-name
                       --resource-group

範例

依名稱和 resourceState 快速列出所有即時活動。

az ams live-event list -a amsAccount -g resourceGroup --query [].{liveEventName:name,state:resourceState}

必要參數

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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event reset

重設即時活動。

az ams live-event reset [--account-name]
                        [--ids]
                        [--name]
                        [--no-wait]
                        [--resource-group]
                        [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event show

顯示即時活動的詳細數據。

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

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event standby

配置稍後要啟動的實時活動。

az ams live-event standby [--account-name]
                          [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event start

啟動即時活動。

az ams live-event start [--account-name]
                        [--ids]
                        [--name]
                        [--no-wait]
                        [--resource-group]
                        [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event stop

停止即時活動。

az ams live-event stop [--account-name]
                       [--ids]
                       [--name]
                       [--no-wait]
                       [--remove-outputs-on-stop]
                       [--resource-group]
                       [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

即時活動的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--remove-outputs-on-stop

停止時移除實時輸出。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event update

更新即時活動的詳細數據。

az ams live-event update [--account-name]
                         [--add]
                         [--client-access-policy]
                         [--cross-domain-policy]
                         [--description]
                         [--force-string]
                         [--ids]
                         [--ips]
                         [--key-frame-interval-duration]
                         [--name]
                         [--preview-ips]
                         [--remove]
                         [--resource-group]
                         [--set]
                         [--subscription]
                         [--tags]

範例

設定新的允許IP位址,並在索引 '0'移除現有的IP位址。

az ams live-event update -a amsAccount -g resourceGroup -n liveEventName --remove input.accessControl.ip.allow 0 --add input.accessControl.ip.allow 1.2.3.4/22

清除現有的IP位址並設定新的IP位址。

az ams live-event update -a amsAccount -g resourceGroup -n liveEventName --ips 1.2.3.4/22 5.6.7.8/30

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--add

藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>

預設值: []
--client-access-policy

Microsoft Silverlight 和 Adobe Flash 所使用的clientaccesspolicy.xml檔案路徑。 使用 @{file} 從檔案載入。

--cross-domain-policy

Microsoft Silverlight 和 Adobe Flash 所使用之crossdomain.xml的 Filepath。 使用 @{file} 從檔案載入。

--description

即時活動描述。

--force-string

使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--ips

訪問控制的空間分隔IP位址。 允許的IP位址可以指定為單一IP位址(例如 “10.0.0.0.1”)或使用IP位址和 CIDR 子網掩碼作為IP範圍(例如 “10.0.0.1/22” )。 使用 「清除現有的清單」。 使用 「AllowAll」 允許所有 IP 位址。 不建議針對生產環境允許所有IP。

--key-frame-interval-duration

以秒為單位主要畫面格間隔持續時間的 ISO 8601 時間範圍持續時間。 此值應該是介於 1(PT1S 或 00:00:01) 到 30 秒 (PT30S 或 00:00:30) 秒之間的交錯器。

--name -n

即時活動的名稱。

--preview-ips

訪問控制的空間分隔IP位址。 允許的IP位址可以指定為單一IP位址(例如 “10.0.0.0.1”)或使用IP位址和 CIDR 子網掩碼作為IP範圍(例如 “10.0.0.1/22” )。 使用 「清除現有的清單」。 使用 「AllowAll」 允許所有 IP 位址。 不建議針對生產環境允許所有IP。

--remove

從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>--remove propertyToRemove

預設值: []
--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--set

指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>

預設值: []
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ams live-event wait

將 CLI 置於等候狀態,直到符合即時活動的條件為止。

az ams live-event wait [--account-name]
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--ids]
                       [--interval]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]

範例

將 CLI 置於等候狀態,直到建立即時事件為止。

az ams live-event wait -g MyResourceGroup -a MyAmsAccount -n MyLiveEvent --created

選擇性參數

--account-name -a

Azure 媒體服務 帳戶的名稱。

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--name -n

即時活動的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。