Skip to content

Commit

Permalink
[DOCS] Completed warning text.
Browse files Browse the repository at this point in the history
  • Loading branch information
szabosteve committed May 22, 2019
1 parent b6f6998 commit a8e8bc5
Show file tree
Hide file tree
Showing 9 changed files with 21 additions and 21 deletions.
6 changes: 3 additions & 3 deletions docs/api/role-management.asciidoc
Expand Up @@ -2,12 +2,12 @@
[[role-management-api]]
== Kibana Role Management API

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying mechanism of enforcing role based access control is stable, but the APIs for managing the roles are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying mechanism of enforcing role based access control is stable, but the APIs for managing the roles are currently experimental."]

The role management API allows people to manage roles that grant <<kibana-privileges>>.
It is *not* supported to do so using the
{ref}/security-api.html#security-role-apis[{es} role management APIs], and doing
so will likely cause {kib}'s authorization to behave unexpectedly.
{ref}/security-api.html#security-role-apis[{es} role management APIs], and doing
so will likely cause {kib}'s authorization to behave unexpectedly.

* <<role-management-api-put>>
* <<role-management-api-get>>
Expand Down
2 changes: 1 addition & 1 deletion docs/api/role-management/delete.asciidoc
@@ -1,7 +1,7 @@
[[role-management-api-delete]]
=== Delete role

experimental[This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental.]
experimental["This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental."]

==== Authorization

Expand Down
6 changes: 3 additions & 3 deletions docs/api/role-management/get.asciidoc
@@ -1,7 +1,7 @@
[[role-management-api-get]]
=== Get Role

experimental[This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental.]
experimental["This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental."]

Retrieves all {kib} roles, or a specific role.

Expand All @@ -24,7 +24,7 @@ GET /api/security/role

===== Response

A successful call returns a response code of `200` and a response body containing a JSON
A successful call returns a response code of `200` and a response body containing a JSON
representation of the roles.

[source,js]
Expand Down Expand Up @@ -86,7 +86,7 @@ GET /api/security/role/my_kibana_role

===== Response

A successful call returns a response code of `200` and a response body containing a JSON
A successful call returns a response code of `200` and a response body containing a JSON
representation of the role.

[source,js]
Expand Down
10 changes: 5 additions & 5 deletions docs/api/role-management/put.asciidoc
@@ -1,7 +1,7 @@
[[role-management-api-put]]
=== Create or Update Role

experimental[This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental.]
experimental["This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental."]

Creates a new {kib} role or updates the attributes of an existing role. {kib} roles are stored in the
{es} native realm.
Expand All @@ -12,7 +12,7 @@ To use this API, you must have at least the `manage_security` cluster privilege.

==== Request

To create or update a role, issue a PUT request to the
To create or update a role, issue a PUT request to the
`/api/security/role/<rolename>` endpoint.

[source,js]
Expand All @@ -27,10 +27,10 @@ The following parameters can be specified in the body of a PUT request to add or
`metadata`:: (object) Optional meta-data. Within the `metadata` object, keys
that begin with `_` are reserved for system usage.

`elasticsearch`:: (object) Optional {es} cluster and index privileges, valid keys are
`elasticsearch`:: (object) Optional {es} cluster and index privileges, valid keys are
`cluster`, `indices` and `run_as`. For more information, see {xpack-ref}/defining-roles.html[Defining Roles].

`kibana`:: (object) An object that specifies the <<kibana-privileges>>. Valid keys are `global` and `space`. Privileges defined in the `global` key will apply to all spaces within Kibana, and will take precedent over any privileges defined in the `space` key. For example, specifying `global: ["all"]` will grant full access to all spaces within Kibana, even if the role indicates that a specific space should only have `read` privileges.
`kibana`:: (object) An object that specifies the <<kibana-privileges>>. Valid keys are `global` and `space`. Privileges defined in the `global` key will apply to all spaces within Kibana, and will take precedent over any privileges defined in the `space` key. For example, specifying `global: ["all"]` will grant full access to all spaces within Kibana, even if the role indicates that a specific space should only have `read` privileges.

===== Example

Expand Down Expand Up @@ -91,7 +91,7 @@ PUT /api/security/role/my_kibana_role
"global": [],
"space": {
"marketing": ["all"],
"engineering": ["read"]
"engineering": ["read"]
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion docs/api/spaces-management.asciidoc
Expand Up @@ -2,7 +2,7 @@
[[spaces-api]]
== Kibana Spaces API

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental."]

The spaces API allows people to manage their spaces within {kib}.

Expand Down
2 changes: 1 addition & 1 deletion docs/api/spaces-management/delete.asciidoc
@@ -1,7 +1,7 @@
[[spaces-api-delete]]
=== Delete space

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental."]

[WARNING]
==================================================
Expand Down
6 changes: 3 additions & 3 deletions docs/api/spaces-management/get.asciidoc
@@ -1,7 +1,7 @@
[[spaces-api-get]]
=== Get Space

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental."]

Retrieves all {kib} spaces, or a specific space.

Expand All @@ -20,7 +20,7 @@ GET /api/spaces/space

===== Response

A successful call returns a response code of `200` and a response body containing a JSON
A successful call returns a response code of `200` and a response body containing a JSON
representation of the spaces.

[source,js]
Expand Down Expand Up @@ -62,7 +62,7 @@ GET /api/spaces/space/marketing

===== Response

A successful call returns a response code of `200` and a response body containing a JSON
A successful call returns a response code of `200` and a response body containing a JSON
representation of the space.

[source,js]
Expand Down
4 changes: 2 additions & 2 deletions docs/api/spaces-management/post.asciidoc
@@ -1,13 +1,13 @@
[[spaces-api-post]]
=== Create Space

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental."]

Creates a new {kib} space. To update an existing space, use the PUT command.

==== Request

To create a space, issue a POST request to the
To create a space, issue a POST request to the
`/api/spaces/space` endpoint.

[source,js]
Expand Down
4 changes: 2 additions & 2 deletions docs/api/spaces-management/put.asciidoc
@@ -1,13 +1,13 @@
[[spaces-api-put]]
=== Update Space

experimental[This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental."]

Updates an existing {kib} space. To create a new space, use the POST command.

==== Request

To update a space, issue a PUT request to the
To update a space, issue a PUT request to the
`/api/spaces/space/<space_id>` endpoint.

[source,js]
Expand Down

0 comments on commit a8e8bc5

Please sign in to comment.