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à.
UpdateStreamStorageConfiguration
Aggiorna la configurazione di archiviazione per un flusso video Kinesis esistente.
Questa operazione consente di modificare le impostazioni del livello di archiviazione per uno stream, consentendoti di ottimizzare i costi e le prestazioni dello storage in base ai tuoi modelli di accesso.
UpdateStreamStorageConfiguration è un'operazione asincrona.
È necessario avere le autorizzazioni per l'operazione KinesisVideo:UpdateStreamStorageConfiguration.
Sintassi della richiesta
POST /updateStreamStorageConfiguration HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "string",
"StreamARN": "string",
"StreamName": "string",
"StreamStorageConfiguration": {
"DefaultStorageTier": "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 modificare la configurazione di archiviazione. Per ottenere la versione, chiama l'
DescribeStreamo l'ListStreamsAPI.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9]+Campo obbligatorio: sì
- StreamARN
-
L'Amazon Resource Name (ARN) dello stream per il quale desideri aggiornare la configurazione dello storage.
Tipo: stringa
Limitazioni 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 dello stream per il quale desideri aggiornare la configurazione dello storage.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: no
- StreamStorageConfiguration
-
La nuova configurazione di archiviazione per lo stream. Ciò include il livello di archiviazione predefinito che determina la modalità di archiviazione e accesso ai dati di flusso.
I diversi livelli di storage offrono diversi livelli di ottimizzazione delle prestazioni e dei costi per soddisfare i requisiti specifici dei casi d'uso.
Tipo: oggetto StreamStorageConfiguration
Campo obbligatorio: sì
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.
- AccessDeniedException
-
Non disponi delle autorizzazioni necessarie per eseguire questa operazione.
Codice di stato HTTP: 401
- 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
- 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 una delle lingue specifiche AWS SDKs, consulta quanto segue:
