サイトの公開の取消
/sites/management/api/v1/sites/{id}/unpublish
サイトの公開を取り消して、公開されたサイト・アーティファクトによって取得されたリソースを解放します。 更新は、サイトがオフラインである場合にのみ公開取消しできます。
リリース19.4.1.での導入。
認可
この操作を起動するには、認証されたユーザーまたはクライアント・アプリケーションがリソースと共有され、次のいずれかの「共有」ロールを持っている必要があります:
- 所有者
- マネージャ
パス代替識別子
「サイト」リソースのデフォルトの識別子は、「サイト識別子」です。 サイト・リソースは代替識別子をサポートしています。
nameサイト名
サイト識別子のかわりに、サイト名を使用してリソース・パスのサイトを一意に識別できます。 サイトのデフォルトのリソース・パス・パラメータはサイト識別子ですが、サイトでの作業時には判読可能なサイト名が簡単になる場合があります。
http://api.example.com/sites/management/api/v1/sites/name:MyNewProduct/unpublish
リリース19.4.1.での導入。
リダイレクション・レスポンスの例
この操作は、次のリダイレクション(3xx)レスポンスで応答します。 レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。 ノート: この操作の起動に使用されるクライアント・テクノロジによっては、リダイレクトが自動的に実行される場合に2xxレスポンスが返されることがあります。
303See Other
この操作が正常に実行されると、操作の結果を読み取ることができるLocation
ヘッダーとともに303
ステータス・コードが返されます。
クライアント・エラー・レスポンスの例
この操作は、レスポンス本文に例外の詳細が含まれている次のクライアント・エラー(4xx)レスポンスで応答します。 レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。
403Forbidden - Site Operation Forbidden
サイト内で共有ロールを持つユーザーは、この操作を実行できません。
エラー・コード
OCE-SITEMGMT-009026
解決 - 共有ロールの変更
認証ユーザーに付与された共有ロールを必要なロール以上に変更します。
解決 - アプリケーション・ロールの変更
ユーザーにStandardユーザーまたはエンタープライズ・ユーザー・アプリケーション・ロールがあることを確認します。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
site | 操作が実行されているサイト。 |
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteOperationForbiddenExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Site Operation Forbidden", "status": "403", "detail": "You do have a sharing role in this site, but your role does not allow you to use this operation.", "o:errorCode": "OCE-SITEMGMT-009026", "site": { "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0" } }
リリース19.1.5.での導入。
403Forbidden - Storage Limit Reached
ストレージ転送制限に達しました。 請求限度は、システム管理者が使用可能なストレージ容量に設定されています。
エラー・コード
OCE-SITEMGMT-009098
解決 - ストレージ制限の増加
ストレージ制限を増やすシステム管理者を取得します。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
used | 使用済ストレージ(GB)。 |
limit | ストレージ制限(GB)。 |
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのStorageLimitReachedExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Storage Limit Reached", "status": "403", "detail": "Storage limit has been reached.", "o:errorCode": "OCE-SITEMGMT-009098", "used": 1.23456789, "limit": 1.23456789 }
リリース20.3.1で導入されました。
404Not Found - Site Not Found
サイトが存在しないか、削除されたか、認証されたユーザーまたはクライアント・アプリケーションがサイトへのアクセス権を持っていません。
エラー・コード
OCE-SITEMGMT-009003
解決 - 識別子のチェック
サイト識別子が有効であることを確認してください。
解決 - メンバーシップのチェック
認証済ユーザーがサイトのメンバーまたはサイト管理者であることを確認します。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
site | 存在しないか、認証されたユーザーが参照できないサイトです。 |
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteNotFoundExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Site Not Found", "status": "404", "detail": "Site does not exist or has been deleted, or the authenticated user or client application does not have access to the site.", "o:errorCode": "OCE-SITEMGMT-009003", "site": { "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0" } }
409Conflict - Invalid Site Publish Status
サイトが間違った公開状態にあるため、サイト操作を実行できません。 例として、未公開のサイトをオンラインにするか、公開済サイトの名前を変更しようとしています。
エラー・コード
OCE-SITEMGMT-009031
解決 - セキュリティ・レベル更新前のサイトの公開解除
サイトが公開されている間は、サイト・セキュリティ・レベルをパブリックからセキュア・サイトに変更したり、またはその逆に変更することはできません。 サイトにサインインが必要かどうかを変更するために、サイトをオフラインおよび非公開にする必要があるかどうか。
解決 - 名前変更前のサイトの公開取消
サイトの名前を変更するには、オフラインで未公開である必要があります。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
site | 操作が実行されているサイト。 |
publishStatus | サイト公開ステータス。 有効な値は次のとおりです。
|
requiredStatus | 必須のサイト・パブリッシュ・ステータス。 有効な値は次のとおりです。
|
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのInvalidSitePublishStatusExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Invalid Site Publish Status", "status": "409", "detail": "Operation cannot be performed on a site with publish status '{publishStatus}'.", "o:errorCode": "OCE-SITEMGMT-009031", "site": { "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0" }, "publishStatus": "unpublished", "requiredStatus": [ "unpublished" ] }
409Conflict - Invalid Site Status
サイトが間違った状態にあるため、サイト操作を実行できません。 すでにオンラインになっているサイトをオンラインにしたり、オンラインサイトの名前を変更したりする例。
エラー・コード
OCE-SITEMGMT-009013
解決 - セキュリティ・レベルを更新する前にサイトをオフラインにします
サイトがオンラインである間は、サイトのセキュリティ・レベルをパブリックからセキュア・サイトに変更したり、またはその逆に変更したりすることはできません。 サイトにサインインが必要かどうかを変更するために、サイトをオフラインおよび非公開にする必要があるかどうか。
解決 - 名前変更前にサイトをオフラインにします
サイトの名前を変更するには、オフラインで未公開である必要があります。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
site | 操作が実行されているサイト。 |
runtimeStatus | サイト 有効な値は次のとおりです。
|
requiredStatus | 必須サイト・ステータスです。 有効な値は次のとおりです。
|
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのInvalidSiteRuntimeStatusExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Invalid Site Status", "status": "409", "detail": "Operation cannot be performed on a site with status '{runtimeStatus}'.", "o:errorCode": "OCE-SITEMGMT-009013", "site": { "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0" }, "runtimeStatus": "offline", "requiredStatus": "offline" }
409Conflict - Site Deleted
ソフト削除されたサイトでは操作を実行できません。 このエラーは、includeDeleted
問合せパラメータがtrue
に設定されている場合にのみ発生します。
エラー・コード
OCE-SITEMGMT-009059
解決 - サイトのリストア
サイトをリストアしてから操作を再試行してください。
例外詳細フィールド
このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:
フィールド名 | 説明 |
site | サイト識別子が指定されている場合、ソフト削除されるサイト。 |
この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteDeletedExceptionDetailスキーマを参照してください。
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Site Deleted", "status": "409", "detail": "The operation cannot be performed as the site has been soft deleted.", "o:errorCode": "OCE-SITEMGMT-009059", "site": { "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0" } }
リリース19.4.1.での導入。
リクエスト
- id: string
サイトの不変の識別子。
- includeDeleted(optional): boolean
削除対象としてマークされているリソースでは、この問合せパラメータが
true
に設定されているかぎり、読取り、変更およびサポート対象の拡張操作が可能です。includeDeleted
問合せパラメータを送信しない場合、読取り、変更および拡張操作に対するレスポンスは、リソースが完全に削除された場合に戻されるものと同じです。
レスポンス
303レスポンス
400レスポンス
401レスポンス
403レスポンス
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
- object SiteOperationForbiddenExceptionDetail-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
- site(optional): string
操作が実行されているサイト。
リリース19.1.5.での導入。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Site Operation Forbidden",
"status":"403",
"detail":"You do have a sharing role in this site, but your role does not allow you to use this operation.",
"o:errorCode":"OCE-SITEMGMT-009026",
"site":{
"id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
}
}
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Storage Limit Reached",
"status":"403",
"detail":"Storage limit has been reached.",
"o:errorCode":"OCE-SITEMGMT-009098",
"used":1.23456789,
"limit":1.23456789
}
404レスポンス
- Cache-Control: string
キャッシュ・メカニズムのディレクティブ。
- Content-Length: string
レスポンス本文のサイズ。
- Content-Type: string
レスポンスのコンテンツ・タイプ。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
- object SiteNotFoundExceptionDetail-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
- site(optional): string
存在しないか、認証されたユーザーが参照できないサイトです。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Site Not Found",
"status":"404",
"detail":"Site does not exist or has been deleted, or the authenticated user or client application does not have access to the site.",
"o:errorCode":"OCE-SITEMGMT-009003",
"site":{
"id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
}
}
409レスポンス
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
- object InvalidSitePublishStatusExceptionDetail-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
- publishStatus(optional): string
サイト公開ステータス。
有効な値は次のとおりです。
-
unpublished
- サイトは公開されていません。 ランタイム・サイト環境に公開されたファイルがありません -
draft
- サイトに下書き更新があります。 公開されたファイルがランタイム・サイト環境に存在しますが、ベース・サイトに新しい未承認の更新があります -
approved
- サイトには更新が承認されました。 公開されたファイルはランタイム・サイト環境に存在しますが、ベース・サイトには新しい承認済の更新があります -
published
- サイトは公開されています。 公開されたファイルは、ランタイム・サイト環境に存在
-
- requiredStatus(optional): array requiredStatus
必須のサイト・パブリッシュ・ステータス。
有効な値は次のとおりです。
-
unpublished
- サイトは公開されていません。 ランタイム・サイト環境に公開されたファイルがありません -
draft
- サイトに下書き更新があります。 公開されたファイルがランタイム・サイト環境に存在しますが、ベース・サイトに新しい未承認の更新があります -
approved
- サイトには更新が承認されました。 公開されたファイルはランタイム・サイト環境に存在しますが、ベース・サイトには新しい承認済の更新があります -
published
- サイトは公開されています。 公開されたファイルは、ランタイム・サイト環境に存在
-
- site(optional): string
操作が実行されているサイト。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
array
必須のサイト・パブリッシュ・ステータス。
有効な値は次のとおりです。
-
unpublished
- サイトは公開されていません。 ランタイム・サイト環境に公開されたファイルがありません -
draft
- サイトに下書き更新があります。 公開されたファイルがランタイム・サイト環境に存在しますが、ベース・サイトに新しい未承認の更新があります -
approved
- サイトには更新が承認されました。 公開されたファイルはランタイム・サイト環境に存在しますが、ベース・サイトには新しい承認済の更新があります -
published
- サイトは公開されています。 公開されたファイルは、ランタイム・サイト環境に存在
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Invalid Site Publish Status",
"status":"409",
"detail":"Operation cannot be performed on a site with publish status '{publishStatus}'.",
"o:errorCode":"OCE-SITEMGMT-009031",
"site":{
"id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
},
"publishStatus":"unpublished",
"requiredStatus":[
"unpublished"
]
}
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Invalid Site Status",
"status":"409",
"detail":"Operation cannot be performed on a site with status '{runtimeStatus}'.",
"o:errorCode":"OCE-SITEMGMT-009013",
"site":{
"id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
},
"runtimeStatus":"offline",
"requiredStatus":"offline"
}
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Site Deleted",
"status":"409",
"detail":"The operation cannot be performed as the site has been soft deleted.",
"o:errorCode":"OCE-SITEMGMT-009059",
"site":{
"id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
}
}