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

Atualiza uma fila MPS.

Descrição da operação

Esta API permite modificar o nome, o status e as configurações de notificação de uma fila MPS especificada.
Se uma fila MPS estiver pausada, qualquer pipeline ou job individual (como revisão automatizada ou impressão digital de mídia) que utilize essa fila pausada falhará e não poderá prosseguir.

Limite de consultas por segundo (QPS)

O limite de QPS para esta API é de 100 solicitações por segundo por usuário. Se esse limite for excedido, as chamadas de API serão limitadas por taxa, o que pode impactar suas operações de negócios. Invoque a API de forma adequada. Para mais informações, consulte Limites de QPS.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

mts:UpdatePipeline

update

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PipelineId	string	Sim	O ID da fila MPS que você deseja atualizar. Para visualizar o ID da fila MPS, faça login no console do MPS e escolha Configurações Globais > Pipelines no painel de navegação à esquerda.	d1ce4d3efcb549419193f50f1fcd****
Name	string	Sim	O novo nome da fila MPS. O valor pode conter letras, dígitos e caracteres especiais como hifens (-) e pode ter até 128 bytes de tamanho. O valor não pode começar com um caractere especial.	example-pipeline-****
State	string	Sim	O novo estado da fila MPS. Active: A fila MPS está ativa. Os jobs na fila MPS podem ser agendados e executados pelo MPS. Paused: A fila MPS está pausada. Os jobs na fila MPS não podem ser agendados ou executados pelo MPS, e todos os jobs permanecem no estado Submitted. Jobs que estão em execução não serão afetados.	Paused
NotifyConfig	string	Não	A configuração do Message Service (MNS), como as informações sobre a fila ou tópico do MNS. Para mais informações, consulte a seção "NotifyConfig" do tópico Detalhes dos parâmetros.	{"Topic":"example-topic-****"}
Role	string	Não	A role atribuída ao usuário RAM atual. Para obter a role, você pode fazer login no console do Resource Access Management (RAM) e escolher Identidades > Roles no painel de navegação à esquerda.	AliyunMTSDefaultRole
ExtendConfig	string	Não	Configuração de extensão.	{\"IsBoostNew\":true,\"MultiSpeedDowngradePolicy\":\"NormalSpeed\",\"MaxMultiSpeed\":20}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	1FE0F96B-544D-4244-9D83-DFCFB0E5A231
Pipeline	object	Os detalhes da fila MPS.
Speed	string	O 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 que suporta Narrowband HD 2.0 AIVideoCover: Fila MPS para captura inteligente de snapshots AIVideoFPShot: Fila MPS para impressão digital de mídia AIVideoCensor: Fila MPS para revisão automatizada AIVideoMCU: Fila MPS para marcação 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	Standard
State	string	O estado da fila MPS. Valores válidos: Active: A fila MPS está ativa. Paused: A fila MPS está pausada.	Paused
NotifyConfig	object	A configuração do MNS.
MqTopic	string	The queue of messages that are received.	example1,example2
QueueName	string	The queue that is created in MNS.	example-queue-****
MqTag	string	The tags of the messages.	mts-test
Topic	string	The topic that is created in MNS.	example-topic-****
Name	string	O novo nome da fila MPS.	example-pipeline-****
Role	string	A role atribuída ao usuário RAM atual.	AliyunMTSExampleRole
Id	string	O ID da fila MPS.	d1ce4d3efcb549419193f50f1fcd****
QuotaAllocate	integer	A cota alocada para a fila MPS.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "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

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.