Asset Filters - Create Or Update

Odwołanie

Service:: Media Services

API Version:: 2021-11-01

Tworzenie lub aktualizowanie filtru zasobów
Tworzy lub aktualizuje filtr zasobów skojarzony z określonym zasobem.

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

Parametry identyfikatora URI

Name	In	Required	Type	Description
accountName	path	True	string	Nazwa konta Media Services.
assetName	path	True	string	Nazwa zasobu.
filterName	path	True	string	Nazwa filtru zasobów
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
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	Type	Description
properties.firstQuality	FirstQuality	Pierwsza jakość.
properties.presentationTimeRange	PresentationTimeRange	Zakres czasu prezentacji.
properties.tracks	FilterTrackSelection[]	Śledzi warunki wyboru.

Odpowiedzi

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

Przykłady

Create an Asset Filter

Sample Request

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

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854774806,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

import com.azure.resourcemanager.mediaservices.models.FilterTrackPropertyCompareOperation;
import com.azure.resourcemanager.mediaservices.models.FilterTrackPropertyCondition;
import com.azure.resourcemanager.mediaservices.models.FilterTrackPropertyType;
import com.azure.resourcemanager.mediaservices.models.FilterTrackSelection;
import com.azure.resourcemanager.mediaservices.models.FirstQuality;
import com.azure.resourcemanager.mediaservices.models.PresentationTimeRange;
import java.util.Arrays;

/** Samples for AssetFilters CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/stable/2021-11-01/examples/assetFilters-create.json
     */
    /**
     * Sample code: Create an Asset Filter.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createAnAssetFilter(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .assetFilters()
            .define("newAssetFilter")
            .withExistingAsset("contoso", "contosomedia", "ClimbingMountRainer")
            .withPresentationTimeRange(
                new PresentationTimeRange()
                    .withStartTimestamp(0L)
                    .withEndTimestamp(170000000L)
                    .withPresentationWindowDuration(9223372036854775000L)
                    .withLiveBackoffDuration(0L)
                    .withTimescale(10000000L)
                    .withForceEndTimestamp(false))
            .withFirstQuality(new FirstQuality().withBitrate(128000))
            .withTracks(
                Arrays
                    .asList(
                        new FilterTrackSelection()
                            .withTrackSelections(
                                Arrays
                                    .asList(
                                        new FilterTrackPropertyCondition()
                                            .withProperty(FilterTrackPropertyType.TYPE)
                                            .withValue("Audio")
                                            .withOperation(FilterTrackPropertyCompareOperation.EQUAL),
                                        new FilterTrackPropertyCondition()
                                            .withProperty(FilterTrackPropertyType.LANGUAGE)
                                            .withValue("en")
                                            .withOperation(FilterTrackPropertyCompareOperation.NOT_EQUAL),
                                        new FilterTrackPropertyCondition()
                                            .withProperty(FilterTrackPropertyType.FOUR_CC)
                                            .withValue("EC-3")
                                            .withOperation(FilterTrackPropertyCompareOperation.NOT_EQUAL))),
                        new FilterTrackSelection()
                            .withTrackSelections(
                                Arrays
                                    .asList(
                                        new FilterTrackPropertyCondition()
                                            .withProperty(FilterTrackPropertyType.TYPE)
                                            .withValue("Video")
                                            .withOperation(FilterTrackPropertyCompareOperation.EQUAL),
                                        new FilterTrackPropertyCondition()
                                            .withProperty(FilterTrackPropertyType.BITRATE)
                                            .withValue("3000000-5000000")
                                            .withOperation(FilterTrackPropertyCompareOperation.EQUAL)))))
            .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/assetFilters-create.json
func ExampleAssetFiltersClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armmediaservices.NewAssetFiltersClient("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := client.CreateOrUpdate(ctx,
		"contoso",
		"contosomedia",
		"ClimbingMountRainer",
		"newAssetFilter",
		armmediaservices.AssetFilter{
			Properties: &armmediaservices.MediaFilterProperties{
				FirstQuality: &armmediaservices.FirstQuality{
					Bitrate: to.Ptr[int32](128000),
				},
				PresentationTimeRange: &armmediaservices.PresentationTimeRange{
					EndTimestamp:               to.Ptr[int64](170000000),
					ForceEndTimestamp:          to.Ptr(false),
					LiveBackoffDuration:        to.Ptr[int64](0),
					PresentationWindowDuration: to.Ptr[int64](9223372036854775000),
					StartTimestamp:             to.Ptr[int64](0),
					Timescale:                  to.Ptr[int64](10000000),
				},
				Tracks: []*armmediaservices.FilterTrackSelection{
					{
						TrackSelections: []*armmediaservices.FilterTrackPropertyCondition{
							{
								Operation: to.Ptr(armmediaservices.FilterTrackPropertyCompareOperationEqual),
								Property:  to.Ptr(armmediaservices.FilterTrackPropertyTypeType),
								Value:     to.Ptr("Audio"),
							},
							{
								Operation: to.Ptr(armmediaservices.FilterTrackPropertyCompareOperationNotEqual),
								Property:  to.Ptr(armmediaservices.FilterTrackPropertyTypeLanguage),
								Value:     to.Ptr("en"),
							},
							{
								Operation: to.Ptr(armmediaservices.FilterTrackPropertyCompareOperationNotEqual),
								Property:  to.Ptr(armmediaservices.FilterTrackPropertyTypeFourCC),
								Value:     to.Ptr("EC-3"),
							}},
					},
					{
						TrackSelections: []*armmediaservices.FilterTrackPropertyCondition{
							{
								Operation: to.Ptr(armmediaservices.FilterTrackPropertyCompareOperationEqual),
								Property:  to.Ptr(armmediaservices.FilterTrackPropertyTypeType),
								Value:     to.Ptr("Video"),
							},
							{
								Operation: to.Ptr(armmediaservices.FilterTrackPropertyCompareOperationEqual),
								Property:  to.Ptr(armmediaservices.FilterTrackPropertyTypeBitrate),
								Value:     to.Ptr("3000000-5000000"),
							}},
					}},
			},
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// TODO: use response item
	_ = res
}

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

Sample Response

Status code:: 201

{
  "name": "newAssetFilter",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainer/assetFilters/newAssetFilter",
  "type": "Microsoft.Media/mediaservices/assets/assetFilters",
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854774806,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "value": "Audio",
            "operation": "Equal"
          },
          {
            "property": "Language",
            "value": "en",
            "operation": "NotEqual"
          },
          {
            "property": "FourCC",
            "value": "EC-3",
            "operation": "NotEqual"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "value": "Video",
            "operation": "Equal"
          },
          {
            "property": "Bitrate",
            "value": "3000000-5000000",
            "operation": "Equal"
          }
        ]
      }
    ]
  }
}

Status code:: 200

{
  "name": "newAssetFilter",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainer/assetFilters/newAssetFilter",
  "type": "Microsoft.Media/mediaservices/assets/assetFilters",
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854774806,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "value": "Audio",
            "operation": "Equal"
          },
          {
            "property": "Language",
            "value": "en",
            "operation": "NotEqual"
          },
          {
            "property": "FourCC",
            "value": "EC-3",
            "operation": "NotEqual"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "value": "Video",
            "operation": "Equal"
          },
          {
            "property": "Bitrate",
            "value": "3000000-5000000",
            "operation": "Equal"
          }
        ]
      }
    ]
  }
}

Definicje

AssetFilter	Filtr zasobu.
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
FilterTrackPropertyCompareOperation	Operacja warunku właściwości śledzenia.
FilterTrackPropertyCondition	Klasa określająca jeden warunek właściwości śledzenia.
FilterTrackPropertyType	Typ właściwości track.
FilterTrackSelection	Reprezentowanie listy elementów FilterTrackPropertyCondition w celu wybrania ścieżki. Filtry są łączone przy użyciu operacji logicznej AND.
FirstQuality	Filtruj pierwszą jakość
PresentationTimeRange	Zakres czasu prezentacji jest powiązany z elementem zawartości i nie jest zalecany w przypadku filtru konta.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AssetFilter

Filtr zasobu.

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.firstQuality	FirstQuality	Pierwsza jakość.
properties.presentationTimeRange	PresentationTimeRange	Zakres czasu prezentacji.
properties.tracks	FilterTrackSelection[]	Śledzi warunki wyboru.
systemData	systemData	Metadane systemowe odnoszące się do tego zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

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.

FilterTrackPropertyCompareOperation

Operacja warunku właściwości śledzenia.

Name	Type	Description
Equal	string	Równa operacja.
NotEqual	string	Nie równa się operacja.

FilterTrackPropertyCondition

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

Name	Type	Description
operation	FilterTrackPropertyCompareOperation	Operacja warunku właściwości śledzenia.
property	FilterTrackPropertyType	Typ właściwości track.
value	string	Wartość właściwości śledzenia.

FilterTrackPropertyType

Typ właściwości track.

Name	Type	Description
Bitrate	string	Szybkość transmisji bitów.
FourCC	string	CzteryCC.
Language	string	Język.
Name	string	Nazwa.
Type	string	Typ.
Unknown	string	Nieznany typ właściwości śledzenia.

FilterTrackSelection

Reprezentowanie listy elementów FilterTrackPropertyCondition w celu wybrania ścieżki. Filtry są łączone przy użyciu operacji logicznej AND.

Name	Type	Description
trackSelections	FilterTrackPropertyCondition[]	Wybrane ścieżki.

FirstQuality

Filtruj pierwszą jakość

Name	Type	Description
bitrate	integer	Pierwsza szybkość transmisji bitów jakości.

PresentationTimeRange

Zakres czasu prezentacji jest powiązany z elementem zawartości i nie jest zalecany w przypadku filtru konta.

Name	Type	Description
endTimestamp	integer	Bezwzględna granica czasu zakończenia.
forceEndTimestamp	boolean	Wskaźnik wymuszania istniejącej sygnatury czasowej zakończenia.
liveBackoffDuration	integer	Względem prawej krawędzi.
presentationWindowDuration	integer	Względem końca przesuwanego okna.
startTimestamp	integer	Bezwzględna granica czasu rozpoczęcia.
timescale	integer	Skala czasu sygnatur czasowych.

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.