Todos os produtos
Search
Central de documentação

Object Storage Service:PutLiveChannelStatus

Última atualização: Sep 08, 2026

Altera o status de um LiveChannel para habilitado ou desabilitado.

Observações de uso

Ao chamar a API PutLiveChannelStatus, observe os seguintes pontos:

  • Se o LiveChannel estiver desabilitado, o OSS bloqueará a ingestão de streams nesse canal. Caso haja ingestão em andamento para um LiveChannel desabilitado, o cliente será desconectado após aproximadamente 10 segundos.

  • Se não houver stream sendo ingerida no LiveChannel, crie o canal chamando a API PutLiveChannel para alterar seu status.

  • Durante a ingestão ativa de uma stream, use apenas a chamada PutLiveChannelStatus para definir o status do LiveChannel como desabilitado.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM vinculados a essa conta não têm permissões atribuídas automaticamente. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de RAM policies ou Bucket Policy.

API

Action

Descrição

PutLiveChannelStatus

oss:PutLiveChannelStatus

Alterna o status entre habilitado e desabilitado.

Sintaxe da solicitação

PUT /ChannelName?live&status=NewStatus HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Elementos da solicitação

Elemento

Tipo

Obrigatório

Descrição

status

String

Sim

O status do LiveChannel.

Valores válidos:

  • enabled

  • disabled

Cabeçalhos da solicitação

Todos os cabeçalhos em uma solicitação PutLiveChannelStatus são cabeçalhos comuns de solicitação. Para mais informações, consulte Common HTTP headers.

Cabeçalhos da resposta

Os cabeçalhos retornados na resposta de uma solicitação PutLiveChannelStatus correspondem aos cabeçalhos comuns de resposta. Para mais detalhes, consulte Common HTTP headers.

Exemplos

Exemplo de solicitação

PUT /test-channel?live&status=disabled HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplo de resposta

HTTP/1.1 200
Content-Length: 0
Server: AliyunOSS
Connection: close
x-oss-request-id: 57BE8422B92475920B00****
Date: Tue, 25 Dec 2018 17:35:24 GMT