Live Events - List
Enumeración de los eventos en directo
Listas todos los eventos en directo de la cuenta.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents?api-version=2022-11-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Media Services. |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Identificador único de una suscripción de Microsoft Azure. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar. La solicitud se ha realizado correctamente. |
|
Other Status Codes |
Respuesta de error de streaming que describe por qué se produjo un error en la operación. |
Ejemplos
List all LiveEvents
Solicitud de ejemplo
Respuesta de muestra
{
"value": [
{
"name": "myLiveEvent1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
"type": "Microsoft.Media/mediaservices/liveevents",
"location": "West US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"description": "test event 1",
"resourceState": "Stopped",
"provisioningState": "Succeeded",
"created": "2018-03-03T02:25:08.5564064Z",
"lastModified": "2018-03-03T02:25:08.5564064Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "RTMP",
"accessToken": "<accessToken>",
"endpoints": [
{
"protocol": "RTMP",
"url": "rtmp://clouddeployment.media-test.net:1935/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmp://clouddeployment.media-test.net:1936/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmps://clouddeployment.media-test.net:2935/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmps://clouddeployment.media-test.net:2936/live/de153bb0814542d9b7e2339ce9430dc4"
}
],
"timedMetadataEndpoints": [
{
"url": "https://clouddeployment.media-test.net/de153bb0814542d9b7e2339ce9430dc4/ingest.isml/eventdata"
}
]
},
"preview": {
"previewLocator": "a220e223-faf8-4e03-b9a9-2c2432f48025",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"endpoints": [
{
"protocol": "FragmentedMP4",
"url": "https://myliveevent1-slitestmedia10.preview-usso.channel.mediaservices.windows.net/a220e223-faf8-4e03-b9a9-2c2432f48025/preview.ism/manifest"
}
]
},
"encoding": {
"encodingType": "None",
"presetName": null
},
"crossSiteAccessPolicies": {
"clientAccessPolicy": null,
"crossDomainPolicy": null
}
}
}
]
}
Definiciones
Nombre | Description |
---|---|
created |
Tipo de identidad que creó el recurso. |
Cross |
Directiva de acceso de cliente. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
IPAccess |
Control de acceso IP. |
IPRange |
Intervalo de direcciones IP en el esquema CIDR. |
Live |
Evento en directo. |
Live |
Especifica el tipo de evento en directo y la configuración de codificación opcional para codificar eventos en directo. |
Live |
Tipo de evento en directo. Cuando encodingType se establece en PassthroughBasic o PassthroughStandard, el servicio simplemente pasa a través de las capas de audio y vídeo entrantes a la salida. Cuando encodingType se establece en Standard o Premium1080p, un codificador en directo transcodifica la secuencia entrante en varias velocidades de bits o capas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obtener más información. Esta propiedad no se puede modificar después de crear el evento en directo. |
Live |
Punto de conexión del evento en directo. |
Live |
Entrada del evento en directo. |
Live |
Control de acceso IP para la entrada de eventos en directo. |
Live |
Protocolo de entrada para el evento en directo. Esto se especifica en el momento de la creación y no se puede actualizar. |
Live |
Una condición de selección de pista. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
Live |
LiveEventListResult |
Live |
Describe una pista de transcripción en la salida de un evento en directo, generado mediante la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
Live |
Configuración de vista previa de eventos en directo. |
Live |
Control de acceso IP para el punto de conexión de vista previa del evento en directo. |
Live |
Estado del recurso del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información. |
Live |
Punto de conexión de inserción de metadatos de eventos en directo. |
Live |
Describe las pistas de transcripción en la salida de un evento en directo, generados mediante la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
Stream |
Las opciones que se usarán para LiveEvent. Este valor se especifica en el momento de la creación y no se puede actualizar. Los valores válidos para los valores de entrada de matriz son "Default" y "LowLatency". |
Stretch |
Especifica cómo se cambiará el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es None |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CrossSiteAccessPolicies
Directiva de acceso de cliente.
Nombre | Tipo | Description |
---|---|---|
clientAccessPolicy |
string |
Contenido de clientaccesspolicy.xml usado por Silverlight. |
crossDomainPolicy |
string |
Contenido de crossdomain.xml usado por Silverlight. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
IPAccessControl
Control de acceso IP.
Nombre | Tipo | Description |
---|---|---|
allow |
IPRange[] |
Lista de direcciones IP permitidas. |
IPRange
Intervalo de direcciones IP en el esquema CIDR.
Nombre | Tipo | Description |
---|---|---|
address |
string |
Dirección IP. |
name |
string |
Nombre descriptivo del intervalo de direcciones IP. |
subnetPrefixLength |
integer |
Longitud del prefijo de máscara de subred (consulte notación CIDR). |
LiveEvent
Evento en directo.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.created |
string |
Hora de creación del evento en directo |
properties.crossSiteAccessPolicies |
Directivas de acceso entre sitios de eventos en directo. |
|
properties.description |
string |
Descripción del evento en directo. |
properties.encoding |
Configuración de codificación para el evento en directo. Configura si se usa un codificador en directo para el evento en directo y la configuración del codificador en directo si se usa. |
|
properties.hostnamePrefix |
string |
Cuando useStaticHostname se establece en true, el hostnamePrefix especifica la primera parte del nombre de host asignado a la vista previa 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. |
properties.input |
Configuración de entrada de eventos en directo. Define cómo el evento en directo recibe la entrada de un codificador de contribución. |
|
properties.lastModified |
string |
Hora de la última modificación del evento en directo. |
properties.preview |
Configuración de vista previa de eventos en directo. La versión preliminar permite a los productores de eventos en directo obtener una vista previa del contenido de streaming en vivo sin crear ninguna salida en directo. |
|
properties.provisioningState |
string |
Estado de aprovisionamiento del evento en directo. |
properties.resourceState |
Estado del recurso del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información. |
|
properties.streamOptions |
Las opciones que se usarán para LiveEvent. Este valor se especifica en el momento de la creación y no se puede actualizar. Los valores válidos para los valores de entrada de matriz son "Default" y "LowLatency". |
|
properties.transcriptions |
Configuración de transcripción en directo para el evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2133742 para obtener más información sobre la característica de transcripción en directo. |
|
properties.useStaticHostname |
boolean |
Especifica si un nombre de host estático se asignaría 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 en espera. |
systemData |
Metadatos del sistema relacionados con este recurso. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
LiveEventEncoding
Especifica el tipo de evento en directo y la configuración de codificación opcional para codificar eventos en directo.
Nombre | Tipo | Description |
---|---|---|
encodingType |
Tipo de evento en directo. Cuando encodingType se establece en PassthroughBasic o PassthroughStandard, el servicio simplemente pasa a través de las capas de audio y vídeo entrantes a la salida. Cuando encodingType se establece en Standard o Premium1080p, un codificador en directo transcodifica la secuencia entrante en varias velocidades de bits o capas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obtener más información. Esta propiedad no se puede modificar después de crear el evento en directo. |
|
keyFrameInterval |
string |
Use un valor de tiempo ISO 8601 entre 0,5 y 20 segundos para especificar la longitud del fragmento de salida para las pistas de vídeo y audio 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 fotograma clave o la longitud de un GoP (grupo de imágenes). Si este valor no se establece para un evento en directo de codificación, la duración del fragmento tiene como valor predeterminado 2 segundos. El valor no se puede establecer para los eventos en directo de paso a través. |
presetName |
string |
El nombre preestablecido de codificación opcional, que se usa cuando encodingType no es None. Este valor se especifica en el momento de la creación y no se puede actualizar. Si el valor de encodingType se establece en Standard, el nombre preestablecido predeterminado es "Default720p". De lo contrario, si el valor de encodingType está establecido en Premium1080p, el valor predeterminado es "Default1080p". |
stretchMode |
Especifica cómo se cambiará el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es None |
LiveEventEncodingType
Tipo de evento en directo. Cuando encodingType se establece en PassthroughBasic o PassthroughStandard, el servicio simplemente pasa a través de las capas de audio y vídeo entrantes a la salida. Cuando encodingType se establece en Standard o Premium1080p, un codificador en directo transcodifica la secuencia entrante en varias velocidades de bits o capas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obtener más información. Esta propiedad no se puede modificar después de crear el evento en directo.
Nombre | Tipo | Description |
---|---|---|
None |
string |
Esto es lo mismo que PassthroughStandard, consulte la descripción siguiente. Este valor de enumeración está en desuso. |
PassthroughBasic |
string |
La secuencia ingerida pasa a través del evento en directo del codificador de contribución sin ningún procesamiento adicional. En el modo PassthroughBasic, la ingesta se limita a hasta 5 Mbps y solo se permite 1 salida en vivo simultánea. La transcripción en vivo no está disponible. |
PassthroughStandard |
string |
La secuencia ingerida pasa a través del evento en directo del codificador de contribución sin ningún procesamiento adicional. La transcripción en directo está disponible. Los límites de velocidad de bits de ingesta son mucho mayores y se permiten hasta 3 salidas en vivo simultáneas. |
Premium1080p |
string |
Un codificador en directo de contribución envía una secuencia de velocidad de bits única al evento en directo y Media Services crea varias secuencias de velocidad de bits. La salida no puede superar los 1080p en resolución. |
Standard |
string |
Un codificador en directo de contribución envía una secuencia de velocidad de bits única al evento en directo y Media Services crea varias secuencias de velocidad de bits. La salida no puede superar los 720p en resolución. |
LiveEventEndpoint
Punto de conexión del evento en directo.
Nombre | Tipo | Description |
---|---|---|
protocol |
string |
Protocolo de punto de conexión. |
url |
string |
Dirección URL del punto de conexión. |
LiveEventInput
Entrada del evento en directo.
Nombre | Tipo | Description |
---|---|---|
accessControl |
Control de acceso para la entrada de eventos en directo. |
|
accessToken |
string |
UuID en forma de cadena para identificar de forma única la secuencia. Esto se puede especificar en el momento de la creación, pero no se puede actualizar. Si se omite, el servicio generará un valor único. |
endpoints |
Puntos de conexión de entrada para el evento en directo. |
|
keyFrameIntervalDuration |
string |
Duración de tiempo ISO 8601 del intervalo de fotograma clave de la entrada. Este valor establece la propiedad EXT-X-TARGETDURATION en la salida de HLS. Por ejemplo, use PT2S para indicar 2 segundos. Deje el valor vacío para codificar eventos en directo. |
streamingProtocol |
Protocolo de entrada para el evento en directo. Esto se especifica en el momento de la creación y no se puede actualizar. |
|
timedMetadataEndpoints |
Puntos de conexión de metadatos para el evento en directo. |
LiveEventInputAccessControl
Control de acceso IP para la entrada de eventos en directo.
Nombre | Tipo | Description |
---|---|---|
ip |
Propiedades del control de acceso IP. |
LiveEventInputProtocol
Protocolo de entrada para el evento en directo. Esto se especifica en el momento de la creación y no se puede actualizar.
Nombre | Tipo | Description |
---|---|---|
FragmentedMP4 |
string |
El codificador de contribución enviará la entrada smooth Streaming al evento en directo. |
RTMP |
string |
La entrada RTMP se enviará mediante el codificador de contribución al evento en directo. |
LiveEventInputTrackSelection
Una condición de selección de pista. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad.
Nombre | Tipo | Description |
---|---|---|
operation |
string |
Operación de comparación. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
property |
string |
Nombre de propiedad que se va a seleccionar. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
value |
string |
Valor de propiedad que se va a seleccionar. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
LiveEventListResult
LiveEventListResult
Nombre | Tipo | Description |
---|---|---|
@odata.count |
integer |
Número de resultados. |
@odata.nextLink |
string |
Vínculo al siguiente conjunto de resultados. No está vacío si el valor contiene una lista incompleta de salidas en vivo. |
value |
Resultado de la operación List Live Event. |
LiveEventOutputTranscriptionTrack
Describe una pista de transcripción en la salida de un evento en directo, generado mediante la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad.
Nombre | Tipo | Description |
---|---|---|
trackName |
string |
Nombre de la pista de salida. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
LiveEventPreview
Configuración de vista previa de eventos en directo.
Nombre | Tipo | Description |
---|---|---|
accessControl |
Control de acceso para la versión preliminar de eventos en directo. |
|
alternativeMediaId |
string |
Identificador de medios alternativo asociado al localizador de streaming 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. |
endpoints |
Los puntos de conexión de la versión preliminar. No comparta la dirección URL de vista previa con la audiencia de eventos en directo. |
|
previewLocator |
string |
Identificador del localizador de vista previa en formato GUID. Especificar esto en el momento de creación permite al autor de la llamada 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. |
streamingPolicyName |
string |
Nombre de la directiva de streaming usada para la versión preliminar del evento en directo. Este valor se especifica en el momento de la creación y no se puede actualizar. |
LiveEventPreviewAccessControl
Control de acceso IP para el punto de conexión de vista previa del evento en directo.
Nombre | Tipo | Description |
---|---|---|
ip |
Propiedades del control de acceso IP. |
LiveEventResourceState
Estado del recurso del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información.
Nombre | Tipo | Description |
---|---|---|
Allocating |
string |
Se ha llamado a la acción de asignación en el evento en directo y se están aprovisionando recursos para este evento en directo. Una vez completada correctamente la asignación, el evento en directo pasará al estado StandBy. |
Deleting |
string |
El evento en directo se eliminará. No se produce facturación en este estado transitorio. Durante este estado no se permite realizar actualizaciones ni streaming. |
Running |
string |
Se han asignado los recursos del evento en directo, se han generado las direcciones URL de ingesta y visualización previa y puede recibir transmisiones en vivo. En este momento, la facturación está activa. Debe llamar explícitamente a Stop en el recurso del evento en directo para evitar que continúe la facturación. |
StandBy |
string |
Los recursos de eventos en directo se han aprovisionado y están listos para iniciarse. La facturación comienza en este estado. La mayoría de las propiedades todavía se pueden actualizar, pero no se permite la ingesta ni la transmisión durante este estado. |
Starting |
string |
Se está iniciando el evento en directo y se asignan recursos. No se produce ninguna facturación en este estado. Durante este estado no se permite realizar actualizaciones ni streaming. Si se produce un error, el evento en directo vuelve al estado Detenido. |
Stopped |
string |
Este es el estado inicial del evento en directo después de su creación (a menos que haya establecido el inicio automático en true). No se produce ninguna facturación en este estado. En este estado, las propiedades del evento en directo se pueden actualizar, pero no se permite el streaming. |
Stopping |
string |
El evento en directo se detendrá y los recursos se desaprovisionarán. No se produce facturación en este estado transitorio. Durante este estado no se permite realizar actualizaciones ni streaming. |
LiveEventTimedMetadataEndpoint
Punto de conexión de inserción de metadatos de eventos en directo.
Nombre | Tipo | Description |
---|---|---|
url |
string |
Dirección URL del punto de conexión de metadatos. |
LiveEventTranscription
Describe las pistas de transcripción en la salida de un evento en directo, generados mediante la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad.
Nombre | Tipo | Description |
---|---|---|
inputTrackSelection |
Proporciona un mecanismo para seleccionar la pista de audio en la fuente en directo de entrada, a la que se aplica la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
|
language |
string |
Especifica el idioma (configuración regional) que se usará para la transcripción de voz a texto; debe coincidir con el idioma hablado en la pista de audio. El valor debe estar en formato BCP-47 (por ejemplo, "en-US"). Consulte https://go.microsoft.com/fwlink/?linkid=2133742 para obtener más información sobre la característica de transcripción en directo y la lista de idiomas admitidos. |
outputTranscriptionTrack |
Describe una pista de transcripción en la salida de un evento en directo, generado mediante la transcripción de voz a texto. Esta propiedad está reservada para uso futuro, se omitirá cualquier valor establecido en esta propiedad. |
StreamOptionsFlag
Las opciones que se usarán para LiveEvent. Este valor se especifica en el momento de la creación y no se puede actualizar. Los valores válidos para los valores de entrada de matriz son "Default" y "LowLatency".
Nombre | Tipo | Description |
---|---|---|
Default |
string |
Streaming en vivo sin optimizaciones de latencia especiales. |
LowLatency |
string |
El evento en directo proporciona una latencia de extremo a extremo inferior al reducir sus búferes internos. |
LowLatencyV2 |
string |
El evento en directo está optimizado para la latencia de un extremo a otro. Esta opción solo está disponible para codificar eventos en directo con entrada RTMP. Las salidas se pueden transmitir mediante formatos HLS o DASH. La longitud de rebobinado o archivo de salida está limitada a 6 horas. Use la opción de flujo "LowLatency" para todos los demás escenarios. |
StretchMode
Especifica cómo se cambiará el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es None
Nombre | Tipo | Description |
---|---|---|
AutoFit |
string |
Rellene la salida (con el cuadro de letras o el cuadro de pilar) para respetar la resolución de salida, a la vez que garantiza que la región de vídeo activa de la salida tenga la misma relación de aspecto que la entrada. Por ejemplo, si la entrada es 1920x1080 y el valor preestablecido de codificación solicita 1280x1280, la salida será de 1280 x 1280, que contiene un rectángulo interno de 1280x720 en relación de aspecto de 16:9 y las regiones del cuadro de pilar 280 píxeles de ancho a la izquierda y derecha. |
AutoSize |
string |
Invalide la resolución de salida y cámbiela para que coincida con la relación de aspecto de visualización de la entrada, sin relleno. Por ejemplo, si la entrada es 1920x1080 y el valor preestablecido de codificación requiere 1280x1280, se invalida el valor en el valor preestablecido y la salida será de 1280x720, que mantiene la relación de aspecto de entrada de 16:9. |
None |
string |
Respeta estrictamente la resolución de salida especificada en el valor preestablecido de codificación sin tener en cuenta la relación de aspecto de píxeles o la relación de aspecto de visualización del vídeo de entrada. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |