REST API for GoldenGate Veridata

Create a User

post

http://{host}:{port}/veridata/v1/services/admin/users

Required Role: Administrator, CommandLineOperator

Create a User

Request

There are no request parameters for this operation.

Supported Media Types

application/json

Root Schema : schema

Type: object

Show Source

description: string
emailId: string
groupIds: array groupIds

Array of group ID to be mapped to user.
name(required): string
password(required): string (password)

Enter at least 6 characters including one number, one uppercase and one lowercase letter.

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "password":{
            "type":"string",
            "description":"Enter at least 6 characters including one number, one uppercase and one lowercase letter.",
            "format":"password"
        },
        "emailId":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "groupIds":{
            "type":"array",
            "description":"Array of group ID to be mapped to user.",
            "items":{
                "type":"integer",
                "description":"group Ids.",
                "format":"int64"
            }
        }
    },
    "required":[
        "name",
        "password"
    ],
    "example":{
        "name":"User1",
        "password":"Abc@123",
        "emailId":"user1@oracle.com",
        "description":"user1",
        "groupIds":[
            0
        ]
    }
}

Example:

{
    "name":"User1",
    "password":"Abc@123",
    "emailId":"user1@oracle.com",
    "description":"user1",
    "groupIds":[
        0
    ]
}

Nested Schema : groupIds

Type: array

Array of group ID to be mapped to user.

Show Source

Array of: integer(int64)

group Ids.

{
    "type":"array",
    "description":"Array of group ID to be mapped to user.",
    "items":{
        "type":"integer",
        "description":"group Ids.",
        "format":"int64"
    }
}

Response

Supported Media Types

application/json

201 Response

User created successfully.

Root Schema : UserDetailsPostResponse

Type: object

Show Source

createdOn: string (date-time)

Pattern: YYYY-MM-DDTHH:mm:ss.sssZ

Example: 2024-02-03T10:15:30Z
description: string
emailId: string
id: integer

user ID.

Example: 1001
name: string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "description":"user ID.",
            "example":1001
        },
        "name":{
            "type":"string"
        },
        "emailId":{
            "type":"string"
        },
        "createdOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        },
        "description":{
            "type":"string"
        }
    },
    "example":{
        "id":1001,
        "name":"User1",
        "emailId":"abc@oracle.com",
        "createdOn":"2024-02-03T10:15:30Z",
        "description":"description"
    }
}

Example:

{
    "id":1001,
    "name":"User1",
    "emailId":"abc@oracle.com",
    "createdOn":"2024-02-03T10:15:30Z",
    "description":"description"
}

400 Response

Bad Request.

Root Schema : Error

Type: object

Show Source

errCode: string

Veridata Error Code.
errMsg: string

Veridata Error Message.

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

Example:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

401 Response

Unauthorized.

Root Schema : Error

Type: object

Show Source

errCode: string

Veridata Error Code.
errMsg: string

Veridata Error Message.

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

Example:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

404 Response

Not Found.

Root Schema : Error

Type: object

Show Source

errCode: string

Veridata Error Code.
errMsg: string

Veridata Error Message.

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

Example:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

500 Response

Server Error.

Root Schema : Error

Type: object

Show Source

errCode: string

Veridata Error Code.
errMsg: string

Veridata Error Message.

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

Example:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}