Live Events - Get
Get Live Event
Ottiene le proprietà di un evento live.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di Servizi multimediali. |
live
|
path | True |
string |
Il nome dell'evento live, la lunghezza massima è 32. Criterio di espressione regolare: |
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione di Azure. |
subscription
|
path | True |
string |
Identificatore univoco per una sottoscrizione di Microsoft Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK. La richiesta ha avuto esito positivo. |
|
Other Status Codes |
Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
Get a LiveEvent by name
Esempio di richiesta
Risposta di esempio
{
"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": {},
"properties": {
"description": "",
"resourceState": "Stopped",
"provisioningState": "Succeeded",
"created": "2018-03-03T02:25:08.3474032Z",
"lastModified": "2018-03-03T02:25:08.3474032Z",
"useStaticHostname": false,
"streamOptions": [
"Default"
],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "FragmentedMP4",
"accessToken": null,
"endpoints": [
{
"protocol": "FragmentedMP4",
"url": "http://clouddeployment.media-test.net/ingest.isml"
}
],
"timedMetadataEndpoints": []
},
"preview": {
"previewLocator": "763f3ea4-d94f-441c-a634-c833f61a4e04",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"endpoints": [
{
"protocol": "FragmentedMP4",
"url": "https://testeventopito4idh2r-weibzmedia05.preview-ts051.channel.media-test.windows-int.net/763f3ea4-d94f-441c-a634-c833f61a4e04/preview.ism/manifest"
}
]
},
"encoding": {
"encodingType": "None",
"presetName": null
},
"crossSiteAccessPolicies": {
"clientAccessPolicy": "<access-policy><cross-domain-access><policy><allow-from http-methods=\"*\"><domain uri=\"http://*\"/></allow-from><grant-to><resource path=\"/\" include-subpaths=\"true\"/></grant-to></policy></cross-domain-access></access-policy>",
"crossDomainPolicy": "<cross-domain-policy><allow-access-from domain=\"*\" secure=\"false\" /></cross-domain-policy>"
}
}
}
Definizioni
Nome | Descrizione |
---|---|
created |
Tipo di identità che ha creato la risorsa. |
Cross |
Criteri di accesso client. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
IPAccess |
Controllo di accesso IP. |
IPRange |
Intervallo di indirizzi IP nello schema CIDR. |
Live |
Evento live. |
Live |
Specifica il tipo di evento live e le impostazioni di codifica facoltative per la codifica degli eventi live. |
Live |
Tipo di evento live. Quando encodingType è impostato su PassthroughBasic o PassthroughStandard, il servizio passa semplicemente attraverso i livelli audio e video in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live esegue la transcodifica del flusso in ingresso in più velocità in bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live. |
Live |
Endpoint dell'evento live. |
Live |
Input dell'evento live. |
Live |
Controllo di accesso IP per l'input dell'evento live. |
Live |
Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato. |
Live |
Condizione di selezione della traccia. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
Live |
Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione da riconoscimento vocale a testo. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
Live |
Impostazioni dell'anteprima degli eventi live. |
Live |
Controllo di accesso IP per l'endpoint dell'anteprima degli eventi live. |
Live |
Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012. |
Live |
Endpoint di inserimento dei metadati dell'evento live. |
Live |
Descrive le tracce di trascrizione nell'output di un evento live, generato usando la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
Stream |
Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'. |
Stretch |
Specifica il modo in cui il video di input verrà ridimensionato in base alle risoluzioni di output desiderate. Il valore predefinito è Nessuno |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CrossSiteAccessPolicies
Criteri di accesso client.
Nome | Tipo | Descrizione |
---|---|---|
clientAccessPolicy |
string |
Contenuto di clientaccesspolicy.xml utilizzato da Silverlight. |
crossDomainPolicy |
string |
Contenuto di crossdomain.xml utilizzato da Silverlight. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
IPAccessControl
Controllo di accesso IP.
Nome | Tipo | Descrizione |
---|---|---|
allow |
IPRange[] |
Elenco indirizzi IP consentiti. |
IPRange
Intervallo di indirizzi IP nello schema CIDR.
Nome | Tipo | Descrizione |
---|---|---|
address |
string |
Indirizzo IP. |
name |
string |
Nome descrittivo per l'intervallo di indirizzi IP. |
subnetPrefixLength |
integer |
Lunghezza del prefisso della subnet mask (vedere notazione CIDR). |
LiveEvent
Evento live.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Posizione geografica in cui risiede la risorsa |
name |
string |
nome della risorsa. |
properties.created |
string |
Ora di creazione per l'evento live |
properties.crossSiteAccessPolicies |
Criteri di accesso tra siti per eventi live. |
|
properties.description |
string |
Descrizione dell'evento live. |
properties.encoding |
Impostazioni di codifica per l'evento live. Configura se viene usato un codificatore live per l'evento live e le impostazioni per il codificatore live, se usato. |
|
properties.hostnamePrefix |
string |
Quando useStaticHostname è impostato su true, il nome hostPrefix specifica la prima parte del nome host assegnato all'anteprima degli eventi live e inserisce gli endpoint. Il nome host finale sarà una combinazione di questo prefisso, il nome dell'account del servizio multimediale e un breve codice per il data center di Servizi multimediali di Azure. |
properties.input |
Impostazioni di input degli eventi live. Definisce il modo in cui l'evento live riceve l'input da un codificatore di contributi. |
|
properties.lastModified |
string |
Ora dell'ultima modifica dell'evento live. |
properties.preview |
Impostazioni dell'anteprima degli eventi live. L'anteprima consente ai produttori di eventi live di visualizzare in anteprima il contenuto di streaming live senza creare alcun output live. |
|
properties.provisioningState |
string |
Stato di provisioning dell'evento live. |
properties.resourceState |
Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012. |
|
properties.streamOptions |
Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'. |
|
properties.transcriptions |
Impostazioni di trascrizione live per l'evento live. Per altre informazioni sulla funzionalità di trascrizione in tempo reale, vedere https://go.microsoft.com/fwlink/?linkid=2133742 . |
|
properties.useStaticHostname |
boolean |
Specifica se un nome host statico verrebbe assegnato all'anteprima degli eventi live e agli endpoint di inserimento. Questo valore può essere aggiornato solo se l'evento live è in stato standby |
systemData |
Metadati di sistema relativi a questa risorsa. |
|
tags |
object |
Tag delle risorse. |
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
LiveEventEncoding
Specifica il tipo di evento live e le impostazioni di codifica facoltative per la codifica degli eventi live.
Nome | Tipo | Descrizione |
---|---|---|
encodingType |
Tipo di evento live. Quando encodingType è impostato su PassthroughBasic o PassthroughStandard, il servizio passa semplicemente attraverso i livelli audio e video in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live esegue la transcodifica del flusso in ingresso in più velocità in bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live. |
|
keyFrameInterval |
string |
Usare un valore di ora ISO 8601 compreso tra 0,5 e 20 secondi per specificare la lunghezza del frammento di output per le tracce video e audio di un evento live di codifica. Ad esempio, usare PT2S per indicare 2 secondi. Per la traccia video definisce anche l'intervallo di fotogrammi chiave o la lunghezza di un GoP (gruppo di immagini). Se questo valore non è impostato per un evento live di codifica, la durata del frammento viene impostata su 2 secondi. Non è possibile impostare il valore per gli eventi live pass-through. |
presetName |
string |
Nome del set di impostazioni di codifica facoltativo, usato quando encodingType non è Nessuno. Questo valore viene specificato al momento della creazione e non può essere aggiornato. Se encodingType è impostato su Standard, il nome predefinito del set di impostazioni è 'Default720p'. In caso contrario, se encodingType è impostato su Premium1080p, il set di impostazioni predefinito è "Default1080p". |
stretchMode |
Specifica il modo in cui il video di input verrà ridimensionato in base alle risoluzioni di output desiderate. Il valore predefinito è Nessuno |
LiveEventEncodingType
Tipo di evento live. Quando encodingType è impostato su PassthroughBasic o PassthroughStandard, il servizio passa semplicemente attraverso i livelli audio e video in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live esegue la transcodifica del flusso in ingresso in più velocità in bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Questo è lo stesso di PassthroughStandard, vedere la descrizione seguente. Questo valore di enumerazione è deprecato. |
PassthroughBasic |
string |
Il flusso inserito passa attraverso l'evento live dal codificatore di contributi senza ulteriori elaborazioni. Nella modalità PassthroughBasic l'inserimento è limitato a un massimo di 5 Mb e sono consentiti solo 1 output live simultaneo. La trascrizione in tempo reale non è disponibile. |
PassthroughStandard |
string |
Il flusso inserito passa attraverso l'evento live dal codificatore di contributi senza ulteriori elaborazioni. La trascrizione in tempo reale è disponibile. I limiti di velocità in bit di inserimento sono molto più elevati e sono consentiti fino a 3 output live simultanei. |
Premium1080p |
string |
Un codificatore live di contributi invia un flusso a velocità in bit singola all'evento live e Servizi multimediali crea più flussi a velocità in bit. L'output non può superare i 1080p in risoluzione. |
Standard |
string |
Un codificatore live di contributi invia un flusso a velocità in bit singola all'evento live e Servizi multimediali crea più flussi a velocità in bit. L'output non può superare i 720p in risoluzione. |
LiveEventEndpoint
Endpoint dell'evento live.
Nome | Tipo | Descrizione |
---|---|---|
protocol |
string |
Protocollo endpoint. |
url |
string |
URL dell'endpoint. |
LiveEventInput
Input dell'evento live.
Nome | Tipo | Descrizione |
---|---|---|
accessControl |
Controllo di accesso per l'input dell'evento live. |
|
accessToken |
string |
UUID in formato stringa per identificare in modo univoco il flusso. Questa impostazione può essere specificata in fase di creazione, ma non può essere aggiornata. Se omesso, il servizio genererà un valore univoco. |
endpoints |
Endpoint di input per l'evento live. |
|
keyFrameIntervalDuration |
string |
Durata iso 8601 dell'intervallo di fotogrammi chiave dell'input. Questo valore imposta la proprietà EXT-X-TARGETDURATION nell'output HLS. Ad esempio, usare PT2S per indicare 2 secondi. Lasciare vuoto il valore per la codifica degli eventi live. |
streamingProtocol |
Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato. |
|
timedMetadataEndpoints |
Endpoint dei metadati per l'evento live. |
LiveEventInputAccessControl
Controllo di accesso IP per l'input dell'evento live.
Nome | Tipo | Descrizione |
---|---|---|
ip |
Proprietà del controllo di accesso IP. |
LiveEventInputProtocol
Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.
Nome | Tipo | Descrizione |
---|---|---|
FragmentedMP4 |
string |
L'input Smooth Streaming verrà inviato dal codificatore di contributi all'evento live. |
RTMP |
string |
L'input RTMP verrà inviato dal codificatore di contributi all'evento live. |
LiveEventInputTrackSelection
Condizione di selezione della traccia. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
Nome | Tipo | Descrizione |
---|---|---|
operation |
string |
Confronto dell'operazione. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
property |
string |
Nome della proprietà da selezionare. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
value |
string |
Valore della proprietà da selezionare. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
LiveEventOutputTranscriptionTrack
Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione da riconoscimento vocale a testo. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
Nome | Tipo | Descrizione |
---|---|---|
trackName |
string |
Nome della traccia di output. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
LiveEventPreview
Impostazioni dell'anteprima degli eventi live.
Nome | Tipo | Descrizione |
---|---|---|
accessControl |
Controllo di accesso per l'anteprima degli eventi live. |
|
alternativeMediaId |
string |
Identificatore multimediale alternativo associato al localizzatore di streaming creato per l'anteprima. Questo valore viene specificato al momento della creazione e non può essere aggiornato. L'identificatore può essere usato in CustomLicenseAcquisitionUrlTemplate o CustomKeyAcquisitionUrlTemplate del FlussoPolicy specificato nel campo StreamingPolicyName. |
endpoints |
Endpoint per l'anteprima. Non condividere l'URL di anteprima con il gruppo di destinatari dell'evento live. |
|
previewLocator |
string |
Identificatore del localizzatore di anteprima in formato Guid. Se si specifica questa impostazione al momento della creazione, il chiamante può conoscere l'URL del localizzatore di anteprima prima della creazione dell'evento. Se omesso, il servizio genererà un identificatore casuale. Questo valore non può essere aggiornato dopo la creazione dell'evento live. |
streamingPolicyName |
string |
Nome dei criteri di streaming usati per l'anteprima dell'evento live. Questo valore viene specificato al momento della creazione e non può essere aggiornato. |
LiveEventPreviewAccessControl
Controllo di accesso IP per l'endpoint dell'anteprima degli eventi live.
Nome | Tipo | Descrizione |
---|---|---|
ip |
Proprietà del controllo di accesso IP. |
LiveEventResourceState
Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.
Nome | Tipo | Descrizione |
---|---|---|
Allocating |
string |
L'azione di allocazione è stata chiamata per l'evento live e viene effettuato il provisioning delle risorse per questo evento live. Al termine dell'allocazione, l'evento live passerà allo stato StandBy. |
Deleting |
string |
L'evento live viene eliminato. In questo stato di transizione non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming. |
Running |
string |
Le risorse degli eventi live sono state allocate, sono stati generati URL di inserimento e anteprima ed è in grado di ricevere flussi live. A questo punto, la fatturazione è attiva. È necessario chiamare in modo esplicito Stop sulla risorsa evento live per interrompere la fatturazione. |
StandBy |
string |
È stato effettuato il provisioning delle risorse degli eventi live ed è pronto per l'avvio. La fatturazione si verifica in questo stato. La maggior parte delle proprietà può comunque essere aggiornata, tuttavia l'inserimento o lo streaming non è consentito durante questo stato. |
Starting |
string |
L'evento live viene avviato e le risorse vengono allocate. In questo stato non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming. Se si verifica un errore, l'evento live torna allo stato Stopped. |
Stopped |
string |
Questo è lo stato iniziale dell'evento live dopo la creazione (a meno che l'avvio automatico non sia stato impostato su true). In questo stato non viene eseguita alcuna fatturazione. In questo stato, le proprietà dell'evento live possono essere aggiornate ma lo streaming non è consentito. |
Stopping |
string |
L'evento live viene arrestato e viene eseguito il deprovisioning delle risorse. In questo stato di transizione non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming. |
LiveEventTimedMetadataEndpoint
Endpoint di inserimento dei metadati dell'evento live.
Nome | Tipo | Descrizione |
---|---|---|
url |
string |
URL dell'endpoint dei metadati. |
LiveEventTranscription
Descrive le tracce di trascrizione nell'output di un evento live, generato usando la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
Nome | Tipo | Descrizione |
---|---|---|
inputTrackSelection |
Fornisce un meccanismo per selezionare la traccia audio nel feed live di input, a cui viene applicata la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
|
language |
string |
Specifica la lingua (impostazioni locali) da usare per la trascrizione della sintesi vocale. Deve corrispondere alla lingua parlata nella traccia audio. Il valore deve essere in formato BCP-47 ,ad esempio "en-US". Per https://go.microsoft.com/fwlink/?linkid=2133742 altre informazioni sulla funzionalità di trascrizione in tempo reale e sull'elenco delle lingue supportate, vedere . |
outputTranscriptionTrack |
Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione da riconoscimento vocale a testo. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato. |
StreamOptionsFlag
Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'.
Nome | Tipo | Descrizione |
---|---|---|
Default |
string |
Streaming live senza ottimizzazioni di latenza speciali. |
LowLatency |
string |
L'evento live offre una latenza end-to-end inferiore riducendo i buffer interni. |
LowLatencyV2 |
string |
L'evento live è ottimizzato per la latenza end-to-end. Questa opzione è disponibile solo per la codifica di eventi live con input RTMP. Gli output possono essere trasmessi usando formati HLS o DASH. La lunghezza dell'archivio o del DVR degli output è limitata a 6 ore. Usare l'opzione di flusso "LowLatency" per tutti gli altri scenari. |
StretchMode
Specifica il modo in cui il video di input verrà ridimensionato in base alle risoluzioni di output desiderate. Il valore predefinito è Nessuno
Nome | Tipo | Descrizione |
---|---|---|
AutoFit |
string |
Aggiungere l'output (con la casella lettera o il pilastro) per rispettare la risoluzione dell'output, garantendo al tempo stesso che l'area video attiva nell'output abbia le stesse proporzioni dell'input. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, l'output sarà a 1280x1280, che contiene un rettangolo interno di 1280x720 a proporzioni di 16:9 e le aree della casella dei pilastri di 280 pixel a sinistra e destra. |
AutoSize |
string |
Eseguire l'override della risoluzione di output e modificarla in modo che corrisponda alle proporzioni di visualizzazione dell'input, senza spaziatura interna. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, il valore nel set di impostazioni viene sottoposto a override e l'output sarà a 1280x720, che mantiene le proporzioni di input di 16:9. |
None |
string |
Rispetta rigorosamente la risoluzione di output specificata nel set di impostazioni di codifica senza considerare le proporzioni dei pixel o le proporzioni dello schermo del video di input. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |