Live Outputs - Get

Référence

Service:: Media Services

Version d'API:: 2022-11-01

Obtenir une sortie en direct
Obtient une sortie en direct.

GET 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	Le nom de l’événement en direct, dont 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 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.

Réponses

Nom	Type	Description
200 OK	LiveOutput	OK. La demande a réussi.
Other Status Codes	ErrorResponse	Réponse d’erreur de streaming décrivant la raison de l’échec de l’opération.

Exemples

Get a LiveOutput by name

GET 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


/**
 * Samples for LiveOutputs Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-list
     * -by-name.json
     */
    /**
     * Sample code: Get a LiveOutput by name.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getALiveOutputByName(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveOutputs().getWithResponse("mediaresources", "slitestmedia10", "myLiveEvent1", "myLiveOutput1",
            com.azure.core.util.Context.NONE);
    }
}

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": null,
    "assetName": "cb2ae0bc-677a-4830-9c8e-06ce4c4cb607",
    "archiveWindowLength": "PT5M",
    "manifestName": "fc7096f5-c488-4b86-8302-f3bfde53fc27",
    "outputSnapTime": 0,
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00-08:00",
    "lastModified": "0001-01-01T00:00:00-08:00",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00-08:00",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00-08:00"
  }
}

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	paramètre d’empaquetage HTTP Live Streaming (HLS) pour la sortie en direct.
LiveOutput	Sortie en direct.
LiveOutputResourceState	État de la ressource de la sortie dynamique.
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 d’erreur.

Hls

paramètre d’empaquetage HTTP Live Streaming (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 ratio d’empaquetage pour 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 qui peut être archivée dans la ressource pour cette sortie en direct. Cela définit également la longueur maximale du contenu de 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 doit écrire.
properties.created	string	Heure de création de la sortie en direct.
properties.description	string	Description de la sortie en direct.
properties.hls	Hls	paramètre d’empaquetage HTTP Live Streaming (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 automatiquement un.
properties.outputSnapTime	integer	Horodatage initial à partir de lequel la sortie en direct démarrera, tout contenu avant cette valeur ne sera pas archivé.
properties.provisioningState	string	État d’approvisionnement de la sortie dynamique.
properties.resourceState	LiveOutputResourceState	État de la ressource de la sortie dynamique.
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ée pendant live. Le service n’utilisera pas cette propriété une fois LiveOutput arrêté. 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 dynamique.

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 dynamique est en cours de conversion de la ressource dynamique en ressource à la demande. Toutes les URL de streaming 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 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 dernière ressource.
lastModifiedByType	createdByType	Type d’identité qui a modifié la dernière ressource.

Partager via