Streaming Endpoints - Create

Servizio:

Media Services

Versione API:

2022-11-01

Creare un'entità StreamingEndpoint
Crea un endpoint di streaming.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
streamingEndpointName	path	True	string	Il nome dell'endpoint di streaming, la lunghezza massima è 24. Criterio di espressione regolare: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
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.
autoStart	query		boolean	Il flag indica se la risorsa deve essere avviata automaticamente alla creazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.scaleUnits	True	integer	Numero di unità di scala. Utilizzare l'operazione Scala per modificare questo valore.
properties.accessControl		StreamingEndpointAccessControl	Definizione del controllo di accesso dell'endpoint di streaming.
properties.availabilitySetName		string	Questa funzionalità è deprecata, non impostare un valore per questa proprietà.
properties.cdnEnabled		boolean	Flag abilitato per la rete CDN.
properties.cdnProfile		string	Nome del profilo della rete CDN.
properties.cdnProvider		string	Nome del provider della rete CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Criteri di accesso agli endpoint di streaming.
properties.customHostNames		string[]	Nomi host personalizzati dell'endpoint di streaming
properties.description		string	Descrizione dell'endpoint di streaming.
properties.maxCacheAge		integer	Validità massima cache
sku		ArmStreamingEndpointCurrentSku	SKU dell'endpoint di streaming.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	StreamingEndpoint	OK. La richiesta ha avuto esito positivo.
201 Created	StreamingEndpoint	Creazione riuscita. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Per https://go.microsoft.com/fwlink/?linkid=2087017 informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure tramite l'intestazione della risposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Create a streaming endpoint

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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"
  }
}

Codice di stato:

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"
  }
}

Definizioni

Nome	Descrizione
AkamaiAccessControl	Controllo di accesso Akamai
AkamaiSignatureHeaderAuthenticationKey	Chiave di autenticazione dell'intestazione della firma Akamai.
ArmStreamingEndpointCurrentSku	SKU corrente dell'endpoint di streaming.
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.
StreamingEndpoint	Endpoint di streaming.
StreamingEndpointAccessControl	Definizione del controllo di accesso dell'endpoint di streaming.
StreamingEndpointResourceState	Stato della risorsa dell'endpoint di streaming.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AkamaiAccessControl

Controllo di accesso Akamai

Nome	Tipo	Descrizione
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	elenco di chiavi di autenticazione

AkamaiSignatureHeaderAuthenticationKey

Chiave di autenticazione dell'intestazione della firma Akamai.

Nome	Tipo	Descrizione
base64Key	string	chiave di autenticazione
expiration	string	Ora di scadenza della chiave di autenticazione.
identifier	string	identificatore della chiave

ArmStreamingEndpointCurrentSku

SKU corrente dell'endpoint di streaming.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU dell'endpoint di streaming.
name	string	Nome sku dell'endpoint di streaming.

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

StreamingEndpoint

Endpoint di streaming.

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.accessControl	StreamingEndpointAccessControl	Definizione del controllo di accesso dell'endpoint di streaming.
properties.availabilitySetName	string	Questa funzionalità è deprecata, non impostare un valore per questa proprietà.
properties.cdnEnabled	boolean	Flag abilitato per la rete CDN.
properties.cdnProfile	string	Nome del profilo della rete CDN.
properties.cdnProvider	string	Nome del provider della rete CDN.
properties.created	string	Ora esatta in cui è stato creato l'endpoint di streaming.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Criteri di accesso agli endpoint di streaming.
properties.customHostNames	string[]	Nomi host personalizzati dell'endpoint di streaming
properties.description	string	Descrizione dell'endpoint di streaming.
properties.freeTrialEndTime	string	Ora di scadenza della versione di valutazione gratuita.
properties.hostName	string	Nome host dell'endpoint di streaming.
properties.lastModified	string	Ora esatta dell'ultima modifica dell'endpoint di streaming.
properties.maxCacheAge	integer	Validità massima cache
properties.provisioningState	string	Stato di provisioning dell'endpoint di streaming.
properties.resourceState	StreamingEndpointResourceState	Stato della risorsa dell'endpoint di streaming.
properties.scaleUnits	integer	Numero di unità di scala. Utilizzare l'operazione Scala per modificare questo valore.
sku	ArmStreamingEndpointCurrentSku	SKU dell'endpoint di streaming.
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"

StreamingEndpointAccessControl

Definizione del controllo di accesso dell'endpoint di streaming.

Nome	Tipo	Descrizione
akamai	AkamaiAccessControl	Controllo di accesso di Akamai
ip	IPAccessControl	Controllo di accesso IP dell'endpoint di streaming.

StreamingEndpointResourceState

Stato della risorsa dell'endpoint di streaming.

Nome	Tipo	Descrizione
Deleting	string	L'endpoint di streaming viene eliminato.
Running	string	L'endpoint di streaming è in esecuzione. È in grado di trasmettere contenuto ai client
Scaling	string	L'endpoint di streaming aumenta o riduce le unità di scala.
Starting	string	L'endpoint di streaming esegue la transizione allo stato di esecuzione.
Stopped	string	Lo stato iniziale di un endpoint di streaming dopo la creazione. Il contenuto non è pronto per essere trasmesso da questo endpoint.
Stopping	string	L'endpoint di streaming esegue la transizione allo stato di arresto.

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.