Udostępnij za pośrednictwem


Szybki start: wdrażanie interfejsu AZURE API for FHIR przy użyciu programu PowerShell

Ważne

Usługa Azure API for FHIR zostanie wycofana 30 września 2026 r. Postępuj zgodnie ze strategiami migracji, aby przejść do usługi Azure Health Data Services FHIR® do tej daty. Ze względu na wycofanie usługi Azure API for FHIR nowe wdrożenia nie będą możliwe od 1 kwietnia 2025 r. Usługa FHIR usług Azure Health Data Services to rozwinięta wersja usługi Azure API for FHIR, która umożliwia klientom zarządzanie usługami FHIR, DICOM i MedTech z integracją z innymi usługami platformy Azure.

Z tego przewodnika Szybki start dowiesz się, jak wdrożyć interfejs API platformy Azure dla standardu FHIR przy użyciu programu PowerShell.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell. Aby uruchomić kod w tym artykule, możesz użyć wstępnie zainstalowanych poleceń usługi Cloud Shell bez konieczności instalowania niczego w środowisku lokalnym.

Aby uruchomić środowisko Azure Cloud Shell:

Opcja Przykład/link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu lub polecenia. Wybranie pozycji Wypróbuj nie powoduje automatycznego skopiowania kodu lub polecenia do usługi Cloud Shell. Zrzut ekranu przedstawiający przykład narzędzia Try It dla usługi Azure Cloud Shell.
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce. Przycisk uruchamiania usługi Azure Cloud Shell.
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal. Zrzut ekranu przedstawiający przycisk usługi Cloud Shell w witrynie Azure Portal

Aby użyć usługi Azure Cloud Shell:

  1. Uruchom usługę Cloud Shell.

  2. Wybierz przycisk Kopiuj w bloku kodu (lub bloku poleceń), aby skopiować kod lub polecenie.

  3. Wklej kod lub polecenie do sesji usługi Cloud Shell, wybierając Ctrl+Shift V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift++V w systemie macOS.

  4. Wybierz Enter, aby uruchomić kod lub polecenie.

Uwaga

Do interakcji z platformą Azure zalecamy używanie modułu Azure Az w programie PowerShell. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Rejestrowanie dostawcy zasobów usługi Azure API for FHIR

Microsoft.HealthcareApis Jeśli dostawca zasobów nie został jeszcze zarejestrowany dla twojej subskrypcji, możesz zarejestrować go za pomocą następującego polecenia.

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Tworzenie grupy zasobów platformy Azure

New-AzResourceGroup -Name "myResourceGroupName" -Location westus2

Wdrażanie usługi Azure API for FHIR

New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4

Uwaga

W zależności od zainstalowanego modułu Az programu PowerShell aprowizowanego serwera FHIR można skonfigurować tak, aby korzystał z lokalnej kontroli dostępu opartej na rolach (RBAC) i mieć aktualnie zalogowanego użytkownika programu PowerShell na liście dozwolonych identyfikatorów obiektów tożsamości dla wdrożonej usługi FHIR. Zalecamy używanie kontroli dostępu opartej na rolach platformy Azure do przypisywania ról płaszczyzny danych. Może być konieczne usunięcie identyfikatora obiektu tego użytkownika po wdrożeniu, aby włączyć tryb RBAC platformy Azure.

Instrukcja pobierania możliwości

Możesz sprawdzić, czy konto usługi Azure API for FHIR jest uruchomione, pobierając instrukcję funkcji FHIR za pomocą następujących poleceń.

$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent

Czyszczenie zasobów

Jeśli nie zamierzasz nadal korzystać z tej aplikacji, usuń grupę zasobów, wykonując następujące kroki.

Remove-AzResourceGroup -Name myResourceGroupName

Następne kroki

W tym przewodniku Szybki start wdrożono interfejs API platformy Azure for FHIR w ramach subskrypcji. Aby uzyskać więcej informacji na temat ustawień w usłudze Azure API for FHIR i rozpoczynania korzystania z usługi Azure API for FHIR, zobacz

Uwaga

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.