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 avaliação gratuita que proporcionam acesso limitado para usuários explorarem o Google Cloud, incluindo a API Cloud Healthcare.
As cotas da API Cloud Healthcare são aplicadas por projeto, por região ou multirregional. 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 dos recursos no 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 do 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 às operações da API Cloud Healthcare.
Cotas DICOM
Na tabela a seguir, descrevemos as cotas da API Cloud Healthcare associadas a 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 por região | Inclui os seguintes métodos:
|
dicom_structured_storage_bytes |
Entrada de armazenamento DICOM estruturado em bytes por minuto e por região | Bytes estruturados, na forma de tags DICOM e metadados relacionados, enviados para a API Cloud Healthcare durante o processamento de operações dicomweb_ops . |
dicom_store_ops |
Número de operações de armazenamento DICOM por minuto e região | Operações no armazenamento DICOM, não em dados DICOM. Inclui os seguintes métodos: |
dicom_store_lro_ops |
Número de operações de longa duração do armazenamento DICOM por minuto e 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 e por região | Bytes estruturados, na forma de tags DICOM e metadados relacionados, enviados para a API Cloud Healthcare durante o processamento de operações dicom_store_lro_ops . |
Cotas do 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_ops |
Número de operações FHIR por minuto e por região | Medido em unidades, em que cada unidade é uma solicitação para qualquer método projects.locations.datasets.fhirStores.fhir nas versões v1beta1 e v1. |
fhir_read_ops |
Número de operações de leitura 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 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 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 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 durante o processamento de operações fhir_read_ops , fhir_write_ops e fhir_search_ops . |
fhir_storage_bytes |
Entrada do armazenamento FHIR em bytes por minuto por região | Bytes enviados para a API Cloud Healthcare durante o processamento de operações fhir_ops . |
fhir_store_ops |
Número de operações de armazenamento FHIR por minuto e por região | Operações no armazenamento de FHIR, não em dados de FHIR. Inclui os seguintes métodos: |
fhir_store_lro_ops |
Número de operações de longa duração do armazenamento FHIR por minuto e 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 e região | Bytes enviados para a API Cloud Healthcare durante o processamento de operações fhir_store_lro_ops . |
Pesquisas em 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
. Duas operações
de pesquisa são realizadas, uma no recurso "Observação" e outra no "Paciente", usando a
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 "Observação", as seguintes
unidades de cota vão ser consumidas:
- Uma unidade de cota
fhir_search_ops
, porque a solicitação de pesquisaGET
é realizada apenas em um tipo de recurso FHIR, o recurso Observação. A solicitação retorna todos os recursos de Observation correspondentes aos critérios de pesquisa. - Seis unidades de cota
fhir_write_ops
, porque há um total de seis operaçõesDELETE
nos recursos de observação excluídos.
Executar o consumo de cota do pacote
Para enviar uma solicitação de pacote de execução, independentemente da cota consumida, seu projeto do Google Cloud precisa ter pelo menos uma unidade disponível para cada uma das cotas a seguir:
fhir_read_ops
fhir_write_ops
fhir_search_ops
Se essas cotas não estiverem disponíveis, a solicitação de execução do pacote falhará.
Por exemplo, se você enviar uma solicitação fhir.executeBundle
com um pacote de transações contendo 100 operações POST
, cada uma criando um recurso FHIR, a API Cloud Healthcare primeiro verificará 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 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
executará o pacote. As unidades de cota a seguir são consumidas:
- Um
fhir_write_ops
para criar o novo recurso Observação. - Um
fhir_search_ops
, porque uma única operação de pesquisa é realizada na referênciaPatient?identifier=a1b2c3d4e5
.