Streaming Endpoints - Create

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

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

Beispiel für eine Antwort

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