Live Outputs - Create

Référence

Service:: Media Services

Version d'API:: 2022-11-01

Créer une sortie dynamique
Crée une sortie en direct.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
liveEventName	path	True	string	Nom de l’événement en direct, la longueur maximale est 32. Modèle d’expression régulière: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	Nom de la sortie en direct. Modèle d’expression régulière: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nom du groupe de ressources dans 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 du client.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.archiveWindowLength	True	string	Durée ISO 8601 comprise entre 1 minute et 25 heures pour indiquer la longueur maximale du contenu pouvant être archivée dans la ressource pour cette sortie en direct. Cela définit également la longueur maximale du contenu pour la fenêtre de rembobinage. Par exemple, utilisez PT1H30M pour indiquer 1 heure et 30 minutes de fenêtre d’archivage.
properties.assetName	True	string	Ressource dans laquelle la sortie en direct écrit.
properties.description		string	Description de la sortie en direct.
properties.hls		Hls	HTTP Live Streaming paramètre de compression (HLS) pour la sortie en direct.
properties.manifestName		string	Nom du fichier manifeste. S’il n’est pas fourni, le service en génère un automatiquement.
properties.outputSnapTime		integer	Horodatage initial auquel la sortie en direct commence, tout contenu avant cette valeur ne sera pas archivé.
properties.rewindWindowLength		string	Temps ISO 8601 compris entre 1 minute et la durée d’archiveWindowLength pour contrôler la longueur de la fenêtre pouvant être recherché pendant live. Le service n’utilise pas cette propriété une fois Que LiveOutput s’arrête. La VOD archivée aura un contenu complet avec ArchiveWindowLength d’origine. Par exemple, utilisez PT1H30M pour indiquer 1 heure et 30 minutes de fenêtre de rembobinage. Le service utilisera la valeur par défaut implicite 30m uniquement si Live Event active LL.

Réponses

Nom	Type	Description
200 OK	LiveOutput	OK. La demande a réussi.
201 Created	LiveOutput	Créé. La demande a été acceptée pour traitement et l’opération se termine 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 diffusion en continu décrivant la raison de l’échec de l’opération.

Exemples

Create a LiveOutput

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

{
  "properties": {
    "description": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "rewindWindowLength": "PT4M",
    "manifestName": "testmanifest",
    "hls": {
      "fragmentsPerTsSegment": 5
    }
  }
}


import com.azure.resourcemanager.mediaservices.models.Hls;
import java.time.Duration;

/**
 * Samples for LiveOutputs Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-
     * create.json
     */
    /**
     * Sample code: Create a LiveOutput.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveOutput(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveOutputs().define("myLiveOutput1")
            .withExistingLiveEvent("mediaresources", "slitestmedia10", "myLiveEvent1")
            .withDescription("test live output 1").withAssetName("6f3264f5-a189-48b4-a29a-a40f22575212")
            .withArchiveWindowLength(Duration.parse("PT5M")).withRewindWindowLength(Duration.parse("PT4M"))
            .withManifestName("testmanifest").withHls(new Hls().withFragmentsPerTsSegment(5)).create();
    }
}

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

Exemple de réponse

Code d’état:: 200

{
  "name": "myLiveOutput1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/liveoutputs/myLiveOutput1",
  "type": "Microsoft.Media/mediaservices/liveevents/liveoutputs",
  "properties": {
    "description": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "manifestName": "testmanifest",
    "outputSnapTime": 0,
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:09.9431835Z",
    "lastModified": "2018-03-03T02:25:09.9431835Z",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "2018-03-03T02:25:09.9431835Z",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
  }
}

Code d’état:: 201

{
  "name": "myLiveOutput1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/liveoutputs/myLiveOutput1",
  "type": "Microsoft.Media/mediaservices/liveevents/liveoutputs",
  "properties": {
    "description": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "manifestName": "testmanifest",
    "outputSnapTime": 0,
    "resourceState": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:09.9431835Z",
    "lastModified": "2018-03-03T02:25:09.9431835Z",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "2018-03-03T02:25:09.9431835Z",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
Hls	HTTP Live Streaming paramètre de compression (HLS) pour la sortie en direct.
LiveOutput	Sortie en direct.
LiveOutputResourceState	État de la ressource de la sortie en direct.
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

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

Hls

HTTP Live Streaming paramètre de compression (HLS) pour la sortie en direct.

Nom	Type	Description
fragmentsPerTsSegment	integer	Nombre de fragments dans un segment TS HTTP Live Streaming (HLS) dans la sortie de l’événement en direct. Cette valeur n’affecte pas le taux d’empaquetage de la sortie CMAF HLS.

LiveOutput

Sortie en direct.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nom de la ressource.
properties.archiveWindowLength	string	Durée ISO 8601 comprise entre 1 minute et 25 heures pour indiquer la longueur maximale du contenu pouvant être archivée dans la ressource pour cette sortie en direct. Cela définit également la longueur maximale du contenu pour la fenêtre de rembobinage. Par exemple, utilisez PT1H30M pour indiquer 1 heure et 30 minutes de fenêtre d’archivage.
properties.assetName	string	Ressource dans laquelle la sortie en direct écrit.
properties.created	string	Heure de création de la sortie en direct.
properties.description	string	Description de la sortie en direct.
properties.hls	Hls	HTTP Live Streaming paramètre de compression (HLS) pour la sortie en direct.
properties.lastModified	string	Heure de la dernière modification de la sortie en direct.
properties.manifestName	string	Nom du fichier manifeste. S’il n’est pas fourni, le service en génère un automatiquement.
properties.outputSnapTime	integer	Horodatage initial auquel la sortie en direct commence, tout contenu avant cette valeur ne sera pas archivé.
properties.provisioningState	string	État d’approvisionnement de la sortie en direct.
properties.resourceState	LiveOutputResourceState	État de la ressource de la sortie en direct.
properties.rewindWindowLength	string	Temps ISO 8601 compris entre 1 minute et la durée d’archiveWindowLength pour contrôler la longueur de la fenêtre pouvant être recherché pendant live. Le service n’utilise pas cette propriété une fois Que LiveOutput s’arrête. La VOD archivée aura un contenu complet avec ArchiveWindowLength d’origine. Par exemple, utilisez PT1H30M pour indiquer 1 heure et 30 minutes de fenêtre de rembobinage. Le service utilisera la valeur par défaut implicite 30m uniquement si Live Event active LL.
systemData	systemData	Métadonnées système relatives à cette ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

LiveOutputResourceState

État de la ressource de la sortie en direct.

Nom	Type	Description
Creating	string	La sortie en direct est en cours de création. Aucun contenu n’est archivé dans la ressource tant que la sortie dynamique n’est pas en cours d’exécution.
Deleting	string	La sortie en direct est en cours de suppression. La ressource en direct est convertie d’une ressource dynamique à une ressource à la demande. Toutes les URL de diffusion en continu créées sur la ressource de sortie en direct continuent de fonctionner.
Running	string	La sortie en direct s’exécute et archive le contenu en streaming en direct sur la ressource s’il existe une entrée valide provenant d’un encodeur de contribution.

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.

Partager via