UpdatePipeline - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação permite modifique o nome, o status e as configurações de notificação de uma fila MPS específica.
Caso uma fila MPS pausada esteja selecionada em um workflow ou job, como revisão de vídeo ou fingerprint de mídia, a execução falhará.

Limites de QPS

O limite desta operação é de 100 chamadas por segundo. Ao ultrapassar esse valor, o sistema ativa o throttling, o que pode impactar seu negócio. Recomendamos observar esse limite ao chamar esta operação. Para mais detalhes, consulte Limites de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdatePipeline	A operação que você deseja execute. Defina o valor como UpdatePipeline.
PipelineId	String	Sim	d1ce4d3efcb549419193f50f1fcd****	ID da fila MPS a ser atualizada. Para obter esse ID, faça login no MPS console e selecione Global Settings > Pipelines no painel de navegação à esquerda.
Name	String	Sim	example-pipeline-****	Novo nome da fila MPS. O valor pode conter letras, dígitos e caracteres especiais, como hífens (-), com tamanho máximo de 128 bytes. Não é permitido iniciar com caractere especial.
State	String	Sim	Paused	Novo estado da fila MPS. Active: A fila MPS está ativa. Os jobs nela contidos podem ser agendados e executados pelo MPS. Paused: A fila MPS está pausada. O MPS não agenda nem executa novos jobs, mantendo todos no estado Submitted. Jobs em execução não são afetados.
NotifyConfig	String	Não	null	Configuração do Message Service (MNS), incluindo informações sobre filas ou tópicos do MNS. Para mais detalhes, consulte NotifyConfig.
Role	String	Não	AliyunMTSDefaultRole	Função atribuída ao usuário RAM atual. Para obtê-la, acesse o RAM console e escolha Identities > Roles no painel de navegação à esquerda.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	1FE0F96B-544D-4244-9D83-DFCFB0E5A231	ID da solicitação.
Pipeline	Object		Detalhes da fila MPS.
Speed	String	Standard	Tipo da fila MPS. Valor padrão: Standard. Valores válidos: Boost: Fila MPS com velocidade de transcodificação acelerada. Standard: Fila MPS padrão. NarrowBandHDV2: Fila MPS compatível com Narrowband HD™ 2.0. AIVideoCover: Fila MPS para captura inteligente de snapshots. AIVideoFPShot: Fila MPS para fingerprint de mídia. AIVideoCensor: Fila MPS para revisão automatizada. AIVideoMCU: Fila MPS para tagging inteligente. AIVideoSummary: Fila MPS para sinopse de vídeo. AIVideoPorn: Fila MPS para detecção de pornografia em vídeos. AIAudioKWS: Fila MPS para reconhecimento de palavras-chave em áudio. AIAudioASR: Fila MPS para conversão de fala em texto.
State	String	Paused	Status da fila. Valores válidos: Active: A fila MPS está ativa. Paused: A fila MPS está pausada.
NotifyConfig	Object		Configuração do MNS.
MqTopic	String	example1,example2	Fila de mensagens recebidas.
QueueName	String	example-queue-****	Fila criada no MNS.
MqTag	String	mts-test	Tags das mensagens.
Topic	String	example-topic-****	Tópico criado no MNS.
Name	String	example-pipeline-****	Novo nome da fila MPS.
Role	String	AliyunMTSExampleRole	Função atribuída ao usuário RAM atual.
Id	String	d1ce4d3efcb549419193f50f1fcd****	ID da fila MPS.
QuotaAllocate	Long	10	Cota alocada para a fila MPS.

Exemplos

Exemplo de solicitação

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdatePipeline
&PipelineId=d1ce4d3efcb549419193f50f1fcd****
&Name=example-pipeline-****
&State=Paused
&NotifyConfig={"Topic":"example-topic-****"}
&Role=AliyunMTSDefaultRole
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdatePipelineResponse>
    <RequestId>1FE0F96B-544D-4244-9D83-DFCFB0E5A231</RequestId>
    <Pipeline>
        <Speed>Standard</Speed>
        <State>Paused</State>
        <NotifyConfig>
            <MqTopic>example1,example2</MqTopic>
            <QueueName>example-queue-****</QueueName>
            <MqTag>mts-test</MqTag>
            <Topic>example-topic-****</Topic>
        </NotifyConfig>
        <Name>example-pipeline-****</Name>
        <Role>AliyunMTSExampleRole</Role>
        <Id>d1ce4d3efcb549419193f50f1fcd****</Id>
        <QuotaAllocate>10</QuotaAllocate>
    </Pipeline>
</UpdatePipelineResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1FE0F96B-544D-4244-9D83-DFCFB0E5A231",
  "Pipeline" : {
    "Speed" : "Standard",
    "State" : "Paused",
    "NotifyConfig" : {
      "MqTopic" : "example1,example2",
      "QueueName" : "example-queue-****",
      "MqTag" : "mts-test",
      "Topic" : "example-topic-****"
    },
    "Name" : "example-pipeline-****",
    "Role" : "AliyunMTSExampleRole",
    "Id" : "d1ce4d3efcb549419193f50f1fcd****",
    "QuotaAllocate" : 10
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.