Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ FunctionGraph/ Referência de API/ As API/ Notificação de execução assíncrona/ Configuração da notificação de execução assíncrona

Atualizado em 2022-11-08 GMT+08:00

Ver PDF

Configuração da notificação de execução assíncrona

Função

Essa API é usada para configurar a notificação de execução assíncrona de uma função.

URI

PUT /v2/{project_id}/fgs/functions/{function_urn}/async-invoke-config

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
function_urn	Sim	String	o URN da função. Mínimo: 0 Máximo: 0 Mínimo: 1 Máximo: 269

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

**Tabela 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
max_async_event_age_in_seconds	Não	Integer	Período máximo de validade de uma mensagem. Faixa de valor: 1s para 86.400s. Valor padrão: 3600s. Mínimo: 1 Máximo: 86400
max_async_retry_attempts	Não	Integer	Número máximo de tentativas a serem feitas se a invocação assíncrona falhar. Valor padrão: 1. Faixa de valor: 0–3. Mínimo: 0 Máximo: 3
destination_config	Não	FuncAsyncDestinationConfig object	Destino de invocação assíncrona.
enable_async_status_log	Não	Boolean	Se ativar a persistência do status de invocação assíncrona.

**Tabela 4** FuncAsyncDestinationConfig
Parâmetro	Obrigatório	Tipo	Descrição
on_success	Não	objeto FuncDestinationConfig	Destino a ser chamado quando uma função é executada com sucesso.
on_failure	Não	FuncDestinationConfig object	Alvo a ser invocado quando uma função falha ao ser executada devido a um erro do sistema ou um erro interno.

**Tabela 5** FuncDestinationConfig
Parâmetro	Obrigatório	Tipo	Descrição
destination	Não	String	Tipo de objeto. OBS SMN DIS FunctionGraph Valores de enumeração: OBS SMN DIS FunctionGraph
param	Não	String	Parâmetros (em formato JSON) correspondentes ao serviço de destino. OBS: Os parâmetros relacionados ao nome do intervalo, prefixo do diretório de objetos e tempo de expiração do objeto estão incluídos. O tempo de expiração do objeto varia de 0 a 365 dias. Se o valor for 0, o objeto não expirará. SMN: O parâmetro topic_urn está incluído. DIS: O parâmetro stream_name está incluído. FunctionGraph: O parâmetro func_urn está incluído.

Parâmetros de resposta

Código de estado: 200

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
func_urn	String	o URN da função. Mínimo: 1 Máximo: 269
max_async_event_age_in_seconds	Integer	Período máximo de validade de uma mensagem. Faixa de valor: 60–86.400. Unidade: segundo.
max_async_retry_attempts	Integer	Número máximo de tentativas a serem feitas se a invocação assíncrona falhar. Valor padrão: 3. Faixa de valor: 0–8.
destination_config	FuncAsyncDestinationConfig object	Destino de invocação assíncrona.
created_time	String	Hora em que a notificação de execução assíncrona foi configurada.
last_modified	String	Hora em que as configurações de notificação de execução assíncrona foram modificadas pela última vez.
enable_async_status_log	Boolean	Se ativar a persistência do status de invocação assíncrona.

**Tabela 7** FuncAsyncDestinationConfig
Parâmetro	Tipo	Descrição
on_success	FuncDestinationConfig object	Destino a ser chamado quando uma função é executada com sucesso.
on_failure	FuncDestinationConfig object	Alvo a ser invocado quando uma função falha ao ser executada devido a um erro do sistema ou um erro interno.

**Tabela 8** FuncDestinationConfig
Parâmetro	Tipo	Descrição
destination	String	Tipo de objeto. OBS SMN DIS FunctionGraph Valores de enumeração: OBS SMN DIS FunctionGraph
param	String	Parâmetros (em formato JSON) correspondentes ao serviço de destino. OBS: Os parâmetros relacionados ao nome do intervalo, prefixo do diretório de objetos e tempo de expiração do objeto estão incluídos. O tempo de expiração do objeto varia de 0 a 365 dias. Se o valor for 0, o objeto não expirará. SMN: O parâmetro topic_urn está incluído. DIS: O parâmetro stream_name está incluído. FunctionGraph: O parâmetro func_urn está incluído.

Código de estado: 400

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Código de estado: 404

**Tabela 10** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Exemplos de solicitações

Configurar notificação de execução assíncrona para uma função.

PUT /v2/{project_id}/fgs/functions/{function_urn}/async-invoke-config { "max_async_event_age_in_seconds" : 10, "max_async_retry_attempts" : 3, "enable_async_status_log" : true }

Exemplo de respostas

Código de estado: 200

{ "func_urn" : "urn:fss:xxxxxxxxx:7aad83af3e8d42e99ac194xxxxxxxxxx:function:default:test:latest", "max_async_event_age_in_seconds" : 60, "max_async_retry_attempts" : 1, "destination_config" : { "on_success" : { "destination" : "FunctionGraph", "param" : "{\"func_urn\":\"urn:fss:{region}:5691ba790e2b46ceb38316xxxxxxxxxx:function:default:testPython:latest\"}" }, "on_failure" : { "destination" : "FunctionGraph", "param" : "{\"func_urn\":\"urn:fss:{region}:5691ba790e2b46ceb38316xxxxxxxxxx:function:default:testPython:latest\"}" } }, "created_time" : "2021-03-04T14:50:02+08:00", "last_modified" : "2021-03-04T14:50:02+08:00" }