Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::FC::FunctionInvoker

Última atualização: Jun 27, 2026

Invoca uma função do Function Compute.

Sintaxe

{
  "Type": "ALIYUN::FC::FunctionInvoker",
  "Properties": {
    "Qualifier": String,
    "ServiceName": String,
    "ExecuteVersion": Integer,
    "Async": Boolean,
    "Event": String,
    "FunctionName": String,
    "CheckError": Boolean,
    "ServiceRegionId": String,
    "CheckAsyncInvocation": Map
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ServiceName

String

Sim

Sim

Nome do serviço.

O nome deve ter de 1 a 128 caracteres.

FunctionName

String

Sim

Sim

Nome da função.

Nenhuma.

Async

Boolean

Não

Sim

Defina se a invocação da função será assíncrona.

Valores válidos:

  • true

  • false (padrão)

Event

String

Não

Sim

Payload do evento transmitido à função.

O valor é codificado como string UTF-8 e passado à função durante a execução. Para transmitir uma string binária ou com codificação diferente de UTF-8, codifique o valor em Base64 previamente.

Qualifier

String

Não

Sim

Versão ou alias do serviço.

Valores válidos:

  • versionId

  • aliasName

ExecuteVersion

Integer

Não

Sim

Versão do gatilho de invocação. A função é invocada apenas se você especificar esta propriedade ao criar o recurso.

A função é invocada apenas se você alterar esta propriedade para um novo valor inteiro ao atualizar o recurso.

Nenhuma.

CheckError

Boolean

Não

Não

Defina se o resultado da invocação deve ser verificado.

Valores válidos:

  • true

    Nota

    Se esta propriedade estiver definida como true e a invocação falhar, a criação do recurso também falhará.

  • false (padrão)

ServiceRegionId

String

Não

Não

ID da região do serviço de função.

Nenhuma.

CheckAsyncInvocation

Map

Não

Não

Configurações de verificação para invocações assíncronas.

Para mais informações, consulte Propriedades de CheckAsyncInvocation neste tópico.

Sintaxe de CheckAsyncInvocation

"CheckAsyncInvocation": {
  "Enabled": Boolean,
  "CheckInterval": Integer,
  "CheckTimes": Integer
}

Propriedades de CheckAsyncInvocation

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Enabled

Boolean

Sim

Não

Defina se o resultado da invocação assíncrona deve ser verificado.

Se esta propriedade e Async estiverem definidas como true, o recurso será criado somente após a conclusão da invocação assíncrona e a verificação do resultado.

Valor padrão: false.

CheckInterval

Integer

Sim

Não

Intervalo entre verificações consecutivas do resultado da invocação assíncrona.

Valor padrão: 10. Unidade: segundos.

CheckTimes

Integer

Sim

Não

Número de verificações do resultado da invocação assíncrona.

Valor padrão: 10.

Valores de retorno

Fn::GetAtt

  • ResultType:

    • Se Async for true e ResultType for NoResult, nenhum resultado é retornado.

    • Se Async for false e ResultType for Success, a invocação foi bem-sucedida.

    • Se Async for false e ResultType for Failure, a invocação falhou.

  • Result:

    • Se ResultType for NoResult, o valor de Result será nulo.

    • Se ResultType for Success, o valor de Result corresponderá ao resultado da invocação da função. O resultado retornado deve ser uma string codificada em UTF-8; caso contrário, a invocação falhará. Para retornar uma string binária ou com codificação diferente de UTF-8, codifique o resultado em Base64 previamente.

    • Se ResultType for Failure, uma mensagem de erro será retornada em Result.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  FunctionInvoker:
    Type: ALIYUN::FC::FunctionInvoker
    Properties:
      ServiceName: mytest
      FunctionName: PythonFunc
      ExecuteVersion: 1
Outputs: {}
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "FunctionInvoker": {
      "Type": "ALIYUN::FC::FunctionInvoker",
      "Properties": {
        "ServiceName": "mytest",
        "FunctionName": "PythonFunc",
        "ExecuteVersion": 1.0
      }
    }
  },
  "Outputs": {
  }
}