Oracle GoldenGate 23ai Microservices Architecture REST APIドキュメンテーション

サービス状態の詳細

get

/services/{version}/config/health

必要なロール: ユーザー

サービス状態の詳細情報を取得します。

リクエスト

パス・パラメータ

version(必須): string

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

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

先頭に戻る

レスポンス

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

application/json

200レスポンス

ルート・スキーマ: Oracle GoldenGate Service Health

型: object

タイトル: Oracle GoldenGate Service Health

このスキーマはOGGサービスの状態を説明します

ソースの表示

$schema:

指定できる値: [ "ogg:health" ]
criticalResources: array criticalResources

最小アイテム数: 1

最大アイテム数: 65535
deploymentName(必須): string

最小長: 1

最大長: 32

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

Oracle GoldenGateデプロイメントの名前
healthy(必須): boolean

Microservice状態インジケータ
serviceName(必須): string

最小長: 1

最大長: 64

OGG Microserviceの名前
started(必須): 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])$

サービスが開始した日時

{
    "title":"Oracle GoldenGate Service Health",
    "description":"This schema describes the health of an OGG service",
    "required":[
        "deploymentName",
        "serviceName",
        "started",
        "healthy"
    ],
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:health"
            ]
        },
        "deploymentName":{
            "description":"Name of the Oracle GoldenGate deployment",
            "type":"string",
            "pattern":"^[A-Za-z][A-Za-z0-9-_.]*$",
            "minLength":"1",
            "maxLength":"32"
        },
        "serviceName":{
            "description":"Name of the OGG Microservice",
            "type":"string",
            "minLength":"1",
            "maxLength":"64"
        },
        "started":{
            "description":"Date and time the service started",
            "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"
        },
        "healthy":{
            "description":"Microservice health indicator",
            "type":"boolean"
        },
        "criticalResources":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "deploymentName":{
                        "description":"Resource deployment name",
                        "type":"string",
                        "pattern":"^[A-Za-z][A-Za-z0-9-_.]*$",
                        "minLength":"1",
                        "maxLength":"32"
                    },
                    "name":{
                        "description":"Resource name",
                        "type":"string",
                        "minLength":"1",
                        "maxLength":"64"
                    },
                    "type":{
                        "description":"Resource type",
                        "enum":[
                            "extract",
                            "replicat",
                            "ER",
                            "service",
                            "task",
                            "distPath",
                            "recvPath"
                        ]
                    },
                    "status":{
                        "x-anyOf":[
                            {
                                "enum":[
                                    "starting",
                                    "running",
                                    "stopped",
                                    "killed",
                                    "abended"
                                ]
                            },
                            {
                                "enum":[
                                    "paused",
                                    "running",
                                    "stopping",
                                    "stopped",
                                    "killed",
                                    "uninitialized"
                                ],
                                "default":"stopped"
                            },
                            {
                                "enum":[
                                    "restarting",
                                    "disabled"
                                ]
                            }
                        ]
                    },
                    "healthy":{
                        "description":"Resource health indicator",
                        "type":"boolean"
                    }
                },
                "required":[
                    "name",
                    "type",
                    "status",
                    "healthy"
                ],
                "additionalProperties":false
            },
            "minItems":"1",
            "maxItems":"65535"
        }
    },
    "additionalProperties":false
}

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

型: array

最小アイテム数: 1

最大アイテム数: 65535

ソースの表示

配列: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "deploymentName":{
                "description":"Resource deployment name",
                "type":"string",
                "pattern":"^[A-Za-z][A-Za-z0-9-_.]*$",
                "minLength":"1",
                "maxLength":"32"
            },
            "name":{
                "description":"Resource name",
                "type":"string",
                "minLength":"1",
                "maxLength":"64"
            },
            "type":{
                "description":"Resource type",
                "enum":[
                    "extract",
                    "replicat",
                    "ER",
                    "service",
                    "task",
                    "distPath",
                    "recvPath"
                ]
            },
            "status":{
                "x-anyOf":[
                    {
                        "enum":[
                            "starting",
                            "running",
                            "stopped",
                            "killed",
                            "abended"
                        ]
                    },
                    {
                        "enum":[
                            "paused",
                            "running",
                            "stopping",
                            "stopped",
                            "killed",
                            "uninitialized"
                        ],
                        "default":"stopped"
                    },
                    {
                        "enum":[
                            "restarting",
                            "disabled"
                        ]
                    }
                ]
            },
            "healthy":{
                "description":"Resource health indicator",
                "type":"boolean"
            }
        },
        "required":[
            "name",
            "type",
            "status",
            "healthy"
        ],
        "additionalProperties":false
    },
    "minItems":"1",
    "maxItems":"65535"
}

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

型: object

ソースの表示

deploymentName: string

最小長: 1

最大長: 32

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

リソース・デプロイメント名
healthy(必須): boolean

リソース状態インジケータ
name(必須): string

最小長: 1

最大長: 64

リソース名
status(必須): status
type(必須):

指定できる値: [ "extract", "replicat", "ER", "service", "task", "distPath", "recvPath" ]

リソース・タイプ

{
    "type":"object",
    "properties":{
        "deploymentName":{
            "description":"Resource deployment name",
            "type":"string",
            "pattern":"^[A-Za-z][A-Za-z0-9-_.]*$",
            "minLength":"1",
            "maxLength":"32"
        },
        "name":{
            "description":"Resource name",
            "type":"string",
            "minLength":"1",
            "maxLength":"64"
        },
        "type":{
            "description":"Resource type",
            "enum":[
                "extract",
                "replicat",
                "ER",
                "service",
                "task",
                "distPath",
                "recvPath"
            ]
        },
        "status":{
            "x-anyOf":[
                {
                    "enum":[
                        "starting",
                        "running",
                        "stopped",
                        "killed",
                        "abended"
                    ]
                },
                {
                    "enum":[
                        "paused",
                        "running",
                        "stopping",
                        "stopped",
                        "killed",
                        "uninitialized"
                    ],
                    "default":"stopped"
                },
                {
                    "enum":[
                        "restarting",
                        "disabled"
                    ]
                }
            ]
        },
        "healthy":{
            "description":"Resource health indicator",
            "type":"boolean"
        }
    },
    "required":[
        "name",
        "type",
        "status",
        "healthy"
    ],
    "additionalProperties":false
}

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

いずれかに一致

ソースの表示

指定できる値: [ "starting", "running", "stopped", "killed", "abended" ]
デフォルト値: stopped

指定できる値: [ "paused", "running", "stopping", "stopped", "killed", "uninitialized" ]
指定できる値: [ "restarting", "disabled" ]

{
    "x-anyOf":[
        {
            "enum":[
                "starting",
                "running",
                "stopped",
                "killed",
                "abended"
            ]
        },
        {
            "enum":[
                "paused",
                "running",
                "stopping",
                "stopped",
                "killed",
                "uninitialized"
            ],
            "default":"stopped"
        },
        {
            "enum":[
                "restarting",
                "disabled"
            ]
        }
    ]
}

レスポンスの例(application/json)

{
    "$schema":"api:standardResponse",
    "links":[
        {
            "href":"http://localhost:9012/services/v2/config/health",
            "mediaType":"application/json",
            "rel":"canonical"
        },
        {
            "href":"http://localhost:9012/services/v2/config/health",
            "mediaType":"application/json",
            "rel":"self"
        },
        {
            "href":"http://localhost:9012/services/v2/metadata-catalog/health",
            "mediaType":"application/schema+json",
            "rel":"describedby"
        }
    ],
    "messages":[
    ],
    "response":{
        "$schema":"ogg:health",
        "deploymentName":"Local",
        "healthy":true,
        "serviceName":"adminsrvr",
        "started":"2024-04-03T22:33:14.387Z"
    }
}

先頭に戻る