할당량 및 한도

Cloud Healthcare API는 다양한 이유로 리소스 사용량에 한도를 적용합니다. 예를 들어 할당량은 사용량이 예기치 않게 급증하는 것을 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. Google Cloud에서는 무료 체험판 할당량도 제공하여 Cloud Healthcare API를 비롯해 Google Cloud를 살펴보는 사용자에게 제한적인 액세스 권한을 부여합니다.

Cloud Healthcare API에 대한 할당량은 리전 단위로 적용합니다. 단일 리전의 할당량이 소진되어도 다른 리전의 Cloud Healthcare API 사용에 영향을 미치지 않습니다.

할당량 및 사용량 확인

할당량은 저장용량(인그레스 제한이라고도 함) 및 작업에 대한 한도입니다.

프로젝트 리소스에 사용할 수 있는 할당량을 확인하려면 Cloud Console의 할당량 페이지로 이동하세요.

Cloud Healthcare API 할당량만 표시하려면 모든 서비스 > 없음을 클릭하고 Cloud Healthcare API를 선택하세요.

모든 프로젝트의 할당량이 동일하지는 않습니다. Cloud Healthcare API 사용량이 점차 늘어나면 할당량도 이에 따라 상향 조정할 수 있습니다. 앞으로 사용량이 현저하게 늘어날 것으로 예상되는 경우 Google Cloud Console의 할당량 페이지에서 사전에 할당량 조정을 요청할 수 있습니다. 할당량 상향 요청 자체는 요금이 부과되지 않으며 리소스를 더 사용한 경우에만 요금이 증가합니다.

리소스 한도

Cloud Healthcare API는 요청 콘텐츠의 크기(예: DICOM 요청의 X-선 이미지 크기)를 제한합니다. 리소스 한도 변경을 요청할 수 없지만 경우에 따라 가져오기 작업을 사용해 리소스 한도보다 더 콘텐츠를 가져올 수 있습니다.

다음과 같은 리소스 한도가 적용되며 이는 변경될 수 있습니다.

형식 요청 크기 한도
DICOM
  • Store 트랜잭션: 무제한, 그 외 모든 메서드는 10MB가 가능합니다.
  • Store 트랜잭션/Retrieve 트랜잭션: 작업이 1시간을 초과하면 시간 초과가 발생합니다.
  • Search 트랜잭션 메서드의 최대 오프셋은 1,000,000입니다.
  • 익명화: 익명화는 1GB보다 큰 DICOM 파일을 처리할 수 없습니다.
  • 수집된 DICOM 파일의 태그당 한도는 2GB입니다. 한도는 기본 형식으로 인코딩된 PixelData를 포함합니다.
  • DICOM 데이터 트랜스코딩 시 최대 파일 크기는 1GB, 최대 프레임 크기는 150MB입니다.
  • dicomStores.import: 최대 파일 크기는 20GB입니다.
FHIR executeBundle: 50MB, 그 외 모든 메서드는 10MB가 가능합니다.
HL7v2 10MB

연관 리소스 한도보다 큰 콘텐츠를 처리하려고 하면 오류가 발생합니다.

리소스 한도를 초과하는 콘텐츠 가져오기 작업을 사용하는 경우

가져오기 작업을 사용하면 연관 리소스 한도보다 큰 콘텐츠를 처리할 수 있습니다. 가져오기 작업의 콘텐츠 크기는 개별 객체에 대한 Google Cloud 최대 저장용량 크기인 5TB로만 제한됩니다. 가져오기 작업은 가져오기 작업의 소요 시간을 결정하는 저장용량 할당량의 적용을 받습니다. 예를 들어 여러 DICOM 인스턴스를 DICOM 저장소에 저장하되 요청 크기 한도의 적용은 받고 싶지 않은 경우 가져오기 작업을 사용하는 것이 좋습니다. 사용할 수 있는 Store 트랜잭션 메서드를 통해 인스턴스를 업로드하지 않고 인스턴스를 Cloud Storage 버킷에 업로드한 다음 DICOM 저장소에 가져오면 됩니다.

가져오기 작업을 사용한 DICOM 데이터 가져오기에 대한 자세한 단계는 DICOM 데이터 가져오기 및 내보내기를 참조하세요.

가져오기 작업을 사용한 FHIR 리소스 가져오기에 대한 자세한 단계는 FHIR 리소스 가져오기 및 내보내기를 참조하세요.

할당량 변경 요청

할당량 변경을 요청하려면 serviceusage.quotas.update 권한이 있어야 합니다. 이 권한은 사전 정의된 역할인 소유자, 편집자, 할당량 관리자에 기본적으로 포함되어 있습니다.

  1. 할당량 페이지로 이동합니다.

    할당량 페이지로 이동

  2. 할당량 페이지에서 변경할 할당량을 선택합니다. Cloud Healthcare API 할당량만 표시하려면 서비스 목록 > 없음을 클릭한 후 Cloud Healthcare API를 클릭하세요.
  3. 수정하고자 하는 할당량의 체크박스를 선택합니다.
  4. 페이지 상단의 할당량 수정 버튼을 클릭합니다.
  5. 양식을 작성하고 다음을 클릭합니다.
  6. 요청할 한도를 입력하고 다음을 클릭합니다.
  7. 요청 제출을 클릭합니다.

할당량 하향 요청은 기본적으로 거부됩니다. 할당량을 하향 조정하려면 지원 이메일에 답장하여 요구사항을 설명해 주시기 바랍니다. 지원팀 담당자가 요청에 대한 답변을 드립니다.

요청 후 24~48시간 내에 Cloud Healthcare API팀이 답변을 드립니다.

요청을 처리하는 데 충분한 시간을 확보할 수 있도록 최소 며칠 전에 추가 리소스 요청을 계획하고 요청하시기 바랍니다.