Streaming Locators - Create

Odwołanie

Service:: Media Services

API Version:: 2021-11-01

Tworzenie lokalizatora przesyłania strumieniowego na koncie Media Services

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}?api-version=2021-11-01

Parametry identyfikatora URI

Name	In	Required	Type	Description
accountName	path	True	string	Nazwa konta Media Services.
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
streamingLocatorName	path	True	string	Nazwa lokalizatora przesyłania strumieniowego.
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API, która ma być używana z żądaniem klienta.

Treść żądania

Name	Required	Type	Description
properties.assetName	True	string	Nazwa zasobu
properties.streamingPolicyName	True	string	Nazwa zasad przesyłania strumieniowego używanych przez ten lokalizator przesyłania strumieniowego. Określ nazwę utworzonych zasad przesyłania strumieniowego lub użyj jednej ze wstępnie zdefiniowanych zasad przesyłania strumieniowego. Dostępne są wstępnie zdefiniowane zasady przesyłania strumieniowego: "Predefined_DownloadOnly", "Predefined_ClearStreamingOnly", "Predefined_DownloadAndClearStreaming", "Predefined_ClearKey", "Predefined_MultiDrmCencStreaming" i "Predefined_MultiDrmStreaming"
properties.alternativeMediaId		string	Alternatywny identyfikator nośnika tego lokalizatora przesyłania strumieniowego
properties.contentKeys		StreamingLocatorContentKey[]	Keys używane przez ten lokalizator przesyłania strumieniowego.
properties.defaultContentKeyPolicyName		string	Nazwa domyślnego obiektu ContentKeyPolicy używanego przez ten lokalizator przesyłania strumieniowego.
properties.endTime		string	Godzina zakończenia lokalizatora przesyłania strumieniowego.
properties.filters		string[]	Lista filtrów zasobów lub kont, które mają zastosowanie do tego lokalizatora przesyłania strumieniowego
properties.startTime		string	Godzina rozpoczęcia lokalizatora przesyłania strumieniowego.
properties.streamingLocatorId		string	Element StreamingLocatorId lokalizatora przesyłania strumieniowego.

Odpowiedzi

Name	Type	Description
201 Created	StreamingLocator	Utworzone
Other Status Codes	ErrorResponse	Szczegółowe informacje o błędzie.

Przykłady

Creates a Streaming Locator with clear streaming

Creates a Streaming Locator with secure streaming

Creates a Streaming Locator with user defined content keys

Creates a Streaming Locator with clear streaming

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedClearStreamingLocator?api-version=2021-11-01

{
  "properties": {
    "streamingPolicyName": "clearStreamingPolicy",
    "assetName": "ClimbingMountRainier"
  }
}

/** Samples for StreamingLocators Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/stable/2021-11-01/examples/streaming-locators-create-clear.json
     */
    /**
     * Sample code: Creates a Streaming Locator with clear streaming.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createsAStreamingLocatorWithClearStreaming(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingLocators()
            .define("UserCreatedClearStreamingLocator")
            .withExistingMediaService("contoso", "contosomedia")
            .withAssetName("ClimbingMountRainier")
            .withStreamingPolicyName("clearStreamingPolicy")
            .create();
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/mediaservices/resource-manager/Microsoft.Media/stable/2021-11-01/examples/streaming-locators-create-clear.json
func ExampleStreamingLocatorsClient_Create() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armmediaservices.NewStreamingLocatorsClient("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	_, err = client.Create(ctx,
		"contoso",
		"contosomedia",
		"UserCreatedClearStreamingLocator",
		armmediaservices.StreamingLocator{
			Properties: &armmediaservices.StreamingLocatorProperties{
				AssetName:           to.Ptr("ClimbingMountRainier"),
				StreamingPolicyName: to.Ptr("clearStreamingPolicy"),
			},
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 201

{
  "name": "UserCreatedClearStreamingLocator",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedClearStreamingLocator",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.4323237Z",
    "endTime": "9999-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "e34b0fc4-3be0-4a3c-9793-1f6b7be5b013",
    "streamingPolicyName": "clearStreamingPolicy",
    "contentKeys": []
  }
}

Creates a Streaming Locator with secure streaming

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocator?api-version=2021-11-01

{
  "properties": {
    "streamingPolicyName": "secureStreamingPolicy",
    "assetName": "ClimbingMountRainier",
    "startTime": "2018-03-01T00:00:00Z",
    "endTime": "2028-12-31T23:59:59.9999999Z"
  }
}

import java.time.OffsetDateTime;

/** Samples for StreamingLocators Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/stable/2021-11-01/examples/streaming-locators-create-secure.json
     */
    /**
     * Sample code: Creates a Streaming Locator with secure streaming.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createsAStreamingLocatorWithSecureStreaming(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingLocators()
            .define("UserCreatedSecureStreamingLocator")
            .withExistingMediaService("contoso", "contosomedia")
            .withAssetName("ClimbingMountRainier")
            .withStartTime(OffsetDateTime.parse("2018-03-01T00:00:00Z"))
            .withEndTime(OffsetDateTime.parse("2028-12-31T23:59:59.9999999Z"))
            .withStreamingPolicyName("secureStreamingPolicy")
            .create();
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 201

{
  "name": "UserCreatedSecureStreamingLocator",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocator",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.6243295Z",
    "startTime": "2018-03-01T00:00:00Z",
    "endTime": "2028-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "962775be-41fb-452a-b0dc-72ca2543a945",
    "streamingPolicyName": "secureStreamingPolicy",
    "contentKeys": [
      {
        "id": "1b2d5581-4518-4a51-ad8a-f55d3bf993d4",
        "type": "CommonEncryptionCbcs",
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "tracks": []
      },
      {
        "id": "1a9858b1-3566-4bf1-9fee-60f2fb98e7e4",
        "type": "CommonEncryptionCenc",
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "tracks": []
      },
      {
        "id": "5faac86a-3aca-4d6b-99c0-6bb8cc3497a1",
        "type": "EnvelopeEncryption",
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "tracks": []
      }
    ]
  }
}

Creates a Streaming Locator with user defined content keys

Sample Request

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys?api-version=2021-11-01

{
  "properties": {
    "assetName": "ClimbingMountRainier",
    "streamingPolicyName": "secureStreamingPolicy",
    "streamingLocatorId": "90000000-0000-0000-0000-00000000000A",
    "contentKeys": [
      {
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "id": "60000000-0000-0000-0000-000000000001",
        "value": "1UqLohAfWsEGkULYxHjYZg=="
      },
      {
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "id": "60000000-0000-0000-0000-000000000004",
        "value": "4UqLohAfWsEGkULYxHjYZg=="
      },
      {
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "id": "60000000-0000-0000-0000-000000000007",
        "value": "7UqLohAfWsEGkULYxHjYZg=="
      }
    ]
  }
}

import com.azure.resourcemanager.mediaservices.models.StreamingLocatorContentKey;
import java.util.Arrays;
import java.util.UUID;

/** Samples for StreamingLocators Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/stable/2021-11-01/examples/streaming-locators-create-secure-userDefinedContentKeys.json
     */
    /**
     * Sample code: Creates a Streaming Locator with user defined content keys.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createsAStreamingLocatorWithUserDefinedContentKeys(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingLocators()
            .define("UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys")
            .withExistingMediaService("contoso", "contosomedia")
            .withAssetName("ClimbingMountRainier")
            .withStreamingLocatorId(UUID.fromString("90000000-0000-0000-0000-00000000000A"))
            .withStreamingPolicyName("secureStreamingPolicy")
            .withContentKeys(
                Arrays
                    .asList(
                        new StreamingLocatorContentKey()
                            .withId(UUID.fromString("60000000-0000-0000-0000-000000000001"))
                            .withLabelReferenceInStreamingPolicy("aesDefaultKey")
                            .withValue("1UqLohAfWsEGkULYxHjYZg=="),
                        new StreamingLocatorContentKey()
                            .withId(UUID.fromString("60000000-0000-0000-0000-000000000004"))
                            .withLabelReferenceInStreamingPolicy("cencDefaultKey")
                            .withValue("4UqLohAfWsEGkULYxHjYZg=="),
                        new StreamingLocatorContentKey()
                            .withId(UUID.fromString("60000000-0000-0000-0000-000000000007"))
                            .withLabelReferenceInStreamingPolicy("cbcsDefaultKey")
                            .withValue("7UqLohAfWsEGkULYxHjYZg==")))
            .create();
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 201

{
  "name": "UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/UserCreatedSecureStreamingLocatorWithUserDefinedContentKeys",
  "type": "Microsoft.Media/mediaservices/streamingLocators",
  "properties": {
    "assetName": "ClimbingMountRainier",
    "created": "2018-08-08T18:29:32.7859424Z",
    "endTime": "9999-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "90000000-0000-0000-0000-00000000000a",
    "streamingPolicyName": "secureStreamingPolicy",
    "contentKeys": [
      {
        "id": "60000000-0000-0000-0000-000000000007",
        "type": "CommonEncryptionCbcs",
        "labelReferenceInStreamingPolicy": "cbcsDefaultKey",
        "tracks": []
      },
      {
        "id": "60000000-0000-0000-0000-000000000004",
        "type": "CommonEncryptionCenc",
        "labelReferenceInStreamingPolicy": "cencDefaultKey",
        "tracks": []
      },
      {
        "id": "60000000-0000-0000-0000-000000000001",
        "type": "EnvelopeEncryption",
        "labelReferenceInStreamingPolicy": "aesDefaultKey",
        "tracks": []
      }
    ]
  }
}

Definicje

createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
StreamingLocator	Zasób lokalizatora przesyłania strumieniowego
StreamingLocatorContentKey	Klasa klucza zawartości w lokalizatorze przesyłania strumieniowego
StreamingLocatorContentKeyType	Typ szyfrowania klucza zawartości
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TrackPropertyCompareOperation	Śledzenie operacji warunku właściwości
TrackPropertyCondition	Klasa określająca warunek jednej właściwości śledzenia
TrackPropertyType	Śledzenie typu właściwości
TrackSelection	Klasa do wybierania ścieżki

createdByType

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

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

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

Name	Type	Description
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Name	Type	Description
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

Name	Type	Description
error	ErrorDetail	Obiekt error.

StreamingLocator

Zasób lokalizatora przesyłania strumieniowego

Name	Type	Description
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.alternativeMediaId	string	Alternatywny identyfikator nośnika tego lokalizatora przesyłania strumieniowego
properties.assetName	string	Nazwa zasobu
properties.contentKeys	StreamingLocatorContentKey[]	Keys używane przez ten lokalizator przesyłania strumieniowego.
properties.created	string	Czas utworzenia lokalizatora przesyłania strumieniowego.
properties.defaultContentKeyPolicyName	string	Nazwa domyślnego obiektu ContentKeyPolicy używanego przez ten lokalizator przesyłania strumieniowego.
properties.endTime	string	Godzina zakończenia lokalizatora przesyłania strumieniowego.
properties.filters	string[]	Lista filtrów zasobów lub kont, które mają zastosowanie do tego lokalizatora przesyłania strumieniowego
properties.startTime	string	Godzina rozpoczęcia lokalizatora przesyłania strumieniowego.
properties.streamingLocatorId	string	Element StreamingLocatorId lokalizatora przesyłania strumieniowego.
properties.streamingPolicyName	string	Nazwa zasad przesyłania strumieniowego używanych przez ten lokalizator przesyłania strumieniowego. Określ nazwę utworzonych zasad przesyłania strumieniowego lub użyj jednej ze wstępnie zdefiniowanych zasad przesyłania strumieniowego. Dostępne są wstępnie zdefiniowane zasady przesyłania strumieniowego: "Predefined_DownloadOnly", "Predefined_ClearStreamingOnly", "Predefined_DownloadAndClearStreaming", "Predefined_ClearKey", "Predefined_MultiDrmCencStreaming" i "Predefined_MultiDrmStreaming"
systemData	systemData	Metadane systemowe odnoszące się do tego zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

StreamingLocatorContentKey

Klasa klucza zawartości w lokalizatorze przesyłania strumieniowego

Name	Type	Description
id	string	Identyfikator klucza zawartości
labelReferenceInStreamingPolicy	string	Etykieta klucza zawartości określona w zasadach przesyłania strumieniowego
policyName	string	ContentKeyPolicy używane przez klucz zawartości
tracks	TrackSelection[]	Śledzi, które używają tego klucza zawartości
type	StreamingLocatorContentKeyType	Typ szyfrowania klucza zawartości
value	string	Wartość klucza zawartości

StreamingLocatorContentKeyType

Typ szyfrowania klucza zawartości

Name	Type	Description
CommonEncryptionCbcs	string	Common Encryption using CBCS
CommonEncryptionCenc	string	Common Encryption using CENC
EnvelopeEncryption	string	Szyfrowanie kopert

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Name	Type	Description
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TrackPropertyCompareOperation

Śledzenie operacji warunku właściwości

Name	Type	Description
Equal	string	Równa operacja
Unknown	string	Nieznana operacja porównywania właściwości śledzenia

TrackPropertyCondition

Klasa określająca warunek jednej właściwości śledzenia

Name	Type	Description
operation	TrackPropertyCompareOperation	Śledzenie operacji warunku właściwości
property	TrackPropertyType	Śledzenie typu właściwości
value	string	Śledzenie wartości właściwości

TrackPropertyType

Śledzenie typu właściwości

Name	Type	Description
FourCC	string	Track FourCC
Unknown	string	Nieznana właściwość ścieżki

TrackSelection

Klasa do wybierania ścieżki

Name	Type	Description
trackSelections	TrackPropertyCondition[]	TrackSelections to lista warunków śledzenia właściwości, która może określać ścieżki