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:
|
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