As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateStreamStorageConfiguration
Atualiza a configuração de armazenamento de um stream de vídeo existente do Kinesis.
Essa operação permite que você modifique as configurações do nível de armazenamento de um stream, permitindo que você otimize os custos e o desempenho do armazenamento com base em seus padrões de acesso.
UpdateStreamStorageConfiguration é uma operação de natureza assíncrona.
Você deve ter permissões para a ação KinesisVideo:UpdateStreamStorageConfiguration.
Sintaxe da Solicitação
POST /updateStreamStorageConfiguration HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "string",
"StreamARN": "string",
"StreamName": "string",
"StreamStorageConfiguration": {
"DefaultStorageTier": "string"
}
}Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- CurrentVersion
-
A versão do stream cuja configuração de armazenamento você deseja alterar. Para obter a versão, chame a API
DescribeStreamou aListStreamsAPI.Tipo: String
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
[a-zA-Z0-9]+Exigido: Sim
- StreamARN
-
O Amazon Resource Name (ARN) do stream para o qual você deseja atualizar a configuração de armazenamento.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.
Padrão:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+Obrigatório: não
- StreamName
-
O nome do fluxo para o qual você deseja atualizar a configuração de armazenamento.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Padrão:
[a-zA-Z0-9_.-]+Obrigatório: não
- StreamStorageConfiguration
-
A nova configuração de armazenamento para o stream. Isso inclui o nível de armazenamento padrão que determina como os dados do stream são armazenados e acessados.
Diferentes níveis de armazenamento oferecem níveis variados de desempenho e otimização de custos para atender aos requisitos específicos de seu caso de uso.
Tipo: objeto StreamStorageConfiguration
Exigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não tem as permissões necessárias para realizar essa operação.
Código de status HTTP: 401
- ClientLimitExceededException
-
O Kinesis Video Streams limitou a solicitação porque você excedeu o limite permitido de chamadas de clientes. Tente fazer a ligação mais tarde.
Código de status HTTP: 400
- InvalidArgumentException
-
O valor desse parâmetro de entrada é inválido.
Código de status HTTP: 400
- ResourceInUseException
-
Quando a entrada
StreamARNouChannelARNa entrada já estiverem mapeadas para um recurso diferente do Kinesis Video Stream, ou se aStreamARNentradaChannelARNfornecida não estiver no status Ativo, tente uma das seguintes opções:CLOUD_STORAGE_MODE-
A
DescribeMediaStorageConfigurationAPI para determinar para qual stream determinado canal é mapeado. -
A
DescribeMappedResourceConfigurationAPI para determinar o canal para o qual o determinado fluxo é mapeado. -
A
DescribeSignalingChannelAPIDescribeStreamou para determinar o status do recurso.
Código de status HTTP: 400
-
- ResourceNotFoundException
-
O Amazon Kinesis Video Streams não consegue encontrar o stream que você especificou.
Código de status HTTP: 404
- VersionMismatchException
-
A versão do stream que você especificou não é a versão mais recente. Para obter a versão mais recente, use a DescribeStreamAPI.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
