Cuotas y límites

La API de Cloud Healthcare aplica ciertos límites sobre el uso de recursos por varios motivos. Por ejemplo, las cuotas protegen a la comunidad de usuarios de Google Cloud al evitar que se produzcan picos de uso imprevistos. Google Cloud también ofrece cuotas de prueba gratuita que proporcionan acceso limitado a los usuarios que quieran probar Google Cloud, incluida la API Cloud Healthcare.

Las cuotas de la API de Cloud Healthcare se aplican por proyecto, ya sea por región o por multirregión. El agotamiento de cuotas en una sola región no afectará al uso de la API Cloud Healthcare en otras regiones.

Comprobar las cuotas y el uso

Las cuotas son límites de almacenamiento (también se denominan límites de entrada) y de operaciones.

Para conocer las cuotas de los recursos de tu proyecto, ve a la página Cuotas de la consola de Google Cloud .

Para ver solo las cuotas de la API Cloud Healthcare, selecciona Servicio en la lista desplegable Filtrar tabla y, luego, API Cloud Healthcare.

Estas cuotas varían en función del proyecto Las cuotas pueden ir aumentando conforme se amplía el uso que le das a la API de Cloud Healthcare. Si crees que tu uso va a aumentar de manera considerable, solicita un ajuste de la cuota en la página Cuotas de laGoogle Cloud consola. No te cobraremos nada por solicitar un aumento de cuota. Los costes solo se incrementan si utilizas más recursos.

Límites de recursos

La API de Cloud Healthcare limita el tamaño del contenido de una solicitud; por ejemplo, el tamaño de una radiografía en una solicitud DICOM. No puedes solicitar cambios en cuanto al límite de recursos, pero hay situaciones en las que puedes usar una operación de importación para importar contenido cuyo tamaño sea superior al límite de recursos.

Estos son los límites de recursos que se aplican, los cuales están sujetos a cambios.

Si intentas procesar contenido cuyo tamaño sea superior al límite de recursos asociado, se producirá un error.

Límites de tamaño de executeBundle de FHIR

Puedes usar el método fhir.executeBundle para realizar varias operaciones de FHIR en una sola solicitud de API. El número de operaciones depende del número de entradas de un paquete de lote o de transacción. Este método es más eficiente que hacer llamadas a la API individuales para cada operación.

Los tiempos de procesamiento de las solicitudes de fhir.executeBundle aumentan con el número de entradas del paquete. Factores como la contención de recursos (por ejemplo, actualizar el mismo recurso como parte de muchos paquetes de transacciones en paralelo) también pueden afectar al rendimiento. Para ver ejemplos de cuándo se puede producir una contención de recursos y cómo evitar que provoque errores, consulta las prácticas recomendadas sobre el rendimiento de los datos. Los paquetes grandes, sobre todo los que superan las 1000 entradas, pueden agotar el tiempo de espera y no completarse.

Para que el proceso se lleve a cabo correctamente y a tiempo, tenga en cuenta estos límites al enviar sus solicitudes fhir.executeBundle:

• Paquetes de transacciones: los paquetes que superen las 4500 entradas se rechazarán inmediatamente para evitar que se agote el tiempo de espera. Los paquetes de transacciones requieren que todas las operaciones se completen correctamente.
• Paquetes por lotes: no hay un límite de entradas específico, pero los paquetes más grandes aumentan el riesgo de que se agote el tiempo de espera. Los tiempos de espera pueden dar lugar a un éxito parcial, en el que solo se procesan algunas entradas.

Usar operaciones de importación si el contenido supera los límites de recursos

Las operaciones de importación te permiten procesar contenido cuyo tamaño supere el límite de recursos asociado. El tamaño del contenido en una operación de importación solo está limitado por el Google Cloud tamaño de almacenamiento máximo de 5 TB para objetos concretos. Las operaciones de importación están sujetas a cuotas de almacenamiento que determinan su duración. Por ejemplo, si quieres almacenar muchas instancias DICOM en un almacén DICOM, pero que no se aplique el límite de tamaño de la solicitud, te recomendamos que utilices una operación de importación. En lugar de subir las instancias con los métodos de Store Transaction, puedes subirlas a un segmento de Cloud Storage y, a continuación, importarlas al almacén DICOM.

Para obtener información detallada sobre cómo importar datos DICOM mediante una operación de importación, consulta el artículo sobre cómo importar y exportar datos DICOM.

Para obtener información detallada sobre cómo importar recursos FHIR mediante una operación de importación, consulta el artículo sobre cómo importar y exportar recursos FHIR.

Para obtener información detallada sobre cómo importar mensajes HL7v2 mediante una operación de importación, consulta el artículo sobre cómo importar mensajes HL7v2 desde Cloud Storage.

Solicitar un cambio de cuota

Para solicitar un cambio de cuota, debes contar con el permiso serviceusage.quotas.update, que está incluido de forma predeterminada en los siguientes roles predefinidos: propietario, editor y administrador de cuota.

1. Ve a la página Cuotas.

   Ir a Cuotas

2. En la página Cuotas, selecciona las cuotas que quieres modificar. Si solo quieres ver las cuotas de la API de Cloud Healthcare, selecciona Servicio en la lista desplegable Filtrar tabla y, luego, API de Cloud Healthcare.

3. Marca las casillas de las cuotas que quieres editar.

4. Haz clic en el botón Editar cuotas que se encuentra en la parte superior de la página.

5. Rellena el formulario y haz clic en Siguiente.

6. Introduce los límites que quieres solicitar y selecciona Siguiente.

7. Haz clic en Enviar solicitud.

Las solicitudes para reducir la cuota se rechazan de forma predeterminada. Si quieres reducirla, responde al correo electrónico de asistencia explicando tu situación. Un representante del equipo de asistencia responderá a tu solicitud.

Tras esto, el equipo de la API de Cloud Healthcare se pondrá en contacto contigo en un plazo de entre 24 y 48 horas.

Si quieres solicitar más recursos, hazlo con algunos días de antelación para que tengamos tiempo suficiente de procesar tu solicitud.

Solicitudes de cuota de ubicación

Puedes solicitar un aumento de cuota para la API Cloud Healthcare en una región específica o en una ubicación multirregión.

Para solicitar un aumento de cuota en una sola región, especifica la región en tu solicitud.

Para solicitar un aumento de cuota en una ubicación multirregional, sigue estos pasos:

• Si quieres aumentar la cuota en la multirregión us, indica en tu solicitud que la cuota es para la "metarregión de EE. UU.".
• Si quieres aumentar la cuota en la multirregión eu, indica en tu solicitud que la cuota es para la "metarregión de la UE".

Límites de cuota

En las siguientes secciones se describen las cuotas asociadas a los almacenes de datos y las operaciones de la API Cloud Healthcare.

Cuotas de DICOM

En la siguiente tabla se describen las cuotas de la API Cloud Healthcare asociadas a los almacenes DICOM y a las operaciones DICOM.

Cuotas de FHIR

En la siguiente tabla se describen las cuotas de la API Cloud Healthcare asociadas a los almacenes FHIR y a las operaciones FHIR.

Búsquedas multioperación

Una sola solicitud puede consumir varias unidades de cuota. Por ejemplo, una solicitud de búsqueda GET que use Observation?subject:Patient.identifier=system|value como parámetro de búsqueda consume dos unidades de cuota fhir_search_ops. Se realizan dos operaciones de búsqueda, una en el recurso Observation y otra en el recurso Patient, usando subject como referencia.

Si una solicitud de eliminación condicional que usa Observation?status=canceled como criterio de búsqueda busca y elimina seis recursos Observation, se consumirán las siguientes unidades de cuota:

• Una unidad de cuota fhir_search_ops, ya que la solicitud de búsqueda GET solo se realiza en un tipo de recurso FHIR, el recurso Observation. La solicitud devuelve todos los recursos Observation que coinciden con los criterios de búsqueda.
• Seis unidades de cuota fhir_write_ops, porque hay un total de seis operaciones DELETE en los recursos Observation eliminados.

Consumo de cuota de ejecución de paquetes

Para enviar una solicitud de ejecución de paquete, independientemente de la cuota que consuma la solicitud, tuGoogle Cloud proyecto debe tener al menos una unidad disponible para cada una de las siguientes cuotas:

• fhir_read_ops
• fhir_write_ops
• fhir_search_ops

Si estas cuotas no están disponibles, la solicitud de paquete de ejecución falla.

Por ejemplo, si envías una solicitud fhir.executeBundle con un paquete de transacciones que contiene 100 operaciones POST, cada una de las cuales crea un recurso FHIR, la API Cloud Healthcare primero verifica que haya al menos una unidad de cuota disponible para fhir_read_ops, fhir_write_ops y fhir_search_ops. Si la verificación se realiza correctamente, la API Cloud Healthcare ejecuta el paquete y crea los recursos FHIR, que consumen un total de 100 unidades de cuota fhir_write_ops.

Considera el siguiente paquete de transacciones, que usa una referencia condicional para crear un recurso Observation si existe reference:

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

Cuando ejecutas el paquete, la API Cloud Healthcare verifica primero que haya al menos una unidad de cuota disponible para fhir_read_ops, fhir_write_ops y fhir_search_ops. Si la verificación se realiza correctamente, la API Cloud Healthcare ejecuta el paquete. Se consumen las siguientes unidades de cuota:

• Una fhir_write_ops para crear el nuevo recurso Observation.
• Una fhir_search_ops, porque se realiza una sola operación de búsqueda en la referencia Patient?identifier=a1b2c3d4e5.

Prácticas recomendadas

Para consultar las prácticas recomendadas para gestionar la cuota de la API Cloud Healthcare, consulta el artículo Prácticas recomendadas para gestionar las cuotas.