UpdateEventSource - EventBridge: Central de Documentação do Alibaba Cloud

Atualiza a configuração de uma origem de evento.

Descrição da operação

Atualiza a configuração de uma origem de evento.

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

eventbridge:UpdateEventSource

update

*EventSource.

acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#EventBusName}/eventsource/{#EventSourceName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
EventSourceName	string	Sim	O nome da origem de evento.	myrabbitmq.source
Description	string	Não	A descrição da origem de evento.	Event source of the RabbitMQ type
LinkedExternalSource	boolean	Não	Especifica se deve conectar a uma origem de dados externa.	true
ExternalSourceType	string	Não	O tipo da origem de dados externa.	SLS
ExternalSourceConfig	object	Não	A configuração da origem de dados externa.	{\"ConsumePosition\":\"end\",\"LogStore\":\"oss_log\",\"Project\":\"slsaudit-center-5795350335281001-cn-beijing\",\"RoleName\":\"sls-beijing-tf\"}
EventBusName	string	Sim	O nome do barramento de eventos associado.	my-event-bus
SourceMNSParameters	object	Não	Os parâmetros para uma origem de evento do Simple Message Queue (anteriormente MNS).
RegionId	string	Não	A região onde a fila do Simple Message Queue (anteriormente MNS) reside.	cn-beijing
QueueName	string	Não	O nome da fila do Simple Message Queue (anteriormente MNS).	queue_api_bind_1672194645178
IsBase64Decode	boolean	Não	Especifica se a decodificação Base64 deve ser ativada. Valor padrão: true.	true
SourceRocketMQParameters	object	Não	O parâmetro de solicitação SourceRocketMQParameters.
RegionId	string	Não	A região onde a instância do ApsaraMQ for RocketMQ reside.	cn-zhangjiakou
InstanceId	string	Não	O ID da instância do ApsaraMQ for RocketMQ. Para mais informações, consulte Limites.	dbaudit-cn-i7m2nx****
Topic	string	Não	O nome do tópico da instância do ApsaraMQ for RocketMQ. Para mais informações, consulte Limites.	topic_default_195820716552192
Tag	string	Não	A tag de filtro da mensagem.	KEY2
Offset	string	Não	O deslocamento de consumo da mensagem. Valores válidos: CONSUME_FROM_LAST_OFFSET: Consome mensagens a partir do deslocamento mais recente. CONSUME_FROM_FIRST_OFFSET: Consome mensagens a partir do deslocamento mais antigo. CONSUME_FROM_TIMESTAMP: Consome mensagens a partir do deslocamento em um ponto específico no tempo. Valor padrão: CONSUME_FROM_LAST_OFFSET.	CONSUMEFROMLASTOFFSET
Timestamp	integer	Não	O carimbo de data e hora. Este parâmetro só entra em vigor quando o parâmetro Offset é definido como CONSUME_FROM_TIMESTAMP.	1663555399032
GroupID	string	Não	O ID do grupo da instância do ApsaraMQ for RocketMQ.	GID-test
InstanceType	string	Não	O tipo de instância. Valores válidos: Cloud_4: Instância 4.0. Cloud_5: Instância 5.0.	Cloud_4
InstanceNetwork	string	Não	O tipo de rede.	PublicNetwork
InstanceVpcId	string	Não	O ID da VPC. Este parâmetro é obrigatório para VPCs.	vpc-bp1a4gmlk31hyg6pt****
InstanceVSwitchIds	string	Não	O ID do vSwitch. Este parâmetro é obrigatório para VPCs.	vsw-bp10rbrt6rb6vrd89****
InstanceSecurityGroupId	string	Não	O ID do grupo de segurança. Este parâmetro é obrigatório para VPCs.	sg-catalog-eventlistener
AuthType	string	Não	O tipo de autenticação. Defina o valor como ACL ou deixe-o vazio.	ACL
InstanceEndpoint	string	Não	O endpoint da instância.	registry-vpc****.aliyuncs.com
InstanceUsername	string	Não	O nome de usuário da instância.	root
InstancePassword	string	Não	A senha da instância.	yourPassword
SourceRabbitMQParameters	object	Não	O parâmetro de solicitação SourceRabbitMQParameters.
RegionId	string	Não	A região onde a instância do ApsaraMQ for RabbitMQ reside.	cn-hangzhou
InstanceId	string	Não	O ID da instância do ApsaraMQ for RabbitMQ. Para mais informações, consulte Limites.	bastionhost-cn-7mz2zky****
VirtualHostName	string	Não	O nome do vhost da instância do ApsaraMQ for RabbitMQ. Para mais informações, consulte Limites.	amqp-cn-nif22u74****
QueueName	string	Não	eb-connect: O nome da fila na instância do ApsaraMQ for RabbitMQ. Para mais informações, consulte Limites.	eb-connect
SourceSLSParameters	object	Não	Os parâmetros para uma origem de evento do Simple Log Service.
Project	string	Não	O projeto do Simple Log Service.	VideoTestProject
LogStore	string	Não	O Logstore do Simple Log Service.	waf-logstore
ConsumePosition	string	Não	O deslocamento inicial de consumo. Você pode definir este parâmetro como begin para consumir a partir do deslocamento mais antigo, end para consumir a partir do deslocamento mais recente, ou um carimbo de data e hora específico em segundos para consumir a partir de um ponto específico no tempo.	end
RoleName	string	Não	Ao autorizar o EventBridge a usar esta função para ler o conteúdo de log do Simple Log Service, as seguintes condições devem ser atendidas: ao criar a função no console do Resource Access Management (RAM), você deve selecionar Alibaba Cloud Service e selecionar EventBridge como o serviço confiável. Para a política de permissão desta função, consulte a origem de evento personalizada do Simple Log Service.	testRole
SourceScheduledEventParameters	object	Não	O parâmetro de solicitação SourceScheduledEventParameters.
Schedule	string	Não	A expressão cron.	10 * * * * *
TimeZone	string	Não	O fuso horário para a expressão cron.	GMT+0:00
UserData	string	Não	A string JSON.	{"a": "b"}
SourceHttpEventParameters	object	Não	O parâmetro de solicitação SourceHttpEventParameters.
Type	string	Não	O tipo de protocolo suportado pelo webhook gerado. Valores válidos: HTTP HTTPS HTTP&HTTPS	HTTPS
Method	array	Não	Os métodos de solicitação HTTP suportados pelo webhook gerado. Você pode selecionar vários valores. Valores válidos: GET POST PUT PATCH DELETE HEAD OPTIONS TRACE CONNECT
	string	Não	Os métodos de solicitação HTTP suportados pelo webhook gerado. Você pode selecionar vários valores. Valores válidos: GET POST PUT PATCH DELETE HEAD OPTIONS TRACE CONNECT	GET
SecurityConfig	string	Não	O tipo da configuração de segurança. Valores válidos: none: Nenhuma configuração é necessária. ip: Bloco CIDR. referer: Nome de domínio seguro.	none
Ip	array	Não	O bloco CIDR para configuração de segurança. Este parâmetro é obrigatório apenas quando o parâmetro SecurityConfig é definido como ip. Você pode inserir um bloco CIDR ou um endereço IP.
	string	Não	O bloco CIDR para configuração de segurança. Este parâmetro é obrigatório apenas quando o parâmetro SecurityConfig é definido como ip. Você pode inserir um bloco CIDR ou um endereço IP.	47.252.126.0/24
Referer	array	Não	O nome de domínio seguro para configuração de segurança. Este parâmetro é obrigatório apenas quando o parâmetro SecurityConfig é definido como referer. Você pode inserir um nome de domínio.
	string	Não	O nome de domínio seguro para configuração de segurança. Este parâmetro é obrigatório apenas quando o parâmetro SecurityConfig é definido como referer. Você pode inserir um nome de domínio.	aliyundoc.com
SourceKafkaParameters	object	Não	O parâmetro de solicitação SourceKafkaParameters.
InstanceId	string	Não	O ID da instância.	cbwp-bp1o3m66wcjgbkssm3****
ConsumerGroup	string	Não	O ID do grupo do consumidor que assina o tópico.	dsp_online_ml_request
Topic	string	Não	O nome do tópico.	billing_notify
OffsetReset	string	Não	O deslocamento de consumo.	latest
RegionId	string	Não	O ID da região.	cn-shanghai
MaximumTasks	integer	Não	A cota de simultaneidade, que é o número de consumidores.	1
Network	string	Não	A configuração de rede. Valores válidos: Default e PublicNetwork.	Default
SecurityGroupId	string	Não	O ID do grupo de segurança. Este parâmetro é obrigatório para redes autogerenciadas.	sg-5wz3mjgo9wpvdnwpwnhkj****
VpcId	string	Não	O ID da VPC. Este parâmetro é obrigatório para redes autogerenciadas.	vpc-2zefu4vfmx6sioguj****
VSwitchIds	string	Não	O ID do vSwitch. Este parâmetro é obrigatório para redes autogerenciadas.	vsw-bp1xyntcxiwplhqxj****
SourceOSSEventParameters	object	Não	Os parâmetros para uma origem de evento do OSS.
EventTypes	array	Não	A lista de tipos de evento.
	string	Não	O tipo de evento.	ObjectCreated:PutObject
StsRoleArn	string	Não	O ARN da função STS.	acs:eventbridge:cn-hangzhou:**
MatchRules	array<object>	Não	As regras de correspondência.
	array<object>	Não	Um conjunto de regras de correspondência.
	object	Não
Suffix	string	Não	The suffix.	/document
MatchState	boolean	Não	The match state.
Prefix	string	Não	The prefix.	fun/document/
Name	string	Não	The name.	bucketName

Exemplo de solicitação: `POST /openapi/updateEventSource HTTP/1.1 Host: 164901546557****.eventbridge.cn-hangzhou.aliyuncs.com Date: Sat, 18 Apr 2020 05:30:41 GMT x-eventbridge-version: 2020-04-01 Authorization: acs vZ3VL0SuJdHi****:Jo2PbT******azYAYoYslKLvWzg= Content-Type: application/json;charset=UTF-8 Content-Length: 26

{ "EventSourceName":"myRocketMQ.source", "Description":"RocketMQ event source", "SourceRocketMQParameters":{ "InstanceId":"MQ_INST_164901546557_BAAN", "GroupID":"GID_group1", "Topic":"mytopic", "Offset":"CONSUME_FROM_LAST_OFFSET", "Tag":"test", "RegionId":"cn-hangzhou" }, "EventBusName":"my-event-bus" }`

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros do corpo da resposta.
Message	string	A mensagem de erro.	Remote error. requestId: [xxxx-9D10-65DFDFA3A75D], error code: [EventSourceNotExist], message: [The event source in request is not exist! ]
RequestId	string	O identificador exclusivo gerado pelo Alibaba Cloud para a solicitação.	c057d379-ea65-41ec-a8a8-90627a9****
Data	boolean	O resultado da atualização.	true
Code	string	O código de resposta da API: Success: indica sucesso. Outros valores: indicam códigos de erro. Para mais informações, consulte Códigos de erro.	Success
Success	boolean	Indica se a operação foi bem-sucedida.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "Remote error. requestId: [xxxx-9D10-65DFDFA3A75D], error code: [EventSourceNotExist], message: [The event source in request is not exist! ]",
  "RequestId": "c057d379-ea65-41ec-a8a8-90627a9****",
  "Data": true,
  "Code": "Success",
  "Success": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	ServiceNotEnable	Service not enable

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.