Streaming Endpoints - Create

Odwołanie

Usługa:: Media Services

Wersja interfejsu API:: 2022-11-01

Tworzenie punktu końcowego przesyłania strumieniowego
Tworzy punkt końcowy przesyłania strumieniowego.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
streamingEndpointName	path	True	string	Nazwa punktu końcowego przesyłania strumieniowego, maksymalna długość to 24. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta.
autoStart	query		boolean	Flaga wskazuje, czy zasób powinien zostać automatycznie uruchomiony podczas tworzenia.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.scaleUnits	True	integer	Liczba jednostek skalowania. Użyj operacji skalowania, aby dostosować tę wartość.
properties.accessControl		StreamingEndpointAccessControl	Definicja kontroli dostępu punktu końcowego przesyłania strumieniowego.
properties.availabilitySetName		string	Ta funkcja jest przestarzała, nie ustawiaj wartości dla tej właściwości.
properties.cdnEnabled		boolean	Flaga włączona usługi CDN.
properties.cdnProfile		string	Nazwa profilu usługi CDN.
properties.cdnProvider		string	Nazwa dostawcy usługi CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Zasady dostępu do punktu końcowego przesyłania strumieniowego.
properties.customHostNames		string[]	Niestandardowe nazwy hostów punktu końcowego przesyłania strumieniowego
properties.description		string	Opis punktu końcowego przesyłania strumieniowego.
properties.maxCacheAge		integer	Maksymalny wiek pamięci podręcznej
sku		ArmStreamingEndpointCurrentSku	Jednostka SKU punktu końcowego przesyłania strumieniowego.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StreamingEndpoint	OK. Żądanie zakończyło się pomyślnie.
201 Created	StreamingEndpoint	Utworzone. Żądanie zostało zaakceptowane na potrzeby przetwarzania, a operacja zostanie ukończona asynchronicznie. Aby https://go.microsoft.com/fwlink/?linkid=2087017 uzyskać szczegółowe informacje na temat monitorowania asynchronicznych operacji platformy Azure przy użyciu nagłówka odpowiedzi Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Odpowiedź z błędem przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

Create a streaming endpoint

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

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
AkamaiAccessControl	Kontrola dostępu Akamai
AkamaiSignatureHeaderAuthenticationKey	Klucz uwierzytelniania nagłówka podpisu Akamai.
ArmStreamingEndpointCurrentSku	Bieżąca jednostka SKU punktu końcowego przesyłania strumieniowego.
createdByType	Typ tożsamości, która utworzyła zasób.
CrossSiteAccessPolicies	Zasady dostępu klienta.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IPAccessControl	Kontrola dostępu do adresu IP.
IPRange	Zakres adresów IP w schemacie CIDR.
StreamingEndpoint	Punkt końcowy przesyłania strumieniowego.
StreamingEndpointAccessControl	Definicja kontroli dostępu punktu końcowego przesyłania strumieniowego.
StreamingEndpointResourceState	Stan zasobu punktu końcowego przesyłania strumieniowego.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AkamaiAccessControl

Kontrola dostępu Akamai

Nazwa	Typ	Opis
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	lista kluczy uwierzytelniania

AkamaiSignatureHeaderAuthenticationKey

Klucz uwierzytelniania nagłówka podpisu Akamai.

Nazwa	Typ	Opis
base64Key	string	klucz uwierzytelniania
expiration	string	Czas wygaśnięcia klucza uwierzytelniania.
identifier	string	identyfikator klucza

ArmStreamingEndpointCurrentSku

Bieżąca jednostka SKU punktu końcowego przesyłania strumieniowego.

Nazwa	Typ	Opis
capacity	integer	Pojemność jednostki SKU punktu końcowego przesyłania strumieniowego.
name	string	Nazwa jednostki SKU punktu końcowego przesyłania strumieniowego.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Zasady dostępu klienta.

Nazwa	Typ	Opis
clientAccessPolicy	string	Zawartość clientaccesspolicy.xml używana przez program Silverlight.
crossDomainPolicy	string	Zawartość crossdomain.xml używana przez program Silverlight.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

IPAccessControl

Kontrola dostępu do adresu IP.

Nazwa	Typ	Opis
allow	IPRange[]	Lista dozwolonych adresów IP.

IPRange

Zakres adresów IP w schemacie CIDR.

Nazwa	Typ	Opis
address	string	Adres IP.
name	string	Przyjazna nazwa zakresu adresów IP.
subnetPrefixLength	integer	Długość prefiksu maski podsieci (zobacz notacja CIDR).