Jump to

• Request
• Response

Find Objectclass Mapping by DN

get

/rest/v1/admin/{dn}

Returns an Objectclass Mapping by DN

Request

Supported Media Types

• application/json

Path Parameters

• dn: string
  LDAP DN of the entry to be fetched.

Query Parameters

• attributes: array
  Collection Format: multi

  List of attributes to be fetched for the entry.

  • [0]: string

  {
      "name":"attributes",
      "in":"query",
      "description":"List of attributes to be fetched for the entry.",
      "type":"array",
      "collectionFormat":"multi",
      "items":{
          "type":"string"
      }
  }

• controls: array
  Collection Format: multi

  LDAP controls to be sent to server for search operation.

  • [0]: string

  {
      "name":"controls",
      "in":"query",
      "description":"LDAP controls to be sent to server for search operation.",
      "type":"array",
      "collectionFormat":"multi",
      "items":{
          "type":"string"
      }
  }

• filter: string
  Search filter for the LDAP search operation. Should follow LDAP search filter syntax.
• scope: string
  Scope for the LDAP search operation.

  Allowed Values: [ "base", "sub", "one" ]

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : Objectclass Mapping GetSuccessResponse

Type: object

Show Source

• msgType: string
  Default Value: urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse

  The REST message type
• searchResultEntries: array searchResultEntries
  Number of search result entries returned after the LDAP operation.
• totalResults: integer(int32)
  Specifies the number of entries created, and returned.

{
    "type":"object",
    "required":[
        "msgType",
        "totalResults",
        "searchResultEntries"
    ],
    "properties":{
        "msgType":{
            "description":"The REST message type",
            "default":"urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse",
            "type":"string"
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the number of entries created, and returned."
        },
        "searchResultEntries":{
            "type":"array",
            "description":"Number of search result entries returned after the LDAP operation.",
            "items":{
                "$ref":"#/definitions/Objectclass Mapping SearchResultEntry"
            }
        }
    }
}

Nested Schema : searchResultEntries

Type: array

Number of search result entries returned after the LDAP operation.

Show Source

• Array of: object Objectclass Mapping SearchResultEntry

{
    "type":"array",
    "description":"Number of search result entries returned after the LDAP operation.",
    "items":{
        "$ref":"#/definitions/Objectclass Mapping SearchResultEntry"
    }
}

Nested Schema : Objectclass Mapping SearchResultEntry

Type: object

Show Source

• attributes: object Objectclass Mapping Properties
• dn: string
  LDAP DN of the entry to be created

{
    "type":"object",
    "required":[
        "dn",
        "attributes"
    ],
    "properties":{
        "dn":{
            "description":"LDAP DN of the entry to be created",
            "type":"string"
        },
        "attributes":{
            "$ref":"#/definitions/Objectclass Mapping Properties"
        }
    }
}

Nested Schema : Objectclass Mapping Properties

Type: object

Show Source

• cn(optional): string
  CN (common name) of the entry
• ds-cfg-objectclass-name: string
  The LDAP Objectclass name for entries generated by this Objectclass Mapping. If the objectclass is not defined in the server schema, then it is added automatically to the server schema during server startup. If it already exists then it is not added. The attributes that MUST/MAY exist for defining an entry of a particular objectclass as per the schema are not relevant as the user has to explicitly define the attributes required by the entries through the Attribute Mappings managed object.
• ds-cfg-rdn-attribute: string
  This property defines the sequence of RDN attributes required to construct the DN of the entries belonging to this Objectclass Mapping. The sequence of attributes is specified as a comma separated list. Example Values: 1) cn 2) cn,o 3) uid+cn+sn,o The DN of the entries is constructed by populating the values of the attributes in the RDN attribute and concatenating it to the suffix DN for the RDBMS Workflow Element to which the Objectclass Mapping belongs.
• objectclass: array objectclass
  Objectclass(es) which this entry belongs to.

{
    "type":"object",
    "required":[
        "objectclass",
        "ds-cfg-objectclass-name",
        "ds-cfg-rdn-attribute"
    ],
    "properties":{
        "objectclass":{
            "type":"array",
            "description":"Objectclass(es) which this entry belongs to.",
            "items":{
                "type":"string"
            }
        },
        "cn":{
            "type":"string",
            "description":"CN (common name) of the entry"
        },
        "ds-cfg-objectclass-name":{
            "description":"The LDAP Objectclass name for entries generated by this Objectclass Mapping. If the objectclass is not defined in the server schema, then it is added automatically to the server schema during server startup. If it already exists then it is not added. The attributes that MUST/MAY exist for defining an entry of a particular objectclass as per the schema are not relevant as the user has to explicitly define the attributes required by the entries through the Attribute Mappings managed object. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-rdn-attribute":{
            "description":"This property defines the sequence of RDN attributes required to construct the DN of the entries belonging to this Objectclass Mapping. The sequence of attributes is specified as a comma separated list. Example Values: 1) cn 2) cn,o 3) uid+cn+sn,o The DN of the entries is constructed by populating the values of the attributes in the RDN attribute and concatenating it to the suffix DN for the RDBMS Workflow Element to which the Objectclass Mapping belongs. ",
            "readOnly":false,
            "type":"string"
        }
    }
}

Nested Schema : objectclass

Type: array

Objectclass(es) which this entry belongs to.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Objectclass(es) which this entry belongs to.",
    "items":{
        "type":"string"
    }
}

406 Response

Not Acceptable

Body ()

Root Schema : ErrorResponse

Type: object

Show Source

• ldapErrorCode(optional): integer(int32)
  Specifies the LDAP error code returned for the operation.
• message: string
  Error message returned returned for the operation.
• msgType: string
  Default Value: urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponse

  The REST message type

{
    "type":"object",
    "required":[
        "msgType",
        "message"
    ],
    "properties":{
        "msgType":{
            "description":"The REST message type",
            "default":"urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponse",
            "type":"string"
        },
        "message":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "ldapErrorCode":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the LDAP error code returned for the operation."
        }
    }
}

Back to Top