データストアの作成 - AWS HealthImaging

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

データストアの作成

CreateDatastore アクションを使用して、DICOM P10 ファイルをインポートするための AWS HealthImaging データストアを作成します。以下のメニューでは、 の手順AWS マネジメントコンソールと、 AWS CLIおよび AWSSDKs。詳細については、「AWS HealthImaging API リファレンス」の「CreateDatastore」を参照してください。データストアを作成するときに、AWS HealthImaging が可逆画像フレームのトランスコードと保存に使用したデフォルトの転送構文を選択できます。データストアの作成後にこの設定を変更することはできません。

高スループット JPEG 2000 (HTJ2K)

HTJ2K (高スループット JPEG 2000) は、HealthImaging データストアのデフォルトのストレージ形式です。これは JPEG 2000 標準の拡張であり、エンコードとデコードのパフォーマンスが大幅に向上します。を指定せずにデータストアを作成すると—lossless-storage-format、HealthImaging は自動的に HTJ2K を使用します。HTJ2SDKs セクションを参照してください。 HTJ2K

JPEG 2000 ロスレス

JPEG 2000 ロスレスエンコーディングを使用すると、トランスコードなしで JPEG 2000 形式でロスレスイメージフレームを永続化および取得するデータストアを作成できるため、JPEG 2000 ロスレス (DICOM Transfer Syntax UID 1.2.840.10008.1.2.4.90) を必要とするアプリケーションのレイテンシーを短縮できます。詳細については、サポートされる転送構文「」を参照してください。JPEG 2000 ロスレス形式を使用したデータストアの作成については、以下の AWS CLI および SDKs セクションを参照してください。

[重要]
  • 保護対象の医療情報 (PHI)、個人を特定できる情報 (PII)、またはその他の機密情報や秘匿性の高い情報はデータストア名に使用しないでください。

  • AWS コンソールは、デフォルト設定でのデータストアの作成をサポートしています。CLI または AWSSDK AWSを使用して、オプションの を指定してデータストアを作成します—lossless-storage-format

データストアを作成するには

AWS HealthImaging のアクセス設定に基づいてメニューを選択します。

  1. HealthImaging コンソールの「データストアの作成ページ」を開きます。

  2. [詳細][データストア名] に、データストアの名前を入力します。

  3. データ暗号化で、リソースを暗号化するための AWS KMSキーを選択します。詳細については、「AWS HealthImaging でのデータ保護」を参照してください。

  4. [タグ - オプション] では、データストアを作成するときに、データストアにタグを追加できます。詳細については、「リソースのタギング」を参照してください。

  5. [データストアの作成] を選択します。

Bash
AWS CLIBash スクリプトを使用する
############################################################################### # function errecho # # This function outputs everything sent to it to STDERR (standard error output). ############################################################################### function errecho() { printf "%s\n" "$*" 1>&2 } ############################################################################### # function imaging_create_datastore # # This function creates an AWS HealthImaging data store for importing DICOM P10 files. # # Parameters: # -n data_store_name - The name of the data store. # # Returns: # The datastore ID. # And: # 0 - If successful. # 1 - If it fails. ############################################################################### function imaging_create_datastore() { local datastore_name response local option OPTARG # Required to use getopts command in a function. # bashsupport disable=BP5008 function usage() { echo "function imaging_create_datastore" echo "Creates an AWS HealthImaging data store for importing DICOM P10 files." echo " -n data_store_name - The name of the data store." echo "" } # Retrieve the calling parameters. while getopts "n:h" option; do case "${option}" in n) datastore_name="${OPTARG}" ;; h) usage return 0 ;; \?) echo "Invalid parameter" usage return 1 ;; esac done export OPTIND=1 if [[ -z "$datastore_name" ]]; then errecho "ERROR: You must provide a data store name with the -n parameter." usage return 1 fi response=$(aws medical-imaging create-datastore \ --datastore-name "$datastore_name" \ --output text \ --query 'datastoreId') local error_code=${?} if [[ $error_code -ne 0 ]]; then aws_cli_error_log $error_code errecho "ERROR: AWS reports medical-imaging create-datastore operation failed.$response" return 1 fi echo "$response" return 0 }
  • API の詳細については、AWS CLI コマンドリファレンスの「CreateDatastore」を参照してください。

注記

GitHub には、その他のリソースもあります。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。

CLI
AWS CLI

例 1:データストアにタグを付けるには

次の create-datastore コード例では、my-datastore という名が付けられたデータストアを作成しています。を指定せずにデータストアを作成する場合--lossless-storage-format、AWSHealthImaging のデフォルトは HTJ2K (高スループット JPEG 2000) です。

aws medical-imaging create-datastore \ --datastore-name "my-datastore"

出力:

{ "datastoreId": "12345678901234567890123456789012", "datastoreStatus": "CREATING" }

例 2: JPEG 2000 ロスレスストレージ形式でデータストアを作成するには

JPEG 2000 ロスレスストレージ形式で設定されたデータストアは、可逆イメージフレームを JPEG 2000 形式でトランスコードして保持します。その後、画像フレームは JPEG 2000 ロスレス、トランスコーディングなしで取得できます。次の create-datastore コード例では、my-datastore という名前の JPEG 2000 ロスレスストレージ形式用に設定されたデータストアを作成します。

aws medical-imaging create-datastore \ --datastore-name "my-datastore" \ --lossless-storage-format JPEG_2000_LOSSLESS

出力:

{ "datastoreId": "12345678901234567890123456789012", "datastoreStatus": "CREATING" }

詳細については、「AWS HealthImaging Developer Guide」の「Creating a data store」を参照してください。

  • API の詳細については、「AWS CLI コマンドリファレンス」の「CreateDatastore」を参照してください。

Java
SDK for Java 2.x
public static String createMedicalImageDatastore(MedicalImagingClient medicalImagingClient, String datastoreName) { try { CreateDatastoreRequest datastoreRequest = CreateDatastoreRequest.builder() .datastoreName(datastoreName) .build(); CreateDatastoreResponse response = medicalImagingClient.createDatastore(datastoreRequest); return response.datastoreId(); } catch (MedicalImagingException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } return ""; }
  • API の詳細については、AWS SDK for Java 2.x API リファレンスの「CreateDatastore」を参照してください。

注記

GitHub には、その他のリソースもあります。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。

JavaScript
SDK for JavaScript (v3)
import { CreateDatastoreCommand } from "@aws-sdk/client-medical-imaging"; import { medicalImagingClient } from "../libs/medicalImagingClient.js"; /** * @param {string} datastoreName - The name of the data store to create. */ export const createDatastore = async (datastoreName = "DATASTORE_NAME") => { const response = await medicalImagingClient.send( new CreateDatastoreCommand({ datastoreName: datastoreName }), ); console.log(response); // { // '$metadata': { // httpStatusCode: 200, // requestId: 'a71cd65f-2382-49bf-b682-f9209d8d399b', // extendedRequestId: undefined, // cfId: undefined, // attempts: 1, // totalRetryDelay: 0 // }, // datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // datastoreStatus: 'CREATING' // } return response; };
  • API の詳細については、AWS SDK for JavaScript API リファレンスの「CreateDatastore」を参照してください。

注記

GitHub には、その他のリソースもあります。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。

Python
SDK for Python (Boto3)
class MedicalImagingWrapper: def __init__(self, health_imaging_client): self.health_imaging_client = health_imaging_client def create_datastore(self, name): """ Create a data store. :param name: The name of the data store to create. :return: The data store ID. """ try: data_store = self.health_imaging_client.create_datastore(datastoreName=name) except ClientError as err: logger.error( "Couldn't create data store %s. Here's why: %s: %s", name, err.response["Error"]["Code"], err.response["Error"]["Message"], ) raise else: return data_store["datastoreId"]

次のコードは MedicalImagingWrapper オブジェクトをインスタンス化します。

client = boto3.client("medical-imaging") medical_imaging_wrapper = MedicalImagingWrapper(client)
  • API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「CreateDatastore」を参照してください。

注記

GitHub には、その他のリソースもあります。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。

可用性の例

必要なものが見つからなかった場合。このページの右側サイドバーにあるフィードバックを提供するリンクを使用して、コード例をリクエストします。