Share via


az ams account-filter

Verwalten von Kontofiltern für ein Azure Media Services-Konto.

Befehle

Name Beschreibung Typ Status
az ams account-filter create

Erstellen Sie einen Kontofilter.

Core Allgemein verfügbar
az ams account-filter delete

Löschen eines Kontofilters.

Core Allgemein verfügbar
az ams account-filter list

Listet alle Kontofilter eines Azure Media Services-Kontos auf.

Core Allgemein verfügbar
az ams account-filter show

Zeigen Sie die Details eines Kontofilters an.

Core Allgemein verfügbar
az ams account-filter update

Aktualisieren Sie die Details eines Kontofilters.

Core Allgemein verfügbar

az ams account-filter create

Erstellen Sie einen Kontofilter.

az ams account-filter create --account-name
                             --name
                             --resource-group
                             [--end-timestamp]
                             [--first-quality]
                             [--force-end-timestamp {false, true}]
                             [--live-backoff-duration]
                             [--presentation-window-duration]
                             [--start-timestamp]
                             [--timescale]
                             [--tracks]

Beispiele

Erstellen Sie einen Objektfilter mit Filtertitelauswahlen.

az ams account-filter create -a amsAccount -g resourceGroup -n filterName --force-end-timestamp=False --end-timestamp 200000 --start-timestamp 100000 --live-backoff-duration 60 --presentation-window-duration 600000 --timescale 1000 --first-quality 720 --tracks @C:\tracks.json

Erforderliche Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--name -n

Der Name des Kontofilters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--end-timestamp

Gilt für Video on Demand (VoD). Bei einer Livestreamingpräsentation wird diese Eigenschaft stillschweigend ignoriert und angewendet, wenn die Präsentation endet und der Stream zu VoD wird. Dies ist ein Long-Wert, der einen absoluten Endpunkt der Präsentation darstellt und auf den nächsten GOP-Start gerundet wird. Die Einheit ist die Zeitskala, daher würde ein „endTimestamp“ von 1800000000 einer Zeit von drei Minuten entsprechen. Verwenden Sie „startTimestamp“ und „endTimestamp“, um die Fragmente in der Wiedergabeliste (das Manifest) zu kürzen. Wenn Sie z. B. „startTimestamp=40000000“ und „endTimestamp=100000000“ mit der voreingestellten Zeitskala verwenden, wird eine Wiedergabeliste generiert, die Fragmente aus einer Zeitspanne von vier bis zehn Sekunden der VoD-Präsentation enthält. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in das Manifest aufgenommen.

--first-quality

Die erste Qualität (niedrigste) Bitrate, die in das Manifest eingeschlossen werden soll.

--force-end-timestamp

Gilt nur für Livestreaming. Gibt an, ob die Eigenschaft „endTimestamp“ vorhanden sein muss. Bei „true“ muss „endTimestamp“ muss angegeben werden, da ansonsten ein ungültiger Anforderungscode zurückgegeben wird. Zulässige Werte: false, true.

Zulässige Werte: false, true
Standardwert: False
--live-backoff-duration

Gilt nur für Livestreaming. Dieser Wert definiert die letzte Liveposition, die ein Client durchsuchen kann. Mit dieser Eigenschaft können Sie die Livewiedergabeposition verzögern und einen serverseitigen Puffer für Spieler erstellen. Die Einheit für diese Eigenschaft ist die Zeitskala (siehe unten). Der maximal zulässige Wert für „LiveBackoffDuration“ beträgt 300 Sekunden (3000000000). Ein Wert von 2000000000 bedeutet z. B., dass der letzte verfügbare Inhalt 20 Sekunden gegenüber der tatsächlichen Liveedge verzögert ist.

--presentation-window-duration

Gilt nur für Livestreaming. Verwenden Sie „presentationWindowDuration“, um ein gleitendes Fenster mit Fragmenten auf die Wiedergabeliste anzuwenden. Die Einheit für diese Eigenschaft ist die Zeitskala (siehe unten). Legen Sie beispielsweise „presentationWindowDuration=1200000000“ fest, um ein gleitendes Fenster von 2 Minuten anzuwenden. Medien, die in einem 2-Minuten-Zeitraum um die Liveposition liegen, werden in die Wiedergabeliste aufgenommen. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in die Wiedergabeliste aufgenommen. Die Mindestdauer für das Präsentationsfenster beträgt 60 Sekunden.

--start-timestamp

Gilt für Video on Demand (VoD) oder Livestreaming. Dies ist ein Long-Wert, der einen absoluten Startpunkt des Streams darstellt. Er wird auf den nächstgelegenen GOP-Start gerundet. Die Einheit ist die Zeitskala, daher würde ein „startTimestamp“ von 150000000 einer Zeit von 15 Sekunden entsprechen. Verwenden Sie „startTimestamp“ und „endTimestamp“, um die Fragmente in der Wiedergabeliste (das Manifest) zu kürzen. Wenn Sie z. B. „startTimestamp=40000000“ und „endTimestamp=100000000“ mit der voreingestellten Zeitskala verwenden, wird eine Wiedergabeliste generiert, die Fragmente aus einer Zeitspanne von vier bis zehn Sekunden der VoD-Präsentation enthält. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in das Manifest aufgenommen.

--timescale

Gilt für alle Zeitstempel und Zeiträume in einem Präsentationszeitbereich, der als Anzahl der Inkremente in einer Sekunde angegeben wird. Der Standardwert ist 10000000 – zehn Millionen Inkremente in einer Sekunde, wobei jedes Inkrement 100 Nanosekunden lang sein würde. Wenn Sie z. B. einen Startzeitstempel auf 30 Sekunden einstellen möchten, würden Sie bei Verwendung der Standardzeitskala einen Wert von 300000000 verwenden.

--tracks

Der JSON-Code, der die Titelauswahl darstellt. Verwenden Sie @{file} zum Laden aus einer Datei. Weitere Informationen zur JSON-Struktur finden Sie in der Dokumentation zu swagger.https://docs.microsoft.com/rest/api/media/accountfilters/createorupdate#filtertrackselection

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ams account-filter delete

Löschen eines Kontofilters.

az ams account-filter delete [--account-name]
                             [--ids]
                             [--name]
                             [--resource-group]
                             [--subscription]

Optionale Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des Kontofilters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ams account-filter list

Listet alle Kontofilter eines Azure Media Services-Kontos auf.

az ams account-filter list --account-name
                           --resource-group

Erforderliche Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ams account-filter show

Zeigen Sie die Details eines Kontofilters an.

az ams account-filter show [--account-name]
                           [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

Optionale Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des Kontofilters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ams account-filter update

Aktualisieren Sie die Details eines Kontofilters.

az ams account-filter update [--account-name]
                             [--add]
                             [--end-timestamp]
                             [--first-quality]
                             [--force-end-timestamp {false, true}]
                             [--force-string]
                             [--ids]
                             [--live-backoff-duration]
                             [--name]
                             [--presentation-window-duration]
                             [--remove]
                             [--resource-group]
                             [--set]
                             [--start-timestamp]
                             [--subscription]
                             [--timescale]
                             [--tracks]

Optionale Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--end-timestamp

Gilt für Video on Demand (VoD). Bei einer Livestreamingpräsentation wird diese Eigenschaft stillschweigend ignoriert und angewendet, wenn die Präsentation endet und der Stream zu VoD wird. Dies ist ein Long-Wert, der einen absoluten Endpunkt der Präsentation darstellt und auf den nächsten GOP-Start gerundet wird. Die Einheit ist die Zeitskala, daher würde ein „endTimestamp“ von 1800000000 einer Zeit von drei Minuten entsprechen. Verwenden Sie „startTimestamp“ und „endTimestamp“, um die Fragmente in der Wiedergabeliste (das Manifest) zu kürzen. Wenn Sie z. B. „startTimestamp=40000000“ und „endTimestamp=100000000“ mit der voreingestellten Zeitskala verwenden, wird eine Wiedergabeliste generiert, die Fragmente aus einer Zeitspanne von vier bis zehn Sekunden der VoD-Präsentation enthält. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in das Manifest aufgenommen.

--first-quality

Die erste Qualität (niedrigste) Bitrate, die in das Manifest eingeschlossen werden soll.

--force-end-timestamp

Gilt nur für Livestreaming. Gibt an, ob die Eigenschaft „endTimestamp“ vorhanden sein muss. Bei „true“ muss „endTimestamp“ muss angegeben werden, da ansonsten ein ungültiger Anforderungscode zurückgegeben wird. Zulässige Werte: false, true.

Zulässige Werte: false, true
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--live-backoff-duration

Gilt nur für Livestreaming. Dieser Wert definiert die letzte Liveposition, die ein Client durchsuchen kann. Mit dieser Eigenschaft können Sie die Livewiedergabeposition verzögern und einen serverseitigen Puffer für Spieler erstellen. Die Einheit für diese Eigenschaft ist die Zeitskala (siehe unten). Der maximal zulässige Wert für „LiveBackoffDuration“ beträgt 300 Sekunden (3000000000). Ein Wert von 2000000000 bedeutet z. B., dass der letzte verfügbare Inhalt 20 Sekunden gegenüber der tatsächlichen Liveedge verzögert ist.

--name -n

Der Name des Kontofilters.

--presentation-window-duration

Gilt nur für Livestreaming. Verwenden Sie „presentationWindowDuration“, um ein gleitendes Fenster mit Fragmenten auf die Wiedergabeliste anzuwenden. Die Einheit für diese Eigenschaft ist die Zeitskala (siehe unten). Legen Sie beispielsweise „presentationWindowDuration=1200000000“ fest, um ein gleitendes Fenster von 2 Minuten anzuwenden. Medien, die in einem 2-Minuten-Zeitraum um die Liveposition liegen, werden in die Wiedergabeliste aufgenommen. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in die Wiedergabeliste aufgenommen. Die Mindestdauer für das Präsentationsfenster beträgt 60 Sekunden.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--start-timestamp

Gilt für Video on Demand (VoD) oder Livestreaming. Dies ist ein Long-Wert, der einen absoluten Startpunkt des Streams darstellt. Er wird auf den nächstgelegenen GOP-Start gerundet. Die Einheit ist die Zeitskala, daher würde ein „startTimestamp“ von 150000000 einer Zeit von 15 Sekunden entsprechen. Verwenden Sie „startTimestamp“ und „endTimestamp“, um die Fragmente in der Wiedergabeliste (das Manifest) zu kürzen. Wenn Sie z. B. „startTimestamp=40000000“ und „endTimestamp=100000000“ mit der voreingestellten Zeitskala verwenden, wird eine Wiedergabeliste generiert, die Fragmente aus einer Zeitspanne von vier bis zehn Sekunden der VoD-Präsentation enthält. Wenn ein Fragment die Grenze überschreitet, wird das gesamte Fragment in das Manifest aufgenommen.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--timescale

Gilt für alle Zeitstempel und Zeiträume in einem Präsentationszeitbereich, der als Anzahl der Inkremente in einer Sekunde angegeben wird. Der Standardwert ist 10000000 – zehn Millionen Inkremente in einer Sekunde, wobei jedes Inkrement 100 Nanosekunden lang sein würde. Wenn Sie z. B. einen Startzeitstempel auf 30 Sekunden einstellen möchten, würden Sie bei Verwendung der Standardzeitskala einen Wert von 300000000 verwenden.

--tracks

Der JSON-Code, der die Titelauswahl darstellt. Verwenden Sie @{file} zum Laden aus einer Datei. Weitere Informationen zur JSON-Struktur finden Sie in der Dokumentation zu swagger.https://docs.microsoft.com/rest/api/media/accountfilters/createorupdate#filtertrackselection

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.