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 dello streaming, come il nome del dispositivo e il tipo di supporto.
Devi fornire il nome dello stream o l'Amazon Resource Name (ARN) dello stream.
Per assicurarti di disporre della versione più recente dello stream prima di aggiornarlo, puoi specificare la versione dello stream. Kinesis Video Streams assegna una versione a ogni stream. Quando aggiorni uno stream, Kinesis Video Streams assegna un nuovo numero di versione. Per ottenere la versione di streaming più recente, utilizza l'API. DescribeStream
UpdateStreamè un'operazione asincrona e il suo completamento richiede tempo.
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 dello stream di cui desideri aggiornare i metadati.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9]+Campo obbligatorio: sì
- DeviceName
-
Il nome del dispositivo che sta scrivendo nello stream.
Nota
Nell'implementazione corrente, Kinesis Video Streams non utilizza questo nome.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: no
- MediaType
-
Il tipo di file multimediale dello stream. Utilizzato
MediaTypeper specificare il tipo di contenuto che lo stream contiene per i consumatori dello stream. Per ulteriori informazioni sui tipi di file multimediali, consulta Tipi di file multimediali. Se scegli di specificare il MediaType, vedi Requisiti di denominazione. Per riprodurre video sulla console, è necessario specificare il tipo di video corretto. Ad esempio, se il video nello stream è H.264, specifica
video/h264come.MediaTypeTipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.
Modello:
[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*Campo obbligatorio: no
- StreamARN
-
L'ARN dello stream di cui desideri aggiornare i metadati.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 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 dello stream di cui desideri aggiornare i metadati.
Il nome dello stream è un identificatore dello stream e deve essere univoco per ogni account e regione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 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é è stato superato il limite di 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
-
Quando l'ingresso
StreamARNoChannelARNl'ingressoCLOUD_STORAGE_MODEsono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARNingresso fornitoChannelARNo non è nello stato Attivo, prova una delle seguenti soluzioni:-
L'
DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream di un determinato canale. -
L'
DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStreamo l'DescribeSignalingChannelAPI per determinare lo stato della risorsa.
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 che hai specificato non è la versione più recente. Per ottenere la versione più recente, usa l'DescribeStreamAPI.
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:
