機械翻訳について
  1. サイト管理用のREST API
  2. タスク
  3. リクエスト

リクエストの取得

get

/sites/management/api/v1/requests/{id}

SINGULAR

リクエスト識別子を指定して、リクエストの詳細を読み取ります。 リクエストを所有するユーザーの拡張など、様々なリクエスト関係を同じレスポンスで展開して戻すことができます。 レビュー・リストを展開して、同じレスポンスに含めることもできます。

認可

ユーザーは自分が作成したリクエストや、ユーザーが承認できる任意のリクエストを読み取ることができます。 リクエストはすべて「サイト管理者」によって読み取ることができます。

成功したレスポンスの例

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

200OK - Read a Pending Approval Request

pendingのリクエスト・ステータスは、リクエストに承認が必要であることを意味します。 承認者は、レビューを追加してリクエストを承認または否認する必要があります。 リクエストが承認されると、リクエストの処理が開始され、リクエストのジョブ・ステータスのリソースを読み取ることによって進行状況を監視できます。

リクエスト

GET https://api.example.com/sites/management/api/v1/requests/{id}

レスポンス本文

{
  "requestType": "SiteRequest",
  "id": "e77229e8-1f44-4c27-bacb-9a99b7c77af7",
  "isDeleted": false,
  "justification": "I require a site for our new product launch.",
  "status": "pending",
  "createdAt": "2018-11-21T12:10:15.123Z",
  "lastModifiedAt": "2018-11-21T12:10:15.123Z",
  "revision": 0,
  "name": "AcmeProductLaunch",
  "description": "Marketing site for Acme New Product Launch.",
  "policy": {
    "id": "request:e77229e8-1f44-4c27-bacb-9a99b7c77af7",
    "status": "active",
    "approvalType": "admin",
    "accessType": "everyone",
    "access": {
    },
    "security": {
      "level": "cloud",
      "appliesTo": "all"
    }
  }
}

200 OK - 失敗したリクエストの読取り

リクエストは承認されましたが、ジョブは失敗しました。 errorプロパティにより失敗の理由が示されます。 失敗の理由が対処されている場合は、リクエストを再試行できます。 たとえば、競合するサイトの名前が変更されている可能性があります。 または、リクエストされているサイトに新しい名前を指定するなどして、問題を解決した場合はリクエスト自体を変更できます。 リクエストの詳細が変更された場合、リクエストは承認プロセスを再度通過する必要があります。

リクエスト

GET https://api.example.com/sites/management/api/v1/requests/{id}

レスポンス本文

{
  "requestType": "SiteRequest",
  "id": "e77229e8-1f44-4c27-bacb-9a99b7c77af7",
  "isDeleted": false,
  "justification": "I require a site for our new product launch.",
  "status": "failed",
  "failure": {
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title": "Site Already Exists",
    "status": 409,
    "detail": "Site with name 'AcmeProductLaunch' already exists.",
    "o:errorCode": "OCE-SITEMGMT-009004",
    "o:errorDetails": [
    ]
  },
  "createdAt": "2018-11-21T12:10:15.123Z",
  "lastModifiedAt": "2018-11-21T12:10:15.123Z",
  "revision": 0,
  "name": "AcmeProductLaunch",
  "description": "Marketing site for Acme New Product Launch.",
  "policy": {
    "id": "request:e77229e8-1f44-4c27-bacb-9a99b7c77af7",
    "status": "active",
    "approvalType": "admin",
    "accessType": "everyone",
    "access": {
    },
    "security": {
      "level": "cloud",
      "appliesTo": "all"
    }
  }
}

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

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

404Not Found - Request Not Found

リクエストが存在しないか、削除されたか、認証されたユーザーまたはクライアント・アプリケーションがリクエストへのアクセス権を持っていません。

エラー・コード

OCE-SITEMGMT-009001

解決 - 識別子のチェック

リクエスト識別子が有効であることを確認してください。

解決 - 認可の確認

認証済ユーザーがリクエストをレビューできること、または認証済ユーザーがリクエストを作成したユーザーであることを確認します。

例外詳細フィールド

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

フィールド名説明
request存在しない、または認証されたユーザーが表示できないリクエストです。

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

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Request Not Found",
  "status": "404",
  "detail": "Request does not exist or has been deleted, or the authenticated user or client application does not have access to the request.",
  "o:errorCode": "OCE-SITEMGMT-009001",
  "request": {
    "id": "e77229e8-1f44-4c27-bacb-9a99b7c77af7"
  }
}

リクエスト

パス・パラメータ

  • リクエストのグローバルに一意の不変識別子。

問合せパラメータ

  • レスポンスに含めないフィールド名のカンマ区切り文字列。

  • レスポンスからexcludeへのリンク関係名のカンマ区切りリスト。

  • 展開するフィールド名のカンマ区切りの文字列。 値allを使用して、すべての関係を展開します。

    expand問合せパラメータには次のフィールド名を指定できます:

    フィールド名説明
    reviewsリクエストに関連するレビュー。
    jobリクエストが承認されると、リクエストに必要な処理がすべて開始されます。たとえば、新規サイトへのリクエストでは、サイト作成処理が開始されます。
    createdByリクエストを作成したユーザーまたはクライアント・アプリケーションを取得します。
    approversこのリクエストを承認する権限を持つユーザーおよびグループのリスト。
    templateリクエストに関連付けられているテンプレートを取得します。
    siteリクエストのタイプによっては、リクエストにより新規サイトが作成される場合があります。
    repositoryサイトの作成時にサイトに関連付けられるアセット・リポジトリ。
    localizationPolicyサイトの作成時にサイトに関連付けられるローカリゼーション・ポリシーです。
    ownedByサイトを所有するユーザーまたはクライアント・アプリケーションを取得します。
    sourceコピーするサイトの詳細。

  • 拡張のエラーの処理方法を指定します。 指定しない場合は、デフォルトで関連フィールドにエラーの詳細が含まれます。

    有効な値は次のとおりです。

    • ignore - エラーを無視して関係を展開しません。 関連リンクはレスポンスに含まれません
    • include - 展開された関係のかわりにエラー詳細を含めます。 関連リンクが返されます
    • fail - リクエストの拡張の失敗エラー・レスポンスでの失敗

  • レスポンスに含めるフィールド名のカンマ区切りの文字列。 フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。

  • 削除対象としてマークされているリソースでは、この問合せパラメータがtrueに設定されているかぎり、読取り、変更およびサポート対象の拡張操作が可能です。 includeDeleted問合せパラメータを送信しない場合、読取り、変更および拡張操作に対するレスポンスは、リソースが完全に削除された場合に戻されるものと同じです。

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

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

    リンク関係説明
    parent親リソースが読取り可能な場所を示します。 このリンクはupリンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。
    selfリソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。
    canonicalリクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。
    editリソースを編集できる場所について説明します。 単一のリソースで使用され、既存のリソースを編集するためにパッチを実行できる場所を示します。
    deleteリソースを削除できる場所を示します。 唯一のリソースで使用され、既存のリソースを削除するために削除を実行できる場所を示します。
    retry再試行拡張操作を説明します。
    undelete拡張削除取消操作について説明します。
    hard-deleteハード削除拡張操作を説明します。
    reviewsレビューの子コレクションを示します。
    request-approversリクエスト承認者子収集を記述します。
    edit-formリソース編集用のテンプレート・リクエスト本文を読むことができる場所を説明します。 編集フォームには、リソースの編集に使用できるプロパティの詳細が表示されます。
    describedByリソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。

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

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

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

  • if matchリクエスト・ヘッダーは、条件付きにするメソッドとともに使用されます。 以前にリソースで取得した1つ以上のエンティティ・タグ値を持つクライアントは、それらのエンティティ・タグ値のいずれかが最新であることを検証できます。 リクエストされたリソースが指定されたエンティティ・タグ値のいずれにも一致しない場合は、事前条件が失敗したレスポンスが本文なしで返されます。

  • if none matchリクエスト・ヘッダーは、条件付きにするメソッドとともに使用されます。 以前にリソースで取得した1つ以上のエンティティ・タグ値を持つクライアントは、それらのエンティティ・タグ値が最新でないことを検証できます。

トップに戻る

レスポンス

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

200レスポンス

OK
ヘッダー
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
  • Request
    識別子: requestType

    リクエストは、処理前に承認を必要とする操作を表します。 リクエストの例は、新規サイトの作成のリクエストです。 リクエストは却下することもできます。 リクエストは、1つ以上の「レビュー」をリクエストに追加することで承認または却下されます。 リクエストが作成されると、リクエストの承認または拒否ステータスに影響するレビューの追加とは別に変更できません。 有効でなくなったリクエストは削除できます。 リクエストが否認された場合、新しいリクエストを作成する必要があります。 リクエストが承認されると、リクエストにレビューを追加できなくなります。 否認されたリクエストは、そのリクエストを承認するレビューを作成することによって承認できます。 サイト・ガバナンスが無効になっている場合、リクエストは失敗します。

ネストされたスキーマ : リクエスト
識別子: requestType

リクエストは、処理前に承認を必要とする操作を表します。 リクエストの例は、新規サイトの作成のリクエストです。 リクエストは却下することもできます。 リクエストは、1つ以上の「レビュー」をリクエストに追加することで承認または却下されます。 リクエストが作成されると、リクエストの承認または拒否ステータスに影響するレビューの追加とは別に変更できません。 有効でなくなったリクエストは削除できます。 リクエストが否認された場合、新しいリクエストを作成する必要があります。 リクエストが承認されると、リクエストにレビューを追加できなくなります。 否認されたリクエストは、そのリクエストを承認するレビューを作成することによって承認できます。 サイト・ガバナンスが無効になっている場合、リクエストは失敗します。

すべてに一致
ソースを表示
  • SingularResource

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

  • Request-allOf[1]
ネストされたスキーマ : SingularResource
型: object

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

ソースを表示
  • links
ネストされたスキーマ : Request-allOf[1]
型: object
ソースを表示
  • approvers

    このリクエストを承認する権限を持つユーザーおよびグループのリスト。 承認タイプが「指定された承認者」でない場合、承認リストは空になります。

    リリース19.3.3.での導入。

  • リクエストが作成された日時。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • createdBy

    リクエストを作成したユーザーまたはクライアント・アプリケーションを取得します。 リクエストが作成されると、認証されたユーザー・アプリケーションまたはクライアント・アプリケーションが取得され、そのリクエストに関連付けられます。

  • failure

    リクエスト処理が失敗した場合、失敗の詳細がこのプロパティに表示されます。 リクエストが失敗としてマークされていない場合、失敗の詳細はありません。

  • リクエストのグローバルに一意の不変識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

  • リクエストがソフト削除済としてマークされていることを示します。

  • job

    リクエストが承認されると、リクエストに必要な処理がすべて開始されます。たとえば、新規サイトへのリクエストでは、サイト作成処理が開始されます。 この処理の進行状況は、ジョブ・ステータスの詳細によって監視できます。 ジョブ・ステータスは常にリクエストに対して使用可能です。リクエストが承認されていない場合、ステータスはリクエストがblockedであることを示します。 - 承認待ちのブロック。 完了したリクエストには、ジョブ・ステータス(completed)もあります。

  • 最大長: 1000

    理由は、承認者がこのリクエストをレビューするのに役立ちます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

  • リクエストが最後に更新された日時。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • リクエストが編集されたリクエストのフォークである場合の元のリクエスト。 リクエストが更新され、リクエストが失敗または却下されると、リクエストおよび関連付けられたレビューがコピーされ、更新されたリクエストにリンクされます。 この「分岐済」リクエストは、リクエストの詳細および編集時にリクエストに関連付けられていたレビューを取得します。 複数の更新が実行される場合、分岐された複数のコピーがある可能性があります。各分岐は元のリクエストにリンクされます。 分岐したリクエストには、編集中の元のリクエストと同じIdを保持しているため、新しい識別子が付けられています。

  • policy

    リクエストが行われた時点でのこのリクエストのポリシー詳細のすべてのスナップショット。 これにより、このリクエストに必要な承認を判断できます。

    リリース19.2.1.での導入。

  • 「リクエスト」のタイプ。 有効な値は次のとおりです: SiteRequest、CopySiteRequest。

  • reviews

    リクエストに関連するレビュー。 リクエストに手動承認が必要な場合、このプロパティには、このリクエストに関連付けられているレビューのセットが反映されます。 リクエストが最初に作成された場合、レビューはありません。

  • リクエストが編集されるたびに、リビジョン番号が増分されます。 改訂番号はゼロから開始します。 リビジョン番号は、リビジョンがこのリソースの強力なETag値としても使用されるため、最後のリクエスト以降にリクエストが変更されたかどうかを確認するために使用できます。

  • このリクエストの承認または拒否のステータス。 リクエストのステータスには、関連付けられたレビューがまだ作成、承認または却下されていないかが反映されます。

    有効な値は次のとおりです。

    • pending - リクエストは承認待ちです
    • rejected - リクエストは承認されていません
    • approved - リクエストが承認されました
    • failed - リクエストは承認されましたが、リクエストの処理に失敗しました
    • complete - リクエストは承認され、現在完了しています

ネストされたスキーマ : 承認者
型: object

このリクエストを承認する権限を持つユーザーおよびグループのリスト。 承認タイプが「指定された承認者」でない場合、承認リストは空になります。

リリース19.3.3.での導入。
ソースを表示
  • items

    「承認者メンバーのリクエスト」要素のコレクション。

    リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • CollectionResource

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

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

リクエストを作成したユーザーまたはクライアント・アプリケーションを取得します。 リクエストが作成されると、認証されたユーザー・アプリケーションまたはクライアント・アプリケーションが取得され、そのリクエストに関連付けられます。

すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
ネストされたスキーマ : 失敗
型: object

リクエスト処理が失敗した場合、失敗の詳細がこのプロパティに表示されます。 リクエストが失敗としてマークされていない場合、失敗の詳細はありません。

ネストされたスキーマ : job
型: object

リクエストが承認されると、リクエストに必要な処理がすべて開始されます。たとえば、新規サイトへのリクエストでは、サイト作成処理が開始されます。 この処理の進行状況は、ジョブ・ステータスの詳細によって監視できます。 ジョブ・ステータスは常にリクエストに対して使用可能です。リクエストが承認されていない場合、ステータスはリクエストがblockedであることを示します。 - 承認待ちのブロック。 完了したリクエストには、ジョブ・ステータス(completed)もあります。

ソースを表示

  • 非同期ジョブが完了したかどうか。

  • プロセスの完了数を取得し、0から100までの数値。 非同期ジョブが開始していない場合、完了率は提供されません。 すべてのバックグラウンド非同期ジョブが詳細なプロセスをサポートしているわけではないため、完了率はステップなしでゼロから100にジャンプできます。

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

  • 非同期ジョブの実行が終了した時間、または非同期ジョブが失敗した時間。 非同期ジョブが終了していないか失敗した(または開始していない)場合、このプロパティは存在しません。 特定のバックグラウンド・ジョブは停止時間を記録しないことがあるため、ジョブが完了した場合、停止時間がない可能性があります。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • error

    ジョブの失敗時の非同期ジョブ・レスポンスのエラー詳細。 このオプションは、非同期ジョブが実行されたにも失敗した場合にのみ使用可能です。

  • クライアントがステータスを再度チェックするまでに待機する必要がある時間のヒントとして、1ミリ秒数。 この値がない場合、ポーリング間隔は提案されず、クライアントは必要に応じてポーリングできることを意味します。

  • links

  • 現在の処理ステータスに関する、人間が読み取り可能なメッセージ。 このメッセージは、エンド・ユーザーに進行状況を通知するために使用されます。 非同期リクエストまたはジョブは、判読可能なステータス・メッセージを提供しない場合があります。

  • 非同期ジョブの現在の進行状況。 これらの値は、非同期ジョブが終了したことを示します: succeeded、failed、aborted。 blockedの値は、非同期ジョブには人による承認の待機など、アクションが必要であることを意味します。 非同期ジョブが処理中であることを示す値は次のとおりです: pending、processing、paused。

    有効な値は次のとおりです。

    • pending - リクエストは実行を待機しています
    • processing - リクエストは実行中です
    • succeeded - リクエストは正常に完了しました
    • failed - リクエストに失敗しました
    処理リクエストが完了する前に失敗しました。
    • aborted - リクエストは中断されました
    処理リクエストが完了する前に中止されました。
    • paused - リクエストは実行中でしたが、現在は一時停止しています
    • blocked - リクエストはブロックされています
    リクエストには、人の承認を待機するなどのアクションが必要です。

  • 非同期ジョブ・リクエストのHTTPステータス・コード。 このステータスは、非同期ジョブ・ステータスの問合せ時に取得するステータスではなく、非同期ジョブが完了したときのステータス・レスポンスです。 この値は非同期ジョブの終了後のみ使用可能です。

  • result

    クライアントがステータスについてサービスをポーリングする際に結果を取得できるよう、ステータス・リソースに最終結果を含めることが望ましい場合もあります。 結果はこのオプション・プロパティで取得されます。 このプロパティは、HTTPレスポンスがステータス・リソース内で効率的に返される場合にのみ使用する必要があります。 このプロパティが存在する場合は、重複を避けるためにrequestStatusプロパティが省略されます。 レスポンスの本文は、レスポンス固有のプロパティで構成されるJSONオブジェクトです。 非JSONレスポンス・データは、Base64が、bodyプロパティ内のバイト文字列として非JSONデータをエンコードするか、ステータス・リソースのリンク・プロパティの非JSONリソースへのリンクを提供することでサポートされます。

  • 非同期ジョブの実行が開始された時間。 非同期ジョブが開始していない場合、このプロパティは表示されません。 特定のバックグラウンド・ジョブは開始時間を記録しないことがあるため、ジョブが開始した場合、開始時間がない可能性があります。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

ネストしたスキーマ: policy

リクエストが行われた時点でのこのリクエストのポリシー詳細のすべてのスナップショット。 これにより、このリクエストに必要な承認を判断できます。

リリース19.2.1.での導入。
すべてに一致
ソースを表示
  • Policy

    ポリシーは、サイト関連の操作を実行するリクエストの承認方法と、その操作を実行する際に適用する特定の制限またはデフォルトがあるかどうかを制御します。

    ポリシーはリソースに関連付けられています。たとえば、「サイト作成」ポリシーはサイト・テンプレートに関連付けることができます。 たとえば、サイト作成ポリシーでは、サイト管理者の承認が特定のサイト・テンプレートからのサイトの作成に必要であり、そのサイト・テンプレートのドメイン・ユーザーのセキュリティ・レベルのみが割り当てられることを指定できます。

    ポリシーはinactiveとしてマークできます。これにより、操作の実行またはリクエストを防止できます。

ネストされたスキーマ : レビュー
型: object

リクエストに関連するレビュー。 リクエストに手動承認が必要な場合、このプロパティには、このリクエストに関連付けられているレビューのセットが反映されます。 リクエストが最初に作成された場合、レビューはありません。

ソースを表示
すべてに一致
ソースを表示
  • CollectionResource

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

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

「承認者メンバーのリクエスト」要素のコレクション。

リリース19.3.3.での導入。
ソースを表示
ネストされたスキーマ : CollectionResource

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

すべてに一致
ソースを表示
  • SingularResource

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

  • CollectionResource-allOf[1]
ネストされたスキーマ : CollectionResource-allOf[1]
型: object
ソースを表示

  • レスポンス内のリソースの合計数。

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

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

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

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

ネストされたスキーマ: items
型: object
ソースを表示

  • ユーザー、クライアント・アプリケーションまたはグループの表示名。

    リリース19.3.3.での導入。
  • グループ

    メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

    リリース19.3.3.での導入。

  • メンバーがグループの場合、グループのタイプが指定されます。 メンバーがユーザーの場合、このフィールドは存在しません。

    有効な値は次のとおりです。

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

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

  • ユーザー、クライアント・アプリケーションまたはグループ・メンバーの識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

    リリース19.3.3.での導入。

  • 関連するユーザーまたはクライアント・アプリケーションに外部ユーザー・ロールのみがある場合、trueに設定されます。

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

  • ユーザー、クライアント・アプリケーションまたはグループの一意の名前。 メンバーがユーザーの場合、名前はユーザー名です。 メンバーがグループの場合、名前はグループ名です。

    リリース19.3.3.での導入。

  • メンバーがユーザー、クライアント・アプリケーションまたはグループであることを示します。

    有効な値は次のとおりです。

    • user - メンバーはユーザーまたはクライアント・アプリケーションです。 ユーザーまたはメンバー間で区別されません
    クライアント・アプリケーションであるメンバー。
    • group - メンバーはグループです

    リリース19.3.3.での導入。
  • user

    メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

    リリース19.3.3.での導入。
ネストされたスキーマ : グループ

メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • Group

    グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

    リリース19.3.1.での導入。
ネストされたスキーマ: user

メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
ネストされたスキーマ: Group

グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

リリース19.3.1.での導入。
すべてに一致
ソースを表示
  • SingularResource

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

  • Group-allOf[1]
ネストされたスキーマ : Group-allOf[1]
型: object
ソースを表示

  • グループに対する、人間が読み取り可能な名前。

    リリース19.3.1.での導入。

  • サービス・インスタンス内で一意のグループ名。

    リリース19.3.1.での導入。

  • グループの一意の識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

    リリース19.3.1.での導入。
  • roles

    ロール

    有効な値は次のとおりです。

    • CECServiceAdministrator - サービス管理者
    • ユーザー列挙の割当
    • ユーザーのパスワードおよびチャレンジ質問の変更
    • サービス・インスタンスの構成、モニターおよび管理
    • CECSitesAdministrator - サイト管理者
    • サイト、テンプレート、テーマまたはコンポーネントの作成
    • CECRepositoryAdministrator - リポジトリ管理者
    • CECDeveloperUser - 開発者ユーザー
    • CECContentAdministrator - コンテンツ管理者
    • 新規コンテンツ・タイプの作成およびアイテムの公開
    • CECStandardUser - 標準ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • サイト内のコンテンツの表示および操作
    • カスタム・プロパティの管理と表示、および値の編集
    • CECEnterpriseUser - エンタープライズ・ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • デジタル・アセット
    • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
    • コンテンツ・アイテムの作成、管理、表示および操作
    • コレクション
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • カスタム・プロパティの管理と表示、および値の編集
    • CECExternalUser - 外部ユーザー
    将来使用するために予約済
    • CECIntegrationUser - 統合ユーザー
    Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
    • CECSitesVisitor - サイト・ビジター
    サイトへのアクセスはビジターに制限されます。

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

  • グループのタイプ。

    有効な値は次のとおりです。

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

    リリース19.3.1.での導入。
ネストされたスキーマ: roles
型: array

ロール

有効な値は次のとおりです。

  • CECServiceAdministrator - サービス管理者
  • ユーザー列挙の割当
  • ユーザーのパスワードおよびチャレンジ質問の変更
  • サービス・インスタンスの構成、モニターおよび管理
  • CECSitesAdministrator - サイト管理者
  • サイト、テンプレート、テーマまたはコンポーネントの作成
  • CECRepositoryAdministrator - リポジトリ管理者
  • CECDeveloperUser - 開発者ユーザー
  • CECContentAdministrator - コンテンツ管理者
  • 新規コンテンツ・タイプの作成およびアイテムの公開
  • CECStandardUser - 標準ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • サイト内のコンテンツの表示および操作
  • カスタム・プロパティの管理と表示、および値の編集
  • CECEnterpriseUser - エンタープライズ・ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • デジタル・アセット
  • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
  • コンテンツ・アイテムの作成、管理、表示および操作
  • コレクション
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • カスタム・プロパティの管理と表示、および値の編集
  • CECExternalUser - 外部ユーザー
将来使用するために予約済
  • CECIntegrationUser - 統合ユーザー
Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
  • CECSitesVisitor - サイト・ビジター
サイトへのアクセスはビジターに制限されます。

リリース21.10.2で導入されました。
ソースを表示
ネストされたスキーマ: Identity
識別子: type

ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

リリース20.3.1で導入されました。
すべてに一致
ソースを表示
  • SingularResource

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

  • Identity-allOf[1]
ネストされたスキーマ : Identity-allOf[1]
型: object
ソースを表示

  • 人間が判読できる表示名。

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

  • ユーザーまたはクライアント・アプリケーションに対してCECによって割り当てられる識別子値。 識別子はサービスのスコープ内で一意です。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

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

  • ユーザー名やクライアント・アプリケーション名などの一意の名前。

    リリース20.3.1で導入されました。
  • roles

    ロール

    有効な値は次のとおりです。

    • CECServiceAdministrator - サービス管理者
    • ユーザー列挙の割当
    • ユーザーのパスワードおよびチャレンジ質問の変更
    • サービス・インスタンスの構成、モニターおよび管理
    • CECSitesAdministrator - サイト管理者
    • サイト、テンプレート、テーマまたはコンポーネントの作成
    • CECRepositoryAdministrator - リポジトリ管理者
    • CECDeveloperUser - 開発者ユーザー
    • CECContentAdministrator - コンテンツ管理者
    • 新規コンテンツ・タイプの作成およびアイテムの公開
    • CECStandardUser - 標準ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • サイト内のコンテンツの表示および操作
    • カスタム・プロパティの管理と表示、および値の編集
    • CECEnterpriseUser - エンタープライズ・ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • デジタル・アセット
    • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
    • コンテンツ・アイテムの作成、管理、表示および操作
    • コレクション
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • カスタム・プロパティの管理と表示、および値の編集
    • CECExternalUser - 外部ユーザー
    将来使用するために予約済
    • CECIntegrationUser - 統合ユーザー
    Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
    • CECSitesVisitor - サイト・ビジター
    サイトへのアクセスはビジターに制限されます。

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

  • 「アイデンティティ」のタイプ。 有効な値は次のとおりです: user, service, application, unknown。

    リリース20.3.1で導入されました。
ネストされたスキーマ: roles
型: array

ロール

有効な値は次のとおりです。

  • CECServiceAdministrator - サービス管理者
  • ユーザー列挙の割当
  • ユーザーのパスワードおよびチャレンジ質問の変更
  • サービス・インスタンスの構成、モニターおよび管理
  • CECSitesAdministrator - サイト管理者
  • サイト、テンプレート、テーマまたはコンポーネントの作成
  • CECRepositoryAdministrator - リポジトリ管理者
  • CECDeveloperUser - 開発者ユーザー
  • CECContentAdministrator - コンテンツ管理者
  • 新規コンテンツ・タイプの作成およびアイテムの公開
  • CECStandardUser - 標準ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • サイト内のコンテンツの表示および操作
  • カスタム・プロパティの管理と表示、および値の編集
  • CECEnterpriseUser - エンタープライズ・ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • デジタル・アセット
  • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
  • コンテンツ・アイテムの作成、管理、表示および操作
  • コレクション
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • カスタム・プロパティの管理と表示、および値の編集
  • CECExternalUser - 外部ユーザー
将来使用するために予約済
  • CECIntegrationUser - 統合ユーザー
Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
  • CECSitesVisitor - サイト・ビジター
サイトへのアクセスはビジターに制限されます。

リリース21.10.2で導入されました。
ソースを表示
ネストされたスキーマ : error
型: object

ジョブの失敗時の非同期ジョブ・レスポンスのエラー詳細。 このオプションは、非同期ジョブが実行されたにも失敗した場合にのみ使用可能です。

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

クライアントがステータスについてサービスをポーリングする際に結果を取得できるよう、ステータス・リソースに最終結果を含めることが望ましい場合もあります。 結果はこのオプション・プロパティで取得されます。 このプロパティは、HTTPレスポンスがステータス・リソース内で効率的に返される場合にのみ使用する必要があります。 このプロパティが存在する場合は、重複を避けるためにrequestStatusプロパティが省略されます。 レスポンスの本文は、レスポンス固有のプロパティで構成されるJSONオブジェクトです。 非JSONレスポンス・データは、Base64が、bodyプロパティ内のバイト文字列として非JSONデータをエンコードするか、ステータス・リソースのリンク・プロパティの非JSONリソースへのリンクを提供することでサポートされます。

すべてに一致
ソースを表示
  • HttpResponse

    非同期リクエストのHTTPレスポンスの取得など、構造化データとして返すことができるようにHTTPレスポンスを取得します。

ネストされたスキーマ : HttpResponse
型: object

非同期リクエストのHTTPレスポンスの取得など、構造化データとして返すことができるようにHTTPレスポンスを取得します。

ソースを表示
ネストされたスキーマ: headers
型: array

HTTPレスポンス・ヘッダー。

ソースを表示
ネストされたスキーマ: status
型: object

HTTPステータス・コードのレスポンス値および理由。

ソースを表示

  • 例外に対応するHTTPステータス・コード。 リソースを含む例外には404のHTTPステータスが存在します。

  • 短い、判読可能なステータス・コードのサマリーです。

ネストされたスキーマ: items
型: object
ソースを表示
ネストされたスキーマ: Policy

ポリシーは、サイト関連の操作を実行するリクエストの承認方法と、その操作を実行する際に適用する特定の制限またはデフォルトがあるかどうかを制御します。

ポリシーはリソースに関連付けられています。たとえば、「サイト作成」ポリシーはサイト・テンプレートに関連付けることができます。 たとえば、サイト作成ポリシーでは、サイト管理者の承認が特定のサイト・テンプレートからのサイトの作成に必要であり、そのサイト・テンプレートのドメイン・ユーザーのセキュリティ・レベルのみが割り当てられることを指定できます。

ポリシーはinactiveとしてマークできます。これにより、操作の実行またはリクエストを防止できます。

すべてに一致
ソースを表示
  • SingularResource

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

  • Policy-allOf[1]
ネストされたスキーマ : Policy-allOf[1]
型: object
ソースを表示
  • access

    ポリシーに関連付けられた操作を実行できるユーザーおよびグループのリスト。 たとえば、テンプレートからサイトを作成できるユーザーおよびグループのリストです。 アクセス・リストが空の場合、すべてのユーザーがポリシー操作を実行できます。 アクセス・リストは、ポリシーのaccessTypeがrestrictedに設定されている場合にのみ使用されます。

    リリース19.3.1.での導入。

  • ポリシーをすべてのユーザーに適用するか、アクセス・リストに含まれるユーザーにのみ適用するかを決定します。

    有効な値は次のとおりです。

    • everyone - ポリシー(アクティブな場合)は全員に適用されます
    • restricted - ポリシーは、アクティブな場合、アクセス・リストに含まれるユーザーに適用可能です

    リリース19.3.1.での導入。

  • このポリシーに関連付けられたリクエストが作成される場合、そのリクエストにはポリシーで定義された承認のタイプが必要です。 承認のタイプが自動の場合、リクエストには手動での承認は必要ありません。

    有効な値は次のとおりです。

    • automatic - リクエストは、ユーザーの承認プロセスなしで自動的に承認されます
    • admin - 「サイト管理者」のロールを持つユーザーは、関連するリクエストを承認できます。
    • named - サイトの作成では、ポリシーに関連付けられた承認者リストのメンバーであるユーザーの承認が必要です

  • approvers

    ポリシーに関連付けられたリクエストを承認する権限を持つユーザーおよびグループのリスト。 たとえば、テンプレートからのサイトの作成を承認できるユーザーおよびグループのリストです。 承認リストは、承認タイプが「指定された承認者」に設定されている場合にのみ使用されます。

    リリース19.3.3.での導入。
  • 有効期限

    サイトが作成されたとき、サイト・テンプレートに関連付けられたポリシーにサイト有効期限が設定されている場合、有効期限をサイトに設定できます。 サイトの有効期限が切れている場合、有効期限が延長されないかぎりサイトをアクティブ化できません。

    リリース19.4.1.での導入。

  • ポリシーのグローバル一意識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

  • ローカリゼーション・ポリシーが許可されていない場合、リクエスタはサイトのリクエスト時にローカリゼーション・ポリシーの指定を許可されません。 テンプレートに関連付けられているローカリゼーション・ポリシーが使用されます。 ローカリゼーション・ポリシーが許可されている場合、リクエスタはサイトのリクエスト時に1つ指定する必要があります。 このプロパティは、ポリシーに関連付けられているテンプレートがエンタープライズ・テンプレートの場合にのみ設定できます。

    リリース19.2.3.での導入。
  • repository

    ポリシーを作成または編集する場合、そのポリシーをアセット・リポジトリに関連付けることができます。 新規サイトがリクエストされると、サイトはポリシー定義済アセット・リポジトリに関連付けられます。 リポジトリがポリシーに設定されている場合、ユーザーは新規サイトの作成時にリポジトリを指定できません。 ポリシーに関連付けられたアセット・リポジトリがない場合、ユーザーが新規サイトを作成するときにアセット・リポジトリを指定できます。 アセット・リポジトリは、ポリシーがエンタープライズ・テンプレートに関連付けられている場合にのみポリシーに関連付けることができます。 Standardサイトはアセット・リポジトリに関連付けられません。

    リリース19.2.3.での導入。

  • ポリシーが編集されるたびに、リビジョン番号が増分されます。 改訂番号はゼロから開始します。 リビジョン番号は、リビジョンがこのリソースの強力なETag値としても使用されるため、最後のリクエスト以降にポリシーが変更されたかどうかを確認するために使用できます。

  • security

    サイト作成ポリシーのセキュリティ・ポリシー。 セキュリティ・ポリシーでは、サイトに許可される最小限のセキュリティ・レベルを指定します。

  • trueの場合、新規サイトに対するリクエストには、明示的なサイト・プレフィクスを含めることができます。 falseの場合、サイト・プレフィクスを指定しないと、自動的に生成されます。 このプロパティは、ポリシーに関連付けられているテンプレートがエンタープライズ・テンプレートの場合にのみ設定できます。

    リリース19.2.3.での導入。

  • ポリシー・ステータスは、ポリシーに関連付けられた操作の実行にポリシーを使用できるかどうかを指定します。 ポリシー・ステータスがinactiveの場合、操作は実行できません。 ポリシー・ステータスが「アクティブ」の場合は、操作を実行できます。 たとえば、サイト・テンプレートに関連付けられたポリシーの場合、「アクティブ」のステータスは、ユーザーがサイト・テンプレートからサイトを作成できることを意味します。

    有効な値は次のとおりです。

    • inactive - 非アクティブとしてマークされているポリシーは、関連する操作をリクエストできないことを意味
    • active - アクティブとしてマークされているポリシーは、関連する操作がリクエスト可能であることを意味

ネストされたスキーマ : アクセス
型: object

ポリシーに関連付けられた操作を実行できるユーザーおよびグループのリスト。 たとえば、テンプレートからサイトを作成できるユーザーおよびグループのリストです。 アクセス・リストが空の場合、すべてのユーザーがポリシー操作を実行できます。 アクセス・リストは、ポリシーのaccessTypeがrestrictedに設定されている場合にのみ使用されます。

リリース19.3.1.での導入。
ソースを表示
  • items

    「ポリシー・アクセス・メンバー」要素のコレクション。

    リリース19.3.1.での導入。
すべてに一致
ソースを表示
  • CollectionResource

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

ネストされたスキーマ : 承認者
型: object

ポリシーに関連付けられたリクエストを承認する権限を持つユーザーおよびグループのリスト。 たとえば、テンプレートからのサイトの作成を承認できるユーザーおよびグループのリストです。 承認リストは、承認タイプが「指定された承認者」に設定されている場合にのみ使用されます。

リリース19.3.3.での導入。
ソースを表示
  • items

    「ポリシー承認者メンバー」要素のコレクション。

    リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • CollectionResource

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

ネストされたスキーマ : 有効期限

サイトが作成されたとき、サイト・テンプレートに関連付けられたポリシーにサイト有効期限が設定されている場合、有効期限をサイトに設定できます。 サイトの有効期限が切れている場合、有効期限が延長されないかぎりサイトをアクティブ化できません。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • SiteExpirationPeriod

    サイトの有効期限は、時間と時間の単位で表されます。 たとえば、サイトが作成された後、2か月後にサイトを失効させます。

    リリース19.4.1.での導入。
ネストされたスキーマ : repository

ポリシーを作成または編集する場合、そのポリシーをアセット・リポジトリに関連付けることができます。 新規サイトがリクエストされると、サイトはポリシー定義済アセット・リポジトリに関連付けられます。 リポジトリがポリシーに設定されている場合、ユーザーは新規サイトの作成時にリポジトリを指定できません。 ポリシーに関連付けられたアセット・リポジトリがない場合、ユーザーが新規サイトを作成するときにアセット・リポジトリを指定できます。 アセット・リポジトリは、ポリシーがエンタープライズ・テンプレートに関連付けられている場合にのみポリシーに関連付けることができます。 Standardサイトはアセット・リポジトリに関連付けられません。

リリース19.2.3.での導入。
すべてに一致
ソースを表示
  • Repository

    リポジトリは、テキストとイメージの両方のファイルのストレージ・ロケーションです。 リポジトリ管理者は、リポジトリに対して指定されたチャネル・ポリシーおよびローカリゼーション・ポリシーを使用してリポジトリを作成できます。 様々なマーケティング・ニーズに対応するために、複数のリポジトリを作成できます。

    リポジトリを使用すると、必要なすべてのアセットを1箇所で管理できます。 たとえば、会社でコンピュータ機器を販売するとします。 デスクトップ・コンピュータに関連するファイルを処理するために、1つのリポジトリを設定できます。 タブレットには別のリポジトリを使用できます。 各リポジトリには、様々な種類のコンピュータに関する写真、グラフィックおよびコンテンツを含めることができます。 各リポジトリのアセットは、リポジトリに割り当てるポリシーによって制御されます。

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

サイト作成ポリシーのセキュリティ・ポリシー。 セキュリティ・ポリシーでは、サイトに許可される最小限のセキュリティ・レベルを指定します。

すべてに一致
ソースを表示
  • SecurityPolicy

    セキュリティ・ポリシーでは、サイトに許可されるセキュリティ・レベルの最小レベルを指定します。 サイトはこの最小レベルで作成されます。サイト・マネージャ/所有者は必要に応じてサイトでより制限的なセキュリティ・レベルを設定できます。 マネージャ/所有者は、サイト・セキュリティ・ポリシーで指定された値よりも安全性が低いセキュリティ・レベルは選択できません。

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

「ポリシー・アクセス・メンバー」要素のコレクション。

リリース19.3.1.での導入。
ソースを表示
ネストされたスキーマ: items
型: object
ソースを表示

  • ユーザー、クライアント・アプリケーションまたはグループの表示名。

    リリース19.3.1.での導入。
  • グループ

    メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

    リリース19.3.1.での導入。

  • メンバーがグループの場合、グループのタイプが指定されます。 メンバーがユーザーの場合、このフィールドは存在しません。

    有効な値は次のとおりです。

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

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

  • ユーザー、クライアント・アプリケーションまたはグループ・メンバーの識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

    リリース19.3.1.での導入。

  • 関連するユーザーまたはクライアント・アプリケーションに外部ユーザー・ロールのみがある場合、trueに設定されます。

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

  • ユーザー、クライアント・アプリケーションまたはグループの一意の名前。 メンバーがユーザーの場合、名前はユーザー名です。 メンバーがグループの場合、名前はグループ名です。

    リリース19.3.1.での導入。

  • メンバーがユーザー、クライアント・アプリケーションまたはグループであることを示します。

    有効な値は次のとおりです。

    • user - メンバーはユーザーまたはクライアント・アプリケーションです。 ユーザーまたはメンバー間で区別されません
    クライアント・アプリケーションであるメンバー。
    • group - メンバーはグループです

    リリース19.3.1.での導入。
  • user

    メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

    リリース19.3.1.での導入。
ネストされたスキーマ : グループ

メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

リリース19.3.1.での導入。
すべてに一致
ソースを表示
  • Group

    グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

    リリース19.3.1.での導入。
ネストされたスキーマ: user

メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

リリース19.3.1.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
ネストされたスキーマ: items
型: array

「ポリシー承認者メンバー」要素のコレクション。

リリース19.3.3.での導入。
ソースを表示
ネストされたスキーマ: items
型: object
ソースを表示

  • ユーザー、クライアント・アプリケーションまたはグループの表示名。

    リリース19.3.3.での導入。
  • グループ

    メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

    リリース19.3.3.での導入。

  • メンバーがグループの場合、グループのタイプが指定されます。 メンバーがユーザーの場合、このフィールドは存在しません。

    有効な値は次のとおりです。

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

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

  • ユーザー、クライアント・アプリケーションまたはグループ・メンバーの識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

    リリース19.3.3.での導入。

  • 関連するユーザーまたはクライアント・アプリケーションに外部ユーザー・ロールのみがある場合、trueに設定されます。

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

  • ユーザー、クライアント・アプリケーションまたはグループの一意の名前。 メンバーがユーザーの場合、名前はユーザー名です。 メンバーがグループの場合、名前はグループ名です。

    リリース19.3.3.での導入。

  • メンバーがユーザー、クライアント・アプリケーションまたはグループであることを示します。

    有効な値は次のとおりです。

    • user - メンバーはユーザーまたはクライアント・アプリケーションです。 ユーザーまたはメンバー間で区別されません
    クライアント・アプリケーションであるメンバー。
    • group - メンバーはグループです

    リリース19.3.3.での導入。
  • user

    メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

    リリース19.3.3.での導入。
ネストされたスキーマ : グループ

メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • Group

    グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

    リリース19.3.1.での導入。
ネストされたスキーマ: user

メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

リリース19.3.3.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
ネストされたスキーマ : SiteExpirationPeriod
型: object

サイトの有効期限は、時間と時間の単位で表されます。 たとえば、サイトが作成された後、2か月後にサイトを失効させます。

リリース19.4.1.での導入。
ソースを表示

  • サイト失効の測定に使用する期間。

    リリース19.4.1.での導入。

  • サイト失効の測定に使用する時間の単位。

    有効な値は次のとおりです。

    • months - 失効は月数で表されます
    • years - 失効までの年数

    リリース19.4.1.での導入。
ネストされたスキーマ : リポジトリ

リポジトリは、テキストとイメージの両方のファイルのストレージ・ロケーションです。 リポジトリ管理者は、リポジトリに対して指定されたチャネル・ポリシーおよびローカリゼーション・ポリシーを使用してリポジトリを作成できます。 様々なマーケティング・ニーズに対応するために、複数のリポジトリを作成できます。

リポジトリを使用すると、必要なすべてのアセットを1箇所で管理できます。 たとえば、会社でコンピュータ機器を販売するとします。 デスクトップ・コンピュータに関連するファイルを処理するために、1つのリポジトリを設定できます。 タブレットには別のリポジトリを使用できます。 各リポジトリには、様々な種類のコンピュータに関する写真、グラフィックおよびコンテンツを含めることができます。 各リポジトリのアセットは、リポジトリに割り当てるポリシーによって制御されます。

すべてに一致
ソースを表示
  • SingularResource

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

  • Repository-allOf[1]
ネストされたスキーマ : Repository-allOf[1]
型: object
ソースを表示
ネストされたスキーマ : channels
型: array

リポジトリに関連付けられているチャネル。

ソースを表示
ネストされたスキーマ : contentTypes
型: array

リポジトリに関連付けられたコンテンツ・タイプ。

ソースを表示
ネストされたスキーマ : createdDate

リポジトリの作成日時。

すべてに一致
ソースを表示
ネストされたスキーマ : languageOptions
型: array

リポジトリの言語オプション。

ソースを表示
ネストされたスキーマ : updatedDate

リポジトリが最後に更新された日時。

すべてに一致
ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
ネストされたスキーマ : ChannelId
型: object

チャネル識別子。

ソースを表示

  • リポジトリの一意の識別子。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

  • チャネルを識別するための短くて判読可能な名前。

ネストされたスキーマ: items
すべてに一致
ソースを表示
ネストされたスキーマ : ContentTypeId
型: object

コンテンツ・タイプ識別子。

ソースを表示
ネストされたスキーマ : DateTimeZone
型: object

日付、時間およびタイムゾーン。

ソースを表示
ネストされたスキーマ : SecurityPolicy
型: object

セキュリティ・ポリシーでは、サイトに許可されるセキュリティ・レベルの最小レベルを指定します。 サイトはこの最小レベルで作成されます。サイト・マネージャ/所有者は必要に応じてサイトでより制限的なセキュリティ・レベルを設定できます。 マネージャ/所有者は、サイト・セキュリティ・ポリシーで指定された値よりも安全性が低いセキュリティ・レベルは選択できません。

ソースを表示

  • サイトにアクセス可能なユーザーのタイプを定義します。 すべてのユーザーを含めることも、指定ユーザーのみに制限することもできます。

    有効な値は次のとおりです。

    • named - 指定されたレベル内の指定ユーザーのみがアクセスできます
    • all - 指定されたレベル内のすべてのユーザーがアクセスできます

  • サイトに設定できる最大オープン・セキュリティ・レベル。

    有効な値は次のとおりです。

    • service - サービス・ユーザーのみ
    • cloud - ドメインにサインインできるクラウド・ユーザーのみ
    • everyone - サインインせずに誰でも

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

「確認」要素のコレクション。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • Review

    レビューとは、リクエストの承認または却下を目的とした人間が開始したレビューです。 レビューは、リクエスト元がリクエストを承認または却下した理由を理解するために使用できるオプションのコメントとともに、リクエストを承認または却下します。 リクエストに関連付けられている承認のタイプに応じて、ゼロ以上のレビューが必要になる場合があります。 たとえば、「自動承認」リクエストではレビューは不要です。 「管理者承認」では、リクエストをレビューするには1人の管理者が必要です。

ネストされたスキーマ : 確認

レビューとは、リクエストの承認または却下を目的とした人間が開始したレビューです。 レビューは、リクエスト元がリクエストを承認または却下した理由を理解するために使用できるオプションのコメントとともに、リクエストを承認または却下します。 リクエストに関連付けられている承認のタイプに応じて、ゼロ以上のレビューが必要になる場合があります。 たとえば、「自動承認」リクエストではレビューは不要です。 「管理者承認」では、リクエストをレビューするには1人の管理者が必要です。

すべてに一致
ソースを表示
  • SingularResource

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

  • Review-allOf[1]
ネストされたスキーマ : Review-allOf[1]
型: object
ソースを表示
  • 最大長: 1000

    レビューに関連付けられたコメントは、リクエストが承認または却下された理由を説明するために使用できます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

  • レビューが作成された日時。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • このレビューの結果で、リクエストを承認または否認します。

    有効な値は次のとおりです。

    • approved - 関連リクエストが承認されました
    • rejected - 関連リクエストは却下されました

  • レビューのリクエスト・スコープ指定識別子。 レビュー識別子は、レビューが作成されるときにシステムによって生成され、変更できません。 識別子は、親リクエストのスコープ内でのみ一意です。 最新のレビューの識別子値は小さくなります。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

  • reviewedBy

    レビューを作成したユーザーまたはクライアント・アプリケーションの詳細を取得します。

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

レビューを作成したユーザーまたはクライアント・アプリケーションの詳細を取得します。

すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
レスポンスの例(保留中の承認リクエストの読取り)
{
    "requestType":"SiteRequest",
    "id":"e77229e8-1f44-4c27-bacb-9a99b7c77af7",
    "isDeleted":false,
    "justification":"I require a site for our new product launch.",
    "status":"pending",
    "createdAt":"2018-11-21T12:10:15.123Z",
    "lastModifiedAt":"2018-11-21T12:10:15.123Z",
    "revision":0,
    "name":"AcmeProductLaunch",
    "description":"Marketing site for Acme New Product Launch.",
    "policy":{
        "id":"request:e77229e8-1f44-4c27-bacb-9a99b7c77af7",
        "status":"active",
        "approvalType":"admin",
        "accessType":"everyone",
        "access":{
        },
        "security":{
            "level":"cloud",
            "appliesTo":"all"
        }
    }
}

304 レスポンス

Not Modified

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止

404レスポンス

見つかりません
ヘッダー
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
ネストされたスキーマ : RequestNotFoundExceptionDetail
すべてに一致
ソースを表示
  • ExceptionDetail

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

  • RequestNotFoundExceptionDetail-allOf[1]
ネストされたスキーマ : ExceptionDetail
型: object

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

ソースを表示

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

  • エラーに関する詳細を提供するリンクへのURI。

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

  • o:errorDetails

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

  • エラーが発生した場所を示すXPathまたはJSONパス。

  • エラーに対応するHTTPステータス・コード。

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

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

ネストされたスキーマ : RequestNotFoundExceptionDetail-allOf[1]
型: object
ソースを表示
ネストされたスキーマ: o:errorDetails
型: array

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

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • ExceptionDetail

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

レスポンスの例(リクエストが見つかりません)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Request Not Found",
    "status":"404",
    "detail":"Request does not exist or has been deleted, or the authenticated user or client application does not have access to the request.",
    "o:errorCode":"OCE-SITEMGMT-009001",
    "request":{
        "id":"e77229e8-1f44-4c27-bacb-9a99b7c77af7"
    }
}

406レスポンス

受入れられない

412レスポンス

Precondition Failed

416 レスポンス

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

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

ゲートウェイがタイムアウト
先頭に戻る