Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/FunctionGraph/Referencia de la API/Las API/Notificación de ejecución asincrónica/Configuración de la notificación de ejecución asincrónica

Actualización más reciente 2022-11-07 GMT+08:00

Configuración de la notificación de ejecución asincrónica

Función

Esta API se utiliza para configurar la notificación de ejecución asincrónica para una función.

URI

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

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
function_urn	Sí	String	URN de la función. Mínimo: 0 Máximo: 0 Mínimo: 1 Máximo: 269

Parámetros de solicitud

**Tabla 2** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
max_async_event_age_in_seconds	No	Integer	Período de validez máximo de un mensaje. Rango de valores: 1s a 86,400s. Valor predeterminado: 3600s. Mínimo: 1 Máximo: 86400
max_async_retry_attempts	No	Integer	Número máximo de intentos de reintento si falla la invocación asincrónica. Valor predeterminado: 1. Rango de valores: 0–3. Mínimo: 0 Máximo: 3
destination_config	No	FuncAsyncDestinationConfig object	Objetivo de invocación asincrónica.
enable_async_status_log	No	Boolean	Se habilita o no la persistencia de estado de invocación asincrónica.

**Tabla 4** FuncAsyncDestinationConfig
Parámetro	Obligatorio	Tipo	Descripción
on_success	No	FuncDestinationConfig object	Objetivo a ser invocado cuando una función se ejecuta con éxito.
on_failure	No	FuncDestinationConfig object	Objetivo a ser invocado cuando una función no puede ser ejecutada debido a un error del sistema o un error interno.

**Tabla 5** FuncDestinationConfig
Parámetro	Obligatorio	Tipo	Descripción
destination	No	String	Tipo de objeto. OBS SMN DIS FunctionGraph Valores de enumeración: OBS SMN DIS FunctionGraph
param	No	String	Parámetros (en formato JSON) correspondientes al servicio de destino. OBS: se incluyen los parámetros relacionados con el nombre del bucket, el prefijo del directorio de objetos y el tiempo de expiración del objeto. El tiempo de expiración del objeto oscila entre 0 y 365 días. Si el valor es 0, el objeto no caducará. SMN: Se incluye el parámetro topic_urn. DIS: Se incluye el parámetro stream_name. FunctionGraph Se incluye el parámetro func_urn.

Parámetros de respuesta

Código de estado: 200

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
func_urn	String	URN de la función. Mínimo: 1 Máximo: 269
max_async_event_age_in_seconds	Integer	Período de validez máximo de un mensaje. Rango de valores: 60–86,400. Unidad: segundo.
max_async_retry_attempts	Integer	Número máximo de intentos de reintento si falla la invocación asincrónica. Valor predeterminado: 3. Rango de valores: 0–8.
destination_config	FuncAsyncDestinationConfig object	Objetivo de invocación asincrónica.
created_time	String	Hora en que se configuró la notificación de ejecución asincrónica.
last_modified	String	Hora en la que se modificó por última vez la configuración de notificación de ejecución asincrónica.
enable_async_status_log	Boolean	Se habilita o no la persistencia de estado de invocación asincrónica.

**Tabla 7** FuncAsyncDestinationConfig
Parámetro	Tipo	Descripción
on_success	FuncDestinationConfig object	Objetivo a ser invocado cuando una función se ejecuta con éxito.
on_failure	FuncDestinationConfig object	Objetivo a ser invocado cuando una función no puede ser ejecutada debido a un error del sistema o un error interno.

**Tabla 8** FuncDestinationConfig
Parámetro	Tipo	Descripción
destination	String	Tipo de objeto. OBS SMN DIS FunctionGraph Valores de enumeración: OBS SMN DIS FunctionGraph
param	String	Parámetros (en formato JSON) correspondientes al servicio de destino. OBS: se incluyen los parámetros relacionados con el nombre del bucket, el prefijo del directorio de objetos y el tiempo de expiración del objeto. El tiempo de expiración del objeto oscila entre 0 y 365 días. Si el valor es 0, el objeto no caducará. SMN: Se incluye el parámetro topic_urn. DIS: Se incluye el parámetro stream_name. FunctionGraph Se incluye el parámetro func_urn.

Código de estado: 400

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Código de estado: 404

**Tabla 10** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Ejemplo de las solicitudes

Configurar la notificación de ejecución asíncrona para una función.

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

Ejemplo de las respuestas

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

Códigos de estado

Código de estado	Descripción
200	Aceptar
400	Error en la solicitud
404	No se ha encontrado

Códigos de error

Consulte Códigos de error.

Tema principal:Notificación de ejecución asincrónica

Tema anterior: Eliminación de la configuración de notificación de ejecución asincrónica

Tema siguiente: Consulta de configuración de notificación de ejecución asincrónica de todas las versiones de una función

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.