[scim] Query on a specific known resource

[Julien Schneider <[e-mail]>]

Hi all,

I have a question about queries performed against a SCIM resource object 
(like "/Users/{id}").

The RFC (https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) 
states:

Responses MUST be identified using the following URI:
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"


If I understand correctly, that means the "schemas" parameter of the 
response to those queries must be set to:

"schemas":["urn:ietf:params:scim:api:messages:2.0:ListResponse"]


While I understand how that applies to queries on a resource type 
endpoint (like "/Users") or on the SCIM server root, I don't understand 
how that applies to queries on a specific resource object.
If I understand correctly, queries on a specific resource object 
actually are quite identical to "retrieving a known resource" 
(https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.1) which are 
a GET on a specific resource, like:

GET /Users/2819c223-7f76-453a-919d-413861904646

Responses to those requests should have the "schemas" parameter set to 
the resource schema(s):

{
      "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],
      "id":"2819c223-7f76-453a-919d-413861904646",
...
}


Now, how should the response to the following query should look like? 
And to what value should the "schemas" parameter of the response be set?

GET /Users/2819c223-7f76-453a-919d-413861904646?attributes=userName


Should it be:

    {
      "schemas":["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
      "totalResults":1,
      "Resources":[
        {
          "id":"2819c223-7f76-453a-919d-413861904646",
          "userName":"bjensen"
        }
      ]
    }


Or something like:

    {
      "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],
      "id":"2819c223-7f76-453a-919d-413861904646",
      "meta":{
        "resourceType":"User",
        "created":"2011-08-01T18:29:49.793Z",
        "lastModified":"2011-08-01T18:29:49.793Z",
        "location":
    "https://example.com/v2/Users/2819c223-7f76-453a-919d-413861904646",
        "version":"W\/\"f250dd84f0671c3\""
      },
      "userName":"bjensen"
    }


Thanks a lot in advance

-- 
Julien Schneider
Tel: [phone]
Fax: [phone]

http://www.audriga.com  |http://www.twitter.com/audriga

--------------------------------------------------------------------------
audriga GmbH |  Alter Schlachthof 57  | 76137 Karlsruhe
Sitz der Gesellschaft: Karlsruhe - Amtsgericht Mannheim - HRB 713034
Geschäftsführer: Dr. Frank Dengler, Dr.-Ing. Hans-Jörg Happel
--------------------------------------------------------------------------