Freigeben über


Services - Create Or Update

Erstellen oder aktualisieren Sie die Metadaten einer Dienstinstanz.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}?api-version=2022-06-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Der Name der Ressourcengruppe, die die Dienstinstanz enthält.

resourceName
path True

string

minLength: 3
maxLength: 24

Der Name der Dienstinstanz.

subscriptionId
path True

string

Der Abonnementbezeichner.

api-version
query True

string

Client-API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
kind True

kind

Die Art des Diensts.

location True

string

Der Ressourcenspeicherort.

etag

string

Ein Etag, das der Ressource zugeordnet ist, wird bei der Bearbeitung für optimistische Parallelität verwendet.

identity

Identity

Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist.

properties

ServicesProperties

Die allgemeinen Eigenschaften eines Diensts.

tags

object

Die Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

ServicesDescription

Aktualisiert – Angenommene Anforderung und vorhandene Ressource werden aktualisiert; der Vorgang wird asynchron abgeschlossen.

201 Created

ServicesDescription

Erstellt – Put-Anforderung akzeptiert und eine neue Ressource wurde erstellt; der Vorgang wird asynchron abgeschlossen.

Other Status Codes

ErrorDetails

DefaultErrorResponse

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Create or Update a service with all parameters
Create or Update a service with minimum parameters

Create or Update a service with all parameters

Beispielanforderung

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service1?api-version=2022-06-01

{
  "location": "westus2",
  "tags": {},
  "kind": "fhir-R4",
  "properties": {
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      },
      {
        "objectId": "5b307da8-43d4-492b-8b66-b0294ade872f"
      }
    ],
    "cosmosDbConfiguration": {
      "offerThroughput": 1000,
      "keyVaultKeyUri": "https://my-vault.vault.azure.net/keys/my-key"
    },
    "authenticationConfiguration": {
      "authority": "https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc",
      "audience": "https://azurehealthcareapis.com",
      "smartProxyEnabled": true
    },
    "corsConfiguration": {
      "origins": [
        "*"
      ],
      "headers": [
        "*"
      ],
      "methods": [
        "DELETE",
        "GET",
        "OPTIONS",
        "PATCH",
        "POST",
        "PUT"
      ],
      "maxAge": 1440,
      "allowCredentials": false
    },
    "exportConfiguration": {
      "storageAccountName": "existingStorageAccount"
    },
    "privateEndpointConnections": [],
    "publicNetworkAccess": "Disabled"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service1",
  "name": "service1",
  "location": "West US 2",
  "type": "Microsoft.HealthcareApis/services",
  "kind": "fhir-R4",
  "etag": "etagvalue",
  "tags": {},
  "properties": {
    "provisioningState": "Creating",
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      },
      {
        "objectId": "5b307da8-43d4-492b-8b66-b0294ade872f"
      }
    ],
    "cosmosDbConfiguration": {
      "offerThroughput": 1000,
      "keyVaultKeyUri": "https://my-vault.vault.azure.net/keys/my-key"
    },
    "authenticationConfiguration": {
      "authority": "https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc",
      "audience": "https://azurehealthcareapis.com",
      "smartProxyEnabled": true
    },
    "corsConfiguration": {
      "origins": [
        "*"
      ],
      "headers": [
        "*"
      ],
      "methods": [
        "DELETE",
        "GET",
        "OPTIONS",
        "PATCH",
        "POST",
        "PUT"
      ],
      "maxAge": 1440,
      "allowCredentials": false
    },
    "exportConfiguration": {
      "storageAccountName": "existingStorageAccount"
    },
    "privateEndpointConnections": [],
    "publicNetworkAccess": "Disabled"
  },
  "identity": {
    "principalId": "03fe6ae0-952c-4e4b-954b-cc0364dd252e",
    "tenantId": "72f988bf-86f1-41af-91ab-2d8cd011db47",
    "type": "SystemAssigned"
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service1",
  "name": "service1",
  "location": "West US 2",
  "type": "Microsoft.HealthcareApis/services",
  "kind": "fhir-R4",
  "etag": "etagvalue",
  "tags": {},
  "properties": {
    "provisioningState": "Creating",
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      },
      {
        "objectId": "5b307da8-43d4-492b-8b66-b0294ade872f"
      }
    ],
    "cosmosDbConfiguration": {
      "offerThroughput": 1000
    },
    "authenticationConfiguration": {
      "authority": "https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc",
      "audience": "https://azurehealthcareapis.com",
      "smartProxyEnabled": true
    },
    "corsConfiguration": {
      "origins": [
        "*"
      ],
      "headers": [
        "*"
      ],
      "methods": [
        "DELETE",
        "GET",
        "OPTIONS",
        "PATCH",
        "POST",
        "PUT"
      ],
      "maxAge": 1440,
      "allowCredentials": false
    },
    "exportConfiguration": {
      "storageAccountName": "existingStorageAccount"
    },
    "privateEndpointConnections": [],
    "publicNetworkAccess": "Disabled"
  },
  "identity": {
    "principalId": "03fe6ae0-952c-4e4b-954b-cc0364dd252e",
    "tenantId": "72f988bf-86f1-41af-91ab-2d8cd011db47",
    "type": "SystemAssigned"
  }
}

Create or Update a service with minimum parameters

Beispielanforderung

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service2?api-version=2022-06-01

{
  "location": "westus2",
  "tags": {},
  "kind": "fhir-R4",
  "properties": {
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      }
    ]
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service2",
  "name": "service2",
  "type": "Microsoft.HealthcareApis/services",
  "etag": "etagvalue",
  "location": "westus2",
  "kind": "fhir-R4",
  "tags": {},
  "properties": {
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      }
    ],
    "cosmosDbConfiguration": {
      "offerThroughput": 1000
    },
    "authenticationConfiguration": {
      "authority": "https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc",
      "audience": "https://azurehealthcareapis.com",
      "smartProxyEnabled": false
    },
    "corsConfiguration": {
      "origins": [],
      "headers": [],
      "methods": [],
      "maxAge": null,
      "allowCredentials": false
    },
    "provisioningState": "Creating",
    "privateEndpointConnections": [],
    "publicNetworkAccess": "Disabled"
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.HealthcareApis/services/service2",
  "name": "service2",
  "type": "Microsoft.HealthcareApis/services",
  "etag": "etagvalue",
  "location": "westus2",
  "kind": "fhir-R4",
  "tags": {},
  "properties": {
    "accessPolicies": [
      {
        "objectId": "c487e7d1-3210-41a3-8ccc-e9372b78da47"
      }
    ],
    "cosmosDbConfiguration": {
      "offerThroughput": 1000,
      "keyVaultKeyUri": null
    },
    "authenticationConfiguration": {
      "authority": "https://login.microsoftonline.com/abfde7b2-df0f-47e6-aabf-2462b07508dc",
      "audience": "https://azurehealthcareapis.com",
      "smartProxyEnabled": false
    },
    "corsConfiguration": {
      "origins": [],
      "headers": [],
      "methods": [],
      "maxAge": null,
      "allowCredentials": false
    },
    "provisioningState": "Creating",
    "privateEndpointConnections": [],
    "publicNetworkAccess": "Disabled"
  }
}

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorDetails

Fehlerdetails.

ErrorDetailsInternal

Fehlerdetails.

Identity

Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist.

kind

Die Art des Diensts.

ManagedServiceIdentityType

Der Typ der angegebenen Identität, derzeit "SystemAssigned" und "None" sind zulässig.

PrivateEndpoint

Die Private Endpoint-Ressource.

PrivateEndpointConnection

Die Private Endpoint Connection-Ressource.

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

PrivateEndpointServiceConnectionStatus

Der Status der privaten Endpunktverbindung.

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.

provisioningState

Der Bereitstellungsstatus.

PublicNetworkAccess

Steuern sie die Berechtigung für Datenebenendatenverkehr aus öffentlichen Netzwerken, während der private Endpunkt aktiviert ist.

ServiceAccessPolicyEntry

Ein Zugriffsrichtlinieneintrag.

ServiceAcrConfigurationInfo

Konfigurationsinformationen zur Azure-Containerregistrierung

ServiceAuthenticationConfigurationInfo

Authentifizierungskonfigurationsinformationen

ServiceCorsConfigurationInfo

Die Einstellungen für die CORS-Konfiguration der Dienstinstanz.

ServiceCosmosDbConfigurationInfo

Die Einstellungen für die Cosmos DB-Datenbank, die den Dienst unterstützt.

ServiceExportConfigurationInfo

Exportvorgangskonfigurationsinformationen

ServiceImportConfigurationInfo

Konfigurationsinformationen für Importvorgänge

ServiceOciArtifactEntry

Ein Open Container Initiative (OCI)-Artefakt.

ServicesDescription

Die Beschreibung des Diensts.

ServicesProperties

Die Eigenschaften einer Dienstinstanz.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

ErrorDetails

Fehlerdetails.

Name Typ Beschreibung
error

ErrorDetailsInternal

Fehlerdetails

ErrorDetailsInternal

Fehlerdetails.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

Identity

Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist.

Name Typ Beschreibung
principalId

string

Die Prinzipal-ID der Ressourcenidentität.

tenantId

string

Die Mandanten-ID der Ressource.

type

ManagedServiceIdentityType

Der Typ der angegebenen Identität, derzeit "SystemAssigned" und "None" sind zulässig.

kind

Die Art des Diensts.

Wert Beschreibung
fhir
fhir-R4
fhir-Stu3

ManagedServiceIdentityType

Der Typ der angegebenen Identität, derzeit "SystemAssigned" und "None" sind zulässig.

Wert Beschreibung
None
SystemAssigned

PrivateEndpoint

Die Private Endpoint-Ressource.

Name Typ Beschreibung
id

string

Der ARM-Bezeichner für private Endpunkte

PrivateEndpointConnection

Die Private Endpoint Connection-Ressource.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.privateEndpoint

PrivateEndpoint

Die Ressource des privaten Endpunkts.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Der Bereitstellungsstatus der privaten Endpunktverbindungsressource.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

Wert Beschreibung
Creating
Deleting
Failed
Succeeded

PrivateEndpointServiceConnectionStatus

Der Status der privaten Endpunktverbindung.

Wert Beschreibung
Approved
Pending
Rejected

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.

Name Typ Beschreibung
actionsRequired

string

Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Verbraucher erfordern.

description

string

Der Grund für die Genehmigung/Ablehnung der Verbindung.

status

PrivateEndpointServiceConnectionStatus

Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde.

provisioningState

Der Bereitstellungsstatus.

Wert Beschreibung
Accepted
Canceled
Creating
Deleting
Deprovisioned
Failed
Moving
Succeeded
Suspended
SystemMaintenance
Updating
Verifying
Warned

PublicNetworkAccess

Steuern sie die Berechtigung für Datenebenendatenverkehr aus öffentlichen Netzwerken, während der private Endpunkt aktiviert ist.

Wert Beschreibung
Disabled
Enabled

ServiceAccessPolicyEntry

Ein Zugriffsrichtlinieneintrag.

Name Typ Beschreibung
objectId

string

pattern: ^(([0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}){1})+$

Eine Azure AD-Objekt-ID (Benutzer oder Apps), die zugriff auf den FHIR-Dienst erlaubt ist.

ServiceAcrConfigurationInfo

Konfigurationsinformationen zur Azure-Containerregistrierung

Name Typ Beschreibung
loginServers

string[]

Die Liste der ACR-Anmeldeserver.

ociArtifacts

ServiceOciArtifactEntry[]

Die Liste der Open Container Initiative (OCI)-Artefakte.

ServiceAuthenticationConfigurationInfo

Authentifizierungskonfigurationsinformationen

Name Typ Beschreibung
audience

string

Die Benutzergruppen-URL für den Dienst

authority

string

Die Autoritäts-URL für den Dienst

smartProxyEnabled

boolean

Wenn der SMART unter FHIR-Proxy aktiviert ist

ServiceCorsConfigurationInfo

Die Einstellungen für die CORS-Konfiguration der Dienstinstanz.

Name Typ Beschreibung
allowCredentials

boolean

Wenn Anmeldeinformationen über CORS zulässig sind.

headers

string[]

Die Kopfzeilen, die über CORS zulässig sind.

maxAge

integer

minimum: 0
maximum: 99999

Das maximale Alter, das über CORS erlaubt werden soll.

methods

string[]

Die Methoden, die über CORS zugelassen werden sollen.

origins

string[]

pattern: ^(?:(?:(?:[hH][tT][tT][pP](?:[sS]|))\:\/\/(?:[a-zA-Z0-9-]+[.]?)+(?:\:[0-9]{1,5})?|[*]))$

Die Ursprünge sollen über CORS zugelassen werden.

ServiceCosmosDbConfigurationInfo

Die Einstellungen für die Cosmos DB-Datenbank, die den Dienst unterstützt.

Name Typ Beschreibung
keyVaultKeyUri

string

Der URI des vom Kunden verwalteten Schlüssels für die Sicherungsdatenbank.

offerThroughput

integer

minimum: 400

Der bereitgestellte Durchsatz für die Sicherungsdatenbank.

ServiceExportConfigurationInfo

Exportvorgangskonfigurationsinformationen

Name Typ Beschreibung
storageAccountName

string

Der Name des standardmäßigen Exportspeicherkontos.

ServiceImportConfigurationInfo

Konfigurationsinformationen für Importvorgänge

Name Typ Beschreibung
enabled

boolean

Wenn der Importvorgang aktiviert ist.

initialImportMode

boolean

Wenn sich der FHIR-Dienst in InitialImportMode befindet.

integrationDataStore

string

Der Name des Standardmäßigen Integrationsspeicherkontos.

ServiceOciArtifactEntry

Ein Open Container Initiative (OCI)-Artefakt.

Name Typ Beschreibung
digest

string

Der Artefaktdig.

imageName

string

Der Artefaktname.

loginServer

string

Der Azure Container Registry-Anmeldeserver.

ServicesDescription

Die Beschreibung des Diensts.

Name Typ Beschreibung
etag

string

Ein Etag, das der Ressource zugeordnet ist, wird bei der Bearbeitung für optimistische Parallelität verwendet.

id

string

Der Ressourcenbezeichner.

identity

Identity

Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist.

kind

kind

Die Art des Diensts.

location

string

Der Ressourcenspeicherort.

name

string

pattern: ^[a-z0-9][a-z0-9-]{1,21}[a-z0-9]$

Der Ressourcenname.

properties

ServicesProperties

Die allgemeinen Eigenschaften eines Diensts.

systemData

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

tags

object

Die Ressourcentags.

type

string

Der Ressourcentyp.

ServicesProperties

Die Eigenschaften einer Dienstinstanz.

Name Typ Beschreibung
accessPolicies

ServiceAccessPolicyEntry[]

Die Zugriffsrichtlinien der Dienstinstanz.

acrConfiguration

ServiceAcrConfigurationInfo

Die Azure-Containerregistrierungseinstellungen, die zum Konvertieren des Datenvorgangs der Dienstinstanz verwendet werden.

authenticationConfiguration

ServiceAuthenticationConfigurationInfo

Die Authentifizierungskonfiguration für die Dienstinstanz.

corsConfiguration

ServiceCorsConfigurationInfo

Die Einstellungen für die CORS-Konfiguration der Dienstinstanz.

cosmosDbConfiguration

ServiceCosmosDbConfigurationInfo

Die Einstellungen für die Cosmos DB-Datenbank, die den Dienst unterstützt.

exportConfiguration

ServiceExportConfigurationInfo

Die Einstellungen für den Exportvorgang der Dienstinstanz.

importConfiguration

ServiceImportConfigurationInfo

Die Einstellungen für den Importvorgang der Dienstinstanz.

privateEndpointConnections

PrivateEndpointConnection[]

Die Liste der privaten Endpunktverbindungen, die für diese Ressource eingerichtet sind.

provisioningState

provisioningState

Der Bereitstellungsstatus.

publicNetworkAccess

PublicNetworkAccess

Steuern sie die Berechtigung für Datenebenendatenverkehr aus öffentlichen Netzwerken, während der private Endpunkt aktiviert ist.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.