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 |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Media Services-Kontos. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe innerhalb des Azure-Abonnements. |
streaming
|
path | True |
string |
Der Name des Streamingendpunkts, die maximale Länge beträgt 24. RegEx-Muster: |
subscription
|
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. |
auto
|
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 |
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 |
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 |
Die SKU des Streamingendpunkts. |
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK. Die Anforderung war erfolgreich. |
|
201 Created |
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 |
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 |
---|---|
Akamai |
Akamai-Zugriffssteuerung |
Akamai |
Authentifizierungsschlüssel des Akamai-Signaturheaders. |
Arm |
Die aktuelle SKU des Streamingendpunkts. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Cross |
Die Clientzugriffsrichtlinie. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
IPAccess |
Die IP-Zugriffssteuerung. |
IPRange |
Der IP-Adressbereich im CIDR-Schema. |
Streaming |
Der Streamingendpunkt. |
Streaming |
Zugriffssteuerungsdefinition für Streamingendpunkte. |
Streaming |
Der Ressourcenstatus des Streamingendpunkts. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
AkamaiAccessControl
Akamai-Zugriffssteuerung
Name | Typ | Beschreibung |
---|---|---|
akamaiSignatureHeaderAuthenticationKeyList |
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 |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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 |
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 |
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 |
Der Ressourcenstatus des Streamingendpunkts. |
|
properties.scaleUnits |
integer |
Die Anzahl der Skalierungseinheiten. Verwenden Sie den Skalierungsvorgang, um diesen Wert anzupassen. |
sku |
Die SKU des Streamingendpunkts. |
|
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 |
Die Zugriffssteuerung von Akamai |
|
ip |
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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |