トレイル順序のリスト表示
get
/services/{version}/trails/{trail}/sequences
必要なロール: ユーザー
特定のトレイルに存在する順序のコレクションをすべて取得します。
リクエスト
パス・パラメータ
- trail(必須): string
最小長:
2
最大長:512
パターン:^[a-zA-Z0-9_#$-]*$
トレイルの名前。これは、
ogg:trail
リソースのtrailName
プロパティまたはトレイル・ファイルシステム・パスに対応します。トレイル名には、
HumanResources
のようなわかりやすい名前、または2文字の名前にpathという問合せパラメータ(値はea?path=north%2Femployees
のようにURIエンコードされたトレイル・ファイルシステムのパス)を付加した名前を指定できます。トレイル名に短縮名とURIエンコード・パスを使用する場合は、対応するogg:trail
リソースのname
およびpath
プロパティと一致する必要があります。パス/名前が
north/employees/ea
に設定されたHumanResources
というトレイルは、HumanResources
またはea?path=north%2Femployees
と呼ばれていますが、正規名は常にわかりやすい名前です。POST操作では、わかりやすい名前のみが受け入れられます。
- version(必須): string
Oracle GoldenGateサービスのAPIバージョン。
指定できる値:[ "v2" ]
レスポンス
サポートされるメディア・タイプ
- application/json
200レスポンス
トレイル順序のコレクションが正常に取得されました。
ルート・スキーマ: Oracle GoldenGate Collection
型:
object
タイトル:
ソースの表示
Oracle GoldenGate Collection
- $schema:
指定できる値:
[ "ogg:collection" ]
- items(必須): array items
最小アイテム数:
0
最大アイテム数:32767
ネストされたスキーマ: items
型:
object
使用可能な追加プロパティ:
ソースの表示
true
- $schema: string
最小長:
1
最大長:255
デフォルト値:ogg:collectionItem
コレクション・アイテムのスキーマ名。デフォルトはこのスキーマです - links(必須): array links
最小アイテム数:
1
最大アイテム数:16
アイテムのリンク - name(必須): string
最小長:
1
最大長:255
アイテム名 - status: status
アイテムのステータス
ネストされたスキーマ: items
型:
ソースの表示
object
- $schema:
指定できる値:
[ "ogg:link" ]
- description: string
最小長:
1
最大長:4095
このリンク固有の情報と詳細を提供する、人が読むための説明。 - href(必須): string
最小長:
2
最大長:4095
パターン:^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$
リンクの絶対URI - mediaType: string
最小長:
6
最大長:255
パターン:^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$
メディア・タイプ - RFC 4288 (https://tools.ietf.org/html/rfc4288)を参照 - rel(必須):
指定できる値:
[ "alternate", "canonical", "current", "describedby", "describes", "enclosure", "parent", "related", "self", "first", "last", "next", "previous", "ogg://service" ]
hrefとリクエスト対象のリンクlinkの関係
レスポンスの例(application/json)
{
"$schema":"api:standardResponse",
"links":[
{
"rel":"canonical",
"href":"http://localhost:9012/services/v2/trails/aa/sequences?path=dir1%2FT_EXT1",
"mediaType":"application/json"
},
{
"rel":"self",
"href":"http://localhost:9012/services/v2/trails/aa/sequences?path=dir1%2FT_EXT1",
"mediaType":"application/json"
},
{
"rel":"describedby",
"href":"http://localhost:9012/services/v2/metadata-catalog/sequences",
"mediaType":"application/schema+json"
}
],
"messages":[
],
"response":{
"items":[
{
"links":[
{
"rel":"parent",
"href":"http://localhost:9012/services/v2/trails/aa/sequences?path=dir1%2FT_EXT1",
"mediaType":"application/json"
},
{
"rel":"canonical",
"href":"http://localhost:9012/services/v2/trails/aa/sequences/0?path=dir1%2FT_EXT1",
"mediaType":"application/json"
}
],
"$schema":"ogg:collectionItem",
"name":"0"
},
{
"links":[
{
"rel":"parent",
"href":"http://localhost:9012/services/v2/trails/aa/sequences?path=dir1%2FT_EXT1",
"mediaType":"application/json"
},
{
"rel":"canonical",
"href":"http://localhost:9012/services/v2/trails/aa/sequences/1?path=dir1%2FT_EXT1",
"mediaType":"application/json"
}
],
"$schema":"ogg:collectionItem",
"name":"1"
},
{
"links":[
{
"rel":"parent",
"href":"http://localhost:9012/services/v2/trails/aa/sequences?path=dir1%2FT_EXT1",
"mediaType":"application/json"
},
{
"rel":"canonical",
"href":"http://localhost:9012/services/v2/trails/aa/sequences/2?path=dir1%2FT_EXT1",
"mediaType":"application/json"
}
],
"$schema":"ogg:collectionItem",
"name":"2"
}
],
"$schema":"ogg:collection"
}
}