HLRC: Delete role API (#34620)

Adds the "Delete role" API to the high-level REST client.

docs/java-rest/high-level/document/delete.asciidoc

@@ -10,7 +10,7 @@
 [id="{upid}-{api}-request"]
 ==== Delete Request
 
-A +{request}+ requires the following arguments:
+A +{request}+ has no arguments
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------

docs/java-rest/high-level/security/delete-role.asciidoc

@@ -0,0 +1,33 @@
+--
+:api: delete-role
+:request: DeleteRoleRequest
+:response: DeleteRoleResponse
+--
+
+[id="{upid}-{api}"]
+=== Delete Role API
+
+[id="{upid}-{api}-request"]
+==== Delete Role Request
+
+A +{request}+ has a single argument
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-request]
+--------------------------------------------------
+<1> role to delete
+
+include::../execution.asciidoc[]
+
+[id="{upid}-{api}-response"]
+==== Delete Response
+
+The returned +{response}+ allows to retrieve information about the executed
+ operation as follows:
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-response]
+--------------------------------------------------
+<1> whether the given role was found

docs/java-rest/high-level/supported-apis.asciidoc

@@ -310,12 +310,16 @@ include::rollup/get_rollup_caps.asciidoc[]
 
 == Security APIs
 
+:upid: {mainid}-security
+:doc-tests-file: {doc-tests}/SecurityDocumentationIT.java
+
 The Java High Level REST Client supports the following Security APIs:
 
 * <<java-rest-high-security-put-user>>
 * <<java-rest-high-security-enable-user>>
 * <<java-rest-high-security-disable-user>>
 * <<java-rest-high-security-change-password>>
+* <<java-rest-high-security-delete-role>>
 * <<java-rest-high-security-get-certificates>>
 * <<java-rest-high-security-put-role-mapping>>
 * <<java-rest-high-security-delete-role-mapping>>
@@ -324,6 +328,7 @@ include::security/put-user.asciidoc[]
 include::security/enable-user.asciidoc[]
 include::security/disable-user.asciidoc[]
 include::security/change-password.asciidoc[]
+include::security/delete-role.asciidoc[]
 include::security/get-certificates.asciidoc[]
 include::security/put-role-mapping.asciidoc[]
 include::security/delete-role-mapping.asciidoc[]