Live Events - Create

Référence

Service:: Media Services

API Version:: 2022-11-01

Créer un événement en direct
Crée un événement en direct.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01

With optional parameters:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01&autoStart={autoStart}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
liveEventName	path	True	string	Le nom de l’événement en direct, dont la longueur maximale est 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nom du groupe de ressources au sein de l’abonnement Azure.
subscriptionId	path	True	string	Identificateur unique d’un abonnement Microsoft Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.
autoStart	query		boolean	L’indicateur indique si la ressource doit être démarrée automatiquement lors de la création.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
properties.input	True	LiveEventInput	Paramètres d’entrée d’événement en direct. Il définit la façon dont l’événement en direct reçoit l’entrée d’un encodeur de contribution.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Stratégies d’accès inter site aux événements en direct.
properties.description		string	Description de l’événement en direct.
properties.encoding		LiveEventEncoding	Paramètres d’encodage de l’événement en direct. Il configure si un encodeur dynamique est utilisé pour l’événement en direct et les paramètres de l’encodeur dynamique s’il est utilisé.
properties.hostnamePrefix		string	Lorsque useStaticHostname a la valeur true, le nom d’hôtePrefix spécifie la première partie du nom d’hôte affectée à l’aperçu de l’événement en direct et aux points de terminaison d’ingestion. Le nom d’hôte final est une combinaison de ce préfixe, du nom du compte de service multimédia et d’un code court pour le centre de données Azure Media Services.
properties.preview		LiveEventPreview	Paramètres de préversion de l’événement en direct. La préversion permet aux producteurs d’événements en direct d’afficher un aperçu du contenu de streaming en direct sans créer de sortie en direct.
properties.streamOptions		StreamOptionsFlag[]	Options à utiliser pour LiveEvent. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».
properties.transcriptions		LiveEventTranscription[]	Paramètres de transcription en direct pour l’événement en direct. Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct.
properties.useStaticHostname		boolean	Spécifie si un nom d’hôte statique est affecté à l’aperçu d’événement en direct et aux points de terminaison d’ingestion. Cette valeur ne peut être mise à jour que si l’événement en direct est à l’état Veille
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	LiveEvent	OK. La demande a réussi.
201 Created	LiveEvent	Créé. La demande a été acceptée pour traitement et l’opération se terminera de manière asynchrone. Pour plus https://go.microsoft.com/fwlink/?linkid=2087017 d’informations sur la surveillance des opérations asynchrones Azure à l’aide de l’en-tête de réponse Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Réponse d’erreur de streaming décrivant la raison de l’échec de l’opération.

Exemples

Create a LiveEvent

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

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "input": {
      "streamingProtocol": "RTMP",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    }
  }
}

import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.LiveEventInput;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputAccessControl;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputProtocol;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreview;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreviewAccessControl;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/** Samples for LiveEvents Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-create.json
     */
    /**
     * Sample code: Create a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .define("myLiveEvent1")
            .withRegion("West US")
            .withExistingMediaservice("mediaresources", "slitestmedia10")
            .withTags(mapOf("tag1", "value1", "tag2", "value2"))
            .withDescription("test event 1")
            .withInput(
                new LiveEventInput()
                    .withStreamingProtocol(LiveEventInputProtocol.RTMP)
                    .withAccessControl(
                        new LiveEventInputAccessControl()
                            .withIp(
                                new IpAccessControl()
                                    .withAllow(
                                        Arrays
                                            .asList(
                                                new IpRange()
                                                    .withName("AllowAll")
                                                    .withAddress("0.0.0.0")
                                                    .withSubnetPrefixLength(0)))))
                    .withKeyFrameIntervalDuration("fakeTokenPlaceholder"))
            .withPreview(
                new LiveEventPreview()
                    .withAccessControl(
                        new LiveEventPreviewAccessControl()
                            .withIp(
                                new IpAccessControl()
                                    .withAllow(
                                        Arrays
                                            .asList(
                                                new IpRange()
                                                    .withName("AllowAll")
                                                    .withAddress("0.0.0.0")
                                                    .withSubnetPrefixLength(0))))))
            .create();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 201

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

Response Body

{
  "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": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}

Status code:: 200

{
  "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:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
CrossSiteAccessPolicies	Stratégie d’accès au client.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
IPAccessControl	Contrôle d’accès IP.
IPRange	Plage d’adresses IP dans le schéma CIDR.
LiveEvent	Événement en direct.
LiveEventEncoding	Spécifie le type d’événement en direct et les paramètres d’encodage facultatifs pour l’encodage des événements en direct.
LiveEventEncodingType	Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes vers la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs débits ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.
LiveEventEndpoint	Point de terminaison d’événement en direct.
LiveEventInput	Entrée d’événement en direct.
LiveEventInputAccessControl	Contrôle d’accès IP pour l’entrée d’événement en direct.
LiveEventInputProtocol	Protocole d’entrée pour l’événement en direct. Il est spécifié au moment de la création et ne peut pas être mis à jour.
LiveEventInputTrackSelection	Condition de sélection de suivi. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
LiveEventOutputTranscriptionTrack	Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
LiveEventPreview	Paramètres d’aperçu de l’événement en direct.
LiveEventPreviewAccessControl	Contrôle d’accès IP pour le point de terminaison de préversion des événements en direct.
LiveEventResourceState	État des ressources de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.
LiveEventTimedMetadataEndpoint	Point de terminaison d’insertion de métadonnées d’événement en direct.
LiveEventTranscription	Décrit les pistes de transcription dans la sortie d’un événement en direct, générées à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
StreamOptionsFlag	Options à utiliser pour l’événement en direct. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».
StretchMode	Spécifie la façon dont la vidéo d’entrée sera redimensionnée pour s’adapter à la ou les résolution(s) de sortie souhaitées. La valeur par défaut est None
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Stratégie d’accès au client.

Nom	Type	Description
clientAccessPolicy	string	Le contenu de clientaccesspolicy.xml utilisé par Silverlight.
crossDomainPolicy	string	Le contenu de crossdomain.xml utilisé par Silverlight.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

IPAccessControl

Contrôle d’accès IP.

Nom	Type	Description
allow	IPRange[]	Liste d’adresses IP autorisées.

IPRange

Plage d’adresses IP dans le schéma CIDR.

Nom	Type	Description
address	string	Adresse IP.
name	string	Nom convivial de la plage d’adresses IP.
subnetPrefixLength	integer	Longueur du préfixe du masque de sous-réseau (voir notation CIDR).

LiveEvent

Événement en direct.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Emplacement géographique où réside la ressource
name	string	nom de la ressource.
properties.created	string	Heure de création de l’événement en direct
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Stratégies d’accès intersites aux événements en direct.
properties.description	string	Description de l’événement en direct.
properties.encoding	LiveEventEncoding	Paramètres d’encodage de l’événement en direct. Il configure si un encodeur en direct est utilisé pour l’événement en direct et les paramètres de l’encodeur en direct s’il est utilisé.
properties.hostnamePrefix	string	Lorsque useStaticHostname a la valeur true, le nom d’hôtePrefix spécifie la première partie du nom d’hôte affecté à l’aperçu de l’événement en direct et aux points de terminaison d’ingestion. Le nom d’hôte final est une combinaison de ce préfixe, du nom du compte de service multimédia et d’un code court pour le centre de données Azure Media Services.
properties.input	LiveEventInput	Paramètres d’entrée d’événement en direct. Il définit la façon dont l’événement en direct reçoit les entrées d’un encodeur de contribution.
properties.lastModified	string	Heure de la dernière modification de l’événement en direct.
properties.preview	LiveEventPreview	Paramètres d’aperçu de l’événement en direct. La préversion permet aux producteurs d’événements en direct d’afficher un aperçu du contenu de streaming en direct sans créer de sortie en direct.
properties.provisioningState	string	État d’approvisionnement de l’événement en direct.
properties.resourceState	LiveEventResourceState	État de la ressource de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.
properties.streamOptions	StreamOptionsFlag[]	Options à utiliser pour l’événement en direct. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».
properties.transcriptions	LiveEventTranscription[]	Paramètres de transcription en direct pour l’événement en direct. Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct.
properties.useStaticHostname	boolean	Spécifie si un nom d’hôte statique est affecté aux points de terminaison d’ingérer et d’aperçu de l’événement en direct. Cette valeur ne peut être mise à jour que si l’événement en direct est à l’état Veille
systemData	systemData	Métadonnées système relatives à cette ressource.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

LiveEventEncoding

Spécifie le type d’événement en direct et les paramètres d’encodage facultatifs pour l’encodage des événements en direct.

Nom	Type	Description
encodingType	LiveEventEncodingType	Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes jusqu’à la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs vitesses de transmission ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.
keyFrameInterval	string	Utilisez une valeur de temps ISO 8601 comprise entre 0,5 et 20 secondes pour spécifier la longueur du fragment de sortie pour les pistes vidéo et audio d’un événement en direct d’encodage. Par exemple, utilisez PT2S pour indiquer 2 secondes. Pour la piste vidéo, elle définit également l’intervalle d’image clé ou la longueur d’un goP (groupe d’images). Si cette valeur n’est pas définie pour un événement en direct d’encodage, la durée du fragment est de 2 secondes par défaut. La valeur ne peut pas être définie pour les événements en direct pass-through.
presetName	string	Nom prédéfini d’encodage facultatif, utilisé lorsque encodingType n’a pas la valeur None. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Si encodingType est défini sur Standard, le nom prédéfini par défaut est « Default720p ». Sinon, si encodingType est défini sur Premium1080p, la présélection par défaut est « Default1080p ».
stretchMode	StretchMode	Spécifie comment la vidéo d’entrée sera redimensionnée pour s’adapter à la ou aux résolutions de sortie souhaitées. La valeur par défaut est None

LiveEventEncodingType

Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes vers la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs débits ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.

Nom	Type	Description
None	string	Il s’agit de la même chose que PassthroughStandard. Consultez la description ci-dessous. Cette valeur d’énumération est dépréciée.
PassthroughBasic	string	Le flux ingéré passe par l’événement en direct de l’encodeur de contribution sans traitement supplémentaire. En mode PassthroughBasic, l’ingestion est limitée à 5 Mbits/s et une seule sortie dynamique simultanée est autorisée. La transcription en direct n’est pas disponible.
PassthroughStandard	string	Le flux ingéré passe par l’événement en direct de l’encodeur de contribution sans traitement supplémentaire. La transcription en direct est disponible. Les limites de débit d’ingestion sont beaucoup plus élevées et jusqu’à 3 sorties actives simultanées sont autorisées.
Premium1080p	string	Un encodeur live de contribution envoie un flux de débit unique à l’événement en direct et Media Services crée plusieurs flux à débit binaire. La résolution de la sortie ne peut pas dépasser 1 080p.
Standard	string	Un encodeur live de contribution envoie un flux de débit unique à l’événement en direct et Media Services crée plusieurs flux à débit binaire. La résolution de la sortie ne peut pas dépasser 720p.

LiveEventEndpoint

Point de terminaison d’événement en direct.

Nom	Type	Description
protocol	string	Protocole de point de terminaison.
url	string	URL du point de terminaison.

LiveEventInput

Entrée d’événement en direct.

Nom	Type	Description
accessControl	LiveEventInputAccessControl	Contrôle d’accès pour l’entrée d’événement en direct.
accessToken	string	UUID sous forme de chaîne pour identifier de manière unique le flux. Cela peut être spécifié au moment de la création, mais ne peut pas être mis à jour. En cas d’omission, le service génère une valeur unique.
endpoints	LiveEventEndpoint[]	Points de terminaison d’entrée pour l’événement en direct.
keyFrameIntervalDuration	string	Durée de temps ISO 8601 de l’intervalle d’image clé de l’entrée. Cette valeur définit la propriété EXT-X-TARGETDURATION dans la sortie HLS. Par exemple, utilisez PT2S pour indiquer 2 secondes. Laissez la valeur vide pour l’encodage des événements en direct.
streamingProtocol	LiveEventInputProtocol	Protocole d’entrée pour l’événement en direct. Ce paramètre est spécifié au moment de la création et ne peut pas être mis à jour.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Points de terminaison de métadonnées pour l’événement en direct.

LiveEventInputAccessControl

Contrôle d’accès IP pour l’entrée d’événement en direct.

Nom	Type	Description
ip	IPAccessControl	Propriétés du contrôle d’accès IP.

LiveEventInputProtocol

Protocole d’entrée pour l’événement en direct. Il est spécifié au moment de la création et ne peut pas être mis à jour.

Nom	Type	Description
FragmentedMP4	string	L’entrée Smooth Streaming sera envoyée par l’encodeur de contribution à l’événement en direct.
RTMP	string	L’entrée RTMP sera envoyée par l’encodeur de contribution à l’événement en direct.

LiveEventInputTrackSelection

Condition de sélection de suivi. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom	Type	Description
operation	string	Opération de comparaison. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
property	string	Nom de la propriété à sélectionner. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
value	string	Valeur de propriété à sélectionner. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventOutputTranscriptionTrack

Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom	Type	Description
trackName	string	Nom de la piste de sortie. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventPreview

Paramètres d’aperçu de l’événement en direct.

Nom	Type	Description
accessControl	LiveEventPreviewAccessControl	Contrôle d’accès pour la préversion de l’événement en direct.
alternativeMediaId	string	Autre identificateur de média associé au localisateur de diffusion en continu créé pour la préversion. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. L’identificateur peut être utilisé dans customLicenseAcquisitionUrlTemplate ou CustomKeyAcquisitionUrlTemplate de StreamingPolicy spécifié dans le champ StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Points de terminaison pour la préversion. Ne partagez pas l’URL de la préversion avec le public de l’événement en direct.
previewLocator	string	Identificateur du localisateur d’aperçu au format GUID. Cette spécification au moment de la création permet à l’appelant de connaître l’URL du localisateur d’aperçu avant la création de l’événement. En cas d’omission, le service génère un identificateur aléatoire. Cette valeur ne peut pas être mise à jour une fois l’événement en direct créé.
streamingPolicyName	string	Nom de la stratégie de diffusion en continu utilisée pour la préversion de l’événement en direct. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour.

LiveEventPreviewAccessControl

Contrôle d’accès IP pour le point de terminaison de préversion des événements en direct.

Nom	Type	Description
ip	IPAccessControl	Propriétés du contrôle d’accès IP.

LiveEventResourceState

État des ressources de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.

Nom	Type	Description
Allocating	string	L’action d’allocation a été appelée sur l’événement en direct et les ressources sont en cours d’approvisionnement pour cet événement en direct. Une fois l’allocation terminée, l’événement en direct passe à l’état StandBy.
Deleting	string	L’événement en direct est en cours de suppression. Aucune facturation ne survient dans cet état de transition. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état.
Running	string	Les ressources de l’événement en direct ont été allouées, des URL de réception et d’aperçu ont été générées, et l’événement peut recevoir des flux temps réel. À ce stade, la facturation est active. Vous devez appeler explicitement la commande Stop sur la ressource de l’événement en direct pour arrêter toute facturation supplémentaire.
StandBy	string	Les ressources d’événement en direct ont été approvisionnées et sont prêtes à démarrer. La facturation intervient dans cet état. La plupart des propriétés peuvent toujours être mises à jour, mais ni l’ingestion ni la diffusion en continu ne sont autorisées dans cet état.
Starting	string	L’événement en direct démarre et les ressources sont allouées. Aucune facturation ne survient dans cet état. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état. Si une erreur se produit, l’événement en direct retourne à l’état Arrêté.
Stopped	string	C’est l’état initial de l’événement en direct après sa création (sauf si le démarrage automatique a été défini sur true). Aucune facturation ne survient dans cet état. Dans cet état, les propriétés de l’événement en direct peuvent être mises à jour, mais la diffusion en continu n’est pas autorisée.
Stopping	string	L’événement en direct est en cours d’arrêt et les ressources sont déprovisionnées. Aucune facturation ne survient dans cet état de transition. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état.

LiveEventTimedMetadataEndpoint

Point de terminaison d’insertion de métadonnées d’événement en direct.

Nom	Type	Description
url	string	URL du point de terminaison de métadonnées.

LiveEventTranscription

Décrit les pistes de transcription dans la sortie d’un événement en direct, générées à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom	Type	Description
inputTrackSelection	LiveEventInputTrackSelection[]	Fournit un mécanisme permettant de sélectionner la piste audio dans le flux en direct d’entrée, auquel la transcription de reconnaissance vocale est appliquée. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.
language	string	Spécifie la langue (paramètres régionaux) à utiliser pour la transcription de reconnaissance vocale : elle doit correspondre à la langue parlée dans la piste audio. La valeur doit être au format BCP-47 (par exemple, « en-US »). Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct et la liste des langues prises en charge.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

StreamOptionsFlag

Options à utiliser pour l’événement en direct. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».

Nom	Type	Description
Default	string	Streaming en direct sans optimisations de latence particulières.
LowLatency	string	L’événement en direct fournit une latence de bout en bout en réduisant ses mémoires tampons internes.
LowLatencyV2	string	L’événement en direct est optimisé pour la latence de bout en bout. Cette option est disponible uniquement pour l’encodage d’événements en direct avec une entrée RTMP. Les sorties peuvent être diffusées en continu au format HLS ou DASH. La durée de rembobinage de l’archive ou de la DVR des sorties est limitée à 6 heures. Utilisez l’option de flux « LowLatency » pour tous les autres scénarios.

StretchMode

Spécifie la façon dont la vidéo d’entrée sera redimensionnée pour s’adapter à la ou les résolution(s) de sortie souhaitées. La valeur par défaut est None

Nom	Type	Description
AutoFit	string	Padez la sortie (avec la boîte aux lettres ou la zone de pilier) pour respecter la résolution de sortie, tout en vous assurant que la région vidéo active dans la sortie a le même rapport d’aspect que l’entrée. Par exemple, si l’entrée est 1920x1080 et que la présélection d’encodage demande 1280x1280, la sortie sera à 1280x1280, qui contient un rectangle interne de 1280x720 au rapport d’aspect de 16 :9, et les zones de piliers de 280 pixels de large à gauche et à droite.
AutoSize	string	Remplacez la résolution de sortie et modifiez-la pour qu’elle corresponde au rapport d’affichage de l’entrée, sans remplissage. Par exemple, si l’entrée est 1920x1080 et la présélection d’encodage demande 1280x1280, la valeur dans la présélection est remplacée, et la sortie sera à 1280x720, qui conserve les proportions d’entrée en 16:9.
None	string	Respecte strictement la résolution de sortie spécifiée dans la présélection d’encodage sans tenir compte du rapport d’aspect en pixels ou de l’affichage de la vidéo d’entrée.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.