Oracle GoldenGate

Retrieve Status

get

/services/{version}/replicats/{replicat}/info/status

Retrieve the current status of the replicat process.

Request

Path Parameters

replicat: string

Minimum Length: 1

Maximum Length: 8

Pattern: ^[A-Z_$][A-Z0-9_$]*$

The name of the replicat. Replicat names are upper case, begin with an alphabetic character followed by up to seven alpha-numeric characters.
version: string

Oracle GoldenGate Service API version.

Allowed Values: [ "v2" ]

Response

Supported Media Types

application/json

200 Response

Process status retrieved successfully.

Root Schema : Replicat process status

Type: object

Title: Replicat process status

Show Source

$schema:

Allowed Values: [ "ogg:replicatStatus" ]
lag: integer

Minimum Value: 0

Maximum Value: 4.294967295E9

Process lag in seconds
lastStarted: lastStarted
position: object position
processId: integer

Minimum Value: 1

Maximum Value: 4.294967295E9
sinceLagReported: integer

Minimum Value: 0

Maximum Value: 4.294967295E9

Time in seconds since process lag was reported
status:

Allowed Values: [ "starting", "running", "stopped", "killed", "abended" ]
synchronized: boolean

{
    "title":"Replicat process status",
    "required":[
        "status",
        "lastStarted",
        "position",
        "lag",
        "sinceLagReported"
    ],
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:replicatStatus"
            ]
        },
        "status":{
            "enum":[
                "starting",
                "running",
                "stopped",
                "killed",
                "abended"
            ]
        },
        "synchronized":{
            "type":"boolean"
        },
        "lastStarted":{
            "x-oneOf":[
                {
                    "type":"string",
                    "pattern":"^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$",
                    "minLength":20,
                    "maxLength":32
                },
                {
                    "type":"null"
                }
            ]
        },
        "position":{
            "type":"object",
            "properties":{
                "$schema":{
                    "enum":[
                        "ogg:trailPosition"
                    ]
                },
                "name":{
                    "description":"The name of the trail",
                    "type":"string",
                    "pattern":"^[A-Za-z][A-Za-z0-9]?$",
                    "minLength":1,
                    "maxLength":2
                },
                "path":{
                    "description":"The path where trail data is stored",
                    "type":"string",
                    "minLength":1,
                    "maxLength":255
                },
                "sequence":{
                    "description":"Trail file sequence number",
                    "type":"integer",
                    "minimum":0,
                    "maximum":999999999,
                    "default":0
                },
                "offset":{
                    "description":"Offset in trail sequence file",
                    "type":"integer",
                    "minimum":0,
                    "default":0,
                    "maximum":2147483647
                }
            },
            "additionalProperties":false
        },
        "lag":{
            "description":"Process lag in seconds",
            "type":"integer",
            "minimum":0,
            "maximum":4.294967295E9
        },
        "sinceLagReported":{
            "description":"Time in seconds since process lag was reported",
            "type":"integer",
            "minimum":0,
            "maximum":4.294967295E9
        },
        "processId":{
            "type":"integer",
            "minimum":1,
            "maximum":4.294967295E9
        }
    },
    "additionalProperties":false
}

Nested Schema : lastStarted

Match One

Show Source

string

Minimum Length: 20

Maximum Length: 32

Pattern: ^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$
null

{
    "x-oneOf":[
        {
            "type":"string",
            "pattern":"^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$",
            "minLength":20,
            "maxLength":32
        },
        {
            "type":"null"
        }
    ]
}

Nested Schema : position

Type: object

Show Source

$schema:

Allowed Values: [ "ogg:trailPosition" ]
name: string

Minimum Length: 1

Maximum Length: 2

Pattern: ^[A-Za-z][A-Za-z0-9]?$

The name of the trail
offset: integer

Minimum Value: 0

Maximum Value: 2147483647

Default Value: 0

Offset in trail sequence file
path: string

Minimum Length: 1

Maximum Length: 255

The path where trail data is stored
sequence: integer

Minimum Value: 0

Maximum Value: 999999999

Default Value: 0

Trail file sequence number

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:trailPosition"
            ]
        },
        "name":{
            "description":"The name of the trail",
            "type":"string",
            "pattern":"^[A-Za-z][A-Za-z0-9]?$",
            "minLength":1,
            "maxLength":2
        },
        "path":{
            "description":"The path where trail data is stored",
            "type":"string",
            "minLength":1,
            "maxLength":255
        },
        "sequence":{
            "description":"Trail file sequence number",
            "type":"integer",
            "minimum":0,
            "maximum":999999999,
            "default":0
        },
        "offset":{
            "description":"Offset in trail sequence file",
            "type":"integer",
            "minimum":0,
            "default":0,
            "maximum":2147483647
        }
    },
    "additionalProperties":false
}

Example Response (application/json)

{
    "$schema":"api:standardResponse",
    "links":[
        {
            "href":"http://localhost:11001/services/v2/replicats/REP2/info/status",
            "mediaType":"application/json",
            "rel":"canonical"
        },
        {
            "href":"http://localhost:11001/services/v2/replicats/REP2/info/status",
            "mediaType":"application/json",
            "rel":"self"
        },
        {
            "href":"http://localhost:11001/services/v2/metadata-catalog/replicatStatus",
            "mediaType":"application/schema+json",
            "rel":"describedby"
        }
    ],
    "messages":[
    ],
    "response":{
        "$schema":"ogg:replicatStatus",
        "lag":0,
        "lastStarted":"2017-12-14T12:43:59.181Z",
        "position":{
            "name":"X2",
            "offset":3987,
            "path":"/u02/ogg/Local/var/lib/data",
            "sequence":0
        },
        "processId":1699,
        "sinceLagReported":2,
        "status":"running"
    }
}