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

Ver PDF

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