A API Cloud Healthcare aplica limites à utilização de recursos por vários motivos. Por exemplo, as quotas protegem a comunidade de Google Cloud utilizadores ao impedir picos imprevistos na utilização. Google Cloud também oferece quotas de avaliação gratuita que oferecem acesso limitado aos utilizadores que estão a explorar Google Cloud, incluindo a API Cloud Healthcare.
As quotas da Cloud Healthcare API são aplicadas por projeto numa base por região ou multirregião. O esgotamento da quota numa única região não afeta a sua utilização da Cloud Healthcare API noutras regiões.
Verificar as suas quotas e utilização
As quotas são limites de armazenamento (também denominados limites de entrada) e operações.
Para verificar a quota disponível para recursos no seu projeto, aceda à página Quotas na Google Cloud consola.
Para apresentar apenas as quotas da Cloud Healthcare API, na lista pendente Filtrar tabela, selecione Serviço e, de seguida, selecione Cloud Healthcare API.
Nem todos os projetos têm as mesmas quotas. À medida que a sua utilização da Cloud Healthcare API se expande ao longo do tempo, as suas quotas podem aumentar em conformidade. Se prevê um aumento significativo da utilização, pode pedir proativamente ajustes de quota na página Quotas na Google Cloud consola. Não é cobrado nenhum valor pelo pedido de aumento da quota. Os seus custos aumentam apenas se usar mais recursos.
Limites de recursos
A Cloud Healthcare API limita o tamanho do conteúdo de um pedido, como o tamanho de uma imagem de raios X num pedido DICOM. Não pode pedir uma alteração a um limite de recursos. No entanto, em algumas situações, pode usar uma operação de importação para importar conteúdo que seja superior a um limite de recursos.
Aplicam-se os seguintes limites de recursos, que estão sujeitos a alterações.
| Modalidade | Limite de tamanho do pedido |
|---|---|
| DICOM |
|
| FHIR |
|
| HL7v2 | 10 MB |
Se tentar processar conteúdo superior ao limite de recursos associado, ocorre um erro.
Limites de tamanho do FHIR executeBundle
Pode usar o método fhir.executeBundle
para realizar várias operações FHIR num único pedido de API. O número de operações depende do número de entradas num lote ou num pacote de transações. Esta abordagem é mais eficiente do que fazer chamadas API individuais para cada operação.
Os tempos de processamento dos pedidos fhir.executeBundle aumentam com o número de entradas no pacote. Fatores como a contenção de recursos (por exemplo, a atualização do mesmo recurso como parte de vários pacotes de transações em paralelo) também podem afetar o desempenho. Para ver exemplos de quando a contenção de recursos pode ocorrer e como evitar que cause erros, consulte as práticas recomendadas de débito de dados.
Os pacotes grandes, especialmente os que excedem 1000 entradas, podem exceder o tempo limite e não serem concluídos.
Para garantir um processamento bem-sucedido e atempado, tenha em atenção estes limites ao enviar os seus pedidos fhir.executeBundle:
- Pacotes de transações: os pacotes que excedam 4500 entradas são imediatamente rejeitados para evitar limites de tempo. Os conjuntos de transações requerem que todas as operações sejam bem-sucedidas.
- Pacotes em lote: não existe um limite de entradas específico, mas os pacotes maiores aumentam o risco de limites de tempo. Os limites de tempo podem resultar num êxito parcial, com apenas algumas entradas processadas.
Usar operações de importação para conteúdo que excede os limites de recursos
As operações de importação permitem-lhe processar conteúdo superior ao limite de recursos associado. O tamanho do conteúdo numa operação de importação só é limitado pelo tamanho máximo de armazenamento de 5 TB para objetos individuais. Google Cloud As operações de importação estão sujeitas a quotas de armazenamento que determinam a duração de uma operação de importação. Por exemplo, pode querer usar uma operação de importação se quiser armazenar muitas instâncias DICOM num arquivo DICOM e não quiser estar sujeito ao limite de tamanho do pedido. Em vez de carregar as instâncias através dos métodos de transação na loja disponíveis, pode carregar as instâncias para um contentor do Cloud Storage e, em seguida, importá-las para a loja DICOM.
Para ver passos detalhados sobre como importar dados DICOM através de uma operação de importação, consulte o artigo Importar e exportar dados DICOM.
Para ver passos detalhados sobre como importar recursos FHIR através de uma operação de importação, consulte o artigo Importar e exportar recursos FHIR.
Para ver passos detalhados para importar mensagens HL7v2 através de uma operação de importação, consulte o artigo Importe mensagens HL7v2 do Cloud Storage.
Peça uma alteração à quota
Para pedir uma alteração a uma quota, tem de ter autorização serviceusage.quotas.update. Esta autorização está incluída por predefinição
para as seguintes funções predefinidas: proprietário,
editor e administrador de quotas.
Aceda à página Quotas.
Na página Quotas, selecione as quotas que quer alterar. Se quiser apresentar apenas as quotas da Cloud Healthcare API, selecione Serviço na lista pendente Filtrar tabela e, de seguida, selecione Cloud Healthcare API.
Selecione as caixas das quotas que quer editar.
Clique no botão Editar quotas na parte superior da página.
Preencha o formulário e, de seguida, clique em Seguinte.
Introduza os limites que está a pedir e, de seguida, clique em Seguinte.
Clique em Enviar pedido.
Por predefinição, um pedido para diminuir a quota é rejeitado. Se quiser reduzir a sua quota, responda ao email de apoio técnico com uma explicação dos seus requisitos. Um representante do apoio técnico vai responder ao seu pedido.
Vai receber uma resposta da equipa da Cloud Healthcare API no prazo de 24 a 48 horas após o seu pedido.
Planeie pedir recursos adicionais com, pelo menos, alguns dias de antecedência para garantir que há tempo suficiente para satisfazer o seu pedido.
Pedidos de quota de localização
Pode pedir um aumento da quota para a Cloud Healthcare API numa região específica ou numa localização multirregional.
Para pedir um aumento da quota numa única região: no seu pedido de aumento da quota, especifique a região.
Para pedir um aumento da quota numa localização de várias regiões:
- Para um aumento da quota na região múltipla
us, indique no seu pedido que a quota se destina à "metaregião dos EUA". - Para um aumento da quota na região múltipla
eu, indique no seu pedido que a quota se destina à "metaregião da UE".
Limites de quota
As secções seguintes descrevem as quotas associadas às operações e às bases de dados da Cloud Healthcare API.
Quotas DICOM
A tabela seguinte descreve as quotas da Cloud Healthcare API associadas a arquivos DICOM e operações DICOM.
| Nome da métrica | Nome a apresentar | Descrição |
|---|---|---|
dicomweb_ops |
Número de operações DICOMweb por minuto por região | Inclui os seguintes métodos:
|
dicom_structured_storage_bytes |
Ingressão de armazenamento DICOM estruturado em bytes por minuto por região | Bytes estruturados, sob a forma de etiquetas DICOM e metadados relacionados, enviados para a Cloud Healthcare API durante o processamento de operações dicomweb_ops. |
dicom_store_ops |
Número de operações de armazenamento DICOM por minuto por região | Operações na loja DICOM, não nos dados DICOM. Inclui os seguintes métodos: |
dicom_store_lro_ops |
Número de operações de longa duração da loja DICOM por minuto por região | Operações na loja DICOM, não em dados DICOM, que devolvem uma operação de longa duração. Inclui os seguintes métodos: |
dicom_structured_storage_operations_bytes |
Entrada de armazenamento DICOM estruturado para operações de longa duração em bytes por minuto por região | Bytes estruturados, sob a forma de etiquetas DICOM e metadados relacionados, enviados para a Cloud Healthcare API durante o processamento de operações dicom_store_lro_ops. |
Quotas da FHIR
A tabela seguinte descreve as quotas da Cloud Healthcare API associadas às lojas FHIR e às operações FHIR.
| Nome da métrica | Nome a apresentar | Descrição |
|---|---|---|
fhir_read_ops |
Número de operações de leitura FHIR por minuto por região | Medido em unidades, em que uma unidade é um pedido de leitura num recurso FHIR individual. Inclui os seguintes métodos: v1beta1: v1: |
fhir_write_ops |
Número de operações de escrita FHIR por minuto por região | Medido em unidades, em que uma unidade é um pedido de criação, atualização ou eliminação num recurso FHIR individual. Inclui os seguintes métodos: v1beta1: v1: |
fhir_search_ops |
Número de operações de pesquisa FHIR por minuto por região | Medido em unidades, em que uma unidade é um pedido de pesquisa num tipo de recurso FHIR em que a pesquisa não requer a resolução de referências, exceto quando é usado _include. Por exemplo, uma pesquisa Observation?subject:Patient.identifier=system|value consome duas unidades de quota fhir_search_ops porque requer duas pesquisas, uma no recurso Observation e outra no recurso Patient, usando o subject como referência.Inclui os seguintes métodos: v1beta1:
|
fhir_storage_egress_bytes |
Saída de armazenamento FHIR em bytes por minuto por região | Medido em unidades, em que uma unidade é um byte que a Cloud Healthcare API lê do armazenamento durante o processamento das operações fhir_read_ops, fhir_write_ops e fhir_search_ops. |
fhir_storage_bytes |
Ingress de armazenamento FHIR em bytes por minuto por região | Bytes enviados para a API Cloud Healthcare durante o processamento de operações fhir_write_ops. |
fhir_store_ops |
Número de operações da loja FHIR por minuto por região | Operações na loja FHIR, não em dados FHIR. Inclui os seguintes métodos: |
fhir_store_lro_ops |
Número de operações de longa duração da FHIR store por minuto por região | Operações na loja FHIR, não em dados FHIR, que devolvem uma operação de longa duração. Inclui os seguintes métodos: |
fhir_storage_operations_bytes |
Carregamento de armazenamento FHIR para operações de longa duração em bytes por minuto por região | Bytes enviados para a API Cloud Healthcare durante o processamento de operações fhir_store_lro_ops. |
Pesquisas com várias operações
Um único pedido pode consumir várias unidades de quota. Por exemplo, um pedido de pesquisa GET que use Observation?subject:Patient.identifier=system|value como parâmetro de pesquisa consome 2 unidades de quota fhir_search_ops. São realizadas duas operações de pesquisa, uma no recurso Observation e outra no recurso Patient, usando o
subject como referência.
Se um pedido de eliminação condicional que usa Observation?status=canceled como os critérios de pesquisa pesquisar e eliminar seis recursos Observation, são consumidas as seguintes unidades de quota:
- Uma unidade de quota
fhir_search_ops, porque o pedido de pesquisaGETsó é realizado num tipo de recurso FHIR, o recurso de observação. O pedido devolve todos os recursos Observation que correspondem aos critérios de pesquisa. - Seis unidades de quota, porque existem um total de seis operações
DELETEnos recursos de observação eliminados.fhir_write_ops
Execute o consumo da quota do pacote
Para enviar um pedido execute bundle, independentemente da quota que o pedido consuma, o seu projeto tem de ter, pelo menos, uma unidade disponível para cada uma das seguintes quotas:Google Cloud
fhir_read_opsfhir_write_opsfhir_search_ops
Se estas quotas não estiverem disponíveis, o pedido de pacote de execução falha.
Por exemplo, se enviar um pedido fhir.executeBundle com um pacote de transações que contenha 100 operações POST, cada uma das quais cria um recurso FHIR, a Cloud Healthcare API verifica primeiro se está disponível, pelo menos, uma unidade de quota para fhir_read_ops, fhir_write_ops e fhir_search_ops. Se a validação for bem-sucedida, a Cloud Healthcare API
executa o pacote e cria os recursos FHIR, que consomem um total de
100 unidades de quota fhir_write_ops.
Considere o seguinte conjunto de transações, que usa uma referência condicional para criar um recurso de observação se o reference existir:
{
"resourceType": "Bundle",
"type": "transaction",
"entry": [
{
"request": {
"method": "POST",
"url": "Observation"
},
"resource": {
"resourceType": "Observation",
"subject": {
"reference": "Patient?identifier=a1b2c3d4e5"
}
}
}
]
}
Quando executa o pacote, a Cloud Healthcare API verifica primeiro se está disponível, pelo menos, uma unidade de quota para fhir_read_ops, fhir_write_ops e fhir_search_ops. Se a validação for bem-sucedida, a Cloud Healthcare API
executa o pacote. As seguintes unidades de quota são consumidas:
- Um
fhir_write_opspara criar o novo recurso Observation. - Um
fhir_search_ops, porque é realizada uma única operação de pesquisa na referênciaPatient?identifier=a1b2c3d4e5.
Práticas recomendadas
Para ver as práticas recomendadas sobre a gestão da quota da Cloud Healthcare API, consulte o artigo Práticas recomendadas de gestão de quotas.