Create an AuthorizationMap

An AuthorizationMap resource type is modeled as a mapping reference to an authorization usage and is mapped to the service instance ID and the GroupPolicy.

An AuthorizationMap resource type has the following elements:

usageContext - The mandatory element usageContext consists of the following:
- system - The CodeSystem of an AuthorizationMap
- code - The code is PaaS
- display - The display is Platform as a Service
usageIdentity - The mandatory element usageIdentity is the Instance ID. Enter a valid SAP Health Data Services for FHIR instance ID.
groupPolicy - The mandatory element groupPolicy indicates the canonical reference to the GroupPolicy.

HTTP Request

You can use an HTTP POST request to create an AuthorizationMap resource:

POST [base]/AuthorizationMap

Path Parameters

base: Service endpoint to interact with FHIR resources. For more information, see Service Endpoint.

Example

The mapping reference to an authorization usage:

Sample Code

{
    "resourceType": "AuthorizationMap",
    "description": "AuthorizationMap for Developer",
    "usageContext": {
        "system": "http://sap.com/healthcare/fhir/CodeSystem/AuthorizationMap-usage-context",
        "code": "PaaS",
        "display": "Platform as a Service"
    },
    "usageIdentity": [
        "<Enter SAP Health Data Services for
                                    FHIR instance ID>"
    ],
    "groupPolicy": [
        "https://sap.com/healthcare/fhir/GroupPolicy/Developer|1.0.0"
    ],
    "publisher": "SAP SE",
    "copyright": "© 2023 SAP SE or an SAP affiliate company. All rights reserved."
}

HTTP Status Response Codes

The following HTTP status response codes are returned for the create request:

HTTP Code	Scenario	Description
201	Successful creation	An AuthorizationMap resource is successfully created.
400	Bad Request	Client error
422	Unprocessable Entity	Validation error. Returns 422 with corresponding error message in response body.
404	No Data Found	Authorization error. Returns 404 with no response body.
500	Internal Server Error	Server encountered an internal error.