リクエスト・リソース編集のためのリクエスト本文の例の取得
/sites/management/api/v1/requests/{id}/edit-form
リクエスト・インスタンスの編集に適したテンプレート・リクエスト本文を取得します。edit-form
リソースは、Request
の編集時に更新可能なプロパティを判断するためのテンプレートとしてクライアントに使用されます。レスポンスには編集可能なすべてのプロパティ値が含まれます。 これらのプロパティを編集または破棄し、Request
を編集するためのリクエスト本文として使用できます。
成功したレスポンスの例
この操作は、次の成功(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" } }
リクエスト
- id: string
リクエストのグローバルに一意の不変識別子。
- excludeFields(optional): string
レスポンスに含めないフィールド名のカンマ区切り文字列。
- excludeLinks(optional): string
レスポンスからexcludeへのリンク関係名のカンマ区切りリスト。
- fields(optional): string
レスポンスに含めるフィールド名のカンマ区切りの文字列。 フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。
- includeDeleted(optional): boolean
削除対象としてマークされているリソースでは、この問合せパラメータが
true
に設定されているかぎり、読取り、変更およびサポート対象の拡張操作が可能です。includeDeleted
問合せパラメータを送信しない場合、読取り、変更および拡張操作に対するレスポンスは、リソースが完全に削除された場合に戻されるものと同じです。 - links(optional): string
レスポンス内のincludeへのリンク関係名のカンマ区切りリスト。 デフォルトでは、すべてのリンクが返されます。
次のリンクは、このリソースにより提供されます:
リンク関係 説明 parent
親リソースが読取り可能な場所を示します。 このリンクは up
リンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。self
リソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。 canonical
リクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。 edit
リソースを編集できる場所について説明します。 単一のリソースで使用され、既存のリソースを編集するためにパッチを実行できる場所を示します。 describedBy
リソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。
レスポンス
- application/json
- application/vnd.oracle.resource+json;type=edit-form
200レスポンス
- Cache-Control: string
キャッシュ・メカニズムのディレクティブ。
- Content-Length: string
レスポンス本文のサイズ。
- Content-Type: string
レスポンスのコンテンツ・タイプ。
- ETag: string
オリジン・サーバーによって特定のバージョンのリソースに割り当てられた不透明識別子。
object
- contentSecurity(optional): contentSecurity
サイトのセキュリティ・カテゴリ。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
- defaultLanguage(optional): string
サイトのデフォルト言語。 ローカリゼーション・ポリシーの必須言語の1つである必要があります。 エンタープライズ・サイトに対するリクエストで必要です。
リリース19.2.3.での導入。 - description(optional): string
最大長:
1000
サイトの説明は、サイトの目的や使用状況をユーザーが理解するのに役立ちます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。
- includeUpdates(optional): boolean
未公開の更新内容をコピーに含めます。
リリース19.2.2.での導入。 - justification(optional): string
最大長:
1000
理由は、承認者がこのリクエストをレビューするのに役立ちます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。
- links(optional): array links
このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。
- localizationPolicy(optional): string
サイトの作成時にサイトに関連付けられるローカリゼーション・ポリシーです。 ローカリゼーション・ポリシーは、エンタープライズ・サイトに対してのみ設定できます。 リクエストに関連付けられているポリシーがローカリゼーション・ポリシーを指定している場合、ローカリゼーション・ポリシーはリクエストに関連付けられません。
リリース19.2.3.での導入。 - name(optional): string
最大長:
242
この名前はサイト作成プロセスで使用され、新しいサイトの識別に使用されます。 名前は一意である必要があります。指定した名前は既存のサイトの名前と同じにできません。
- repository(optional): string
サイトの作成時にサイトに関連付けられるアセット・リポジトリ。 リポジトリは、エンタープライズ・サイトに対してのみ設定できます。 リクエストに関連付けられているポリシーでリポジトリが指定されている場合、リポジトリをリクエストに関連付けることはできません。
リリース19.2.3.での導入。 - sitePrefix(optional): string
最大長:
15
サイトの作成時にサイトに設定されるサイト・プレフィクス。 エンタープライズ・サイトのリクエストにのみ設定されます。 リクエストに関連付けられているポリシーで許可されている場合のみ設定できます。そうでない場合、サイト・プレフィクスが自動的に生成されます。 サイト・プレフィクスの長さは15文字までです。
リリース19.2.3.での導入。
サイトのセキュリティ・カテゴリ。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
- object SiteContentSecurity
サイトのコンテンツ・セキュリティ。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
array
このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。
object
サイトのコンテンツ・セキュリティ。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
- category(optional): string
関連付けられたタクソノミ・カテゴリ・リソース。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
- taxonomy(optional): string
関連付けられたタクソノミ・リソース。
将来のリリースを対象としています。
この操作は、未使用の将来のリリースを対象としています。 この操作は変更される可能性があります。
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
とみなすことができます。
{
"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レスポンス
- Cache-Control: string
キャッシュ・メカニズムのディレクティブ。
- Content-Length: string
レスポンス本文のサイズ。
- Content-Type: string
レスポンスのコンテンツ・タイプ。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
- object RequestNotFoundExceptionDetail-allOf[1]
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ページなどの問題の判読可能なサマリーを提供します。
object
- request(optional): string
存在しない、または認証されたユーザーが表示できないリクエストです。
- object 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"
}
}