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 |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Der Name der Ressourcengruppe, die die Dienstinstanz enthält. |
resource
|
path | True |
string minLength: 3maxLength: 24 |
Der Name der Dienstinstanz. |
subscription
|
path | True |
string |
Der Abonnementbezeichner. |
api-version
|
query | True |
string |
Client-API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
kind | True |
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 |
Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist. |
||
properties |
Die allgemeinen Eigenschaften eines Diensts. |
||
tags |
object |
Die Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Aktualisiert – Angenommene Anforderung und vorhandene Ressource werden aktualisiert; der Vorgang wird asynchron abgeschlossen. |
|
201 Created |
Erstellt – Put-Anforderung akzeptiert und eine neue Ressource wurde erstellt; der Vorgang wird asynchron abgeschlossen. |
|
Other Status Codes |
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 |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Fehlerdetails. |
Error |
Fehlerdetails. |
Identity |
Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist. |
kind |
Die Art des Diensts. |
Managed |
Der Typ der angegebenen Identität, derzeit "SystemAssigned" und "None" sind zulässig. |
Private |
Die Private Endpoint-Ressource. |
Private |
Die Private Endpoint Connection-Ressource. |
Private |
Der aktuelle Bereitstellungsstatus. |
Private |
Der Status der privaten Endpunktverbindung. |
Private |
Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider. |
provisioning |
Der Bereitstellungsstatus. |
Public |
Steuern sie die Berechtigung für Datenebenendatenverkehr aus öffentlichen Netzwerken, während der private Endpunkt aktiviert ist. |
Service |
Ein Zugriffsrichtlinieneintrag. |
Service |
Konfigurationsinformationen zur Azure-Containerregistrierung |
Service |
Authentifizierungskonfigurationsinformationen |
Service |
Die Einstellungen für die CORS-Konfiguration der Dienstinstanz. |
Service |
Die Einstellungen für die Cosmos DB-Datenbank, die den Dienst unterstützt. |
Service |
Exportvorgangskonfigurationsinformationen |
Service |
Konfigurationsinformationen für Importvorgänge |
Service |
Ein Open Container Initiative (OCI)-Artefakt. |
Services |
Die Beschreibung des Diensts. |
Services |
Die Eigenschaften einer Dienstinstanz. |
system |
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 |
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 |
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 |
Die Ressource des privaten Endpunkts. |
|
properties.privateLinkServiceConnectionState |
Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider. |
|
properties.provisioningState |
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 |
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 |
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: 0maximum: 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 |
Einstellung, die angibt, ob dem Dienst eine verwaltete Identität zugeordnet ist. |
|
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 |
Die allgemeinen Eigenschaften eines Diensts. |
|
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 |
Die Zugriffsrichtlinien der Dienstinstanz. |
|
acrConfiguration |
Die Azure-Containerregistrierungseinstellungen, die zum Konvertieren des Datenvorgangs der Dienstinstanz verwendet werden. |
|
authenticationConfiguration |
Die Authentifizierungskonfiguration für die Dienstinstanz. |
|
corsConfiguration |
Die Einstellungen für die CORS-Konfiguration der Dienstinstanz. |
|
cosmosDbConfiguration |
Die Einstellungen für die Cosmos DB-Datenbank, die den Dienst unterstützt. |
|
exportConfiguration |
Die Einstellungen für den Exportvorgang der Dienstinstanz. |
|
importConfiguration |
Die Einstellungen für den Importvorgang der Dienstinstanz. |
|
privateEndpointConnections |
Die Liste der privaten Endpunktverbindungen, die für diese Ressource eingerichtet sind. |
|
provisioningState |
Der Bereitstellungsstatus. |
|
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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |