1. Oracle GoldenGate 23ai Microservices Architecture REST API Documentation
  2. Tasks
  3. Administration Service
  4. Trails

List Trails

get

/services/{version}/trails

Required Role: User

Retrieve a collection of all known trails

Request

Path Parameters
Query Parameters

  • When provided, the returned collection includes a "details" property for each trail item.

Back to Top

Response

Supported Media Types

200 Response

Collection of Trails retrieved successfully.

Body ()
Root Schema : Oracle GoldenGate Trail Collection
Type: object
Title: Oracle GoldenGate Trail Collection
Show Source
Nested Schema : items
Type: array
Minimum Number of Items: 0
Maximum Number of Items: 32767
Show Source
Nested Schema : items
Match All
Show Source
Nested Schema : items-allOf[0]
Type: object
Additional Properties Allowed: true
Show Source
Nested Schema : items-allOf[1]
Type: object
Additional Properties Allowed: true
Show Source
Nested Schema : status
Item status
Match Any
Show Source
  • Allowed Values: [ "starting", "running", "stopped", "killed", "abended" ]
  • Default Value: stopped
    Allowed Values: [ "paused", "running", "stopping", "stopped", "killed", "uninitialized" ]
Nested Schema : details
Type: object
Show Source
  • Allowed Values: [ "ogg:trail" ]
  • Minimum Length: 1
    Maximum Length: 4095
    Description for the trail
  • Minimum Length: 2
    Maximum Length: 2
    Pattern: ^[A-Za-z][A-Za-z0-9]$
    The two-character name of the trail
  • Minimum Value: 0
    Maximum Value: 2147483647
    Offset in trail sequence file
  • Minimum Length: 1
    Maximum Length: 4096
    The path where trail data is stored
  • processRef
    Minimum Number of Items: 1
    Maximum Number of Items: 5000
    List of all processes associated with this trail
  • Default Value: false
    Indicates if trail is local or remote
  • Minimum Value: 0
    Maximum Value: 999999999
    Default Value: 0
    Trail beginning sequence number
  • sequenceLastArchived
    Minimum Number of Items: 1
    Maximum Number of Items: 128
    Last sequence number archived (Managed Trails only)
  • Default Value: 9
    Allowed Values: [ "6", "9" ]
    Number of digits in sequence file name
  • Default Value: false
    Indicates sequence number length will change
  • Minimum Value: 0
    Maximum Value: 999999999
    Default Value: 0
    Maximum trail sequence number that exists in the deployment
  • Minimum Value: 0
    Maximum Value: 999999999
    Default Value: 0
    Maximum trail sequence number in use
  • Minimum Value: 0
    Maximum Value: 999999999
    Default Value: 0
    Minimum trail sequence number that exists in the deployment
  • Minimum Value: 0
    Maximum Value: 999999999
    Default Value: 0
    Minimum trail sequence number in use
  • Minimum Value: 1
    Maximum Value: 2000
    Default Value: 500
    The maximum size, in megabytes, of a file in the trail.
  • Minimum Value: 0
    Maximum Value: 18446744073709552000
    Bytes consumed by all trail sequences
  • Minimum Length: 3
    Maximum Length: 512
    Pattern: ^[a-zA-Z0-9_#$/-]*$
    The optional 'user-friendly' name for the trail
Nested Schema : processRef
Type: array
Minimum Number of Items: 1
Maximum Number of Items: 5000
List of all processes associated with this trail
Show Source
Nested Schema : sequenceLastArchived
Type: array
Minimum Number of Items: 1
Maximum Number of Items: 128
Last sequence number archived (Managed Trails only)
Show Source
Nested Schema : items
Type: object
A reference to an OGG process associated with this managed trail
Show Source
Nested Schema : processName
Match Any
Show Source
  • Minimum Length: 1
    Maximum Length: 8
    Pattern: ^[A-Z_$][A-Z0-9_$]*$
  • Minimum Length: 1
    Maximum Length: 32
    Pattern: ^[A-Za-z][A-Za-z0-9-_.]*$
Nested Schema : items
Type: object
Show Source
Nested Schema : archiveTarget
The location where the trail sequences were archived
Match One
Show Source
Nested Schema : archiveTarget-x-oneOf[1]
Type: object
OCI Object Storage Bucket
Show Source
Nested Schema : archiveTarget-x-oneOf[2]
Type: object
S3-compatible object storage bucket
Show Source
Nested Schema : authentication
Match One
Show Source
Nested Schema : authentication-x-oneOf[0]
Type: object
Authentication using a named profile from the default profile configuration file
Show Source
Nested Schema : authentication-x-oneOf[1]
Type: object
Authentication for OCI using an instance principal
Show Source
Nested Schema : authentication-x-oneOf[2]
Type: object
Authentication for OCI using an API signing key for a user
Show Source
Nested Schema : authentication
Match One
Show Source
Nested Schema : authentication-x-oneOf[0]
Type: object
Authentication using a named profile from the default profile configuration file
Show Source
Nested Schema : authentication-x-oneOf[1]
Type: object
S3 Authentication using secrets
Show Source
Example Response (application/json)
{
}
Back to Top