機械翻訳について

リクエスト・リソース編集のためのリクエスト本文の例の取得

get

/sites/management/api/v1/requests/{id}/edit-form

EDIT FORM

リクエスト・インスタンスの編集に適したテンプレート・リクエスト本文を取得します。edit-formリソースは、Requestの編集時に更新可能なプロパティを判断するためのテンプレートとしてクライアントに使用されます。レスポンスには編集可能なすべてのプロパティ値が含まれます。 これらのプロパティを編集または破棄し、Requestを編集するためのリクエスト本文として使用できます。

認可

このedit-formリソースにアクセスするには、親リソースへの読取りアクセス権が必要です。

成功したレスポンスの例

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

200OK

リクエスト

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

レスポンス本文

{
  "justification": "I require a marketing site for our new product.",
  "name": "MyNewProduct",
  "description": "This is a marketing site for my new product.",
  "repository": "F81629473A3DB8B2A28669F19E68209BBAD3340745B0",
  "localizationPolicy": "7D77CB6653BC1FF8E0530100007F6630",
  "defaultLanguage": "en-US",
  "sitePrefix": "News",
  "contentSecurity": {
    "taxonomy": "BC42C4FE109446539C9962DAC0C64CF2",
    "category": "AF11C4FE109446539C9962DAC0C09KF2"
  },
  "includeUpdates": false
}

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

この操作は、レスポンス本文に例外の詳細が含まれている次のクライアント・エラー(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へのリンク関係名のカンマ区切りリスト。

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

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

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

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

    リンク関係説明
    parent親リソースが読取り可能な場所を示します。 このリンクはupリンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。
    selfリソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。
    canonicalリクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。
    editリソースを編集できる場所について説明します。 単一のリソースで使用され、既存のリソースを編集するためにパッチを実行できる場所を示します。
    describedByリソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。
トップに戻る

レスポンス

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

200レスポンス

OK
ヘッダー
本文()
ルート・スキーマ: schema
型: object
ソースを表示
  • contentSecurity

    サイトのセキュリティ・カテゴリ。

    将来のリリースを対象としています。

    この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

  • サイトのデフォルト言語。 ローカリゼーション・ポリシーの必須言語の1つである必要があります。 エンタープライズ・サイトに対するリクエストで必要です。

    リリース19.2.3.での導入。
  • 最大長: 1000

    サイトの説明は、サイトの目的や使用状況をユーザーが理解するのに役立ちます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

  • 未公開の更新内容をコピーに含めます。

    リリース19.2.2.での導入。
  • 最大長: 1000

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

  • links
  • サイトの作成時にサイトに関連付けられるローカリゼーション・ポリシーです。 ローカリゼーション・ポリシーは、エンタープライズ・サイトに対してのみ設定できます。 リクエストに関連付けられているポリシーがローカリゼーション・ポリシーを指定している場合、ローカリゼーション・ポリシーはリクエストに関連付けられません。

    リリース19.2.3.での導入。
  • 最大長: 242

    この名前はサイト作成プロセスで使用され、新しいサイトの識別に使用されます。 名前は一意である必要があります。指定した名前は既存のサイトの名前と同じにできません。

  • サイトの作成時にサイトに関連付けられるアセット・リポジトリ。 リポジトリは、エンタープライズ・サイトに対してのみ設定できます。 リクエストに関連付けられているポリシーでリポジトリが指定されている場合、リポジトリをリクエストに関連付けることはできません。

    リリース19.2.3.での導入。
  • 最大長: 15

    サイトの作成時にサイトに設定されるサイト・プレフィクス。 エンタープライズ・サイトのリクエストにのみ設定されます。 リクエストに関連付けられているポリシーで許可されている場合のみ設定できます。そうでない場合、サイト・プレフィクスが自動的に生成されます。 サイト・プレフィクスの長さは15文字までです。

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

サイトのセキュリティ・カテゴリ。

将来のリリースを対象としています。

この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

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

    サイトのコンテンツ・セキュリティ。

    将来のリリースを対象としています。

    この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

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

サイトのコンテンツ・セキュリティ。

将来のリリースを対象としています。

この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

ソースを表示
  • 関連付けられたタクソノミ・カテゴリ・リソース。

    将来のリリースを対象としています。

    この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

  • 関連付けられたタクソノミ・リソース。

    将来のリリースを対象としています。

    この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。

レスポンスの例 ()
{
    "justification":"I require a marketing site for our new product.",
    "name":"MyNewProduct",
    "description":"This is a marketing site for my new product.",
    "repository":"F81629473A3DB8B2A28669F19E68209BBAD3340745B0",
    "localizationPolicy":"7D77CB6653BC1FF8E0530100007F6630",
    "defaultLanguage":"en-US",
    "sitePrefix":"News",
    "contentSecurity":{
        "taxonomy":"BC42C4FE109446539C9962DAC0C64CF2",
        "category":"AF11C4FE109446539C9962DAC0C09KF2"
    },
    "includeUpdates":false
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止

404レスポンス

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

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

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

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

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

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

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

  • 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レスポンス

受入れられない

416 レスポンス

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

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

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