repository-delete

構文

void repository-delete(element, name, md5);
nmtoken element;
nmtoken name;
string md5;

パラメーター

• nmtoken element - ノードのタグ名。(必須)
• nmtoken name - ノードの名前属性。(必須)
• string md5 - 削除するノードの md5。これを指定すると、md5 が一致した場合にのみノードが削除されます。

例外

• repository-error - リポジトリー・ファイルにアクセスする際にエラーが発生しました。
• repository-unknown-node - ノードがリポジトリーに存在しません。
• repository-bad-md5 - 渡された md5 が、リポジトリーに現在あるノードと一致しません。

認証

ping を除くすべての Watson™ Explorer Engine API 関数と同様に、repository-delete 関数には認証が必要です。

REST を使用する場合、HTTP または HTTPS を介して単に v.username および v.password を CGI パラメーターとして渡し、repository-delete 関数への REST 呼び出しを認証することができます。

SOAP API を使用する場合、エンドポイントで資格情報をパラメーターとして渡すか、すべての Watson Explorer Engine 関数でサポートされている認証方式を活用することができます。いずれも、関数の実行に使用されるユーザー名とパスワードを指定するために認証オブジェクトに渡すことができる setAuthentication メソッドを提供します。repository-delete 関数への SOAP 呼び出しを Java で実行する例は次のとおりです。

    Authentication authentication = new Authentication();
    authentication.setUsername("joe-user");
    authentication.setPassword("joes-password");

    RepositoryDelete foo = new RepositoryDelete();
    foo.setAuthentication(authentication);

通常、個々のアプリケーション全体で 1 つの認証オブジェクトが再使用されます。