Cuotas y límites

La API de Cloud Healthcare aplica límites al uso de los recursos por diversos motivos. Por ejemplo, las cuotas protegen a la comunidad de usuarios de Google Cloud mediante la prevención de aumentos repentinos de uso. Google Cloud también ofrece cuotas de prueba gratuita que proporcionan acceso limitado a los usuarios que están explorando Google Cloud, incluida la API de Cloud Healthcare.

Las cuotas de la API de Cloud Healthcare se aplican por proyecto, ya sea por región o multirregional. Si se agota la cuota en una región, eso no afecta el uso de la API de Cloud Healthcare en otras regiones.

Verifica tus cuotas y el uso

Las cuotas son límites que se aplican al almacenamiento (límites de entrada) y a las operaciones.

Puedes revisar la cuota disponible para los recursos de tu proyecto en la página Cuotas de la consola de Google Cloud.

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

No todos los proyectos tienen las mismas cuotas. A medida que tu uso de la API de Cloud Healthcare aumenta con el tiempo, tus cuotas también pueden aumentar. Si prevés un aumento notable en el uso, puedes solicitar ajustes en la cuota de forma proactiva en la página Cuotas de Google Cloud Console. No se aplican cargos por solicitar aumentos de cuota. Tus costos aumentan solo si usas más recursos.

Límites de recursos

La API de Cloud Healthcare limita el tamaño del contenido de las solicitudes (por ejemplo, el tamaño de una imagen de rayos X en una solicitud de DICOM). No puedes solicitar cambios a los límites de recursos; sin embargo, en algunos casos, puedes usar una operación de importación para importar contenido que supere el límite de recursos.

Se aplican los siguientes límites de recursos y están sujetos a cambios.

Modalidad Límite de tamaño de solicitud
DICOM
  • Transacción en tienda: Ilimitada. Todos los demás métodos: 10 MB.
  • Transacción de almacenamiento o transacción de recuperación: Se agota el tiempo de espera si la operación tarda más de una hora.
  • Los métodos de transacción de búsqueda tienen una compensación máxima de 1,000,000 y un límite máximo de 5,000 para los estudios o las series, y de 50,000 para las instancias.
  • Desidentificación: No se pueden procesar archivos de DICOM que sean de más de 1 GB si se trata de ocultamiento de píxeles.
  • Los archivos de DICOM transferidos tienen un límite de 2 GB por etiqueta. Este límite incluye PixelData codificado en formato nativo.
  • Cuando se transcodifican datos de DICOM, el tamaño máximo de archivo es de 1 GB, y el de marco es de 150 MB.
  • dicomStores.import: El tamaño máximo de archivo es de 20 GB.
FHIR executeBundle: 50 MB; todos los demás métodos tienen un límite de 10 MB.
HL7v2 10 MB

Si intentas procesar contenido más grande que el límite del recurso asociado, se muestra un error.

Usa operaciones de importación para el contenido que supera el límite de recursos

Las operaciones de importación te permiten procesar el contenido que supera el límite de recursos asociado. El tamaño del contenido en una operación de importación está limitado solo por el tamaño máximo de almacenamiento de Google Cloud, que es de 5 TB para objetos independientes. Las operaciones de importación están sujetas a cuotas de almacenamiento que determinan cuánto tiempo tarda una operación de importación. Se recomienda que uses una operación de importación, por ejemplo, si quieres almacenar varias instancias de DICOM en un almacén DICOM y no quieres estar sujeto a los límites de tamaño de solicitud. En vez de subir las instancias mediante los métodos de Transacción de almacenamiento disponibles, puedes subirlas a un bucket de Cloud Storage y, luego, importarlas al almacén DICOM.

Si deseas obtener instrucciones para importar datos de DICOM mediante una operación de importación, consulta cómo importar y exportar datos de DICOM.

Si deseas obtener instrucciones para importar recursos de FHIR mediante una operación de importación, consulta cómo importar y exportar recursos de FHIR.

Si deseas obtener instrucciones detalladas para importar mensajes HL7v2 mediante una operación de importación, consulta este artículo.

Solicita un cambio de una cuota

Para solicitar que se modifique una cuota, debes tener el permiso serviceusage.quotas.update. Este permiso se incluye de forma predeterminada en las funciones predefinidas de Propietario, Editor y Administrador de cuotas.

  1. Ve a la página Cuotas.

    Ir a Cuotas

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

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

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

  5. Completa el formulario y haz clic en Siguiente.

  6. Ingresa los límites que deseas solicitar y haz clic en Siguiente.

  7. Haz clic en Enviar solicitud.

Las solicitudes de disminución de cuota se rechazan de forma predeterminada. Si deseas reducir la cuota, responde el correo electrónico de asistencia para explicar tus requisitos. Un representante del equipo de asistencia responderá a tu solicitud.

Recibirás una respuesta del equipo de la API de Cloud Healthcare en un plazo de 24 a 48 horas tras el envío de tu solicitud.

Planifica tu solicitud de recursos adicionales con al menos un par de días de anticipación a fin de asegurarte de que haya tiempo suficiente para completarla.

Límites de cuota

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

Cuotas de DICOM

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

Nombre de la métrica Nombre visible Descripción
dicomweb_ops Cantidad de operaciones de DICOMweb por minuto y por región Incluye los siguientes métodos:
  • Todos los métodos projects.locations.datasets.dicomStores.studies en v1beta1 y v1
  • Todos los métodos projects.locations.datasets.dicomStores.studies.series en v1beta1 y v1
  • Todos los métodos projects.locations.datasets.dicomStores.studies.series.instances en v1beta1 y v1
  • Todos los métodos projects.locations.datasets.dicomStores.studies.series.instances.frames en v1beta1 y v1
dicom_structured_storage_bytes Entrada del almacenamiento de DICOM estructurado en bytes por minuto y por región Bytes estructurados, en forma de etiquetas DICOM y metadatos relacionados, que se envían a la API de Cloud Healthcare mientras se procesan operaciones dicomweb_ops.
dicom_store_ops Cantidad de operaciones de almacén de DICOM por minuto y por región Operaciones en el almacén de DICOM, no en los datos de DICOM. Incluye los siguientes métodos:
dicom_store_lro_ops Cantidad de operaciones de larga duración del almacén de DICOM por minuto y por región Operaciones en el almacén de DICOM, no en los datos de DICOM, que muestran una operación de larga duración. Incluye los siguientes métodos:
dicom_structured_storage_operations_bytes Entrada de almacenamiento de DICOM estructurado para operaciones de larga duración en bytes por minuto y por región Bytes estructurados, en forma de etiquetas DICOM y metadatos relacionados, que se envían a la API de Cloud Healthcare mientras se procesan operaciones dicom_store_lro_ops.

Cuotas de FHIR

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

Nombre de la métrica Nombre visible Descripción
fhir_ops Cantidad de operaciones de FHIR por minuto y por región Se mide en unidades. Cada unidad es una solicitud a cualquier método projects.locations.datasets.fhirStores.fhir en v1beta1 y v1.
fhir_read_ops Cantidad de operaciones de lectura de FHIR por minuto y por región Se mide en unidades. Una unidad es una solicitud de lectura en un recurso de FHIR individual.

Incluye los siguientes métodos:

v1beta1: v1:
fhir_write_ops Cantidad de operaciones de escritura de FHIR por minuto y por región Se mide en unidades, en la que una unidad es una solicitud de creación, actualización o eliminación en un recurso de FHIR individual.

Se incluyen los siguientes métodos:

v1beta1: v1:
fhir_search_ops Cantidad de operaciones de búsqueda de FHIR por minuto y por región Se mide en unidades. Una unidad es una solicitud de búsqueda en un tipo de recurso FHIR en la que la búsqueda no requiere resolver referencias, excepto cuando se usa _include. Por ejemplo, una búsqueda Observation?subject:Patient.identifier=system|value consume dos unidades de cuota fhir_search_ops porque requiere dos búsquedas, una en el recurso de observación y otra en el recurso de paciente, con subject como referencia.

Incluye los siguientes métodos:

v1beta1: v1:
fhir_storage_egress_bytes Salida de almacenamiento de FHIR en bytes por minuto y por región Se mide en unidades, donde una unidad es un byte que la API de Cloud Healthcare lee del almacenamiento mientras procesa las operaciones fhir_read_ops, fhir_write_ops y fhir_search_ops.
fhir_storage_bytes Entrada de almacenamiento de FHIR en bytes por minuto y por región Bytes enviados a la API de Cloud Healthcare mientras se procesan operaciones de fhir_ops.
fhir_store_ops Cantidad de operaciones de almacén de FHIR por minuto y por región Operaciones en el almacén de FHIR, no los datos de FHIR.

Incluye los siguientes métodos:
fhir_store_lro_ops Cantidad de operaciones de larga duración del almacén de FHIR por minuto y por región Operaciones en el almacén de FHIR, no datos de FHIR, que muestran una operación de larga duración.

Incluye los siguientes métodos:
fhir_storage_operations_bytes Entrada de almacenamiento de FHIR para operaciones de larga duración en bytes por minuto y por región Bytes enviados a la API de Cloud Healthcare mientras se procesan operaciones de fhir_store_lro_ops.

Una sola solicitud puede consumir varias unidades de cuota. Por ejemplo, una solicitud de búsqueda GET que usa 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 Observación y otra en el recurso Paciente, con subject como referencia.

Si una solicitud de eliminación condicional que usa Observation?status=canceled como criterios de búsqueda busca y borra seis recursos de observación, se consumen 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 de FHIR: el recurso Observación. La solicitud muestra todos los recursos de observación que coinciden con los criterios de búsqueda.
  • Seis unidades de cuota fhir_write_ops, ya que hay un total de seis operaciones DELETE en los recursos de observación borrados.

Ejecuta el consumo de cuota por paquete

A fin de enviar una solicitud de ejecutar paquete, sin importar la cuota que consuma, el proyecto de Google Cloud 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, fallará la solicitud de ejecución del paquete.

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 de FHIR, la API de Cloud Healthcare primero verifica que al menos una unidad de cuota esté disponible para fhir_read_ops, fhir_write_ops y fhir_search_ops. Si la verificación se realiza correctamente, la API de Cloud Healthcare ejecuta el paquete y crea los recursos de 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 de observación si reference existe:

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

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

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