Streaming Endpoints - Create

Service:

Media Services

Version d'API:

2022-11-01

Create StreamingEndpoint
Crée un point de terminaison de streaming.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
resourceGroupName	path	True	string	Nom du groupe de ressources au sein de l’abonnement Azure.
streamingEndpointName	path	True	string	Le nom du point de terminaison de streaming, dont la longueur maximale est 24. Modèle d’expression régulière: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
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.scaleUnits	True	integer	Nombre d’unités d’échelle. Utilisez l’opération de mise à l’échelle pour ajuster cette valeur.
properties.accessControl		StreamingEndpointAccessControl	Définition du contrôle d’accès du point de terminaison de streaming.
properties.availabilitySetName		string	Cette fonctionnalité est déconseillée, ne définissez pas de valeur pour cette propriété.
properties.cdnEnabled		boolean	Indicateur cdn activé.
properties.cdnProfile		string	Nom du profil CDN.
properties.cdnProvider		string	Nom du fournisseur CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Stratégies d’accès au point de terminaison de streaming.
properties.customHostNames		string[]	Noms d’hôte personnalisés du point de terminaison de streaming
properties.description		string	Description du point de terminaison de streaming.
properties.maxCacheAge		integer	Âge maximal du cache
sku		ArmStreamingEndpointCurrentSku	Référence SKU du point de terminaison de streaming.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	StreamingEndpoint	OK. La demande a réussi.
201 Created	StreamingEndpoint	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 streaming endpoint

Exemple de requête

HTTP

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

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2029-12-31T16:00:00-08:00",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2030-12-31T16:00:00-08:00",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1"
          }
        ]
      }
    },
    "cdnEnabled": false
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.AkamaiAccessControl;
import com.azure.resourcemanager.mediaservices.models.AkamaiSignatureHeaderAuthenticationKey;
import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.StreamingEndpointAccessControl;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for StreamingEndpoints Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/
     * streamingendpoint-create.json
     */
    /**
     * Sample code: Create a streaming endpoint.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createAStreamingEndpoint(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.streamingEndpoints().define("myStreamingEndpoint1").withRegion("West US")
            .withExistingMediaservice("mediaresources", "slitestmedia10")
            .withTags(mapOf("tag1", "value1", "tag2", "value2")).withDescription("test event 1").withScaleUnits(1)
            .withAvailabilitySetName("availableset")
            .withAccessControl(new StreamingEndpointAccessControl()
                .withAkamai(new AkamaiAccessControl().withAkamaiSignatureHeaderAuthenticationKeyList(Arrays.asList(
                    new AkamaiSignatureHeaderAuthenticationKey().withIdentifier("id1")
                        .withBase64Key("fakeTokenPlaceholder")
                        .withExpiration(OffsetDateTime.parse("2029-12-31T16:00:00-08:00")),
                    new AkamaiSignatureHeaderAuthenticationKey().withIdentifier("id2")
                        .withBase64Key("fakeTokenPlaceholder")
                        .withExpiration(OffsetDateTime.parse("2030-12-31T16:00:00-08:00")))))
                .withIp(new IpAccessControl()
                    .withAllow(Arrays.asList(new IpRange().withName("AllowedIp").withAddress("192.168.1.1")))))
            .withCdnEnabled(false).create();
    }

    // Use "Map.of" if available
    @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

Exemple de réponse

Code d’état:

201

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpointoperations/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/streamingendpoints/myStreamingEndpoint1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": "",
    "customHostNames": [],
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2030-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2031-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1",
            "subnetPrefixLength": null
          }
        ]
      }
    },
    "maxCacheAge": null,
    "hostName": "mystreamingendpoint1-slitestmedia10.streaming.mediaservices.windows.net",
    "freeTrialEndTime": "0001-01-01T00:00:00-08:00",
    "provisioningState": "InProgress",
    "resourceState": "Creating",
    "created": "2018-03-03T02:25:09.7561389Z",
    "lastModified": "2018-03-03T02:25:09.7561389Z"
  }
}

Code d’état:

200

{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": "",
    "customHostNames": [],
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2030-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2031-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1",
            "subnetPrefixLength": null
          }
        ]
      }
    },
    "maxCacheAge": null,
    "hostName": "mystreamingendpoint1-slitestmedia10.streaming.mediaservices.windows.net",
    "freeTrialEndTime": "0001-01-01T00:00:00-08:00",
    "provisioningState": "Succeeded",
    "resourceState": "Stopped",
    "created": "2018-03-03T02:25:09.7561389Z",
    "lastModified": "2018-03-03T02:25:09.7561389Z"
  }
}

Définitions

Nom	Description
AkamaiAccessControl	Contrôle d’accès Akamai
AkamaiSignatureHeaderAuthenticationKey	Clé d’authentification de l’en-tête de signature Akamai.
ArmStreamingEndpointCurrentSku	Référence SKU actuelle du point de terminaison de streaming.
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.
StreamingEndpoint	Point de terminaison de streaming.
StreamingEndpointAccessControl	Définition du contrôle d’accès au point de terminaison de streaming.
StreamingEndpointResourceState	État de la ressource du point de terminaison de streaming.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AkamaiAccessControl

Contrôle d’accès Akamai

Nom	Type	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	liste de clés d’authentification

AkamaiSignatureHeaderAuthenticationKey

Clé d’authentification de l’en-tête de signature Akamai.

Nom	Type	Description
base64Key	string	clé d’authentification
expiration	string	Heure d’expiration de la clé d’authentification.
identifier	string	identificateur de la clé

ArmStreamingEndpointCurrentSku

Référence SKU actuelle du point de terminaison de streaming.

Nom	Type	Description
capacity	integer	Capacité de référence SKU du point de terminaison de streaming.
name	string	Nom de la référence SKU du point de terminaison de streaming.

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

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

StreamingEndpoint

Point de terminaison de streaming.

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.accessControl	StreamingEndpointAccessControl	Définition du contrôle d’accès du point de terminaison de streaming.
properties.availabilitySetName	string	Cette fonctionnalité est déconseillée, ne définissez pas de valeur pour cette propriété.
properties.cdnEnabled	boolean	Indicateur cdn activé.
properties.cdnProfile	string	Nom du profil CDN.
properties.cdnProvider	string	Nom du fournisseur CDN.
properties.created	string	Heure exacte à laquelle le point de terminaison de streaming a été créé.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Stratégies d’accès au point de terminaison de streaming.
properties.customHostNames	string[]	Noms d’hôte personnalisés du point de terminaison de streaming
properties.description	string	Description du point de terminaison de streaming.
properties.freeTrialEndTime	string	Délai d’expiration de l’essai gratuit.
properties.hostName	string	Nom d’hôte du point de terminaison de streaming.
properties.lastModified	string	Heure exacte à laquelle le point de terminaison de streaming a été modifié pour la dernière fois.
properties.maxCacheAge	integer	Âge maximal du cache
properties.provisioningState	string	État d’approvisionnement du point de terminaison de streaming.
properties.resourceState	StreamingEndpointResourceState	État de la ressource du point de terminaison de streaming.
properties.scaleUnits	integer	Nombre d’unités d’échelle. Utilisez l’opération de mise à l’échelle pour ajuster cette valeur.
sku	ArmStreamingEndpointCurrentSku	Référence SKU du point de terminaison de streaming.
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 »

StreamingEndpointAccessControl

Définition du contrôle d’accès au point de terminaison de streaming.

Nom	Type	Description
akamai	AkamaiAccessControl	Contrôle d’accès d’Akamai
ip	IPAccessControl	Contrôle d’accès IP du point de terminaison de streaming.

StreamingEndpointResourceState

État de la ressource du point de terminaison de streaming.

Nom	Type	Description
Deleting	string	Le point de terminaison de streaming est en cours de suppression.
Running	string	Le point de terminaison de streaming est en cours d’exécution. Il est en mesure de diffuser du contenu vers les clients
Scaling	string	Le point de terminaison de streaming augmente ou diminue les unités d’échelle.
Starting	string	Le point de terminaison de streaming est en transition vers l’état « Exécution en cours ».
Stopped	string	État initial d’un point de terminaison de streaming après sa création. Le contenu n’est pas prêt à être diffusé à partir de ce point de terminaison.
Stopping	string	Le point de terminaison de streaming est en transition vers l’état « Arrêté ».

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.