アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> createLink
 
createLink
TABLEまたはPROCEDUREリソースを指すリンクを/servicesディレクトリーに作成します。リンクはリソースを効果的に公開して、外部クライアントが使用できるようにします。
ターゲットリソースが存在しない場合でも、リンクを作成できます。この手順では、ターゲットリソースの存在の検証は実行されません。リンクされたリソースを使用するには、特権も適切かつ独立して設定する必要があります。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
paths:リンクを作成する場所。リンクは、/servicesコンテナ内、およびデータサービス、スキーマ、またはオペレーションリソース内でのみ作成できます。
name:リンクの名前。
detail:応答に含めるリソースに関する詳細レベル。有効な値は、NONE、SIMPLE、およびFULLです。
targetPath:新しいリンクが指すリソースの完全修飾パス。
targetType:targetPathで指定された有効なターゲットは、TABLEまたはPROCEDUREのいずれかです。
annotation(オプション):リンクの説明。
応答エレメント
resource:新しく作成されたリソースのリスト。 resource:impactlevelは、応答の一部のターゲット妥当性情報について詳細がSIMPLEまたはFULLに設定されている場合にチェックできます。 リソースエレメントを参照してください。
エラー解析
DuplicateName:指定されたパスと名前を持つ任意のタイプのリソースがすでに存在する場合。
IllegalArgument:pathまたはtargetPathのいずれかが不正な形式であるか、detailまたはtargetTypeのいずれかが不正である場合。
NotAllowed:指定されたパスと名前を使用してリソースを作成することが合法でない場合。リンクは、/servicesの下、およびRELATIONAL_DATA_SOURCE、SCHEMA、およびOPERATIONリソース内でのみ作成できます。
NotAllowed:targetTypeのリンクが許可されていない場合。リンクのターゲットとして使用できるのは、TABLEおよびPROCEDUREリソースのみです。
NotFound:パスのいずれかの部分が存在しない場合。
セキュリティ:ユーザーがパス内のすべてのアイテムに対する読み取りアクセス権を持っていない場合。
セキュリティ:ユーザーがパスの最後のアイテムへの書き込みアクセス権を持っていない場合。
セキュリティ:ユーザーがACCESS_TOOLS権限を持っていない場合。