Invoca uma função do Function Compute (FC) 3,0.
Syntax
{
"Type": "ALIYUN::FC3::FunctionInvoker",
"Properties": {
"FunctionName": String,
"Async": Boolean,
"CheckError": Boolean,
"CheckAsyncInvocation": Map,
"ExecuteVersion": Integer,
"Event": String,
"Qualifier": String,
"ServiceRegionId": String
}
}
Properties
Property | Type | Required | Update allowed | Description | Constraints |
FunctionName | String | Yes | Yes | O nome da função. | None |
Async | Boolean | No | Yes | Ativa a invocação assíncrona. | Valores válidos:
|
CheckError | Boolean | No | No | Verifica o resultado da invocação. | Valores válidos:
|
CheckAsyncInvocation | Map | No | No | As configurações para verificações de invocação assíncrona. | Para mais informações, consulte CheckAsyncInvocation properties. |
ExecuteVersion | Integer | No | Yes | Na criação do recurso, a função só é executada se este parâmetro for especificado. Na atualização do recurso, a função só é executada se este valor for alterado para um novo inteiro. | None |
Event | String | No | Yes | A entrada personalizada para a função. | Transmitido à função como uma string codificada em UTF-8. Para transmitir dados binários ou outras codificações, codifique o valor em Base64 antes de enviá-lo. |
Qualifier | String | No | Yes | A versão do service. | Valores válidos:
|
ServiceRegionId | String | No | No | A região do service do Function Compute. | None |
CheckAsyncInvocation syntax
"CheckAsyncInvocation": {
"CheckTimes": Integer,
"CheckInterval": Integer,
"Enabled": Boolean
}
CheckAsyncInvocation properties
|
Property |
Type |
Required |
Update allowed |
Description |
Constraints |
|
CheckTimes |
Integer |
Yes |
No |
O número de verificações dos resultados de invocação assíncrona. |
Padrão: 10. |
|
CheckInterval |
Integer |
Yes |
No |
O intervalo entre as verificações dos resultados de invocação assíncrona. |
Padrão: 10 segundos. |
|
Enabled |
Boolean |
Yes |
No |
Defina se a verificação dos resultados de invocação assíncrona está ativada. |
Se definido como true e a invocação for assíncrona, a criação do recurso aguarda a conclusão e verifica o resultado. Padrão: false. |
Valores de retorno
Fn::GetAtt
-
ResultType: Tipo do resultado da invocação assíncrona.
NoResult: Invocação assíncrona (Async é true). Sem valor de retorno.
Success: Invocação síncrona (Async é false) bem-sucedida.
Failure: Invocação síncrona (Async é false) malsucedida.
-
Result: Resultado da invocação assíncrona.
Se ResultType for NoResult, este atributo estará vazio.
Se ResultType for Success, Result contém o resultado retornado pela operação
invoke function, na forma de uma string cujo conteúdo específico é definido pelo usuário. O resultado retornado deve ser uma string codificada em UTF-8; caso contrário, o ROS considerará que a execução da função falhou. Para retornar dados binários ou uma string em outra codificação, codifique-a em Base64 antes de retorná-la.Se ResultType for Failure, Result contém a mensagem de erro.
Events: Eventos de invocação assíncrona.
TaskId: ID da tarefa de invocação assíncrona.
Exemplos
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
FunctionName:
Type: String
Description:
en: The name of the function.
Required: true
Resources:
FunctionInvoker:
Type: ALIYUN::FC3::FunctionInvoker
Properties:
FunctionName:
Ref: FunctionName
Outputs:
ResultType:
Description: |-
Result type:
NoResult: Async invoke has no result.
Success: Sync invoke succeeds.
Failure: Sync invoke fails.
Value:
Fn::GetAtt:
- FunctionInvoker
- ResultType
Result:
Description: |-
Depends on result type:
NoResult: Async invoke has no result.
Success: The response of the function. The response should be utf-8 encoded string, otherwise ROS will report an error. If the response is binary, encode it via base64 before it is returned.
Failure: Error Message.
Value:
Fn::GetAtt:
- FunctionInvoker
- Result
{
"ROSTemplateFormatVersion": "2015-09-01",
"Parameters": {
"FunctionName": {
"Type": "String",
"Description": {
"en": "The name of the function."
},
"Required": true
}
},
"Resources": {
"FunctionInvoker": {
"Type": "ALIYUN::FC3::FunctionInvoker",
"Properties": {
"FunctionName": {
"Ref": "FunctionName"
}
}
}
},
"Outputs": {
"ResultType": {
"Description": "Result type:\nNoResult: Async invoke has no result.\nSuccess: Sync invoke succeeds.\nFailure: Sync invoke fails.",
"Value": {
"Fn::GetAtt": [
"FunctionInvoker",
"ResultType"
]
}
},
"Result": {
"Description": "Depends on result type:\nNoResult: Async invoke has no result.\nSuccess: The response of the function. The response should be utf-8 encoded string, otherwise ROS will report an error. If the response is binary, encode it via base64 before it is returned.\nFailure: Error Message.",
"Value": {
"Fn::GetAtt": [
"FunctionInvoker",
"Result"
]
}
}
}
}