GlobalOptions
son opciones que se pueden establecer en todo un proyecto. Estas opciones son comunes a HTTPS y a las funciones de control de eventos.
Firma:
export interface GlobalOptions
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
simultaneidad | número | Expresión<número> | RestablecerValor | Cantidad de solicitudes que puede entregar una función a la vez. |
CPU | número | “gcf_gen1” | Cantidad fraccionaria de CPU para asignar a una función. |
aplicar la verificación de aplicaciones | booleano | Determina si se aplica la Verificación de aplicaciones de Firebase. La configuración predeterminada es "false". |
ingressSettings | IngressSetting | RestablecerValor | Son parámetros de configuración de entrada que controlan desde dónde se puede llamar a esta función. |
invocador | “público” | “privado” | cadena | cadena | Invocador para configurar el control de acceso en las funciones HTTPS. |
etiquetas | Registro<cadena, cadena> | Son las etiquetas de usuario que se deben configurar en la función. |
instanciasmax | número | Expresión<número> | RestablecerValor | La cantidad máxima de instancias que se pueden ejecutar en paralelo. |
memoria | MemoryOption | Expresión<número> | RestablecerValor | Cantidad de memoria para asignar a una función. |
instanciasmin | número | Expresión<número> | RestablecerValor | Cantidad mínima de instancias reales que se ejecutarán en un momento determinado. |
omitir | booleano | Expresión<booleano> | Si es verdadero, no implementes ni emules esta función. |
conservación de los cambios externos | booleano | Controla si se conserva la configuración modificada de la función fuera de la fuente de la función. La configuración predeterminada es "false". |
region | SupportedRegion | cadena | Expresión<string> | RestablecerValor | La región en la que se deben implementar las funciones. |
secretos | (cadena | SecretParam)[] | |
serviceAccount | cadena | Expresión<string> | RestablecerValor | Cuenta de servicio específica con la que se ejecutará la función. |
timeoutSeconds | número | Expresión<número> | RestablecerValor | Es el tiempo de espera de la función en segundos. Los valores posibles son de 0 a 540. Las funciones HTTPS pueden especificar un tiempo de espera mayor. |
vpcConnector | cadena | Expresión<string> | RestablecerValor | Conecta una función a un conector de VPC especificado. |
vpcConnectorEgressSettings | VpcEgressSetting | RestablecerValor | Configuración de salida para el conector de VPC. |
GlobalOptions.concurrency
Cantidad de solicitudes que puede entregar una función a la vez.
Solo se puede aplicar a las funciones que se ejecutan en Cloud Functions (2a gen.)). Un valor nulo restablece la simultaneidad predeterminada (80 cuando CPU >= 1, 1 en caso contrario). No se puede establecer la simultaneidad en ningún valor que no sea 1 si cpu
es menor que 1. El valor máximo para la simultaneidad es 1,000.
Firma:
concurrency?: number | Expression<number> | ResetValue;
GlobalOptions.cpu
Cantidad fraccionaria de CPU para asignar a una función.
El valor predeterminado es 1 para las funciones con <= 2 GB de RAM y aumenta para tamaños de memoria más grandes. Esto es diferente de los valores predeterminados cuando se usa la utilidad de gcloud y es diferente del importe fijo asignado en Cloud Functions (1a gen.). Para revertir a las cantidades de CPU usadas en gcloud o en Cloud Functions (1a gen.), establece esto en el valor “gcf_gen1”
Firma:
cpu?: number | "gcf_gen1";
GlobalOptions.enforceAppCheck.
Determina si se aplica la Verificación de aplicaciones de Firebase. La configuración predeterminada es "false".
Cuando es verdadero, las solicitudes con tokens no válidos responden automáticamente con un error 401 (No autorizado). Cuando es falsa, las solicitudes con tokens no válidos establecen event.app
en undefined
.
Firma:
enforceAppCheck?: boolean;
GlobalOptions.ingressSettings
Son parámetros de configuración de entrada que controlan desde dónde se puede llamar a esta función.
Firma:
ingressSettings?: IngressSetting | ResetValue;
GlobalOptions.Invoker
Invocador para configurar el control de acceso en las funciones HTTPS.
Firma:
invoker?: "public" | "private" | string | string[];
GlobalOptions.labels
Son las etiquetas de usuario que se deben configurar en la función.
Firma:
labels?: Record<string, string>;
GlobalOptions.maxInstances
La cantidad máxima de instancias que se pueden ejecutar en paralelo.
Firma:
maxInstances?: number | Expression<number> | ResetValue;
GlobalOptions.memory
Cantidad de memoria para asignar a una función.
Firma:
memory?: MemoryOption | Expression<number> | ResetValue;
GlobalOptions.minInstances
Cantidad mínima de instancias reales que se ejecutarán en un momento determinado.
Las instancias se facturan por la asignación de memoria y por el 10% de la asignación de CPU mientras estén inactivas.
Firma:
minInstances?: number | Expression<number> | ResetValue;
GlobalOptions.omit.
Si es verdadero, no implementes ni emules esta función.
Firma:
omit?: boolean | Expression<boolean>;
GlobalOptions.preserveExternalChanges
Controla si se conserva la configuración modificada de la función fuera de la fuente de la función. La configuración predeterminada es "false".
Cuando establezcas la configuración disponible en una plataforma subyacente que aún no está disponible en el SDK de Firebase para Cloud Functions, te recomendamos establecer preserveExternalChanges
en true
. De lo contrario, cuando Google lanza una nueva versión del SDK compatible con la configuración que falta, es posible que la configuración manual de la función se borre sin darte cuenta.
Firma:
preserveExternalChanges?: boolean;
GlobalOptions.region
La región en la que se deben implementar las funciones.
Firma:
region?: SupportedRegion | string | Expression<string> | ResetValue;
GlobalOptions.secrets
Firma:
secrets?: (string | SecretParam)[];
GlobalOptions.serviceAccount.
Cuenta de servicio específica con la que se ejecutará la función.
Firma:
serviceAccount?: string | Expression<string> | ResetValue;
GlobalOptions.timeoutSeconds
Es el tiempo de espera de la función en segundos. Los valores posibles son de 0 a 540. Las funciones HTTPS pueden especificar un tiempo de espera mayor.
El tiempo de espera mínimo para una función de 2a gen. es de 1 s. El tiempo de espera máximo de una función depende del tipo de función: las funciones de control de eventos tienen un tiempo de espera máximo de 540 s (9 minutos). Las funciones HTTPS y que admiten llamadas tienen un tiempo de espera máximo de 36,00 s (1 hora). Las funciones de lista de tareas en cola tienen un tiempo de espera máximo de 1,800 s (30 minutos).
Firma:
timeoutSeconds?: number | Expression<number> | ResetValue;
GlobalOptions.vpcConnector
Conecta una función a un conector de VPC especificado.
Firma:
vpcConnector?: string | Expression<string> | ResetValue;
GlobalOptions.vpcConnectorEgressSettings
Configuración de salida para el conector de VPC.
Firma:
vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;