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 來取得完整偵錯記錄。