インポートされる翻訳ファイルの詳細の取得
/sites/management/api/v1/sites/_status/{id}/translationImportFile
サイト翻訳のインポートに使用された翻訳ファイルの詳細。
リリース19.2.1.での導入。
成功したレスポンスの例
この操作は、次の成功(2xx)のレスポンスで応答します。 レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。
200OK
リクエスト
GET https://api.example.com/sites/management/api/v1/sites/_status/{id}/translationImportFile
レスポンス本文
{ "id": "F40B9BE3E69F6DC440559A1F033BB2482DB740ECB2D8", "name": "Marketing.docx", "description": "value", "type": "file", "version": "1", "size": "10987", "mimetype": "application/doc", "parentID": "self", "createdTime": "2019-09-20T14:09:57Z", "createdBy": { "id": "UC1279D4F6BCCD27849F348E5915CC72E971", "displayName": "John Smith", "loginName": "jsmith", "type": "user" }, "modifiedTime": "2019-09-20T14:09:57Z", "modifiedBy": { "id": "UC1279D4F6BCCD27849F348E5915CC72E971", "displayName": "John Smith", "loginName": "jsmith", "type": "user" }, "ownedBy": { "id": "UC1279D4F6BCCD27849F348E5915CC72E971", "displayName": "John Smith", "loginName": "jsmith", "type": "user" }, "conversationID": "value", "isConversationInherited": false, "reservationDate": "2019-09-20T14:09:57Z", "reservedBy": { "id": "UC1279D4F6BCCD27849F348E5915CC72E971", "displayName": "John Smith", "loginName": "jsmith", "type": "user" } }
クライアント・エラー・レスポンスの例
この操作は、レスポンス本文に例外の詳細が含まれている次のクライアント・エラー(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" } }
404Not Found - Relationship Not Found
関係が存在しないため、関係を読み取ろうとしましたが失敗しました。 関係が存在しなくなった場合、または認証されたアイデンティティが関係の詳細の読取りを承認されていない場合に、関係の読取りが失敗する可能性があります。
エラー・コード
PAAS-005027
レスポンス本文の例
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Relationship Not Found", "status": "404", "detail": "Relationship resource not found. There is a relationship to a resource, but the resource at the end of the relationship does not exist, or the authenticated identity cannot see the resource.", "o:errorCode": "PAAS-005027" }
このリソースは、サイト・ジョブ・ステータスとドキュメント・ファイル・リソース間の関係を表します。 サイト・ジョブ・ステータスに関連付けられているドキュメント・ファイルがない場合、レスポンス・ステータス・コードは204 No Contentになります。 ドキュメント・ファイルが削除されたか、リソースを読み取る権限が認証されたユーザーにない場合、レスポンス・ステータス・コードは「404見つかりません」になり、レスポンス本文に「関係が見つかりません」エラーが返されます。
リクエスト
- id: string
レスポンスを元の非同期ジョブに関連付けるために使用できるジョブ・コンテキスト識別子の値。 非同期ジョブがどのように開始されたかによって、コンテキスト値があるかどうか、およびコンテキスト値は何かが決まります。
- excludeFields(optional): string
レスポンスに含めないフィールド名のカンマ区切り文字列。
- excludeLinks(optional): string
レスポンスからexcludeへのリンク関係名のカンマ区切りリスト。
- fields(optional): string
レスポンスに含めるフィールド名のカンマ区切りの文字列。 フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。
- links(optional): string
レスポンス内のincludeへのリンク関係名のカンマ区切りリスト。 デフォルトでは、すべてのリンクが返されます。
次のリンクは、このリソースにより提供されます:
リンク関係 説明 parent
親リソースが読取り可能な場所を示します。 このリンクは up
リンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。self
リソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。 canonical
リクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。 describedBy
リソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。 download
ダウンロード・リンクはファイル・リソースで返されます。 ダウンロード・リンクは、ファイル・データのストリームに使用できます。 - return(optional): string
レスポンス・フィールドおよびリンクの制御に使用するリソース表現を指定します。 表現が指定されない場合、
fields
、excludeFields
、links
、excludeLinks
およびexpand
問合せパラメータの値に基づいて、クライアント定義の表現が戻されます。次の表現は、
return
問合せパラメータでサポートされています:表現 説明 representation
フル・リソース表示には、すべてのプロパティとリンクが含まれ、大部分の関係が拡張されます。 default
デフォルトのリソース表示には、ほとんどのプロパティとリンクが含まれます。 basic
基本的なリソース表現には、いくつかのプロパティといくつかのリンクが含まれます。 minimal
最小リソース表現。必須プロパティとリンクなしが含まれます。
レスポンス
- application/json
- application/vnd.oracle.resource+json;type=singular
200レスポンス
- Cache-Control: string
キャッシュ・メカニズムのディレクティブ。
- Content-Length: string
レスポンス本文のサイズ。
- Content-Type: string
レスポンスのコンテンツ・タイプ。
ドキュメントのファイルに関する情報。
リリース19.4.3での導入。- object SingularResource
すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。
- object DocumentFile-allOf[1]
object
すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。
- links(optional): array links
このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。
object
- conversationID(optional): string
このファイルまたは親フォルダに関連付けられている会話ID。
リリース19.4.3での導入。 - createdBy(optional): createdBy
ファイルを作成したユーザー。
リリース19.4.3での導入。 - createdTime(optional): string(date-time)
ファイルの作成時間。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601
リリース19.4.3での導入。yyyy-MM-dd'T'HH:mm:ss'Z'
形式です。 - description(optional): string
ファイルの説明
リリース19.4.3での導入。 - id(optional): string
ファイルの一意の識別子。
フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。
リリース19.4.3での導入。 - isConversationInherited(optional): boolean
対話IDが現在のファイルに関連付けられているか(false)、または対話IDが親フォルダに関連付けられているか(true)を示します。
リリース19.4.3での導入。 - mimetype(optional): string
ファイルのMimeタイプ。
リリース19.4.3での導入。 - modifiedBy(optional): modifiedBy
ファイルを最後に変更したユーザー。
リリース19.4.3での導入。 - modifiedTime(optional): string(date-time)
ファイルの作成時間。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601
リリース19.4.3での導入。yyyy-MM-dd'T'HH:mm:ss'Z'
形式です。 - name(optional): string
Filename.
リリース19.4.3での導入。 - ownedBy(optional): ownedBy
ファイルを所有するユーザー。
リリース19.4.3での導入。 - parentID(optional): string
ファイルのMimeタイプ。
リリース19.4.3での導入。 - reservationDate(optional): string(date-time)
ファイル予約時間。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601
リリース19.4.3での導入。yyyy-MM-dd'T'HH:mm:ss'Z'
形式です。 - reservedBy(optional): reservedBy
ファイルが予約されているユーザー。
リリース19.4.3での導入。 - size(optional): string
ファイル・サイズ(バイト単位)。
リリース19.4.3での導入。 - type(optional): string
リソース・タイプ 値fileを指定します。
リリース19.4.3での導入。 - version(optional): string
ファイルのバージョン。
リリース19.4.3での導入。
array
このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。
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
とみなすことができます。
ファイルを作成したユーザー。
リリース19.4.3での導入。- allOf DocumentUser
ファイルまたはフォルダのユーザーに関する情報。
リリース19.4.3での導入。
ファイルを最後に変更したユーザー。
リリース19.4.3での導入。- allOf DocumentUser
ファイルまたはフォルダのユーザーに関する情報。
リリース19.4.3での導入。
ファイルを所有するユーザー。
リリース19.4.3での導入。- allOf DocumentUser
ファイルまたはフォルダのユーザーに関する情報。
リリース19.4.3での導入。
ファイルが予約されているユーザー。
リリース19.4.3での導入。- allOf DocumentUser
ファイルまたはフォルダのユーザーに関する情報。
リリース19.4.3での導入。
ファイルまたはフォルダのユーザーに関する情報。
リリース19.4.3での導入。- object SingularResource
すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。
- object DocumentUser-allOf[1]
object
- displayName(optional): string
ユーザー表示名
リリース19.4.3での導入。 - id(optional): string
ユーザーの一意の識別子。
リリース19.4.3での導入。 - loginName(optional): string
ユーザーのログイン名。
リリース19.4.3での導入。 - type(optional): string
リソース・タイプ 値'user'があります。
リリース19.4.3での導入。
{
"id":"F40B9BE3E69F6DC440559A1F033BB2482DB740ECB2D8",
"name":"Marketing.docx",
"description":"value",
"type":"file",
"version":"1",
"size":"10987",
"mimetype":"application/doc",
"parentID":"self",
"createdTime":"2019-09-20T14:09:57Z",
"createdBy":{
"id":"UC1279D4F6BCCD27849F348E5915CC72E971",
"displayName":"John Smith",
"loginName":"jsmith",
"type":"user"
},
"modifiedTime":"2019-09-20T14:09:57Z",
"modifiedBy":{
"id":"UC1279D4F6BCCD27849F348E5915CC72E971",
"displayName":"John Smith",
"loginName":"jsmith",
"type":"user"
},
"ownedBy":{
"id":"UC1279D4F6BCCD27849F348E5915CC72E971",
"displayName":"John Smith",
"loginName":"jsmith",
"type":"user"
},
"conversationID":"value",
"isConversationInherited":false,
"reservationDate":"2019-09-20T14:09:57Z",
"reservedBy":{
"id":"UC1279D4F6BCCD27849F348E5915CC72E971",
"displayName":"John Smith",
"loginName":"jsmith",
"type":"user"
}
}
400レスポンス
401レスポンス
403レスポンス
404レスポンス
- Cache-Control: string
キャッシュ・メカニズムのディレクティブ。
- Content-Length: string
レスポンス本文のサイズ。
- Content-Type: string
レスポンスのコンテンツ・タイプ。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
- object SiteJobNotFoundExceptionDetail-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
- jobStatus(optional): string
存在しないか、認証されたユーザーが参照できないサイト・ジョブ・ステータス。
- object ExceptionDetail
HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。
{
"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"
}
}
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Relationship Not Found",
"status":"404",
"detail":"Relationship resource not found. There is a relationship to a resource, but the resource at the end of the relationship does not exist, or the authenticated identity cannot see the resource.",
"o:errorCode":"PAAS-005027"
}