Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
UpdateStream
Aggiorna i metadati del flusso, come il nome del dispositivo e il tipo di supporto.
Devi fornire il nome del flusso o l'Amazon Resource Name (ARN) del flusso.
Per assicurarti di disporre della versione più recente del flusso prima di aggiornarlo, puoi specificare la versione del flusso. Kinesis Video Streams assegna una versione a ciascun flusso. Quando si aggiorna uno stream, Kinesis Video Streams assegna un nuovo numero di versione. Per ottenere la versione più recente dello streaming, utilizzare ilDescribeStreamAPI.
UpdateStreamè un'operazione asincrona e richiederà tempo per essere completato.
Sintassi della richiesta
POST /updateStream HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "string",
"DeviceName": "string",
"MediaType": "string",
"StreamARN": "string",
"StreamName": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- CurrentVersion
-
La versione del flusso di cui vuoi aggiornare i metadati.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9]+: campo obbligatorio Sì
- DeviceName
-
Il nome del dispositivo che sta scrivendo nel flusso.
Nota Nell'attuale implementazione, Kinesis Video Streams non usa questo nome.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+: campo obbligatorio No
- MediaType
-
Il tipo di supporto dello stream. Utilizza
MediaTypeper specificare il tipo di contenuto che lo stream contiene per i consumatori dello stream. Per ulteriori informazioni sui tipi di supporti, consultaTipi di supporti. Se si sceglie di specificare il MediaType, consultaRequisiti di denominazione. Per riprodurre video sulla console, è necessario specificare il tipo di video corretto. Ad esempio, se il video nello stream è H.264, specificare
video/h264come ilMediaType.Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*: campo obbligatorio No
- StreamARN
-
L'ARN del flusso di cui si desidera aggiornare i metadati.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+: campo obbligatorio No
- StreamName
-
Il nome del flusso di cui vuoi aggiornare i metadati.
Il nome del flusso è un identificatore del flusso e deve essere univoco per ogni account e area geografica.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+: campo obbligatorio No
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ClientLimitExceededException
-
Kinesis Video Streams ha limitato la richiesta perché hai superato il limite delle chiamate client consentite. Prova a effettuare la chiamata più tardi.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
Codice di stato HTTP: 400
- NotAuthorizedException
-
Il chiamante non è autorizzato a eseguire questa operazione.
Codice di stato HTTP: 401
- ResourceInUseException
-
La risorsa non è attualmente disponibile per questa operazione. Non è possibile creare nuove risorse con lo stesso nome delle risorse esistenti. Inoltre, le risorse non possono essere aggiornate o eliminate a meno che non si trovino in un
ACTIVEstato.Se viene restituita questa eccezione, non utilizzarla per determinare se la risorsa richiesta esiste già. Invece, si consiglia di utilizzare l'API di descrizione specifica delle risorse, ad esempio
DescribeStreamper flussi video.Codice di stato HTTP: 400
- ResourceNotFoundException
-
Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.
Codice di stato HTTP: 404
- VersionMismatchException
-
La versione dello stream specificata non è la versione più recente. Per ottenere la versione più recente, usa ilDescribeStreamAPI.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
