Streaming Endpoints - Create

Dienst:

Media Services

API-Version:

2022-11-01

Create StreamingEndpoint
Erstellt einen Streamingendpunkt.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Media Services-Kontos.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
streamingEndpointName	path	True	string	Der Name des Streamingendpunkts, die maximale Länge beträgt 24. RegEx-Muster: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId	path	True	string	Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.
autoStart	query		boolean	Das Flag gibt an, ob die Ressource bei der Erstellung automatisch gestartet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
properties.scaleUnits	True	integer	Die Anzahl der Skalierungseinheiten. Verwenden Sie den Skalierungsvorgang, um diesen Wert anzupassen.
properties.accessControl		StreamingEndpointAccessControl	Die Zugriffssteuerungsdefinition des Streamingendpunkts.
properties.availabilitySetName		string	Dieses Feature ist veraltet. Legen Sie keinen Wert für diese Eigenschaft fest.
properties.cdnEnabled		boolean	Das CDN-aktivierte Flag.
properties.cdnProfile		string	Der NAME des CDN-Profils.
properties.cdnProvider		string	Der Name des CDN-Anbieters.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Die Zugriffsrichtlinien für Streamingendpunkte.
properties.customHostNames		string[]	Die benutzerdefinierten Hostnamen des Streamingendpunkts
properties.description		string	Die Beschreibung des Streamingendpunkts.
properties.maxCacheAge		integer	Maximales Cachealter
sku		ArmStreamingEndpointCurrentSku	Die SKU des Streamingendpunkts.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	StreamingEndpoint	OK. Die Anforderung war erfolgreich.
201 Created	StreamingEndpoint	Erstellt. Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Ausführliche Informationen zum Überwachen asynchroner Azure-Vorgänge mithilfe des Azure-AsyncOperation-Antwortheaders finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter .
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

Create a streaming endpoint

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

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

Definitionen

Name	Beschreibung
AkamaiAccessControl	Akamai-Zugriffssteuerung
AkamaiSignatureHeaderAuthenticationKey	Authentifizierungsschlüssel des Akamai-Signaturheaders.
ArmStreamingEndpointCurrentSku	Die aktuelle SKU des Streamingendpunkts.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CrossSiteAccessPolicies	Die Clientzugriffsrichtlinie.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
IPAccessControl	Die IP-Zugriffssteuerung.
IPRange	Der IP-Adressbereich im CIDR-Schema.
StreamingEndpoint	Der Streamingendpunkt.
StreamingEndpointAccessControl	Zugriffssteuerungsdefinition für Streamingendpunkte.
StreamingEndpointResourceState	Der Ressourcenstatus des Streamingendpunkts.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

AkamaiAccessControl

Akamai-Zugriffssteuerung

Name	Typ	Beschreibung
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	Authentifizierungsschlüsselliste

AkamaiSignatureHeaderAuthenticationKey

Authentifizierungsschlüssel des Akamai-Signaturheaders.

Name	Typ	Beschreibung
base64Key	string	Authentifizierungsschlüssel
expiration	string	Die Ablaufzeit des Authentifizierungsschlüssels.
identifier	string	Bezeichner des Schlüssels

ArmStreamingEndpointCurrentSku

Die aktuelle SKU des Streamingendpunkts.

Name	Typ	Beschreibung
capacity	integer	Die SKU-Kapazität des Streamingendpunkts.
name	string	Der SKU-Name des Streamingendpunkts.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Die Clientzugriffsrichtlinie.

Name	Typ	Beschreibung
clientAccessPolicy	string	Der Inhalt der von Silverlight verwendeten clientaccesspolicy.xml.
crossDomainPolicy	string	Der Inhalt der von Silverlight verwendeten crossdomain.xml.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IPAccessControl

Die IP-Zugriffssteuerung.

Name	Typ	Beschreibung
allow	IPRange[]	Die Ip-Zulassungsliste.

IPRange

Der IP-Adressbereich im CIDR-Schema.

Name	Typ	Beschreibung
address	string	Die IP-Adresse.
name	string	Der Anzeigename für den IP-Adressbereich.
subnetPrefixLength	integer	Die Präfixlänge der Subnetzmaske (siehe CIDR-Notation).

StreamingEndpoint

Der Streamingendpunkt.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.accessControl	StreamingEndpointAccessControl	Die Zugriffssteuerungsdefinition des Streamingendpunkts.
properties.availabilitySetName	string	Dieses Feature ist veraltet. Legen Sie keinen Wert für diese Eigenschaft fest.
properties.cdnEnabled	boolean	Das CDN-aktivierte Flag.
properties.cdnProfile	string	Der NAME des CDN-Profils.
properties.cdnProvider	string	Der Name des CDN-Anbieters.
properties.created	string	Die genaue Erstellungszeit des Streamingendpunkts.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Die Zugriffsrichtlinien für Streamingendpunkte.
properties.customHostNames	string[]	Die benutzerdefinierten Hostnamen des Streamingendpunkts
properties.description	string	Die Beschreibung des Streamingendpunkts.
properties.freeTrialEndTime	string	Die Ablaufzeit der kostenlosen Testversion.
properties.hostName	string	Der Hostname des Streamingendpunkts.
properties.lastModified	string	Der genaue Zeitpunkt der letzten Änderung des Streamingendpunkts.
properties.maxCacheAge	integer	Maximales Cachealter
properties.provisioningState	string	Der Bereitstellungsstatus des Streamingendpunkts.
properties.resourceState	StreamingEndpointResourceState	Der Ressourcenstatus des Streamingendpunkts.
properties.scaleUnits	integer	Die Anzahl der Skalierungseinheiten. Verwenden Sie den Skalierungsvorgang, um diesen Wert anzupassen.
sku	ArmStreamingEndpointCurrentSku	Die SKU des Streamingendpunkts.
systemData	systemData	Die Systemmetadaten, die sich auf diese Ressource beziehen.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Zugriffssteuerungsdefinition für Streamingendpunkte.

Name	Typ	Beschreibung
akamai	AkamaiAccessControl	Die Zugriffssteuerung von Akamai
ip	IPAccessControl	Die IP-Zugriffssteuerung des Streamingendpunkts.

StreamingEndpointResourceState

Der Ressourcenstatus des Streamingendpunkts.

Name	Typ	Beschreibung
Deleting	string	Der Streamingendpunkt wird gelöscht.
Running	string	Der Streamingendpunkt wird ausgeführt. Es ist in der Lage, Inhalte an Clients zu streamen.
Scaling	string	Der Streamingendpunkt erhöht oder verringert Skalierungseinheiten.
Starting	string	Der Streamingendpunkt geht über in den Status „Running“.
Stopped	string	Der ursprüngliche Status eines Streamingendpunkts nach der Erstellung. Der Inhalt kann nicht von diesem Endpunkt gestreamt werden.
Stopping	string	Der Streamingendpunkt geht über in den Status „Stopped“.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.