Quotas et limites

Ce document répertorie les quotas et limites qui s'appliquent à Media CDN.

Un quota limite la quantité d'une ressource Google Cloud partagée particulière que votre projet cloud peut utiliser, y compris les composants matériels, logiciels et réseau.

Les quotas font partie d'un système qui effectue les opérations suivantes :

Surveille votre utilisation ou votre consommation des produits et services Google Cloud
Limite la consommation de ces ressources pour des raisons telles que l'équité et la réduction des pics d'utilisation
Gère des configurations qui appliquent automatiquement des restrictions recommandées
Fournit un moyen de modifier le quota ou de demander des modifications

Dans la plupart des cas, lorsqu'un quota est dépassé, le système bloque immédiatement l'accès à la ressource Google concernée et la tâche que vous essayez d'effectuer échoue. Dans la plupart des cas, les quotas s'appliquent à chaque projet Cloud. Ils sont partagés entre toutes les applications et adresses IP qui utilisent ce projet.

Il existe également des limites pour les ressources Media CDN. Ces limites ne sont pas liées au système de quotas. Sauf indication contraire, les limites ne peuvent pas être modifiées.

Limites

Configuration

Élément	Limites	Remarques
Nombre maximum de `EdgeCacheService`	20 par projet	Contactez l'équipe commerciale Google Cloud si vous souhaitez augmenter cette limite.
Nombre maximum de `EdgeCacheOrigin`	30 par projet	Contactez l'équipe commerciale Google Cloud si vous souhaitez augmenter cette limite.
Nombre maximum de `EdgeCacheKeyset`	10 par projet	Contactez l'équipe commerciale Google Cloud si vous souhaitez augmenter cette limite.
Nombre maximal de `RouteRules` par `EdgeCacheService`	640	Chaque `EdgeCacheService` peut définir jusqu'à 10 `PathMatchers`, et chaque `PathMatcher` peut définir jusqu'à 64 `RouteRules`. Cette limite ne peut pas être augmentée.
Nombre maximal de certificats SSL par service	5	Cette limite ne peut pas être augmentée. Reportez-vous également au quota par projet pour les certificats SSL.
Nombre maximal de clés publiques par `EdgeCacheKeyset`	3	Cette limite ne peut pas être augmentée. Les multiples clés d'une collection de clés sont conçues pour permettre une rotation des clés : vous devez supprimer les clés plus anciennes et inutilisées au fil du temps.
Nombre maximal de clés partagées de validation par `EdgeCacheKeyset`	3	Cette limite ne peut pas être augmentée. Les multiples clés d'une collection de clés sont conçues pour permettre une rotation des clés : vous devez supprimer les clés plus anciennes et inutilisées au fil du temps.

En-têtes, requêtes et réponses HTTP

Élément	Limites	Remarques
Taille maximale de l'en-tête de requête	Environ 11 Kio	Cette limite ne peut pas être augmentée. La taille combinée de l'URL et de l'en-tête de requête est limitée à 15 Kio. Les requêtes sont rejetées avec une réponse HTTP 431 pour les connexions HTTP/1.1. Les connexions HTTP/2 sont fermées sans écrire de code de réponse. Ces requêtes sont consignées avec un objet `statusDetails` contant la valeur `headers_too_long`, si la journalisation est activée.
Taille maximale de l'en-tête de réponse	Environ 128 Kio	Cette limite ne peut pas être augmentée. Les réponses de l'origine dont les en-têtes dépassent cette limite entraînent l'envoi d'une réponse HTTP 502 au client. Ces réponses sont consignées avec un objet `statusDetails` contant la valeur `backend_response_headers_too_long`, si la journalisation est activée.
Taille maximale des entrées de cache	50 Gio	Cette limite ne peut pas être augmentée. Il s'agit de la taille maximale d'une réponse pouvant être mise en cache. Par exemple, un seul fichier. Les réponses dont la valeur Content-Length est supérieure à cette limite ou les réponses fragmentées qui dépassent cette limite ne sont pas mises en cache. Une erreur HTTP 413 (corps de requête trop long) est renvoyée au client.
Conversion en minuscules pour les en-têtes	Toujours pour Media CDN	Media CDN suit les conventions HTTP/2 pour la casse des en-têtes de requête et de réponse. Quel que soit le protocole utilisé, tous les en-têtes sont convertis en minuscules. Par exemple, `Host` devient `host` et `Keep-Alive` devient `keep-alive`. La casse des valeurs d'en-tête n'est pas modifiée.

Limites de débit des requêtes d'API

Si vous avez besoin d'augmenter la limite de débit des API, vous pouvez examiner l'utilisation actuelle et demander une augmentation.

Élément	Limites
Tous les appels qui ne se trouvent pas dans l'espace de noms `networkservices`	1 200 appels par minute et par projet
*Lecture seule : `GetEdgeCache`, `ListEdgeCache`*	100 par minute et par projet
Lecture/écriture : tous les éléments de l'espace de noms `networkservices` qui ne sont pas marqués comme en lecture seule.	100 par minute et par projet

Délais avant expiration du client

Délai avant expiration	Durée maximale	Code de réponse	Description
Maximum request duration	5 minutes	HTTP 408 (Request Timeout)	Durée maximale d'une réponse à une requête unique.
Header timeout	10 seconds	HTTP 408 (Request Timeout)	Durée d'envoi de l'intégralité des en-têtes de requête par le client.

Délais avant expiration de l'origine

connectTimeout et maxAttemptsTimeout limitent le temps nécessaire à Media CDN pour trouver une réponse utilisable.

Les deux délais avant expiration incluent le temps nécessaire à l'origine pour renvoyer des en-têtes et pour déterminer s'il convient d'utiliser un basculement ou une redirection. connectTimeout s'applique indépendamment pour chaque tentative d'origine, tandis que maxAttemptsTimeout inclut le temps nécessaire pour se connecter à toutes les tentatives d'origine, en incluant les basculements et les redirections. Le suivi d'une redirection est considéré comme une tentative supplémentaire de connexion à l'origine et est comptabilisé dans le maxAttempts défini pour l'origine configurée.

Lorsque Media CDN rencontre une réponse de non redirection, par exemple en provenance d'une origine de redirection ou de basculement, les valeurs readTimeout et responseTimeout s'appliquent. Les origines redirigées utilisent les valeurs connectTimeout, readTimeout et responseTimeout configurées pour le EdgeCacheOrigin qui a rencontré la redirection.
responseTimeout et readTimeout contrôlent la durée maximale d'une réponse en flux continu. Une fois que Media CDN a déterminé qu'il utilisera une réponse en amont, ni connectTimeout, ni maxAttemptsTimeout n'ont d'importance. À ce stade, readTimeout et responseTimeout entrent en vigueur.

Media CDN effectue au maximum quatre tentatives d'origine sur toutes les origines, quel que soit le paramètre maxAttempts défini par chaque EdgeCacheOrigin. Media CDN utilise la valeur maxAttemptsTimeout de la EdgeCacheOrigin principale. Les valeurs de délai d'expiration par tentative (connectTimeout, readTimeout et responseTimeout) sont configurées pour la EdgeCacheOrigin de chaque tentative.

Le tableau suivant décrit les champs de délai avant expiration :

Champ	Par défaut	Description
connectTimeout	5 secondes	Durée maximale utilisable par Media CDN, entre le lancement de la requête et l'origine, avant que Media CDN détermine si la réponse est utilisable. En pratique, `connectTimeout` couvre le temps nécessaire à la création de la requête, aux recherches DNS, aux handshakes TLS et à l'établissement de connexions TCP/QUIC, jusqu'à l'obtention des en-têtes de réponse qui contiennent le code d'état HTTP. Le délai avant expiration doit être compris entre 1 et 15 secondes.
maxAttemptsTimeout	15 secondes	Délai maximal pour toutes les tentatives de connexion à l'origine (y compris les origines de basculement) avant qu'une erreur soit renvoyée au client. Une erreur HTTP 504 est renvoyée si le délai avant expiration est atteint avant le renvoi d'une réponse. Le délai avant expiration doit être compris entre 1 et 30 secondes. Ce paramètre définit la durée totale de toutes les tentatives de connexion d'origine, en incluant les origines de basculement, afin de plafonner le temps total d'attente des clients avant de lancer la diffusion. Seule la première valeur `maxAttemptsTimeout` est utilisée, la première valeur étant définie par l'origine configurée pour la route donnée.
readTimeout	15 secondes	Durée maximale d'attente entre les lectures d'une seule réponse HTTP. Le `readTimeout` est limité par le `responseTimeout`. Toutes les lectures de la réponse HTTP doivent être effectuées dans le délai défini par le `responseTimeout`. Le délai avant expiration doit être compris entre 1 et 30 secondes. Si ce délai avant expiration est atteint avant que la réponse ne soit complète, la réponse est tronquée et enregistrée.
responseTimeout	30 seconds	Durée maximale autorisée pour l'obtention d'une réponse complète. Le délai avant expiration doit être compris entre 1 et 120 secondes. La durée est mesurée à partir du moment où les premiers octets du corps sont reçus. Si ce délai avant expiration est atteint avant que la réponse ne soit complète, la réponse est tronquée et enregistrée.

Gestion des quotas

Media CDN impose des quotas sur l'utilisation des ressources pour différentes raisons. Il s'agit, par exemple, de préserver la communauté des utilisateurs de Google Cloud en empêchant les pics d'utilisation imprévus. Les quotas aident également les utilisateurs qui explorent Google Cloud avec la version gratuite à ne pas dépasser les limites de leur version d'essai.

Tous les projets débutent avec les mêmes quotas, que vous pouvez modifier en demandant un quota supplémentaire. Certains quotas peuvent augmenter automatiquement en fonction de votre utilisation d'un produit.

Autorisations

Pour afficher les quotas ou demander une augmentation de quotas, les comptes principaux IAM (Identity and Access Management) doivent disposer de l'un des rôles suivants.

Tâche	Rôle requis
Vérifier les quotas d'un projet	Choisissez l'une des options suivantes : Propriétaire du projet (`roles/owner`) Éditeur du projet (`roles/editor`) Lecteur de quotas (`roles/servicemanagement.quotaViewer`)
Modifier les quotas, demander un quota supplémentaire	Choisissez l'une des options suivantes : Propriétaire du projet (`roles/owner`) Éditeur du projet (`roles/editor`) Administrateur de quotas (`roles/servicemanagement.quotaAdmin`) Rôle personnalisé doté de l'autorisation `serviceusage.quotas.update`

Vérifier les quotas

Console

Dans la console Google Cloud, accédez à la page Quotas.
Accéder à la section "Quotas"
Pour rechercher le quota à mettre à jour, utilisez l'option Filtrer le tableau. Si vous ne connaissez pas le nom du quota, utilisez les liens disponibles sur cette page à la place.

gcloud

À l'aide de l'interface de ligne de commande Google Cloud, exécutez la commande suivante pour vérifier vos quotas. Remplacez PROJECT_ID par votre ID de projet :

      gcloud compute project-info describe --project PROJECT_ID

Pour vérifier le quota que vous avez déjà consommé dans une région, exécutez la commande suivante :

      gcloud compute regions describe example-region

Erreurs lors du dépassement de votre quota

Si vous dépassez un quota avec une commande gcloud, gcloud génère un message d'erreur quota exceeded et renvoie le code de sortie 1.

Si vous dépassez un quota avec une requête API, Google Cloud renvoie le code d'état HTTP suivant: HTTP 413 Request Entity Too Large.

Demander des quotas supplémentaires

Pour demander une augmentation ou une diminution de la plupart des quotas, vous pouvez utiliser Google Cloud Console. Pour en savoir plus, consultez Demander une augmentation de quota.

Console

Dans la console Google Cloud, accédez à la page Quotas.
Accéder à la section "Quotas"
Sur la page Quotas, sélectionnez les quotas à modifier.
En haut de la page, cliquez sur Modifier les quotas.
Indiquez votre nom, votre adresse e-mail et votre numéro de téléphone, puis cliquez sur Suivant.
Remplissez votre demande de quota, puis cliquez sur Terminé.
Envoyez la demande. Le traitement des demandes de quotas nécessite un délai de 24 à 48 heures.

Disponibilité des ressources

Chaque quota représente le nombre maximal de ressources que vous pouvez créer pour un type de ressource donné, sous réserve de disponibilité. Il est important de noter que les quotas ne garantissent pas la disponibilité des ressources. Même si vous disposez d'un quota, vous ne pouvez pas créer une ressource si celle-ci n'est pas disponible.

Par exemple, vous pouvez disposer d'un quota suffisant pour créer une adresse IP régionale externe dans la région us-central1. Toutefois, cela n'est pas possible si aucune adresse IP externe n'est disponible dans cette région. La disponibilité des ressources par zone peut également avoir une incidence sur votre capacité à créer des ressources.

Les situations dans lesquelles des ressources sont indisponibles dans une région entière sont rares. Toutefois, les ressources d'une zone peuvent parfois être épuisées de temps en temps, ce qui n'a généralement pas d'incidence sur le contrat de niveau de service pour le type de ressource. Pour plus d'informations, consultez le contrat de niveau de service correspondant à la ressource.