A API Cloud Healthcare aplica limites ao uso de recursos por vários motivos. Por exemplo, as cotas protegem a comunidade de usuários do Google Cloud ao impedir picos de uso inesperados. O Google Cloud também oferece cotas de teste gratuito que fornecem acesso limitado para usuários que usam o Google Cloud, incluindo a API Cloud Healthcare.
As cotas da API Cloud Healthcare são aplicadas por projeto por região ou multirregião. O esgotamento da cota em uma única região não afetará o uso da API Cloud Healthcare em outras regiões.
Verificação das cotas e do uso
As cotas são limites de armazenamento (também chamados de limites de entrada) e operações.
Para verificar a cota disponível para recursos em seu projeto, acesse a página Cotas no console do Google Cloud.
Para exibir apenas cotas da API Cloud Healthcare, na lista suspensa Filtrar tabela, selecione Serviço e, em seguida, API Cloud Healthcare.
Nem todos os projetos têm as mesmas cotas. À medida que você usa mais a API Cloud Healthcare, as cotas também podem aumentar proporcionalmente. Caso espere um aumento de uso significativo, solicite o ajuste das cotas na página Cotas no console do Google Cloud. Não há custo algum para solicitar um aumento de cota. Seus custos aumentam apenas se você usar mais recursos.
Limites de recurso
A API Cloud Healthcare limita o tamanho do conteúdo de uma solicitação, como o tamanho de uma imagem de raios x em uma solicitação DICOM. Não é possível solicitar uma alteração em um limite de recurso. No entanto, em algumas situações, é possível usar uma operação de importação para importar conteúdo que excede o limite do recurso.
Os limites de recursos a seguir se aplicam e estão sujeitos a alterações.
| Modalidade | Limite de tamanho da solicitação |
|---|---|
| DICOM |
|
| FHIR | executeBundle: 50 MB; todos os outros métodos 10 MB |
| HL7v2 | 10 MB |
Se você tentar processar conteúdo além do limite de recurso associado, ocorrerá um erro.
Como usar operações de importação para conteúdo que excede os limites do recurso
As operações de importação permitem processar mais conteúdo que o limite de recursos associado. O tamanho do conteúdo em uma operação de importação é limitado apenas pelo tamanho máximo de armazenamento de 5 TB do Google Cloud para objetos individuais. As operações de importação estão sujeitas a cotas de armazenamento que determinam quanto tempo leva uma operação de importação. É possível usar uma operação de importação, por exemplo, se você quiser armazenar muitas instâncias DICOM em um armazenamento DICOM e não quiser estar sujeito ao limite de tamanho da solicitação. Em vez de fazer upload das instâncias usando os métodos de transações de armazenamento disponíveis, faça upload das instâncias em um bucket do Cloud Storage e depois importe-as para o armazenamento DICOM.
Para ver as etapas detalhadas de importação de dados DICOM usando uma operação desse tipo, consulte Como importar e exportar dados DICOM.
Para ver as etapas detalhadas de importação de recursos do FHIR usando uma operação desse tipo, consulte Como importar e exportar recursos do FHIR.
Para etapas detalhadas sobre como importar mensagens HL7v2 usando uma operação, consulte Como importar mensagens HL7v2.
Solicite uma alteração da cota
Para solicitar uma alteração em uma cota, você precisa ter
a permissão serviceusage.quotas.update. Por padrão, ela está incluída nos seguintes papéis predefinidos: proprietário, editor e administrador de cotas.
Acesse a página Cotas.
Na página Cotas, selecione as cotas que você quer alterar. Se você quer exibir apenas as cotas da API Cloud Healthcare API, selecione a opção Serviço na lista suspensa Filtrar tabela e depois clique em API Cloud Healthcare.
Marque as caixas das cotas que você quer editar.
Clique no botão Editar cotas na parte superior da página.
Preencha o formulário e clique em Avançar.
Insira os limites que você está solicitando e clique em Avançar.
Clique em Enviar solicitação.
Solicitações para redução de cota serão recusadas por padrão. Se você quiser reduzir sua cota, responda ao e-mail de suporte com uma explicação das suas necessidades. Um representante de suporte responderá à sua solicitação.
Você receberá uma resposta da equipe da API Cloud Healthcare de 24 a 48 horas após a solicitação.
Planeje solicitar outros recursos com pelo menos alguns dias de antecedência para garantir que o atendimento será feito a tempo.
Limites de cotas
As seções a seguir descrevem as cotas associadas aos armazenamentos de dados e operações da API Cloud Healthcare.
Cotas DICOM
A tabela a seguir descreve as cotas da API Cloud Healthcare associadas aos armazenamentos DICOM e operações DICOM.
| Nome da métrica | Nome de exibição | Descrição |
|---|---|---|
dicomweb_ops |
Número de operações DICOMweb por minuto e por região | Inclui os seguintes métodos:
|
dicom_structured_storage_bytes |
Entrada de armazenamento DICOM estruturado em bytes por minuto por região | Bytes estruturados, na forma de tags DICOM e metadados relacionados, enviados à API Cloud Healthcare ao processar as operações dicomweb_ops. |
dicom_store_ops |
Número de operações de armazenamento DICOM por minuto por região | Operações no armazenamento DICOM, não nos dados DICOM. Inclui os seguintes métodos: |
dicom_store_lro_ops |
Número de operações de armazenamento DICOM de longa duração por minuto por região | Operações no armazenamento DICOM, não dados DICOM, que retornam 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, na forma de tags DICOM e metadados relacionados, enviados à API Cloud Healthcare ao processar as operações dicom_store_lro_ops. |
Cotas de FHIR
Na tabela a seguir, descrevemos as cotas da API Cloud Healthcare associadas aos armazenamentos FHIR e às operações FHIR.
| Nome da métrica | Nome de exibição | Descrição |
|---|---|---|
fhir_read_ops |
Número de operações de leitura de FHIR por minuto e por região | Medido em unidades, em que uma unidade é uma solicitação de leitura em um recurso FHIR individual. Inclui os seguintes métodos: v1beta1: v1: |
fhir_write_ops |
Número de operações de gravação de FHIR por minuto e por região | Medido em unidades, em que uma unidade é uma solicitação de criação, atualização ou exclusão em um recurso FHIR individual. Inclui os seguintes métodos: v1beta1: v1: |
fhir_search_ops |
Número de operações de pesquisa FHIR por minuto e por região | Medido em unidades, em que uma unidade é uma solicitação de pesquisa em um tipo de recurso FHIR em que a pesquisa não exige a resolução de referências, exceto quando _include é usado. Por exemplo, uma pesquisa Observation?subject:Patient.identifier=system|value consome duas unidades de cota fhir_search_ops porque requer duas pesquisas, uma no recurso "Observação" e outra no recurso "Paciente", 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 API Cloud Healthcare lê do armazenamento ao processar as operações fhir_read_ops, fhir_write_ops e fhir_search_ops. |
fhir_storage_bytes |
Entrada de armazenamento FHIR em bytes por minuto por região | Bytes enviados para a API Cloud Healthcare durante o processamento das operações fhir_write_ops. |
fhir_store_ops |
Número de operações de armazenamento FHIR por minuto e por região | Operações no armazenamento FHIR, não nos dados FHIR. Inclui os seguintes métodos: |
fhir_store_lro_ops |
Número de operações de longa duração de armazenamento FHIR por minuto e por região | Operações no armazenamento FHIR, não nos dados FHIR, que retornam uma operação de longa duração. Inclui os seguintes métodos: |
fhir_storage_operations_bytes |
Entrada 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 das operações fhir_store_lro_ops. |
Pesquisas de várias operações
Uma única solicitação pode consumir várias unidades de cota. Por exemplo, uma solicitação de pesquisa GET que usa Observation?subject:Patient.identifier=system|value como o parâmetro de pesquisa consome duas unidades de cota fhir_search_ops. São realizadas duas operações de pesquisa, uma no recurso "Observação" e outra no recurso "Paciente", usando o subject como referência.
Se uma solicitação de exclusão condicional usando Observation?status=canceled como o critério de pesquisa procurar e excluir seis recursos de observação, as seguintes unidades de cota serão consumidas:
- Uma unidade de cota
fhir_search_ops, porque a solicitação de pesquisaGETé executada apenas em um tipo de recurso FHIR, o recurso de observação. A solicitação retorna todos os recursos de observação que correspondem aos critérios de pesquisa. - Seis unidades de cota
fhir_write_ops, porque há um total de seis operaçõesDELETEnos recursos de observação excluídos.
Executar consumo de cota de pacote
Para enviar uma solicitação de pacote de execução, independentemente da cota que a solicitação consome, o projeto do Google Cloud precisa ter pelo menos uma unidade disponível para cada uma das cotas a seguir:
fhir_read_opsfhir_write_opsfhir_search_ops
Se essas cotas não estiverem disponíveis, a solicitação de execução de pacote falhará.
Por exemplo, se você enviar uma solicitação fhir.executeBundle com um pacote de transação contendo 100 operações POST, cada uma criando um recurso FHIR, a API Cloud Healthcare verificará primeiro se pelo menos uma unidade de cota está disponível para fhir_read_ops, fhir_write_ops e fhir_search_ops. Se a verificação for bem-sucedida, a API Cloud Healthcare executará o pacote e criará os recursos FHIR, que consomem um total de 100 unidades de cota fhir_write_ops.
Considere o pacote de transações a seguir, 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 você executa o pacote, a API Cloud Healthcare
verifica primeiro se pelo menos uma unidade de cota está disponível para fhir_read_ops, fhir_write_ops e
fhir_search_ops. Se a verificação for bem-sucedida, a API Cloud Healthcare
vai executar o pacote. As seguintes unidades de cota são consumidas:
- Um
fhir_write_opspara criar o novo recurso de observação. - Um
fhir_search_ops, porque uma única operação de pesquisa é realizada na referênciaPatient?identifier=a1b2c3d4e5.