Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::FC3::FunctionInvoker

Última atualização: Sep 18, 2026

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:

  • true

  • false (default)

CheckError

Boolean

No

No

Verifica o resultado da invocação.

Valores válidos:

  • true

    Note

    Se definido como true, uma invocação malsucedida faz com que a criação do recurso falhe.

  • false (default)

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:

  • versionId: O número da versão.

  • aliasName: O alias.

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