GlobalOptions interface

GlobalOptions são opções que podem ser definidas em um projeto inteiro. Essas opções são comuns para HTTPS e funções de manipulação de eventos.

Assinatura:

export interface GlobalOptions 

Propriedades

Propriedade Tipo Descrição
simultaneidade número | Expressão<number> | Redefinir Valor Número de solicitações que uma função pode exibir de uma vez.
CPU número | "gcf_gen1" Número fracionário de CPUs a serem alocadas para uma função.
enforceAppCheck (em inglês) booleano Determina se o Firebase App Check é aplicado. O padrão é "false".
ingressSettings (em inglês) IngressSetting | Redefinir Valor Configurações de entrada que controlam de onde essa função pode ser chamada.
invoker (em inglês) "público" | "privado" | string | string[] Invocador para definir o controle de acesso em funções HTTPS.
rótulos Record<string, string> Rótulos de usuário a serem definidos na função.
maxInstances (link em inglês) número | Expressão<number> | Redefinir Valor Número máximo de instâncias que podem ser executadas em paralelo.
memória MemoryOption | Expressão<number> | Redefinir Valor Quantidade de memória a ser alocada para uma função.
minInstances (link em inglês) número | Expressão<number> | Redefinir Valor Número mínimo de instâncias reais a serem executadas em um determinado momento.
omitir booleano | Expressão<boolean> Se verdadeiro, não implante ou emule essa função.
preserveExternalChanges (link em inglês) booleano Controla se a configuração da função modificada fora da fonte da função é preservada. O padrão é "false".
region supportedRegion | string | Expressão<string> | Redefinir Valor Região onde as funções precisam ser implantadas.
segredos (string | SecretParam)[]
serviceAccount. string | Expressão<string> | Redefinir Valor Conta de serviço específica em que a função será executada.
timeoutSeconds (em inglês) número | Expressão<number> | Redefinir Valor O tempo limite da função é em segundos. Os valores possíveis são de 0 a 540. As funções HTTPS podem especificar um tempo limite maior.
vpcConnector (em inglês) string | Expressão<string> | Redefinir Valor Conectar uma função a um conector de VPC especificado.
vpcConnectorEgressSettings (em inglês) VpcEgressSetting | Redefinir Valor Configurações de saída para o conector VPC.

GlobalOptions.concurrency

Número de solicitações que uma função pode exibir de uma vez.

Pode ser aplicado apenas a funções em execução no Cloud Functions (2a geração). Um valor nulo restaura a simultaneidade padrão (80 quando a CPU é maior que = 1; caso contrário, é 1). A simultaneidade não pode ser definida com qualquer valor diferente de 1 se cpu for menor que 1. O valor máximo para simultaneidade é 1.000.

Assinatura:

concurrency?: number | Expression<number> | ResetValue;

GlobalOptions.cpu

Número fracionário de CPUs a serem alocadas para uma função.

O padrão é 1 para funções com <= 2 GB de RAM e aumenta para tamanhos de memória maiores. Isso é diferente dos padrões ao usar o utilitário gcloud e do valor fixo atribuído no Cloud Functions (1a geração). Para reverter para a quantidade de CPU usada no gcloud ou no Cloud Functions (1a geração), defina-o como o valor "gcf_gen1"

Assinatura:

cpu?: number | "gcf_gen1";

GlobalOptions.enforceAppCheck

Determina se o Firebase App Check é aplicado. O padrão é "false".

Quando verdadeiro, as solicitações com tokens inválidos respondem automaticamente com um erro 401 (não autorizado). Quando "false", as solicitações com tokens inválidos definem event.app como undefined.

Assinatura:

enforceAppCheck?: boolean;

GlobalOptions.ingressSettings

Configurações de entrada que controlam de onde essa função pode ser chamada.

Assinatura:

ingressSettings?: IngressSetting | ResetValue;

GlobalOptions.invoker

Invocador para definir o controle de acesso em funções HTTPS.

Assinatura:

invoker?: "public" | "private" | string | string[];

GlobalOptions.labels

Rótulos de usuário a serem definidos na função.

Assinatura:

labels?: Record<string, string>;

GlobalOptions.maxInstances

Número máximo de instâncias que podem ser executadas em paralelo.

Assinatura:

maxInstances?: number | Expression<number> | ResetValue;

GlobalOptions.memory

Quantidade de memória a ser alocada para uma função.

Assinatura:

memory?: MemoryOption | Expression<number> | ResetValue;

GlobalOptions.minInstances

Número mínimo de instâncias reais a serem executadas em um determinado momento.

As instâncias são faturadas pela alocação de memória e 10% da alocação de CPU enquanto estiverem inativas.

Assinatura:

minInstances?: number | Expression<number> | ResetValue;

GlobalOptions.omit

Se verdadeiro, não implante ou emule essa função.

Assinatura:

omit?: boolean | Expression<boolean>;

GlobalOptions.preserveExternalChanges

Controla se a configuração da função modificada fora da fonte da função é preservada. O padrão é "false".

Ao definir a configuração disponível em uma plataforma subjacente que ainda não está disponível no SDK do Firebase para Cloud Functions, recomendamos definir preserveExternalChanges como true. Caso contrário, quando o Google lançar uma nova versão do SDK compatível com a configuração ausente, a configuração definida manualmente na função poderá ser apagada acidentalmente.

Assinatura:

preserveExternalChanges?: boolean;

GlobalOptions.region

Região onde as funções precisam ser implantadas.

Assinatura:

region?: SupportedRegion | string | Expression<string> | ResetValue;

GlobalOptions.secrets

Assinatura:

secrets?: (string | SecretParam)[];

GlobalOptions.serviceAccount

Conta de serviço específica em que a função será executada.

Assinatura:

serviceAccount?: string | Expression<string> | ResetValue;

GlobalOptions.timeoutSeconds

O tempo limite da função é em segundos. Os valores possíveis são de 0 a 540. As funções HTTPS podem especificar um tempo limite maior.

O tempo limite mínimo para uma função de 2a geração é de 1 s. O tempo limite máximo de uma função depende do tipo dela: as funções de manipulação de eventos têm um tempo limite máximo de 540 segundos (9 minutos). As funções HTTPS e chamáveis têm um tempo limite máximo de 36.000s (1 hora). As funções da fila de tarefas têm um tempo limite máximo de 1.800 segundos (30 minutos).

Assinatura:

timeoutSeconds?: number | Expression<number> | ResetValue;

GlobalOptions.vpcConnector

Conectar uma função a um conector de VPC especificado.

Assinatura:

vpcConnector?: string | Expression<string> | ResetValue;

GlobalOptions.vpcConnectorEgressSettings

Configurações de saída para o conector VPC.

Assinatura:

vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;