Services - Create Or Update
De metagegevens van een service-exemplaar maken of bijwerken.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}?api-version=2022-06-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
De naam van de resourcegroep die het service-exemplaar bevat. |
resource
|
path | True |
string minLength: 3maxLength: 24 |
De naam van het service-exemplaar. |
subscription
|
path | True |
string |
De abonnement-ID. |
api-version
|
query | True |
string |
Client-API-versie. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
kind | True |
Het soort service. |
|
location | True |
string |
De resourcelocatie. |
etag |
string |
Een etag die is gekoppeld aan de resource, die wordt gebruikt voor optimistische gelijktijdigheid bij het bewerken ervan. |
|
identity |
Instelling die aangeeft of aan de service een beheerde identiteit is gekoppeld. |
||
properties |
De algemene eigenschappen van een service. |
||
tags |
object |
De resourcetags. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Bijgewerkt: geaccepteerde aanvraag plaatsen en een bestaande resource wordt bijgewerkt; de bewerking asynchroon wordt voltooid. |
|
201 Created |
Gemaakt - Aanvraag geaccepteerd plaatsen en er is een nieuwe resource gemaakt; de bewerking asynchroon wordt voltooid. |
|
Other Status Codes |
DefaultErrorResponse |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
Create or Update a service with all parameters |
Create or Update a service with minimum parameters |
Create or Update a service with all parameters
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
]
}
}
Voorbeeldrespons
{
"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"
}
}
Definities
Name | Description |
---|---|
created |
Het type identiteit waarmee de resource is gemaakt. |
Error |
Foutdetails. |
Error |
Foutdetails. |
Identity |
Instelling die aangeeft of aan de service een beheerde identiteit is gekoppeld. |
kind |
Het soort service. |
Managed |
Het type identiteit dat wordt opgegeven, momenteel SystemAssigned en None zijn toegestaan. |
Private |
De privé-eindpuntresource. |
Private |
De privé-eindpuntverbindingsresource. |
Private |
De huidige inrichtingsstatus. |
Private |
De verbindingsstatus van het privé-eindpunt. |
Private |
Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider. |
provisioning |
De inrichtingsstatus. |
Public |
Beheermachtiging voor gegevensvlakverkeer dat afkomstig is van openbare netwerken terwijl privé-eindpunt is ingeschakeld. |
Service |
Een toegangsbeleidsvermelding. |
Service |
Configuratiegegevens van Azure Container Registry |
Service |
Informatie over verificatieconfiguratie |
Service |
De instellingen voor de CORS-configuratie van het service-exemplaar. |
Service |
De instellingen voor de Cosmos DB-database die de service back-up maken. |
Service |
Configuratiegegevens voor exportbewerkingen |
Service |
Configuratiegegevens voor importbewerkingen |
Service |
Een OCI-artefact (Open Container Initiative). |
Services |
De beschrijving van de service. |
Services |
De eigenschappen van een service-exemplaar. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Waarde | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorDetails
Foutdetails.
Name | Type | Description |
---|---|---|
error |
Foutdetails |
ErrorDetailsInternal
Foutdetails.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
message |
string |
Het foutbericht. |
target |
string |
Het doel van de specifieke fout. |
Identity
Instelling die aangeeft of aan de service een beheerde identiteit is gekoppeld.
Name | Type | Description |
---|---|---|
principalId |
string |
De principal-id van de resource-id. |
tenantId |
string |
De tenant-id van de resource. |
type |
Het type identiteit dat wordt opgegeven, momenteel SystemAssigned en None zijn toegestaan. |
kind
Het soort service.
Waarde | Description |
---|---|
fhir | |
fhir-R4 | |
fhir-Stu3 |
ManagedServiceIdentityType
Het type identiteit dat wordt opgegeven, momenteel SystemAssigned en None zijn toegestaan.
Waarde | Description |
---|---|
None | |
SystemAssigned |
PrivateEndpoint
De privé-eindpuntresource.
Name | Type | Description |
---|---|---|
id |
string |
De ARM-id voor privé-eindpunt |
PrivateEndpointConnection
De privé-eindpuntverbindingsresource.
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
De naam van de resource |
properties.privateEndpoint |
De resource van het privé-eindpunt. |
|
properties.privateLinkServiceConnectionState |
Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider. |
|
properties.provisioningState |
De inrichtingsstatus van de privé-eindpuntverbindingsresource. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
PrivateEndpointConnectionProvisioningState
De huidige inrichtingsstatus.
Waarde | Description |
---|---|
Creating | |
Deleting | |
Failed | |
Succeeded |
PrivateEndpointServiceConnectionStatus
De verbindingsstatus van het privé-eindpunt.
Waarde | Description |
---|---|
Approved | |
Pending | |
Rejected |
PrivateLinkServiceConnectionState
Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.
Name | Type | Description |
---|---|---|
actionsRequired |
string |
Een bericht dat aangeeft of wijzigingen in de serviceprovider updates voor de consument vereisen. |
description |
string |
De reden voor goedkeuring/afwijzing van de verbinding. |
status |
Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service. |
provisioningState
De inrichtingsstatus.
Waarde | Description |
---|---|
Accepted | |
Canceled | |
Creating | |
Deleting | |
Deprovisioned | |
Failed | |
Moving | |
Succeeded | |
Suspended | |
SystemMaintenance | |
Updating | |
Verifying | |
Warned |
PublicNetworkAccess
Beheermachtiging voor gegevensvlakverkeer dat afkomstig is van openbare netwerken terwijl privé-eindpunt is ingeschakeld.
Waarde | Description |
---|---|
Disabled | |
Enabled |
ServiceAccessPolicyEntry
Een toegangsbeleidsvermelding.
Name | Type | Description |
---|---|---|
objectId |
string pattern: ^(([0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}){1})+$ |
Een Azure AD-object-id (gebruiker of apps) die toegang heeft tot de FHIR-service. |
ServiceAcrConfigurationInfo
Configuratiegegevens van Azure Container Registry
Name | Type | Description |
---|---|---|
loginServers |
string[] |
De lijst met de ACR-aanmeldingsservers. |
ociArtifacts |
De lijst met OCI-artefacten (Open Container Initiative). |
ServiceAuthenticationConfigurationInfo
Informatie over verificatieconfiguratie
Name | Type | Description |
---|---|---|
audience |
string |
De doelgroep-URL voor de service |
authority |
string |
De instantie-URL voor de service |
smartProxyEnabled |
boolean |
Als de SMART on FHIR-proxy is ingeschakeld |
ServiceCorsConfigurationInfo
De instellingen voor de CORS-configuratie van het service-exemplaar.
Name | Type | Description |
---|---|---|
allowCredentials |
boolean |
Als referenties zijn toegestaan via CORS. |
headers |
string[] |
De headers kunnen worden toegestaan via CORS. |
maxAge |
integer minimum: 0maximum: 99999 |
De maximale leeftijd die via CORS mag worden toegestaan. |
methods |
string[] |
De methoden die via CORS moeten worden toegestaan. |
origins |
string[] pattern: ^(?:(?:(?:[hH][tT][tT][pP](?:[sS]|))\:\/\/(?:[a-zA-Z0-9-]+[.]?)+(?:\:[0-9]{1,5})?|[*]))$ |
De oorsprong mag via CORS worden toegestaan. |
ServiceCosmosDbConfigurationInfo
De instellingen voor de Cosmos DB-database die de service back-up maken.
Name | Type | Description |
---|---|---|
keyVaultKeyUri |
string |
De URI van de door de klant beheerde sleutel voor de back-updatabase. |
offerThroughput |
integer minimum: 400 |
De ingerichte doorvoer voor de back-updatabase. |
ServiceExportConfigurationInfo
Configuratiegegevens voor exportbewerkingen
Name | Type | Description |
---|---|---|
storageAccountName |
string |
De naam van het standaardopslagaccount voor exporteren. |
ServiceImportConfigurationInfo
Configuratiegegevens voor importbewerkingen
Name | Type | Description |
---|---|---|
enabled |
boolean |
Als de importbewerking is ingeschakeld. |
initialImportMode |
boolean |
Als de FHIR-service zich in InitialImportMode bevindt. |
integrationDataStore |
string |
De naam van het standaardopslagaccount voor integratie. |
ServiceOciArtifactEntry
Een OCI-artefact (Open Container Initiative).
Name | Type | Description |
---|---|---|
digest |
string |
De artefactsamenvating. |
imageName |
string |
De naam van het artefact. |
loginServer |
string |
De azure Container Registry-aanmeldingsserver. |
ServicesDescription
De beschrijving van de service.
Name | Type | Description |
---|---|---|
etag |
string |
Een etag die is gekoppeld aan de resource, die wordt gebruikt voor optimistische gelijktijdigheid bij het bewerken ervan. |
id |
string |
De resource-id. |
identity |
Instelling die aangeeft of aan de service een beheerde identiteit is gekoppeld. |
|
kind |
Het soort service. |
|
location |
string |
De resourcelocatie. |
name |
string pattern: ^[a-z0-9][a-z0-9-]{1,21}[a-z0-9]$ |
De resourcenaam. |
properties |
De algemene eigenschappen van een service. |
|
systemData |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
|
tags |
object |
De resourcetags. |
type |
string |
Het resourcetype. |
ServicesProperties
De eigenschappen van een service-exemplaar.
Name | Type | Description |
---|---|---|
accessPolicies |
Het toegangsbeleid van het service-exemplaar. |
|
acrConfiguration |
De azure Container Registry-instellingen die worden gebruikt voor het converteren van gegevensbewerkingen van het service-exemplaar. |
|
authenticationConfiguration |
De verificatieconfiguratie voor het service-exemplaar. |
|
corsConfiguration |
De instellingen voor de CORS-configuratie van het service-exemplaar. |
|
cosmosDbConfiguration |
De instellingen voor de Cosmos DB-database die de service back-up maken. |
|
exportConfiguration |
De instellingen voor de exportbewerking van het service-exemplaar. |
|
importConfiguration |
De instellingen voor de importbewerking van het service-exemplaar. |
|
privateEndpointConnections |
De lijst met privé-eindpuntverbindingen die zijn ingesteld voor deze resource. |
|
provisioningState |
De inrichtingsstatus. |
|
publicNetworkAccess |
Beheermachtiging voor gegevensvlakverkeer dat afkomstig is van openbare netwerken terwijl privé-eindpunt is ingeschakeld. |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string (date-time) |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |