GoldenGate Veridata REST API

接続の取得(複数)

get

http://{host}:{port}/veridata/v1/services/configuration/connections

必要なロール: Administrator、SuperUser、DetailMonitoringOperator、MonitoringOperator、CommandLineOperator

接続のリストを返します。

リクエスト

問合せパラメータ

dbType:

データベース・タイプ。
description: string

接続の説明。
isManaged: boolean

接続を管理対象エージェントに関連付けるかどうかを指定します。
name: string

接続の名前。
properties: boolean

trueに設定すると、接続プロパティがフェッチされます。

デフォルト値: false
settings: boolean

trueに設定すると、接続設定がフェッチされます。

デフォルト値: false
ssl: string

SSL対応の接続。

デフォルト値: all

指定できる値: [ "true", "false", "all" ]

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

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

application/json

200 レスポンス

接続が正常に取得されました。

ルート・スキーマ: schema

タイプ: array

ソースの表示

配列: object BaseConnection

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BaseConnection"
    },
    "example":[
        {
            "createdOn":"2025-01-02T10:45:52.080Z",
            "host":"100.00.00.00",
            "id":1083,
            "name":"Oracle-Source-Connection",
            "port":7851,
            "dbType":"oracle",
            "isManaged":false,
            "properties":[
                {
                    "datatype":"ARRAY",
                    "datatypeNumber":2004,
                    "defaultFormat":{
                        "defaultFormatType":"ggComparisonFormatBlob",
                        "formatName":"blob",
                        "order":0
                    },
                    "formatName":"blob"
                }
            ],
            "settings":{
                "useSourceTargetAsKeys":"true",
                "useAllColsAsKeys":"true",
                "fetchSize":"1000",
                "agentTimeout":"3600",
                "trimTrailingSpaces":"true",
                "ssl":"false"
            },
            "updatedOn":"2025-01-02T10:45:52Z"
        },
        {
            "createdOn":"2025-01-02T10:45:52.080Z",
            "host":"100.00.00.00",
            "id":1084,
            "name":"Oracle-Target-Connection",
            "port":7852,
            "dbType":"oracle",
            "isManaged":true,
            "properties":[
                {
                    "datatype":"ARRAY",
                    "datatypeNumber":2004,
                    "defaultFormat":{
                        "defaultFormatType":"ggComparisonFormatBlob",
                        "formatName":"blob",
                        "order":0
                    },
                    "formatName":"blob"
                }
            ],
            "settings":{
                "useSourceTargetAsKeys":"true",
                "useAllColsAsKeys":"true",
                "fetchSize":"1000",
                "agentTimeout":"3600",
                "trimTrailingSpaces":"true",
                "ssl":"false"
            },
            "updatedOn":"2025-01-02T10:45:52Z"
        }
    ]
}

例:

[
    {
        "createdOn":"2025-01-02T10:45:52.080Z",
        "host":"100.00.00.00",
        "id":1083,
        "name":"Oracle-Source-Connection",
        "port":7851,
        "dbType":"oracle",
        "isManaged":false,
        "properties":[
            {
                "datatype":"ARRAY",
                "datatypeNumber":2004,
                "defaultFormat":{
                    "defaultFormatType":"ggComparisonFormatBlob",
                    "formatName":"blob",
                    "order":0
                },
                "formatName":"blob"
            }
        ],
        "settings":{
            "useSourceTargetAsKeys":"true",
            "useAllColsAsKeys":"true",
            "fetchSize":"1000",
            "agentTimeout":"3600",
            "trimTrailingSpaces":"true",
            "ssl":"false"
        },
        "updatedOn":"2025-01-02T10:45:52Z"
    },
    {
        "createdOn":"2025-01-02T10:45:52.080Z",
        "host":"100.00.00.00",
        "id":1084,
        "name":"Oracle-Target-Connection",
        "port":7852,
        "dbType":"oracle",
        "isManaged":true,
        "properties":[
            {
                "datatype":"ARRAY",
                "datatypeNumber":2004,
                "defaultFormat":{
                    "defaultFormatType":"ggComparisonFormatBlob",
                    "formatName":"blob",
                    "order":0
                },
                "formatName":"blob"
            }
        ],
        "settings":{
            "useSourceTargetAsKeys":"true",
            "useAllColsAsKeys":"true",
            "fetchSize":"1000",
            "agentTimeout":"3600",
            "trimTrailingSpaces":"true",
            "ssl":"false"
        },
        "updatedOn":"2025-01-02T10:45:52Z"
    }
]

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

タイプ: object

ソースの表示

createdOn: string (date-time)

パターン: YYYY-MM-DDTHH:mm:ss.sssZ

例: 2024-02-03T10:15:30Z
description: string

接続の説明。
host: string

Veridataエージェントのホスト。
id: integer (int64)

接続ID。
name: string

接続名。
port: integer (int32)

Veridataエージェントのポート。
updatedOn: string (date-time)

パターン: YYYY-MM-DDTHH:mm:ss.sssZ

例: 2024-02-03T10:15:30Z

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "description":"Connection Id.",
            "format":"int64"
        },
        "name":{
            "type":"string",
            "description":"Connection Name."
        },
        "description":{
            "type":"string",
            "description":"Connection Description."
        },
        "host":{
            "type":"string",
            "description":"Veridata Agent Host."
        },
        "port":{
            "type":"integer",
            "description":"Veridata Agent Port.",
            "format":"int32"
        },
        "createdOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        },
        "updatedOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        }
    },
    "example":{
        "createdOn":"2025-04-02T11:20:51.269Z",
        "description":"Connection to source Oracle database",
        "host":"100.00.00.00",
        "id":1090,
        "name":"Oracle-Connection-Source",
        "port":7800
    }
}

例:

{
    "createdOn":"2025-04-02T11:20:51.269Z",
    "description":"Connection to source Oracle database",
    "host":"100.00.00.00",
    "id":1090,
    "name":"Oracle-Connection-Source",
    "port":7800
}

400 レスポンス

不正なリクエスト。

ルート・スキーマ: Error

タイプ: object

ソースの表示

errCode: string

Veridataのエラー・コード。
errMsg: string

Veridataのエラー・メッセージ。

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

例:

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

401 レスポンス

権限がありません。

ルート・スキーマ: Error

タイプ: object

ソースの表示

errCode: string

Veridataのエラー・コード。
errMsg: string

Veridataのエラー・メッセージ。

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

例:

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

404 レスポンス

見つかりません。

ルート・スキーマ: Error

タイプ: object

ソースの表示

errCode: string

Veridataのエラー・コード。
errMsg: string

Veridataのエラー・メッセージ。

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

例:

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

500 レスポンス

サーバー・エラー。

ルート・スキーマ: Error

タイプ: object

ソースの表示

errCode: string

Veridataのエラー・コード。
errMsg: string

Veridataのエラー・メッセージ。

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

例:

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

先頭に戻る