サイト管理用のREST API

サイト・リフレッシュ・ジョブのリスト・ページ

get

/sites/management/api/v1/sites/_status/{id}/pages

COLLECTION

サイトのリフレッシュ・ジョブでリフレッシュされるサイト・ページをリストします。個々のステータスや各ページのエラーの詳細など、リフレッシュされるページに関する詳細が返されます。ページは、失敗したページや完了したページなどのステータスでフィルタできます。サイトには多数のページが存在する可能性があるため、ページで結果をリクエストできます。

リリース20.2.2で導入されました。

サイトのリフレッシュ

リフレッシュを使用すると、事前レンダリングされたサイト・コンテンツをより高速に使用できるようになります。

詳細は、「コンテンツ・キャッシュのリフレッシュ」を参照してください。

制限

limit問合せパラメータが指定されていない場合、この操作では50アイテムのデフォルト制限が使用されます。指定できる最大制限は250です。制限がこの最大値を超えると、250の制限が使用されます。

成功したレスポンスの例

この操作は、次の成功(2xx)のレスポンスで応答します。レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。

200OK - List Pages with Paging

サイトのリフレッシュ・ジョブの最初の5ページをリストします。

リクエスト

GET https://api.example.com/sites/management/api/v1/sites/_status/{id}/pages?links=none&offset=0&limit=5

レスポンス本文

{
  "limit": 5,
  "count": 5,
  "hasMore": true,
  "offset": 0,
  "items": [
      {
        "pageUrl": "http://oracle.cec.com/site/home.html",
        "status": "complete"
      },
      {
        "pageUrl": "http://oracle.cec.com/site/about.html",
        "status": "processing"
      },
      {
        "pageUrl": "http://oracle.cec.com/site/menu.html",
        "status": "processing"
      },
      {
        "pageUrl": "http://oracle.cec.com/site/menu/details.html",
        "status": "processing"
      },
      {
        "pageUrl": "http://oracle.cec.com/site/privacy-policy.html",
        "status": "pending"
      }
  ]
}

200 OK - ステータス別ページ・リスト

サイト・リフレッシュ・ジョブでリフレッシュに失敗したページをリストします。

リクエスト

GET https://api.example.com/sites/management/api/v1/sites/_status/{id}/pages?links=none&q=status eq "failed"

レスポンス本文

{
  "limit": 50,
  "count": 2,
  "hasMore": false,
  "offset": 0,
  "items": [
      {
        "pageUrl": "http://oracle.cec.com/site/home.html",
        "status": "failed",
        "error": {
          "title": "Page Contains Invalid Characters",
          "detail": "The page contains one or more invalid characters"
        }
      },
      {
        "pageUrl": "http://oracle.cec.com/site/about.html",
        "status": "failed",
        "error": {
          "title": "Page Contains Invalid Characters",
          "detail": "The page contains one or more invalid characters"
        }
      }
  ]
}

クライアント・エラー・レスポンスの例

この操作は、レスポンス本文に例外の詳細が含まれている次のクライアント・エラー(4xx)レスポンスで応答します。レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。

404Not Found - Site Job Not Found

サイト・ジョブが存在しないか、削除されたか、認証されたユーザーまたはクライアント・アプリケーションにジョブへのアクセス権がありません。

エラー・コード

OCE-SITEMGMT-009024

解決 - 識別子のチェック

サイト・ジョブ識別子が有効であることを確認してください。

例外詳細フィールド

このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:

フィールド名	説明
`jobStatus`	存在しないか、認証されたユーザーが参照できないサイト・ジョブ・ステータス。

この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteJobNotFoundExceptionDetailスキーマを参照してください。

レスポンス本文の例

{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Site Job Not Found",
  "status": "404",
  "detail": "Job does not exist or has been deleted, or the authenticated user or client application does not have access to the job.",
  "o:errorCode": "OCE-SITEMGMT-009024",
  "jobStatus": {
    "context": "37D1070720325969AC6C47ACE8B9BFF91533560416423"
  }
}

リクエスト

パス・パラメータ

id: string

レスポンスを元の非同期ジョブに関連付けるために使用できるジョブ・コンテキスト識別子の値。非同期ジョブがどのように開始されたかによって、コンテキスト値があるかどうか、およびコンテキスト値は何かが決まります。

問合せパラメータ

excludeFields(optional): string

レスポンスに使用しないフィールド名のカンマ区切り文字列。フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。フィールド名は大文字と小文字を区別します。フィールドが存在しない場合、フィールド名は無視されます。コレクションのフィールドを参照するために、フィールド名の先頭に@文字(@hasMoreなど)を付加できます。
excludeLinks(optional): string

レスポンスからexcludeへのリンク関係名のカンマ区切りリスト。
fields(optional): string

レスポンスに必要なフィールド名のカンマ区切り文字列。フィールド名を区切るためにドットを使用して、ネストされたプロパティを特定できます。フィールド名は大文字と小文字を区別します。フィールドが存在しない場合、フィールド名は無視されます。コレクションのフィールドを参照するために、フィールド名の先頭に@文字(@hasMoreなど)を付加できます。
limit(optional): integer(int32)

レスポンスで返される最大品目数を指定する正の整数値。指定しない場合、サービスでは適切な制限が選択されます。

links(optional): string

レスポンス内のincludeへのリンク関係名のカンマ区切りリスト。デフォルトでは、すべてのリンクが返されます。

次のリンクは、このリソースにより提供されます:

リンク関係	説明
`parent`	親リソースが読取り可能な場所を示します。このリンクは`up`リンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。
`self`	リソースの現在の戻り表現を示します。リソース自体を表すリンクに使用されます。たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。
`canonical`	リクエストされたリソースの優先表現を示します。リソースの標準的な形式を表すリンクに使用されます。たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。
`child`	関連リソースまたは子リソースの読取りが可能な場所を表します。子リンクは展開可能なプロパティとして返され、展開されていない関係の詳細が読み取られるロケーションを提供します。
`prev`	前のページが存在する場合、結果の前のページを説明します。コレクション・リソースとともに使用し、`offset`および`limit`問合せパラメータを指定したページ・リクエストへのレスポンスに基づいて前のパス・リンクを提供します。
`next`	次のページが存在する場合、結果の次のページについて説明します。収集リソースとともに使用し、`offset`および`limit`問合せパラメータを指定したページ・リクエストへのレスポンスに基づいて、次のページ・リンクを提供します。
`search-form`	使用可能な問合せ構文を説明する検索フォームの読取り可能な場所を説明します。検索フォームには、リソースの検索に使用できる検索基準の詳細が表示されます。
`describedBy`	リソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。

offset(optional): integer(int64)

返される最初のアイテムのインデックスを指定する負でない整数値。オフセット索引はゼロから始まります。デフォルトでは、オフセットはゼロで、コレクション内の最初のアイテムから始まるアイテムが返されます。
q(optional): string

コレクションで返されるアイテムを制御する問合せ式。問合せ式が指定されていない場合に、アイテムにフィルタリングは適用されません。
q問合せパラメータでは、次のフィールドおよび演算子を使用できます:
フィールド名サポートされる演算子
status (eq)と等しい
次の演算子について説明します:
オペレータ説明
eq
次と等しい演算子。属性と演算子の値は同一です。

フィールド名	サポートされる演算子
`status`	`(eq)`と等しい

オペレータ	説明
`eq`	次と等しい演算子。属性と演算子の値は同一です。

return(optional): string

レスポンス・フィールドおよびリンクの制御に使用するリソース表現を指定します。表現が指定されない場合、fields、excludeFields、links、excludeLinksおよびexpand問合せパラメータの値に基づいて、クライアント定義の表現が戻されます。

次の表現は、return問合せパラメータでサポートされています:

表現	説明
`representation`	フル・リソース表示には、すべてのプロパティとリンクが含まれ、大部分の関係が拡張されます。
`default`	デフォルトのリソース表示には、ほとんどのプロパティとリンクが含まれます。
`basic`	基本的なリソース表現には、いくつかのプロパティといくつかのリンクが含まれます。
`minimal`	最小リソース表現。必須プロパティとリンクなしが含まれます。

トップに戻る

レスポンス

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

application/json
application/vnd.oracle.resource+json;type=collection

200レスポンス

ヘッダー

Cache-Control: string

キャッシュ・メカニズムのディレクティブ。
Content-Length: string

レスポンス本文のサイズ。
Content-Type: string

レスポンスのコンテンツ・タイプ。

ルート・スキーマ: schema

型: object

ソースを表示

items: array items

「サイト・ページ・リフレッシュ・アイテム」要素のコレクション。
リリース20.2.2で導入されました。

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/definitions/CollectionResource"
        }
    ],
    "properties":{
        "items":{
            "description":"<p>Collection of <em>Site Page Refresh Item</em> elements.</p><small>Introduced in release 20.2.2.</small>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"array",
            "items":{
                "allOf":[
                    {
                        "$ref":"#/definitions/SitePageRefreshItem"
                    }
                ]
            }
        }
    },
    "required":[
        "items"
    ]
}

すべてに一致

ソースを表示

allOf CollectionResource

REST APIによって返されるすべてのコレクションは、標準のコレクション定義を拡張します。この定義では、品目の合計数、返される品目のオフセットおよび制限の詳細、品目の数、および使用可能な品目が他にもあるかどうかを示すインジケータに関する情報を提供します。

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/definitions/CollectionResource"
        }
    ],
    "properties":{
        "items":{
            "description":"<p>Collection of <em>Site Page Refresh Item</em> elements.</p><small>Introduced in release 20.2.2.</small>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"array",
            "items":{
                "allOf":[
                    {
                        "$ref":"#/definitions/SitePageRefreshItem"
                    }
                ]
            }
        }
    },
    "required":[
        "items"
    ]
}

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

型: array

「サイト・ページ・リフレッシュ・アイテム」要素のコレクション。

リリース20.2.2で導入されました。

ソースを表示

Array of: items

{
    "description":"<p>Collection of <em>Site Page Refresh Item</em> elements.</p><small>Introduced in release 20.2.2.</small>",
    "x-returnedIn":[
        "representation",
        "default",
        "basic",
        "minimal"
    ],
    "type":"array",
    "items":{
        "allOf":[
            {
                "$ref":"#/definitions/SitePageRefreshItem"
            }
        ]
    }
}

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

REST APIによって返されるすべてのコレクションは、標準のコレクション定義を拡張します。この定義では、品目の合計数、返される品目のオフセットおよび制限の詳細、品目の数、および使用可能な品目が他にもあるかどうかを示すインジケータに関する情報を提供します。

すべてに一致

ソースを表示

object SingularResource

すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。
object CollectionResource-allOf[1]

{
    "description":"<p>All collections returned by REST APIs extend the standard collection definition. The definition provides information about the total number of items, the offset and limit details for the items returned, the number of items and an indicator to whether there are more items available.</p>",
    "allOf":[
        {
            "$ref":"#/definitions/SingularResource"
        },
        {
            "properties":{
                "totalResults":{
                    "description":"<p>Total number of resources that match the request. If provided, this is the total number of available items. If not specified the total is not known, or is not viable to return. Paging limits or offsets are ignored when calculating this value. Only returned if the <code>totalResults</code> parameter is supported and is set to <code>true</code> by the client.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"integer",
                    "format":"int64"
                },
                "limit":{
                    "description":"<p>Actual response size limit used. If the request specifies too large a limit, or does not specify a limit then the response will specify the limit used.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"integer",
                    "format":"int32"
                },
                "count":{
                    "description":"<p>Total number of resources in the response.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"integer",
                    "format":"int32"
                },
                "hasMore":{
                    "description":"<p>Collection has more elements that match the request. Indicates whether there are more items to be returned when a paged request is made and the page was not big enough to return all elements.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"boolean"
                },
                "offset":{
                    "description":"<p>Actual response offset used. If the request specifies no offset then the actual offset is provided in the response.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"integer",
                    "format":"int64"
                }
            }
        }
    ]
}

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

型: object

すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。

ソースを表示

links(optional): array links

このリソースに対する関連リソースおよびアクションへのHATEOSリンク。リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。

{
    "description":"<p>All singular resources include the properties of the singular resource definition. A singular resource includes a list of links that provide relationships to other resources, or in the case of the <em>self</em> link the resource itself.</p>",
    "properties":{
        "links":{
            "description":"<p>HATEOS link to related resources and actions or actions on this resource. Must include at least a 'self' link that contains a link to the canonical representation of the resource.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"array",
            "items":{
                "allOf":[
                    {
                        "$ref":"#/definitions/Link"
                    }
                ]
            }
        }
    }
}

ネストされたスキーマ : CollectionResource-allOf[1]

型: object

ソースを表示

count(optional): integer(int32)

レスポンス内のリソースの合計数。
hasMore(optional): boolean

コレクションには、リクエストに一致する多くの要素があります。ページ・リクエストを作成し、ページがすべての要素を返すのに十分な大きさでない場合に、返されるアイテムが他にもあるかどうかを示します。
limit(optional): integer(int32)

実際のレスポンス・サイズ制限。リクエストで指定されている制限値が大きすぎる場合、または制限が指定されていない場合、レスポンスでは使用される制限が指定されます。
offset(optional): integer(int64)

使用される実際のレスポンス・オフセット。リクエストでオフセットが指定されていない場合、レスポンスに実際のオフセットが指定されます。
totalResults(optional): integer(int64)

リクエストに一致するリソースの合計数。指定した場合は、使用可能なアイテムの合計数です。指定されない場合、合計が不明か、または戻り不可能です。この値を計算するとき、ページング制限またはオフセットは無視されます。 totalResultsパラメータがサポートされていて、クライアントがtrueに設定している場合にのみ返されます。

{
    "properties":{
        "totalResults":{
            "description":"<p>Total number of resources that match the request. If provided, this is the total number of available items. If not specified the total is not known, or is not viable to return. Paging limits or offsets are ignored when calculating this value. Only returned if the <code>totalResults</code> parameter is supported and is set to <code>true</code> by the client.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"integer",
            "format":"int64"
        },
        "limit":{
            "description":"<p>Actual response size limit used. If the request specifies too large a limit, or does not specify a limit then the response will specify the limit used.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"integer",
            "format":"int32"
        },
        "count":{
            "description":"<p>Total number of resources in the response.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"integer",
            "format":"int32"
        },
        "hasMore":{
            "description":"<p>Collection has more elements that match the request. Indicates whether there are more items to be returned when a paged request is made and the page was not big enough to return all elements.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"boolean"
        },
        "offset":{
            "description":"<p>Actual response offset used. If the request specifies no offset then the actual offset is provided in the response.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"integer",
            "format":"int64"
        }
    }
}

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

すべてに一致

ソースを表示

allOf SitePageRefreshItem

サイト・リフレッシュ・ジョブの個々のページのステータス詳細。
リリース20.2.2で導入されました。

{
    "allOf":[
        {
            "$ref":"#/definitions/SitePageRefreshItem"
        }
    ]
}

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

サイト・リフレッシュ・ジョブの個々のページのステータス詳細。

リリース20.2.2で導入されました。

すべてに一致

ソースを表示

object SingularResource

すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。
object SitePageRefreshItem-allOf[1]

{
    "description":"<p>Status details for an individual page in a site refresh job.</p><small>Introduced in release 20.2.2.</small>",
    "allOf":[
        {
            "$ref":"#/definitions/SingularResource"
        },
        {
            "properties":{
                "pageUrl":{
                    "description":"<p>The page URL of an individual page in a site refresh job.</p><small>Introduced in release 20.2.2.</small>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic",
                        "minimal"
                    ],
                    "type":"string",
                    "format":"uri"
                },
                "status":{
                    "description":"<p>The current status of an individual page in a site refresh job.</p><p>Valid values are:\n<ul><li> <code>pending</code> - Job has been queued</li><li> <code>processing</code> - Job is processing</li><li> <code>complete</code> - Job has completed</li><li> <code>failed</code> - Job has failed</li></p><small>Introduced in release 20.2.2.</small>",
                    "x-queryable":true,
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic"
                    ],
                    "type":"string"
                },
                "error":{
                    "description":"<p>Error details for an individual page that has failed to refresh in a site refresh job.</p><small>Introduced in release 20.2.2.</small>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic"
                    ],
                    "type":"object"
                }
            }
        }
    ]
}

ネストされたスキーマ : SitePageRefreshItem-allOf[1]

型: object

ソースを表示

error(optional): object error

サイト・リフレッシュ・ジョブでリフレッシュに失敗した個々のページのエラー詳細。
リリース20.2.2で導入されました。
pageUrl(optional): string(uri)

サイト・リフレッシュ・ジョブの個々のページのページURL。
リリース20.2.2で導入されました。
status(optional): string
サイト・リフレッシュ・ジョブの個々のページの現在のステータス。
有効な値は次のとおりです。
- pending - ジョブはキューに入れられました
- processing - ジョブは処理中です
- complete - ジョブが完了しました
- failed - ジョブが失敗しました
リリース20.2.2で導入されました。

{
    "properties":{
        "pageUrl":{
            "description":"<p>The page URL of an individual page in a site refresh job.</p><small>Introduced in release 20.2.2.</small>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic",
                "minimal"
            ],
            "type":"string",
            "format":"uri"
        },
        "status":{
            "description":"<p>The current status of an individual page in a site refresh job.</p><p>Valid values are:\n<ul><li> <code>pending</code> - Job has been queued</li><li> <code>processing</code> - Job is processing</li><li> <code>complete</code> - Job has completed</li><li> <code>failed</code> - Job has failed</li></p><small>Introduced in release 20.2.2.</small>",
            "x-queryable":true,
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "error":{
            "description":"<p>Error details for an individual page that has failed to refresh in a site refresh job.</p><small>Introduced in release 20.2.2.</small>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"object"
        }
    }
}

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

型: array

このリソースに対する関連リソースおよびアクションへのHATEOSリンク。リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。

ソースを表示

Array of: items

{
    "description":"<p>HATEOS link to related resources and actions or actions on this resource. Must include at least a 'self' link that contains a link to the canonical representation of the resource.</p>",
    "x-returnedIn":[
        "representation",
        "default",
        "basic"
    ],
    "type":"array",
    "items":{
        "allOf":[
            {
                "$ref":"#/definitions/Link"
            }
        ]
    }
}

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

すべてに一致

ソースを表示

object 「リンク」

REST HATEOASリンクおよび関連メタデータ。レスポンスがリンクを提供する場合(リソース自体へのselfリンクなど)、提供されるリンクには、このリンク構造で定義された1つ以上のプロパティが含まれます。

{
    "allOf":[
        {
            "$ref":"#/definitions/Link"
        }
    ]
}

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

型: object

REST HATEOASリンクおよび関連メタデータ。レスポンスがリンクを提供する場合(リソース自体へのselfリンクなど)、提供されるリンクには、このリンク構造で定義された1つ以上のプロパティが含まれます。

ソースを表示

href(optional): string

ターゲット・リソースのURI URI RFC3986またはURIテンプレートRFC6570。値がURIテンプレートに設定されている場合、templatedプロパティをtrueに設定する必要があります。
mediaType(optional): string

メディア・タイプ。RFC 2046で定義され、リンク・ターゲットを記述します。
method(optional): string
リンクのターゲットをリクエストするためのHTTPメソッド。
有効な値は次のとおりです。
- OPTIONS - HTTP OPTIONS
- HEAD - HTTP HEAD
- GET - HTTP GET
- POST - HTTP POST
- PUT - HTTP PUT
- PATCH - HTTP PATCH
- DELETE - HTTP DELETE
profile(optional): string(uri)

ターゲット・リソースを参照解除するときにリソースを指定するJSONスキーマなどのリソースのメタデータへのリンク。
rel(optional): string

リンクの詳細を取得するために使用できるリンク・リレーションの名前。
templated(optional): boolean

hrefプロパティを指定するブール・フラグは、URIまたはURIテンプレートです。プロパティが存在しない場合、falseとみなすことができます。

{
    "description":"<p>REST HATEOAS link and related metadata. If responses provide links (for example, a <code>self</code> link to the resource itself) the links provided will include one or more of the properties defined on this link structure.</p>",
    "properties":{
        "rel":{
            "description":"<p>Name of the link relation that, in addition to the type property, can be used to retrieve link details.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "href":{
            "description":"<p>The target resource URI. URI <em>RFC3986</em> or URI Template <em>RFC6570</em>. If the value is set to URI Template, then the <code>templated</code> property must be set to <code>true</code>.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "templated":{
            "description":"<p>Boolean flag that specifies the <code>href</code> property is a URI or URI Template. The property can be assumed to be <code>false</code> if the property is not present.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"boolean"
        },
        "mediaType":{
            "description":"<p>Media type, as defined by RFC 2046, describing the link target.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "method":{
            "description":"<p>HTTP method for requesting the target of the link.</p><p>Valid values are:\n<ul><li> <code>OPTIONS</code> - HTTP OPTIONS</li><li> <code>HEAD</code> - HTTP HEAD</li><li> <code>GET</code> - HTTP GET</li><li> <code>POST</code> - HTTP POST</li><li> <code>PUT</code> - HTTP PUT</li><li> <code>PATCH</code> - HTTP PATCH</li><li> <code>DELETE</code> - HTTP DELETE</li></p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "profile":{
            "description":"<p>Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string",
            "format":"uri"
        }
    }
}

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

型: object

サイト・リフレッシュ・ジョブでリフレッシュに失敗した個々のページのエラー詳細。

リリース20.2.2で導入されました。

レスポンスの例(ページングを含むリスト・ページ)

{
    "limit":5,
    "count":5,
    "hasMore":true,
    "offset":0,
    "items":[
        {
            "pageUrl":"http://oracle.cec.com/site/home.html",
            "status":"complete"
        },
        {
            "pageUrl":"http://oracle.cec.com/site/about.html",
            "status":"processing"
        },
        {
            "pageUrl":"http://oracle.cec.com/site/menu.html",
            "status":"processing"
        },
        {
            "pageUrl":"http://oracle.cec.com/site/menu/details.html",
            "status":"processing"
        },
        {
            "pageUrl":"http://oracle.cec.com/site/privacy-policy.html",
            "status":"pending"
        }
    ]
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止

404レスポンス

見つかりません

ヘッダー

Cache-Control: string

キャッシュ・メカニズムのディレクティブ。
Content-Length: string

レスポンス本文のサイズ。
Content-Type: string

レスポンスのコンテンツ・タイプ。

ルート・スキーマ: schema

すべてに一致

ソースを表示

allOf SiteJobNotFoundExceptionDetail

{
    "allOf":[
        {
            "$ref":"#/definitions/SiteJobNotFoundExceptionDetail"
        }
    ]
}

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

すべてに一致

ソースを表示

object ExceptionDetail

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。その場合、追加情報がレスポンス本文に含まれます。
object SiteJobNotFoundExceptionDetail-allOf[1]

{
    "description":"",
    "allOf":[
        {
            "$ref":"#/definitions/ExceptionDetail"
        },
        {
            "properties":{
                "jobStatus":{
                    "description":"<p>Site job status that does not exist or is not visible to the authenticated user.</p>",
                    "x-returnedIn":[
                        "representation",
                        "default",
                        "basic"
                    ],
                    "type":"string"
                }
            }
        }
    ]
}

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

型: object

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。その場合、追加情報がレスポンス本文に含まれます。

ソースを表示

detail(optional): string

この問題の発生に固有の説明。人間が判読できる、場合によっては複数行の詳細で問題を説明しています。
instance(optional): string(uri)

エラーに関する詳細を提供するリンクへのURI。
o:errorCode(optional): string

アプリケーション・エラー・コード。HTTPエラー・コードとは異なります。このコードは、titleやdetailなどのフィールドを比較するのではなく、特定のエラーをチェックするために使用する必要があります。
o:errorDetails(optional): array o:errorDetails

階層構造に複数のエラーがある場合もあります。
o:errorPath(optional): string

エラーが発生した場所を示すXPathまたはJSONパス。
status(optional): integer(int32)

エラーに対応するHTTPステータス・コード。
title(optional): string

問題の短く、判読可能なサマリー。タイトルは、特定のエラーをチェックする方法としては使用しないでください。そのためにはo:errorCodeを使用してください。
type(optional): string(uri)

問題のタイプを識別する絶対URI。このURIが参照解除されると、「推奨」は、HTMLページなどの問題の判読可能なサマリーを提供します。

{
    "description":"<p>In addition to HTTP error code and error messages, it is often desirable to provide additional information to the client when a request fails. In such cases, the additional information will be included in the response body.</p>",
    "properties":{
        "type":{
            "description":"<p>Absolute URI that identifies the problem type. When this URI dereferenced, it <strong>should</strong> provide a human-readable summary of the problem, for example, as a HTML page.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string",
            "format":"uri"
        },
        "title":{
            "description":"<p>Short, human-readable summary of the problem. It is not advisable to use the title as a way of checking for specific errors, use the <code>o:errorCode</code> for this purpose.</p>",
            "x-multiLingual":true,
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "status":{
            "description":"<p>Corresponding HTTP status code for the error.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"integer",
            "format":"int32"
        },
        "detail":{
            "description":"<p>Description specific to this occurrence of the problem. The human-readable, potentially multi-line details describing the problem in more details.</p>",
            "x-multiLingual":true,
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "instance":{
            "description":"<p>URI to the link that provides more detail about the error.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string",
            "format":"uri"
        },
        "o:errorCode":{
            "description":"<p>Application error code, which is different from HTTP error code. This code should be used to check for specific errors, rather than comparing fields such as the <code>title</code> or <code>detail</code>.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "o:errorPath":{
            "description":"<p>XPath or JSON path to indicate where the error occurs.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        },
        "o:errorDetails":{
            "description":"<p>Multiple errors can be organized in a hierarchical structure.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"array",
            "items":{
                "allOf":[
                    {
                        "$ref":"#/definitions/ExceptionDetail"
                    }
                ]
            }
        }
    }
}

ネストされたスキーマ : SiteJobNotFoundExceptionDetail-allOf[1]

型: object

ソースを表示

jobStatus(optional): string

存在しないか、認証されたユーザーが参照できないサイト・ジョブ・ステータス。

{
    "properties":{
        "jobStatus":{
            "description":"<p>Site job status that does not exist or is not visible to the authenticated user.</p>",
            "x-returnedIn":[
                "representation",
                "default",
                "basic"
            ],
            "type":"string"
        }
    }
}

ネストされたスキーマ: o:errorDetails

型: array

階層構造に複数のエラーがある場合もあります。

ソースを表示

Array of: items

{
    "description":"<p>Multiple errors can be organized in a hierarchical structure.</p>",
    "x-returnedIn":[
        "representation",
        "default",
        "basic"
    ],
    "type":"array",
    "items":{
        "allOf":[
            {
                "$ref":"#/definitions/ExceptionDetail"
            }
        ]
    }
}

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

すべてに一致

ソースを表示

object ExceptionDetail

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。その場合、追加情報がレスポンス本文に含まれます。

{
    "allOf":[
        {
            "$ref":"#/definitions/ExceptionDetail"
        }
    ]
}

レスポンスの例(サイト・ジョブが見つかりません)

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Site Job Not Found",
    "status":"404",
    "detail":"Job does not exist or has been deleted, or the authenticated user or client application does not have access to the job.",
    "o:errorCode":"OCE-SITEMGMT-009024",
    "jobStatus":{
        "context":"37D1070720325969AC6C47ACE8B9BFF91533560416423"
    }
}

406レスポンス

受入れられない

416 レスポンス

範囲を満たすことはできません

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

ゲートウェイがタイムアウト

先頭に戻る