Jump to

• Request
• Response

Modify a Primary ForkJoin Participant by DN

patch

/rest/v1/admin/{dn}

Modify a Primary ForkJoin Participant by DN

Request

Supported Media Types

• application/json

Path Parameters

• dn: string
  LDAP DN of the entry to be modified

Body ()

Primary ForkJoin Participant that needs to be modified

Root Schema : PatchRequest

Type: object

Show Source

• controls(optional): array controls
  LDAP controls to be sent to server for LDAP modify operation.
• msgType: string
  Default Value: urn:ietf:params:rest:schemas:oracle:oud:1.0:ModifyRequest

  The REST message type
• operations: array operations
  Modifications (Patch operations) to be performed on the entry.

{
    "type":"object",
    "required":[
        "msgType",
        "operations"
    ],
    "properties":{
        "msgType":{
            "description":"The REST message type",
            "default":"urn:ietf:params:rest:schemas:oracle:oud:1.0:ModifyRequest",
            "type":"string"
        },
        "operations":{
            "type":"array",
            "description":"Modifications (Patch operations) to be performed on the entry.",
            "items":{
                "$ref":"#/definitions/PatchOperation"
            }
        },
        "controls":{
            "description":"LDAP controls to be sent to server for LDAP modify operation.",
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : controls

Type: array

LDAP controls to be sent to server for LDAP modify operation.

Show Source

• Array of: string

{
    "description":"LDAP controls to be sent to server for LDAP modify operation.",
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : operations

Type: array

Modifications (Patch operations) to be performed on the entry.

Show Source

• Array of: object PatchOperation

{
    "type":"array",
    "description":"Modifications (Patch operations) to be performed on the entry.",
    "items":{
        "$ref":"#/definitions/PatchOperation"
    }
}

Nested Schema : PatchOperation

Type: object

Show Source

• attribute: string
  The entry attribute to be modified.
• opType: string
  Allowed Values: [ "add", "delete", "replace", "increment" ]

  The type of the Patch Operation.
• values(optional): array values
  The attribute values to be updated.

{
    "type":"object",
    "required":[
        "opType",
        "attribute"
    ],
    "properties":{
        "opType":{
            "description":"The type of the Patch Operation.",
            "type":"string",
            "enum":[
                "add",
                "delete",
                "replace",
                "increment"
            ]
        },
        "attribute":{
            "type":"string",
            "description":"The entry attribute to be modified."
        },
        "values":{
            "type":"array",
            "description":"The attribute values to be updated.",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : values

Type: array

The attribute values to be updated.

Show Source

• Array of: string

{
    "type":"array",
    "description":"The attribute values to be updated.",
    "items":{
        "type":"string"
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : Primary ForkJoin Participant PatchSuccessResponse

Type: object

Show Source

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

  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:ModifyResponse",
            "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/Primary ForkJoin Participant SearchResultEntry"
            }
        }
    }
}

Nested Schema : searchResultEntries

Type: array

Number of search result entries returned after the LDAP operation.

Show Source

• Array of: object Primary ForkJoin Participant SearchResultEntry

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

Nested Schema : Primary ForkJoin Participant SearchResultEntry

Type: object

Show Source

• attributes: object Primary ForkJoin Participant 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/Primary ForkJoin Participant Properties"
        }
    }
}

Nested Schema : Primary ForkJoin Participant Properties

Type: object

Show Source

• cn(optional): string
  CN (common name) of the entry
• ds-cfg-enabled-operation(optional): array ds-cfg-enabled-operation
  This participant participates only in those LDAP operations specified in this parameter. By default, it participates only in SEARCH, COMPARE, DELETE and MODIFY operations. If BIND operation is specified in enabled operations, then the bind priority configured is honoured. Else, it is not.
• ds-cfg-join-condition(optional): string
  Only the entries satisfying the join condition are considered for join in this participant where the condition is defined. It is of the LDAPFilter syntax.
• ds-cfg-non-retrievable-attribute(optional): array ds-cfg-non-retrievable-attribute
  Defines the list of non-retrievable attributes for this participant
• ds-cfg-non-storable-attribute(optional): array ds-cfg-non-storable-attribute
  Defines the list of non-storable attributes for this participant. This overrides the storable list.
• ds-cfg-participant-bind-priority(optional): integer(int32)
  Default Value: 0

  Determines the priority of this participant when serving bind requests, if BIND is specified as enabled operation in this participant. It can take any values greater than or equal to zero. The priority decreases as the number increases - Lower the number, higher the priority; 0 being the highest priority.
• ds-cfg-participant-criticality(optional): string
  Default Value: true

  Allowed Values: [ "false", "partial", "true" ]

  When a search operation done against a participant fails due to a communication error, Join WorkflowElement reacts based on the Criticality setting. It can be set to one of the following values - true, false, partial. Criticality is honored only for Search operations.
• ds-cfg-participant-dn: string
  The real DN that is exposed by the participating workflow element
• ds-cfg-participating-workflow-element: string
  Name of the Participating WorkFlow Element
• ds-cfg-retrievable-attribute(optional): array ds-cfg-retrievable-attribute
  Defines the list of retrievable attributes for this participant
• ds-cfg-storable-attribute(optional): array ds-cfg-storable-attribute
  Defines the list of storable attributes for this participant
• objectclass: array objectclass
  Objectclass(es) which this entry belongs to.

{
    "type":"object",
    "required":[
        "objectclass",
        "ds-cfg-participating-workflow-element",
        "ds-cfg-participant-dn"
    ],
    "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-join-condition":{
            "description":"Only the entries satisfying the join condition are considered for join in this participant where the condition is defined. It is of the LDAPFilter syntax. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-participating-workflow-element":{
            "description":"Name of the Participating WorkFlow Element ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-participant-bind-priority":{
            "description":"Determines the priority of this participant when serving bind requests, if BIND is specified as enabled operation in this participant. It can take any values greater than or equal to zero. The priority decreases as the number increases - Lower the number, higher the priority; 0 being the highest priority. ",
            "readOnly":false,
            "default":0,
            "type":"integer",
            "format":"int32"
        },
        "ds-cfg-non-storable-attribute":{
            "description":"Defines the list of non-storable attributes for this participant. This overrides the storable list. ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "ds-cfg-enabled-operation":{
            "description":"This participant participates only in those LDAP operations specified in this parameter. By default, it participates only in SEARCH, COMPARE, DELETE and MODIFY operations. If BIND operation is specified in enabled operations, then the bind priority configured is honoured. Else, it is not. ",
            "readOnly":false,
            "default":[
                "search",
                "compare",
                "delete",
                "modify"
            ],
            "type":"array",
            "items":{
                "type":"string"
            },
            "enum":[
                "add",
                "bind",
                "compare",
                "delete",
                "modify",
                "modifydn",
                "search"
            ]
        },
        "ds-cfg-non-retrievable-attribute":{
            "description":"Defines the list of non-retrievable attributes for this participant ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "ds-cfg-storable-attribute":{
            "description":"Defines the list of storable attributes for this participant ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "ds-cfg-participant-dn":{
            "description":"The real DN that is exposed by the participating workflow element ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-retrievable-attribute":{
            "description":"Defines the list of retrievable attributes for this participant ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "ds-cfg-participant-criticality":{
            "description":"When a search operation done against a participant fails due to a communication error, Join WorkflowElement reacts based on the Criticality setting. It can be set to one of the following values - true, false, partial. Criticality is honored only for Search operations. ",
            "readOnly":false,
            "default":"true",
            "type":"string",
            "enum":[
                "false",
                "partial",
                "true"
            ]
        }
    }
}

Nested Schema : ds-cfg-enabled-operation

Type: array

This participant participates only in those LDAP operations specified in this parameter. By default, it participates only in SEARCH, COMPARE, DELETE and MODIFY operations. If BIND operation is specified in enabled operations, then the bind priority configured is honoured. Else, it is not.

Default Value: [ "search", "compare", "delete", "modify" ]

Allowed Values: [ "add", "bind", "compare", "delete", "modify", "modifydn", "search" ]

Show Source

• Array of: string

{
    "description":"This participant participates only in those LDAP operations specified in this parameter. By default, it participates only in SEARCH, COMPARE, DELETE and MODIFY operations. If BIND operation is specified in enabled operations, then the bind priority configured is honoured. Else, it is not. ",
    "readOnly":false,
    "default":[
        "search",
        "compare",
        "delete",
        "modify"
    ],
    "type":"array",
    "items":{
        "type":"string"
    },
    "enum":[
        "add",
        "bind",
        "compare",
        "delete",
        "modify",
        "modifydn",
        "search"
    ]
}

Nested Schema : ds-cfg-non-retrievable-attribute

Type: array

Defines the list of non-retrievable attributes for this participant

Show Source

• Array of: string

{
    "description":"Defines the list of non-retrievable attributes for this participant ",
    "readOnly":false,
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : ds-cfg-non-storable-attribute

Type: array

Defines the list of non-storable attributes for this participant. This overrides the storable list.

Show Source

• Array of: string

{
    "description":"Defines the list of non-storable attributes for this participant. This overrides the storable list. ",
    "readOnly":false,
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : ds-cfg-retrievable-attribute

Type: array

Defines the list of retrievable attributes for this participant

Show Source

• Array of: string

{
    "description":"Defines the list of retrievable attributes for this participant ",
    "readOnly":false,
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : ds-cfg-storable-attribute

Type: array

Defines the list of storable attributes for this participant

Show Source

• Array of: string

{
    "description":"Defines the list of storable attributes for this participant ",
    "readOnly":false,
    "type":"array",
    "items":{
        "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"
    }
}

400 Response

ERROR

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