Streaming Endpoints - Create

Service:

Media Services

API Version:

2022-11-01

StreamingEndpoint maken
Hiermee maakt u een streaming-eindpunt.

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

With optional parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
accountName	path	True	string	De naam van het Media Services-account.
resourceGroupName	path	True	string	De naam van de resourcegroep binnen het Azure-abonnement.
streamingEndpointName	path	True	string	De naam van het streaming-eindpunt, de maximale lengte is 24. Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId	path	True	string	De unieke id voor een Microsoft Azure-abonnement.
api-version	query	True	string	De versie van de API die moet worden gebruikt met de clientaanvraag.
autoStart	query		boolean	De vlag geeft aan of de resource automatisch moet worden gestart bij het maken.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
properties.scaleUnits	True	integer	Het aantal schaaleenheden. Gebruik de schaalbewerking om deze waarde aan te passen.
properties.accessControl		StreamingEndpointAccessControl	De definitie van toegangsbeheer van het streaming-eindpunt.
properties.availabilitySetName		string	Deze functie is afgeschaft. Stel geen waarde in voor deze eigenschap.
properties.cdnEnabled		boolean	De vlag CDN ingeschakeld.
properties.cdnProfile		string	De naam van het CDN-profiel.
properties.cdnProvider		string	De naam van de CDN-provider.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Het toegangsbeleid voor streaming-eindpunten.
properties.customHostNames		string[]	De aangepaste hostnamen van het streaming-eindpunt
properties.description		string	De beschrijving van het streaming-eindpunt.
properties.maxCacheAge		integer	Maximale cacheleeftijd
sku		ArmStreamingEndpointCurrentSku	De streaming-eindpunt-SKU.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	StreamingEndpoint	OK. De aanvraag is geslaagd.
201 Created	StreamingEndpoint	Gemaakt. De aanvraag is geaccepteerd voor verwerking en de bewerking wordt asynchroon voltooid. Zie https://go.microsoft.com/fwlink/?linkid=2087017 voor meer informatie over het bewaken van asynchrone Azure-bewerkingen met behulp van de Azure-AsyncOperation antwoordheader.
Other Status Codes	ErrorResponse	Het streamingfoutantwoord waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

Create a streaming endpoint

Sample Request

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();
    }

    @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

Sample Response

Status code:

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

Response Body

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

Status code:

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

Definities

Name	Description
AkamaiAccessControl	Akamai-toegangsbeheer
AkamaiSignatureHeaderAuthenticationKey	Verificatiesleutel akamai Signature Header.
ArmStreamingEndpointCurrentSku	De huidige SKU van het streaming-eindpunt.
createdByType	Het type identiteit waarmee de resource is gemaakt.
CrossSiteAccessPolicies	Het clienttoegangsbeleid.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IPAccessControl	Het IP-toegangsbeheer.
IPRange	Het IP-adresbereik in het CIDR-schema.
StreamingEndpoint	Het streaming-eindpunt.
StreamingEndpointAccessControl	Definitie van toegangsbeheer voor streaming-eindpunten.
StreamingEndpointResourceState	De resourcestatus van het streaming-eindpunt.
systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

AkamaiAccessControl

Akamai-toegangsbeheer

Name	Type	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	lijst met verificatiesleutels

AkamaiSignatureHeaderAuthenticationKey

Verificatiesleutel akamai Signature Header.

Name	Type	Description
base64Key	string	verificatiesleutel
expiration	string	De verlooptijd van de verificatiesleutel.
identifier	string	id van de sleutel

ArmStreamingEndpointCurrentSku

De huidige SKU van het streaming-eindpunt.

Name	Type	Description
capacity	integer	De SKU-capaciteit van het streaming-eindpunt.
name	string	De SKU-naam van het streaming-eindpunt.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Het clienttoegangsbeleid.

Name	Type	Description
clientAccessPolicy	string	De inhoud van clientaccesspolicy.xml gebruikt door Silverlight.
crossDomainPolicy	string	De inhoud van crossdomain.xml gebruikt door Silverlight.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IPAccessControl

Het IP-toegangsbeheer.

Name	Type	Description
allow	IPRange[]	De lijst met toegestane IP-adressen.

IPRange

Het IP-adresbereik in het CIDR-schema.

Name	Type	Description
address	string	Het IP-adres.
name	string	De beschrijvende naam voor het IP-adresbereik.
subnetPrefixLength	integer	De lengte van het subnetmaskervoorvoegsel (zie CIDR-notatie).

StreamingEndpoint

Het streaming-eindpunt.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.accessControl	StreamingEndpointAccessControl	De definitie van toegangsbeheer van het streaming-eindpunt.
properties.availabilitySetName	string	Deze functie is afgeschaft. Stel geen waarde in voor deze eigenschap.
properties.cdnEnabled	boolean	De vlag CDN ingeschakeld.
properties.cdnProfile	string	De naam van het CDN-profiel.
properties.cdnProvider	string	De naam van de CDN-provider.
properties.created	string	De exacte tijd waarop het streaming-eindpunt is gemaakt.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Het toegangsbeleid voor streaming-eindpunten.
properties.customHostNames	string[]	De aangepaste hostnamen van het streaming-eindpunt
properties.description	string	De beschrijving van het streaming-eindpunt.
properties.freeTrialEndTime	string	De verlooptijd van de gratis proefversie.
properties.hostName	string	De hostnaam van het streaming-eindpunt.
properties.lastModified	string	De exacte tijd waarop het streaming-eindpunt voor het laatst is gewijzigd.
properties.maxCacheAge	integer	Maximale cacheleeftijd
properties.provisioningState	string	De inrichtingsstatus van het streaming-eindpunt.
properties.resourceState	StreamingEndpointResourceState	De resourcestatus van het streaming-eindpunt.
properties.scaleUnits	integer	Het aantal schaaleenheden. Gebruik de schaalbewerking om deze waarde aan te passen.
sku	ArmStreamingEndpointCurrentSku	De streaming-eindpunt-SKU.
systemData	systemData	De systeemmetagegevens met betrekking tot deze resource.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

StreamingEndpointAccessControl

Definitie van toegangsbeheer voor streaming-eindpunten.

Name	Type	Description
akamai	AkamaiAccessControl	Het toegangsbeheer van Akamai
ip	IPAccessControl	Het IP-toegangsbeheer van het streaming-eindpunt.

StreamingEndpointResourceState

De resourcestatus van het streaming-eindpunt.

Name	Type	Description
Deleting	string	Het streaming-eindpunt wordt verwijderd.
Running	string	Het streaming-eindpunt wordt uitgevoerd. Het kan inhoud naar clients streamen
Scaling	string	Het streaming-eindpunt verhoogt of verlaagt de schaaleenheden.
Starting	string	Het streaming-eindpunt gaat over naar de actieve status.
Stopped	string	De initiële status van een streaming-eindpunt na het maken. Inhoud is niet gereed om te worden gestreamd vanaf dit eindpunt.
Stopping	string	Het streaming-eindpunt gaat over naar de status Gestopt.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name	Type	Description
createdAt	string	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit die de resource heeft gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource het laatst heeft gewijzigd.