Condividi tramite


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
accountName
path True

string

Nome dell'account di Servizi multimediali.

liveEventName
path True

string

Il nome dell'evento live, la lunghezza massima è 32.

Criterio di espressione regolare: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
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

LiveEvent

OK. La richiesta ha avuto esito positivo.

Other Status Codes

ErrorResponse

Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Get a LiveEvent by name

Esempio di richiesta

GET https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

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
createdByType

Tipo di identità che ha creato la risorsa.

CrossSiteAccessPolicies

Criteri di accesso client.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IPAccessControl

Controllo di accesso IP.

IPRange

Intervallo di indirizzi IP nello schema CIDR.

LiveEvent

Evento live.

LiveEventEncoding

Specifica il tipo di evento live e le impostazioni di codifica facoltative per la codifica degli eventi live.

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.

LiveEventEndpoint

Endpoint dell'evento live.

LiveEventInput

Input dell'evento live.

LiveEventInputAccessControl

Controllo di accesso IP per l'input dell'evento live.

LiveEventInputProtocol

Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.

LiveEventInputTrackSelection

Condizione di selezione della traccia. 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.

LiveEventPreview

Impostazioni dell'anteprima degli eventi live.

LiveEventPreviewAccessControl

Controllo di accesso IP per l'endpoint dell'anteprima degli eventi live.

LiveEventResourceState

Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.

LiveEventTimedMetadataEndpoint

Endpoint di inserimento dei metadati dell'evento live.

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.

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

StretchMode

Specifica il modo in cui il video di input verrà ridimensionato in base alle risoluzioni di output desiderate. Il valore predefinito è Nessuno

systemData

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

CrossSiteAccessPolicies

Criteri di accesso tra siti per eventi live.

properties.description

string

Descrizione dell'evento live.

properties.encoding

LiveEventEncoding

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

LiveEventInput

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

LiveEventPreview

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

LiveEventResourceState

Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.

properties.streamOptions

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

properties.transcriptions

LiveEventTranscription[]

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

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

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.

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

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

LiveEventInputAccessControl

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

LiveEventEndpoint[]

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

LiveEventInputProtocol

Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.

timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

Endpoint dei metadati per l'evento live.

LiveEventInputAccessControl

Controllo di accesso IP per l'input dell'evento live.

Nome Tipo Descrizione
ip

IPAccessControl

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

LiveEventPreviewAccessControl

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

LiveEventEndpoint[]

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

IPAccessControl

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

LiveEventInputTrackSelection[]

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

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.

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

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

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.