az ams live-event

Administración de eventos en directo para una cuenta de Azure Media Service.

Comandos

az ams live-event create

Cree un evento en directo.

az ams live-event delete

Elimina un evento en directo.

az ams live-event list

Enumera todos los eventos en directo de una Azure Media Services cuenta.

az ams live-event reset

Restablecer un evento en directo.

az ams live-event show

Mostrar los detalles de un evento en directo.

az ams live-event standby

Asigne un evento en directo para que se pueda iniciar más adelante.

az ams live-event start

Iniciar un evento en directo.

az ams live-event stop

Detenga un evento en directo.

az ams live-event update

Actualice los detalles de un evento en directo.

az ams live-event wait

Coloque la CLI en estado de espera hasta que se cumple una condición del evento en directo.

az ams live-event create

Cree un evento en directo.

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}]
                         [--streaming-policy-name]
                         [--stretch-mode]
                         [--subscription]
                         [--tags]
                         [--transcription-lang]
                         [--use-static-hostname]

Parámetros requeridos

--account-name -a

Nombre de la cuenta Azure Media Services usuario.

--ips

Direcciones IP separadas por espacios para el control de acceso. Las direcciones IP permitidas se pueden especificar como una sola dirección IP (por ejemplo, "10.0.0.1") o como un intervalo IP mediante una dirección IP y una máscara de subred CIDR (por ejemplo, "10.0.0.1/22"). Use "" para borrar la lista existente. Use "AllowAll" para permitir todas las direcciones IP. No se recomienda permitir todas las IP para entornos de producción.

--name -n

Nombre del evento en directo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--streaming-protocol

El protocolo de streaming para el evento en directo. Este valor se especifica en el momento de la creación y no se puede actualizar.

valores aceptados: FragmentedMP4, RTMP

Parámetros opcionales

--access-token

Identificador único de una secuencia. Se puede especificar en el momento de la creación, pero no se puede actualizar. Si se omite, el servicio generará un valor único.

--alternative-media-id

Identificador de medios alternativo asociado al objeto StreamingLocator creado para la versión preliminar. Este valor se especifica en el momento de la creación y no se puede actualizar. El identificador se puede usar en CustomLicenseAcquisitionUrlTemplate o CustomKeyAcquisitionUrlTemplate del objeto StreamingPolicy especificado en el campo StreamingPolicyName.

--auto-start

La marca indica si el recurso debe iniciarse automáticamente al crearse.

--client-access-policy

Ruta de acceso al clientaccesspolicy.xml usa Microsoft Silverlight y Adobe Flash. Use @{file} para cargar desde un archivo.

--cross-domain-policy

Ruta de acceso al crossdomain.xml usa Microsoft Silverlight y Adobe Flash. Use @{file} para cargar desde un archivo.

--description

Descripción del evento en directo.

--encoding-type

Tipo de codificación para el evento en directo. Este valor se especifica en el momento de la creación y no se puede actualizar. Valores permitidos: Premium1080p, None, Standard.

--hostname-prefix

Cuando useStaticHostname se establece en true, hostname_prefix especifica la primera parte del nombre de host asignado a la versión preliminar del evento en directo y los puntos de conexión de ingesta. El nombre de host final sería una combinación de este prefijo, el nombre de la cuenta de servicios multimedia y un código corto para el centro de datos de Azure Media Services.

--key-frame-interval

Use un valor de tiempo ISO 8601 entre 0,5 y 20 segundos para especificar la longitud del fragmento de salida para el vídeo y los audiotracks de un evento en directo de codificación. Por ejemplo, use PT2S para indicar 2 segundos. Para la pista de vídeo, también define el intervalo de fotogramas clave o la longitud de un GoP (grupo de imágenes). Si este valor no se establece para la anencoding de un evento en directo, la duración del fragmento se establece de forma predeterminada en 2 segundos. El valor no se puede establecer para eventos en directo de paso a través.

--key-frame-interval-duration

Duración del intervalo de tiempo ISO 8601 de la duración del intervalo de fotogramas clave en segundos. El valor debe ser un interger en el intervalo de 1 (PT1S o 00:00:01) a 30 (PT30S o 00:00:30) segundos.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

--preset-name

Nombre preestablecido de codificación. Este valor se especifica en el momento de la creación y no se puede actualizar.

--preview-ips

Direcciones IP separadas por espacios para el control de acceso. Las direcciones IP permitidas se pueden especificar como una sola dirección IP (por ejemplo, "10.0.0.1") o como un intervalo IP mediante una dirección IP y una máscara de subred CIDR (por ejemplo, "10.0.0.1/22"). Use "" para borrar la lista existente. Use "AllowAll" para permitir todas las direcciones IP. No se recomienda permitir todas las IP para entornos de producción.

--preview-locator

Identificador del localizador de vista previa en formato GUID. Si se especifica en el momento de la creación, el autor de la llamada puede conocer la dirección URL del localizador de vista previa antes de crear el evento. Si se omite, el servicio generará un identificador aleatorio. Este valor no se puede actualizar una vez creado el evento en directo.

--stream-options

Opciones que se usarán para LiveEvent. Este valor se especifica en el momento de la creación y no se puede actualizar.

valores aceptados: Default, LowLatency
--streaming-policy-name

Nombre de la directiva de streaming que se usa para la versión preliminar de eventos en directo. Se puede especificar en el momento de la creación, pero no se puede actualizar.

--stretch-mode

Especifica cómo se cambiará el tamaño del vídeo de entrada para que se ajuste a las resoluciones de salida deseadas. El valor predeterminado es None. Valores permitidos: None, AutoSize, AutoFit.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--transcription-lang

Lenguaje de transcripción en directo para el evento en directo. Valores permitidos: 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 Consulte para obtener más información sobre la característica de transcripción en https://go.microsoft.com/fwlink/?linkid=2133742 vivo.

--use-static-hostname

Especifica si se asignaría un nombre de host estático a la versión preliminar del evento en directo y a los puntos de conexión de ingesta. Este valor solo se puede actualizar si el evento en directo está en estado de espera. Si hostname_prefix no se especifica, el nombre del evento en directo se usará como prefijo de nombre de host.

az ams live-event delete

Elimina un evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services usuario.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event list

Enumera todos los eventos en directo de una Azure Media Services cuenta.

az ams live-event list --account-name
                       --resource-group
                       [--query-examples]
                       [--subscription]

Ejemplos

Enuméstate rápidamente todos los eventos en directo por nombre y resourceState.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta Azure Media Services usuario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--query-examples

Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event reset

Restablecer un evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services usuario.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event show

Mostrar los detalles de un evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services usuario.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--query-examples

Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event standby

Asigne un evento en directo para que se pueda iniciar más adelante.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services cliente.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event start

Iniciar un evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services cliente.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event stop

Detenga un evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services cliente.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del evento en directo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

--remove-outputs-on-stop

Quite las salidas en directo al detener.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az ams live-event update

Actualice los detalles de un evento en directo.

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]

Ejemplos

Establezca una nueva dirección IP permitida y quite una dirección IP existente en el índice "0".

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

Borre las direcciones IP existentes y establezca otras nuevas.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services cliente.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares de valor de clave. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--client-access-policy

Ruta de acceso al clientaccesspolicy.xml usa Microsoft Silverlight y Adobe Flash. Use @{file} para cargar desde un archivo.

--cross-domain-policy

Ruta de acceso al crossdomain.xml usa Microsoft Silverlight y Adobe Flash. Use @{file} para cargar desde un archivo.

--description

Descripción del evento en directo.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir a JSON.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--ips

Direcciones IP separadas por espacios para el control de acceso. Las direcciones IP permitidas se pueden especificar como una única dirección IP (por ejemplo, "10.0.0.1") o como un intervalo IP mediante una dirección IP y una máscara de subred CIDR (por ejemplo, "10.0.0.1/22"). Use "" para borrar la lista existente. Use "AllowAll" para permitir todas las direcciones IP. No se recomienda permitir todas las IP en entornos de producción.

--key-frame-interval-duration

Duración del intervalo de tiempo ISO 8601 de la duración del intervalo de fotogramas clave en segundos. El valor debe ser un interger en el intervalo de 1 (PT1S o 00:00:01) a 30 (PT30S o 00:00:30) segundos.

--name -n

Nombre del evento en directo.

--preview-ips

Direcciones IP separadas por espacios para el control de acceso. Las direcciones IP permitidas se pueden especificar como una única dirección IP (por ejemplo, "10.0.0.1") o como un intervalo IP mediante una dirección IP y una máscara de subred CIDR (por ejemplo, "10.0.0.1/22"). Use "" para borrar la lista existente. Use "AllowAll" para permitir todas las direcciones IP. No se recomienda permitir todas las IP en entornos de producción.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list O --remove propertyToRemove.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor para establecer. Ejemplo: --set property1.property2=.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

az ams live-event wait

Coloque la CLI en estado de espera hasta que se cumple una condición del evento en directo.

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

Ejemplos

Coloque la CLI en estado de espera hasta que se cree el evento en directo.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta Azure Media Services cliente.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

--custom

Espere hasta que la condición satisfaga una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

--exists

Espere hasta que el recurso exista.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--name -n

Nombre del evento en directo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".