Oracle GoldenGate Microservices REST API

ステータスの取得

get

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

必要なロール: ユーザー

Replicatプロセスの現在のステータスを取得します。

リクエスト

パス・パラメータ

replicat(必須): string

最小長: 1

最大長: 8

パターン: ^[A-Z_$][A-Z0-9_$]*$

Replicatの名前。Replicat名は大文字で、先頭が英字、その後に英数字が最大で7文字続きます。
version(必須): string

Oracle GoldenGateサービスのAPIバージョン。

指定できる値: [ "v2" ]

先頭に戻る

レスポンス

サポートされるメディア・タイプ

application/json

200レスポンス

プロセスのステータスが正常に取得されました。

ルート・スキーマ: Replicat process status

型: object

タイトル: Replicat process status

ソースの表示

$schema:

指定できる値: [ "ogg:replicatStatus" ]
lag(必須): integer

最小値: 0

最大値: 4294967295

プロセス・ラグ(秒)
lastStarted(必須): lastStarted
position: position
processId: integer

最小値: 1

最大値: 4294967295
sinceLagReported(必須): integer

最小値: 0

最大値: 4294967295

プロセス・ラグがレポートされてからの秒数
status(必須):

指定できる値: [ "starting", "running", "stopped", "killed", "abended" ]
synchronized: boolean

{
    "title":"Replicat process status",
    "required":[
        "status",
        "lastStarted",
        "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":{
            "x-oneOf":[
                {
                    "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":"2",
                            "maxLength":"2"
                        },
                        "path":{
                            "description":"The path where trail data is stored",
                            "type":"string",
                            "minLength":"1",
                            "maxLength":"4096"
                        },
                        "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"
                        }
                    },
                    "required":[
                        "name",
                        "sequence",
                        "offset"
                    ],
                    "additionalProperties":false
                },
                {
                    "type":"object",
                    "properties":{
                        "$schema":{
                            "enum":[
                                "ogg:filePosition"
                            ]
                        },
                        "name":{
                            "description":"The name of the file",
                            "type":"string",
                            "minLength":"1",
                            "maxLength":"4096"
                        },
                        "path":{
                            "description":"The path where file data is stored",
                            "type":"string",
                            "minLength":"1",
                            "maxLength":"4096"
                        },
                        "offset":{
                            "description":"Offset in file",
                            "type":"integer",
                            "minimum":"0",
                            "maximum":"2147483647"
                        }
                    },
                    "required":[
                        "name",
                        "path",
                        "offset"
                    ],
                    "additionalProperties":false
                }
            ]
        },
        "lag":{
            "description":"Process lag in seconds",
            "type":"integer",
            "minimum":"0",
            "maximum":"4294967295"
        },
        "sinceLagReported":{
            "description":"Time in seconds since process lag was reported",
            "type":"integer",
            "minimum":"0",
            "maximum":"4294967295"
        },
        "processId":{
            "type":"integer",
            "minimum":"1",
            "maximum":"4294967295"
        }
    },
    "additionalProperties":false
}

ネストされたスキーマ: lastStarted

1つに一致

ソースの表示

string

最小長: 20

最大長: 32

パターン: ^[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"
        }
    ]
}

ネストされたスキーマ: position

1つに一致

ソースの表示

object position-x-oneOf[0]
object position-x-oneOf[1]

{
    "x-oneOf":[
        {
            "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":"2",
                    "maxLength":"2"
                },
                "path":{
                    "description":"The path where trail data is stored",
                    "type":"string",
                    "minLength":"1",
                    "maxLength":"4096"
                },
                "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"
                }
            },
            "required":[
                "name",
                "sequence",
                "offset"
            ],
            "additionalProperties":false
        },
        {
            "type":"object",
            "properties":{
                "$schema":{
                    "enum":[
                        "ogg:filePosition"
                    ]
                },
                "name":{
                    "description":"The name of the file",
                    "type":"string",
                    "minLength":"1",
                    "maxLength":"4096"
                },
                "path":{
                    "description":"The path where file data is stored",
                    "type":"string",
                    "minLength":"1",
                    "maxLength":"4096"
                },
                "offset":{
                    "description":"Offset in file",
                    "type":"integer",
                    "minimum":"0",
                    "maximum":"2147483647"
                }
            },
            "required":[
                "name",
                "path",
                "offset"
            ],
            "additionalProperties":false
        }
    ]
}

ネストされたスキーマ: position-x-oneOf[0]

型: object

ソースの表示

$schema:

指定できる値: [ "ogg:trailPosition" ]
name(必須): string

最小長: 2

最大長: 2

パターン: ^[A-Za-z][A-Za-z0-9]$

トレイルの名前
offset(必須): integer

最小値: 0

最大値: 2147483647

デフォルト値: 0

トレイル順序ファイルのオフセット
path: string

最小長: 1

最大長: 4096

トレイル・データが格納されるパス
sequence(必須): integer

最小値: 0

最大値: 999999999

デフォルト値: 0

トレイル・ファイル順序番号

{
    "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":"2",
            "maxLength":"2"
        },
        "path":{
            "description":"The path where trail data is stored",
            "type":"string",
            "minLength":"1",
            "maxLength":"4096"
        },
        "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"
        }
    },
    "required":[
        "name",
        "sequence",
        "offset"
    ],
    "additionalProperties":false
}

ネストされたスキーマ: position-x-oneOf[1]

型: object

ソースの表示

$schema:

指定できる値: [ "ogg:filePosition" ]
name(必須): string

最小長: 1

最大長: 4096

ファイルの名前
offset(必須): integer

最小値: 0

最大値: 2147483647

ファイル内のオフセット
path(必須): string

最小長: 1

最大長: 4096

ファイル・データが格納されるパス

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:filePosition"
            ]
        },
        "name":{
            "description":"The name of the file",
            "type":"string",
            "minLength":"1",
            "maxLength":"4096"
        },
        "path":{
            "description":"The path where file data is stored",
            "type":"string",
            "minLength":"1",
            "maxLength":"4096"
        },
        "offset":{
            "description":"Offset in file",
            "type":"integer",
            "minimum":"0",
            "maximum":"2147483647"
        }
    },
    "required":[
        "name",
        "path",
        "offset"
    ],
    "additionalProperties":false
}

レスポンスの例(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":"2021-07-13T16:38:52.479Z",
        "position":{
            "name":"X2",
            "offset":"4528",
            "path":"/u02/ogg/Local/var/lib/data/",
            "sequence":"0"
        },
        "processId":"1904",
        "sinceLagReported":"3",
        "status":"running"
    }
}

先頭に戻る