GlobalOptions
sont des options qui peuvent être définies sur l'ensemble d'un projet. Ces options sont communes aux fonctions HTTPS et de gestion d’événements.
Signature:
export interface GlobalOptions
Propriétés
Propriété | Taper | Description |
---|---|---|
concurrence | numéro | Expression <numéro> | Réinitialiser la valeur | Nombre de requêtes qu'une fonction peut traiter en même temps. |
CPU | numéro | "gcf_gen1" | Nombre fractionnaire de processeurs à allouer à une fonction. |
appliquerAppCheck | booléen | Détermine si Firebase App Check est appliqué. La valeur par défaut est false. |
paramètres d'entrée | Paramètres d'entrée | Réinitialiser la valeur | Paramètres d'entrée qui contrôlent d'où cette fonction peut être appelée. |
invocateur | "publique" | "privé" | chaîne | chaîne[] | Invocateur pour définir le contrôle d’accès sur les fonctions HTTPS. |
Étiquettes | Enregistrer<string, string> | Libellés utilisateur à définir sur la fonction. |
maxInstances | numéro | Expression <numéro> | Réinitialiser la valeur | Nombre maximum d'instances pouvant s'exécuter en parallèle. |
mémoire | Option mémoire | Expression <numéro> | Réinitialiser la valeur | Quantité de mémoire à allouer à une fonction. |
minInstances | numéro | Expression <numéro> | Réinitialiser la valeur | Nombre minimum d'instances réelles à exécuter à un moment donné. |
omettre | booléen | Expression <booléen> | Si c’est vrai, ne déployez pas et n’émulez pas cette fonction. |
préserver les changements externes | booléen | Contrôle si la configuration de la fonction modifiée en dehors de la source de la fonction est conservée. La valeur par défaut est false. |
région | Région prise en charge | chaîne | Expression <chaîne> | Réinitialiser la valeur | Région où les fonctions doivent être déployées. |
secrets | (chaîne | SecretParam)[] | |
compte de service | chaîne | Expression <chaîne> | Réinitialiser la valeur | Compte de service spécifique sous lequel la fonction doit être exécutée. |
timeoutSecondes | numéro | Expression <numéro> | Réinitialiser la valeur | Délai d'expiration de la fonction en secondes, les valeurs possibles sont comprises entre 0 et 540. Les fonctions HTTPS peuvent spécifier un délai d'expiration plus élevé. |
vpcConnecteur | chaîne | Expression <chaîne> | Réinitialiser la valeur | Connectez une fonction à un connecteur VPC spécifié. |
vpcConnectorEgressSettings | VpcEgressSetting | Réinitialiser la valeur | Paramètres de sortie pour le connecteur VPC. |
GlobalOptions.concurrency
Nombre de requêtes qu'une fonction peut traiter en même temps.
Peut être appliqué uniquement aux fonctions exécutées sur Cloud Functions (2e génération)). Une valeur null restaure la concurrence par défaut (80 lorsque CPU > = 1, 1 sinon). La simultanéité ne peut pas être définie sur une valeur autre que 1 si cpu
est inférieur à 1. La valeur maximale de la simultanéité est de 1 000.
Signature:
concurrency?: number | Expression<number> | ResetValue;
GlobalOptions.cpu
Nombre fractionnaire de processeurs à allouer à une fonction.
La valeur par défaut est 1 pour les fonctions avec < = 2 Go de RAM et augmente pour les tailles de mémoire plus grandes. Ceci est différent des valeurs par défaut lors de l'utilisation de l'utilitaire gcloud et du montant fixe attribué dans Cloud Functions (1re génération). Pour revenir aux quantités de processeur utilisées dans gcloud ou dans Cloud Functions (1re génération), définissez cette valeur sur la valeur "gcf_gen1".
Signature:
cpu?: number | "gcf_gen1";
GlobalOptions.enforceAppCheck
Détermine si Firebase App Check est appliqué. La valeur par défaut est false.
Lorsque cela est vrai, les demandes contenant des jetons non valides répondent automatiquement avec une erreur 401 (non autorisée). Lorsqu'elles sont fausses, les requêtes avec des jetons non valides définissent event.app
sur undefined
.
Signature:
enforceAppCheck?: boolean;
GlobalOptions.ingressSettings
Paramètres d'entrée qui contrôlent d'où cette fonction peut être appelée.
Signature:
ingressSettings?: IngressSetting | ResetValue;
GlobalOptions.invoker
Invocateur pour définir le contrôle d’accès sur les fonctions HTTPS.
Signature:
invoker?: "public" | "private" | string | string[];
GlobalOptions.labels
Libellés utilisateur à définir sur la fonction.
Signature:
labels?: Record<string, string>;
GlobalOptions.maxInstances
Nombre maximum d'instances pouvant s'exécuter en parallèle.
Signature:
maxInstances?: number | Expression<number> | ResetValue;
GlobalOptions.mémoire
Quantité de mémoire à allouer à une fonction.
Signature:
memory?: MemoryOption | Expression<number> | ResetValue;
GlobalOptions.minInstances
Nombre minimum d'instances réelles à exécuter à un moment donné.
Les instances sont facturées pour l'allocation de mémoire et 10 % de l'allocation de processeur lorsqu'elles sont inactives.
Signature:
minInstances?: number | Expression<number> | ResetValue;
GlobalOptions.omit
Si c’est vrai, ne déployez pas et n’émulez pas cette fonction.
Signature:
omit?: boolean | Expression<boolean>;
GlobalOptions.preserveExternalChanges
Contrôle si la configuration de la fonction modifiée en dehors de la source de la fonction est conservée. La valeur par défaut est false.
Lors de la définition d'une configuration disponible sur une plate-forme sous-jacente qui n'est pas encore disponible dans le SDK Firebase pour Cloud Functions, nous vous recommandons de définir preserveExternalChanges
sur true
. Sinon, lorsque Google publie une nouvelle version du SDK prenant en charge la configuration manquante, le paramètre configuré manuellement de votre fonction risque d'être effacé par inadvertance.
Signature:
preserveExternalChanges?: boolean;
GlobalOptions.region
Région où les fonctions doivent être déployées.
Signature:
region?: SupportedRegion | string | Expression<string> | ResetValue;
GlobalOptions.secrets
Signature:
secrets?: (string | SecretParam)[];
GlobalOptions.serviceAccount
Compte de service spécifique sous lequel la fonction doit être exécutée.
Signature:
serviceAccount?: string | Expression<string> | ResetValue;
GlobalOptions.timeoutSeconds
Délai d'expiration de la fonction en secondes, les valeurs possibles sont comprises entre 0 et 540. Les fonctions HTTPS peuvent spécifier un délai d'expiration plus élevé.
Le délai d'attente minimum pour une fonction de 2e génération est de 1 s. Le délai d'attente maximum pour une fonction dépend du type de fonction : Les fonctions de gestion d'événements ont un délai d'attente maximum de 540 s (9 minutes). HTTPS et les fonctions appelables ont un délai d'attente maximum de 36,00 s (1 heure). Les fonctions de file d'attente de tâches ont un délai d'expiration maximum de 1 800 s (30 minutes).
Signature:
timeoutSeconds?: number | Expression<number> | ResetValue;
GlobalOptions.vpcConnector
Connectez une fonction à un connecteur VPC spécifié.
Signature:
vpcConnector?: string | Expression<string> | ResetValue;
GlobalOptions.vpcConnectorEgressSettings
Paramètres de sortie pour le connecteur VPC.
Signature:
vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;