Quotas et limites

L'API Cloud Healthcare impose des limites à l'utilisation des ressources pour différentes raisons. Ils peuvent par exemple servir à préserver la communauté des utilisateurs de Google Cloud en empêchant les pics d'utilisation imprévus. Google Cloud propose également des quotas d'essai gratuit qui offrent un accès limité aux utilisateurs qui souhaitent explorer Google Cloud, y compris l'API Cloud Healthcare.

Les quotas de l'API Cloud Healthcare sont fixés par projet pour chaque région ou emplacement multirégional. Si vous épuisez votre quota pour une région donnée, l'utilisation de l'API Cloud Healthcare dans les autres régions n'est pas affectée.

Vérifier vos quotas et votre utilisation

Les quotas sont des limites qui s'appliquent au stockage (également appelées "limites d'entrée") et aux opérations.

Pour vérifier les quotas disponibles pour les ressources de votre projet, accédez à la page Quotas de la console Google Cloud .

Pour afficher uniquement les quotas de l'API Cloud Healthcare, cliquez sur Service dans la liste déroulante Filtrer le tableau, puis sélectionnez API Cloud Healthcare.

Tous les projets ne sont pas soumis aux mêmes quotas. À mesure que votre utilisation de l'API Cloud Healthcare s'accroît, les quotas peuvent augmenter en conséquence. Si vous prévoyez une augmentation notable de l'utilisation, vous pouvez anticiper cette évolution en demandant des ajustements de quota sur la page Quotas de la consoleGoogle Cloud . Aucuns frais ne s'appliquent lorsque vous demandez une augmentation de quota. Vos coûts n'augmentent que si vous utilisez plus de ressources.

Limites de ressources

L'API Cloud Healthcare limite la taille du contenu d'une requête, par exemple la taille d'une image radio dans une requête DICOM. Vous ne pouvez pas demander la modification d'une limite imposée à une ressource. Toutefois, dans certaines situations, vous pouvez effectuer une opération d'importation pour importer un contenu excédant la limite imposée à une ressource.

Le tableau ci-dessous indique les limites imposées aux ressources et sujettes à modification.

Si vous tentez de traiter un contenu plus volumineux que la limite autorisée pour la ressource, une erreur se produit.

Limites de taille de FHIR executeBundle

Vous pouvez utiliser la méthode fhir.executeBundle pour effectuer plusieurs opérations FHIR dans une même requête API. Le nombre d'opérations dépend du nombre d'entrées dans un lot ou un bundle de transactions. Cette approche est plus efficace que d'effectuer des appels d'API individuels pour chaque opération.

Les délais de traitement des requêtes fhir.executeBundle augmentent avec le nombre d'entrées dans le bundle. Des facteurs tels que la contention des ressources (par exemple, la mise à jour de la même ressource dans plusieurs ensembles de transactions en parallèle) peuvent également avoir un impact sur les performances. Pour obtenir des exemples de situations où une contention des ressources peut se produire et découvrir comment éviter qu'elle n'entraîne des erreurs, consultez les bonnes pratiques concernant le débit de données. Les grands bundles, en particulier ceux qui dépassent 1 000 entrées, peuvent expirer et ne pas se terminer.

Pour que vos demandes fhir.executeBundle soient traitées rapidement et efficacement, tenez compte des limites suivantes :

• Regroupements de transactions : les regroupements dépassant 4 500 entrées sont immédiatement refusés pour éviter les délais d'expiration. Pour les bundles de transactions, toutes les opérations doivent réussir.
• Regroupements par lot : il n'existe pas de limite d'entrée spécifique, mais les regroupements plus importants augmentent le risque de délai d'attente. Les délais d'inactivité peuvent entraîner un succès partiel, avec seulement certaines entrées traitées.

Utiliser des opérations d'importation pour les contenus excédant les limites de ressources

Les opérations d'importation vous permettent de traiter des contenus dont la taille est supérieure à la limite imposée aux ressources. Lors d'une opération d'importation, la taille du contenu n'est limitée que par la taille de stockage maximale de 5 To autorisée pour les objets individuels sur Google Cloud . Les opérations d'importation sont soumises à des quotas de stockage qui déterminent leur durée. Vous pouvez effectuer une opération d'importation si vous souhaitez, par exemple, stocker de nombreuses instances DICOM dans un datastore DICOM, sans être soumis à la limite de taille des requêtes. Au lieu d'importer les instances au moyen des méthodes Store Transaction disponibles, vous pouvez les importer dans un bucket Cloud Storage, puis les importer dans le datastore DICOM.

Pour connaître les étapes détaillées de l'importation de données DICOM au moyen d'une opération d'importation, consultez la page Importer et exporter des données DICOM à l'aide de Cloud Storage.

Pour connaître les étapes détaillées de l'importation de ressources FHIR au moyen d'une opération d'importation, consultez la page Importer et exporter des ressources FHIR à l'aide de Cloud Storage.

Pour connaître les étapes détaillées de l'importation de messages HL7v2 au moyen d'une opération d'importation, consultez la page Importer des messages HL7v2 à partir de Cloud Storage.

Demander la modification d'un quota

Pour demander la modification d'un quota, vous devez disposer de l'autorisation serviceusage.quotas.update. Elle est incluse par défaut pour les rôles prédéfinis suivants : propriétaire, éditeur et administrateur de quotas.

1. Accédez à la page Quotas.

   Accéder à la section "Quotas"

2. Sur la page Quotas, sélectionnez les quotas que vous souhaitez modifier. Si vous souhaitez afficher uniquement les quotas de l'API Cloud Healthcare, cliquez sur Service dans la liste déroulante Filtrer le tableau, puis sélectionnez API Cloud Healthcare.

3. Cochez les cases correspondant aux quotas que vous souhaitez modifier.

4. En haut de la page, cliquez sur le bouton Modifier les quotas.

5. Remplissez le formulaire et cliquez sur Suivant.

6. Saisissez les limites que vous souhaitez, puis cliquez sur Suivant.

7. Cliquez sur Envoyer la requête.

Par défaut, les demandes de réduction de quota sont refusées. Si vous souhaitez réduire votre quota, répondez à l'e-mail de l'assistance en précisant vos besoins. Un conseiller répondra à votre demande.

Vous recevrez une réponse de l'équipe API Cloud Healthcare dans les 24 à 48 heures suivant votre demande.

Prévoyez une demande de ressources supplémentaires au moins quelques jours à l'avance pour qu'elle soit traitée en temps voulu.

Demandes de quota de localisation

Vous pouvez demander une augmentation du quota pour l'API Cloud Healthcare dans une région spécifique ou dans un emplacement multirégional.

Pour demander une augmentation de quota dans une seule région : spécifiez la région dans votre demande d'augmentation de quota.

Pour demander une augmentation de quota dans un emplacement multirégional :

• Pour demander une augmentation de quota dans la région multirégionale us, indiquez dans votre demande que le quota concerne la "métarégion des États-Unis".
• Pour augmenter le quota dans la région multirégionale eu, indiquez dans votre demande que le quota concerne la "métarégion européenne".

Limites de quota

Les sections suivantes décrivent les quotas associés aux opérations et aux magasins de données de l'API Cloud Healthcare.

Quotas DICOM

Le tableau suivant décrit les quotas de l'API Cloud Healthcare associés aux magasins et opérations DICOM.

Quotas FHIR

Le tableau suivant décrit les quotas de l'API Cloud Healthcare associés aux magasins et aux opérations FHIR.

Recherches multi-opérations

Une même requête peut consommer plusieurs unités de quota. Par exemple, une requête de recherche GET utilisant Observation?subject:Patient.identifier=system|value comme paramètre de recherche consomme deux unités de quota fhir_search_ops. Deux opérations de recherche sont effectuées, l'une sur la ressource Observation et l'autre sur la ressource Patient, en utilisant subject comme référence.

Si une requête de suppression conditionnelle utilisant Observation?status=canceled comme critère de recherche recherche et supprime six ressources Observation, les unités de quota suivantes sont consommées :

• Une unité de quota fhir_search_ops, car la requête de recherche GET n'est effectuée que sur un seul type de ressource FHIR, à savoir la ressource Observation. La requête renvoie toutes les ressources "Observation" correspondant aux critères de recherche.
• Six unités de quota fhir_write_ops, car il y a un total de six opérations DELETE sur les ressources Observation supprimées.

Consommation du quota d'exécution de bundle

Pour envoyer une requête execute bundle, quel que soit le quota consommé par la requête, votre projetGoogle Cloud doit disposer d'au moins une unité disponible pour chacun des quotas suivants :

• fhir_read_ops
• fhir_write_ops
• fhir_search_ops

Si ces quotas ne sont pas disponibles, la requête d'exécution du bundle échoue.

Par exemple, si vous envoyez une requête fhir.executeBundle avec un bundle de transactions contenant 100 opérations POST, chacune créant une ressource FHIR, l'API Cloud Healthcare vérifie d'abord qu'au moins une unité de quota est disponible pour fhir_read_ops, fhir_write_ops et fhir_search_ops. Si la validation réussit, l'API Cloud Healthcare exécute le bundle et crée les ressources FHIR, qui consomment un total de 100 unités de quota fhir_write_ops.

Prenons l'exemple du groupe de transactions suivant, qui utilise une référence conditionnelle pour créer une ressource Observation si reference existe :

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "request": {
        "method": "POST",
        "url": "Observation"
      },
      "resource": {
        "resourceType": "Observation",
        "subject": {
          "reference": "Patient?identifier=a1b2c3d4e5"
        }
      }
    }
  ]
}

Lorsque vous exécutez le bundle, l'API Cloud Healthcare vérifie d'abord qu'au moins une unité de quota est disponible pour fhir_read_ops, fhir_write_ops et fhir_search_ops. Si la validation réussit, l'API Cloud Healthcare exécute le bundle. Les unités de quota suivantes sont consommées :

• Un fhir_write_ops pour créer la ressource Observation.
• Un fhir_search_ops, car une seule opération de recherche est effectuée sur la référence Patient?identifier=a1b2c3d4e5.

Bonnes pratiques

Pour connaître les bonnes pratiques de gestion des quotas de l'API Cloud Healthcare, consultez Bonnes pratiques de gestion des quotas.