Add, Search, Compare or Delete Global Index
post
/rest/v1/admin
Add, Search, Compare or Delete Global Index
Request
Supported Media Types
- application/json
Global Index that needs to be created
Root Schema : Global Index POSTRequest
Type:
Show Source
object-
assertion:
string
Assertion string for the LDAP compare operation. Note: To be used only while performing LDAP compare operation using POST, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequest.
-
attributes:
object Global Index Properties
-
base:
string
Search Base DN to be used for the LDAP search operation. Note: To be used only while performing LDAP search operation using POST, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest. It is also mandatory for such operation
-
controls:
array controls
LDAP controls to be sent to server for the LDAP operation.
-
dn:
string
LDAP DN of the entry to be created or deleted or compared. Note: To be used only while performing LDAP add, delete or compare operations, i.e, if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:AddRequest, urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteRequest or urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequest.It is mandatory for such operations.
-
filter:
string
Search filter for the LDAP search operation. Should follow LDAP search filter syntax. Note: To be used only while performing LDAP search operation using POST request, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest.
-
msgType(required):
string
Allowed Values:
[ "urn:ietf:params:rest:schemas:oracle:oud:1.0:AddRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequest" ]The REST message type -
requiredAttributes:
array requiredAttributes
List of attributes to be fetched for the entry. Note: To be used only while performing LDAP search operation using POST, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest.
-
scope:
string
Allowed Values:
[ "base", "sub", "one" ]Scope for the LDAP search operation. Note: To be used only while performing LDAP search operation using POST, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest.
Nested Schema : Global Index Properties
Type:
Show Source
object-
cn:
string
CN (common name) of the entry
-
ds-cfg-db-checkpointer-bytes-interval:
string
Default Value:
20mbSpecifies the maximum number of bytes that may be written to the database before it is forced to perform a checkpoint. -
ds-cfg-db-checkpointer-wakeup-interval:
string
Default Value:
30sSpecifies the maximum length of time that may pass between checkpoints. -
ds-cfg-db-cleaner-min-utilization:
integer(int32)
Default Value:
50Specifies the minimum percentage of "live" data that the database cleaner attempts to keep in database log files. -
ds-cfg-db-directory(required):
string
Default Value:
catalogsSpecifies the path to the filesystem directory that is used to hold the Berkeley DB Java Edition database files containing the data for this Global Index. -
ds-cfg-db-directory-permissions:
string
Default Value:
700Specifies the permissions that should be applied to the directory containing the Global Index database files. -
ds-cfg-db-log-file-max:
string
Default Value:
10mbSpecifies the maximum size for a database log file. -
ds-cfg-db-num-cleaner-threads:
integer(int32)
Specifies the number of threads that the backend should maintain to keep the database log files at or near the desired utilization.
-
ds-cfg-db-num-lock-tables:
integer(int32)
Specifies the number of lock tables that are used by the underlying database.
-
ds-cfg-db-txn-no-sync:
boolean
Default Value:
falseIndicates whether database writes should be primarily written to an internal buffer but not immediately written to disk. -
ds-cfg-db-txn-write-no-sync:
boolean
Default Value:
trueIndicates whether the database should synchronously flush data as it is written to disk. -
ds-cfg-deleted-entry-retention-timeout:
string
Default Value:
500msSpecifies how long a deleted entry is kept in the system. -
ds-cfg-global-index-attribute:
string
Read Only:
trueSpecifies the attribute to index. - ds-cfg-global-index-catalogs-shared-cache: string
-
ds-cfg-je-property:
array ds-cfg-je-property
Specifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
-
objectclass(required):
array objectclass
Objectclass(es) which this entry belongs to.
Nested Schema : controls
Type:
arrayLDAP controls to be sent to server for the LDAP operation.
Show Source
Nested Schema : requiredAttributes
Type:
arrayList of attributes to be fetched for the entry. Note: To be used only while performing LDAP search operation using POST, i.e., if the msgType is urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest.
Show Source
Nested Schema : ds-cfg-je-property
Type:
arraySpecifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
Show Source
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : Global Index SuccessResponse
Type:
Show Source
object-
compareResult:
boolean
Indicates the result of LDAP compare operation.
-
msgType(required):
string
Allowed Values:
[ "urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse", "urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteResponse", "urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareResponse" ]The REST message type -
searchResultEntries(required):
array searchResultEntries
Number of search result entries returned after the LDAP operation.
-
totalResults(required):
integer(int32)
Specifies the number of entries created, and returned.
Nested Schema : searchResultEntries
Type:
arrayNumber of search result entries returned after the LDAP operation.
Show Source
Nested Schema : Global Index SearchResultEntry
Type:
Show Source
object-
attributes(required):
object Global Index Properties
-
dn(required):
string
LDAP DN of the entry to be created
Nested Schema : Global Index Properties
Type:
Show Source
object-
cn:
string
CN (common name) of the entry
-
ds-cfg-db-checkpointer-bytes-interval:
string
Default Value:
20mbSpecifies the maximum number of bytes that may be written to the database before it is forced to perform a checkpoint. -
ds-cfg-db-checkpointer-wakeup-interval:
string
Default Value:
30sSpecifies the maximum length of time that may pass between checkpoints. -
ds-cfg-db-cleaner-min-utilization:
integer(int32)
Default Value:
50Specifies the minimum percentage of "live" data that the database cleaner attempts to keep in database log files. -
ds-cfg-db-directory(required):
string
Default Value:
catalogsSpecifies the path to the filesystem directory that is used to hold the Berkeley DB Java Edition database files containing the data for this Global Index. -
ds-cfg-db-directory-permissions:
string
Default Value:
700Specifies the permissions that should be applied to the directory containing the Global Index database files. -
ds-cfg-db-log-file-max:
string
Default Value:
10mbSpecifies the maximum size for a database log file. -
ds-cfg-db-num-cleaner-threads:
integer(int32)
Specifies the number of threads that the backend should maintain to keep the database log files at or near the desired utilization.
-
ds-cfg-db-num-lock-tables:
integer(int32)
Specifies the number of lock tables that are used by the underlying database.
-
ds-cfg-db-txn-no-sync:
boolean
Default Value:
falseIndicates whether database writes should be primarily written to an internal buffer but not immediately written to disk. -
ds-cfg-db-txn-write-no-sync:
boolean
Default Value:
trueIndicates whether the database should synchronously flush data as it is written to disk. -
ds-cfg-deleted-entry-retention-timeout:
string
Default Value:
500msSpecifies how long a deleted entry is kept in the system. -
ds-cfg-global-index-attribute:
string
Read Only:
trueSpecifies the attribute to index. - ds-cfg-global-index-catalogs-shared-cache: string
-
ds-cfg-je-property:
array ds-cfg-je-property
Specifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
-
objectclass(required):
array objectclass
Objectclass(es) which this entry belongs to.
Nested Schema : ds-cfg-je-property
Type:
arraySpecifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
Show Source
201 Response
Created
Root Schema : Global Index ADDResponse
Type:
Show Source
object-
msgType(required):
string
Default Value:
urn:ietf:params:rest:schemas:oracle:oud:1.0:AddResponseThe REST message type -
searchResultEntries(required):
array searchResultEntries
-
totalResults(required):
integer(int32)
Specifies the number of entries created, and returned.
Nested Schema : Global Index SearchResultEntry
Type:
Show Source
object-
attributes(required):
object Global Index Properties
-
dn(required):
string
LDAP DN of the entry to be created
Nested Schema : Global Index Properties
Type:
Show Source
object-
cn:
string
CN (common name) of the entry
-
ds-cfg-db-checkpointer-bytes-interval:
string
Default Value:
20mbSpecifies the maximum number of bytes that may be written to the database before it is forced to perform a checkpoint. -
ds-cfg-db-checkpointer-wakeup-interval:
string
Default Value:
30sSpecifies the maximum length of time that may pass between checkpoints. -
ds-cfg-db-cleaner-min-utilization:
integer(int32)
Default Value:
50Specifies the minimum percentage of "live" data that the database cleaner attempts to keep in database log files. -
ds-cfg-db-directory(required):
string
Default Value:
catalogsSpecifies the path to the filesystem directory that is used to hold the Berkeley DB Java Edition database files containing the data for this Global Index. -
ds-cfg-db-directory-permissions:
string
Default Value:
700Specifies the permissions that should be applied to the directory containing the Global Index database files. -
ds-cfg-db-log-file-max:
string
Default Value:
10mbSpecifies the maximum size for a database log file. -
ds-cfg-db-num-cleaner-threads:
integer(int32)
Specifies the number of threads that the backend should maintain to keep the database log files at or near the desired utilization.
-
ds-cfg-db-num-lock-tables:
integer(int32)
Specifies the number of lock tables that are used by the underlying database.
-
ds-cfg-db-txn-no-sync:
boolean
Default Value:
falseIndicates whether database writes should be primarily written to an internal buffer but not immediately written to disk. -
ds-cfg-db-txn-write-no-sync:
boolean
Default Value:
trueIndicates whether the database should synchronously flush data as it is written to disk. -
ds-cfg-deleted-entry-retention-timeout:
string
Default Value:
500msSpecifies how long a deleted entry is kept in the system. -
ds-cfg-global-index-attribute:
string
Read Only:
trueSpecifies the attribute to index. - ds-cfg-global-index-catalogs-shared-cache: string
-
ds-cfg-je-property:
array ds-cfg-je-property
Specifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
-
objectclass(required):
array objectclass
Objectclass(es) which this entry belongs to.
Nested Schema : ds-cfg-je-property
Type:
arraySpecifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
Show Source
204 Response
No content
406 Response
Not Acceptable
Root Schema : ErrorResponse
Type:
Show Source
object-
ldapErrorCode:
integer(int32)
Specifies the LDAP error code returned for the operation.
-
message(required):
string
Error message returned returned for the operation.
-
msgType(required):
string
Default Value:
urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponseThe REST message type