このページでは、Digital Imaging and Communications in Medicine(DICOM)ストアを作成、編集、表示、一覧表示、削除する方法について説明します。
DICOM ストアは DICOM インスタンスを保持します。Cloud Healthcare API で DICOMweb の実装を使用して、DICOM ストアに DICOM インスタンスを追加して管理できます。また、Google Cloud サービスを使用して DICOM インスタンスをインポートおよびエクスポートすることもできます。
Cloud Healthcare API が DICOM 規格にどのように準拠しているかについては、DICOM 適合性宣言をご覧ください。
DICOM ストアの作成
DICOM ストアを作成する前に、データセットを作成する必要があります。
以下のサンプルは、DICOM ストアの作成方法を示しています。
Console
DICOM ストアを作成するには:
- Google Cloud コンソールで、[データセット] ページに移動します。
- DICOM ストアを作成するデータセットを選択します。
- [データストアの作成] をクリックします。
- データストアのタイプとして [DICOM] を選択します。
- データセット内で一意の名前を入力します。名前が一意でない場合、データストアの作成は失敗します。
- [次へ] をクリックします。
-
データストアの Pub/Sub トピックを構成する場合は、[Cloud Pub/Sub 通知の受信] をクリックし、トピック名を選択します。Pub/Sub トピックを指定する場合は、次のサンプルに示すように、トピックの修飾 URI を入力します。
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- [次へ] をクリックします。
- ストアに 1 つ以上のラベルを追加するには、[データストアを整理するラベルの追加] をクリックし、Key-Value ラベルを入力します。リソースラベルの詳細については、リソースラベルの使用をご覧ください。
- [作成] をクリックします。
新しいデータストアがリストに表示されます。
gcloud
DICOM ストアを削除するには、gcloud healthcare dicom-stores create
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストア ID。DICOM ストア ID は、次の要件を満たす必要があります。- そのデータセットの一意の ID
- 次のもので構成される 1 ~ 256 文字の Unicode 文字列。
- 数字
- 文字
- アンダースコア
- ダッシュ
- ピリオド
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
次のようなレスポンスが返されます。
レスポンス
Created dicomStore [DICOM_STORE_ID].
REST
DICOM ストアを作成するには、projects.locations.datasets.dicomStores.create
メソッドを使用します。
データをリクエストする前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストア ID。DICOM ストア ID は、次の要件を満たす必要があります。- そのデータセットの一意の ID
- 次のもので構成される 1 ~ 256 文字の Unicode 文字列。
- 数字
- 文字
- アンダースコア
- ダッシュ
- ピリオド
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
PowerShell
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
Go
Java
Node.js
Python
DICOM ストアの編集
次のサンプルは、DICOM ストアに対して次の変更を行う方法を示しています。
- Cloud Healthcare API が DICOM ストアの変更通知を送信する Pub/Sub トピックを編集します。
- ラベルを編集します。ラベルは、Google Cloud リソースの整理で役立つ Key-Value ペアです。
projects/PROJECT_ID/topics/PUBSUB_TOPIC通知が機能するためには、Cloud Healthcare サービス エージェントのサービス アカウントに追加の権限を付与する必要があります。 詳しくは、DICOM、FHIR、HL7v2 ストアの Pub/Sub 権限をご覧ください。
Console
DICOM ストアを編集するには、次の手順を行います。
- Google Cloud コンソールで、[データセット] ページに移動します。
- 編集する DICOM ストアを含むデータセットを選択します。
- [データストア] リストで、編集するデータストアをクリックします。
- データストアの Pub/Sub トピックを構成する場合は、[Cloud Pub/Sub トピックを選択してください] からトピック名を選択します。
- ストアに 1 つ以上のラベルを追加するには、リソースラベルの使用をご覧ください。 [ラベル] をクリックし、[ラベルを追加] をクリックして、Key-Value ラベルを入力します。 リソースラベルの詳細については、
- [保存] をクリックします。
gcloud
DICOM ストアを編集するには、gcloud healthcare dicom-stores update
コマンドを実行します。gcloud CLI はラベルの編集をサポートしていません。
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの IDPUBSUB_TOPIC
: データストアでイベントが発生した場合にメッセージが公開される Pub/Sub トピック
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows(PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows(cmd.exe)
gcloud healthcare dicom-stores update DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
次のようなレスポンスが返されます。
レスポンス
Updated dicomStore [DICOM_STORE_ID]. ... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
REST
DICOM ストアを編集するには、projects.locations.datasets.dicomStores.patch
メソッドを使用します。
データをリクエストする前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの IDPUBSUB_TOPIC
: データストアでイベントが発生した場合にメッセージが公開される Pub/Sub トピックKEY_1
: 最初のラベルキーVALUE_1
: 最初のラベル値KEY_2
: 2 番目のラベルキーVALUE_2
: 2 番目のラベル値
JSON 本文のリクエスト:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json
という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
その後、次のコマンドを実行して REST リクエストを送信します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
リクエスト本文を request.json
という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
その後、次のコマンドを実行して REST リクエストを送信します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
API Explorer
リクエスト本文をコピーして、メソッドのリファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。このツールにリクエスト本文を貼り付け、その他の必須フィールドに入力して、[Execute] をクリックします。
次のようなレスポンスが返されます。
DicomStore
リソースでフィールドを構成した場合は、そのフィールドもレスポンスに表示されます。
Go
Java
Node.js
Python
DICOM ストアの詳細を取得する
以下のサンプルは、DICOM ストアの詳細を取得する方法を示しています。
Console
DICOM ストアの詳細を表示するには:
- Google Cloud コンソールで、[データセット] ページに移動します。
- 表示する DICOM ストアを含むデータセットを選択します。
- DICOM ストアの名前をクリックします。
[概要] タブに、選択した DICOM ストアの詳細が表示されます。[指標] タブに、DICOM ストア、DICOM スタディ、DICOM シリーズの指標が表示されます。詳細については、DICOM ストア、DICOM スタディ、DICOM シリーズの指標を表示するをご覧ください。
gcloud
DICOM ストアの詳細を取得するには、gcloud healthcare dicom-stores describe
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの ID
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
次のようなレスポンスが返されます。
DicomStore
リソースでフィールドを構成した場合は、そのフィールドもレスポンスに表示されます。
レスポンス
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
FHIR ストアの詳細を取得するには、projects.locations.datasets.dicomStores.get
メソッドを使用します。
データをリクエストする前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの ID
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のようなレスポンスが返されます。
DicomStore
リソースでフィールドを構成した場合は、そのフィールドもレスポンスに表示されます。
Go
Java
Node.js
Python
データセット内の DICOM ストアの一覧表示
以下のサンプルは、データセット内の DICOM ストアを一覧表示する方法を示します。
Console
データセット内のデータストアを表示するには:
- Google Cloud コンソールで、[データセット] ページに移動します。
- 表示するデータストアを含むデータセットを選択します。
gcloud
データセット内の DICOM ストアを一覧表示するには、gcloud healthcare dicom-stores list
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセット
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
次のようなレスポンスが返されます。
DicomStore
リソースでフィールドを構成した場合は、そのフィールドもレスポンスに表示されます。
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
データセット内の DICOM ストアを一覧表示するには、projects.locations.datasets.dicomStores.list
メソッドを使用します。
データをリクエストする前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセット
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
PowerShell
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のようなレスポンスが返されます。
DicomStore
リソースでフィールドを構成した場合は、そのフィールドもレスポンスに表示されます。
Go
Java
Node.js
Python
DICOM ストアを削除する
以下のサンプルは、DICOM ストアを削除する方法を示します。
Console
データストアを削除するには:
- Google Cloud コンソールで、[データセット] ページに移動します。
- 削除するデータストアを含むデータセットを選択します。
- 削除するデータストアの [アクション] プルダウン リストから [削除] を選択します。
- 確認のために、データストア名を入力して [削除] をクリックします。
gcloud
DICOM ストアを削除するには、gcloud healthcare dicom-stores delete
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの ID
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
DICOM ストアを削除するには、projects.locations.datasets.dicomStores.delete
メソッドを使用します。
データをリクエストする前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: DICOM ストアの親データセットDICOM_STORE_ID
: DICOM ストアの ID
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。