disable-user-profile.asciidoc 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. [role="xpack"]
  2. [[security-api-disable-user-profile]]
  3. === Disable user profile API
  4. ++++
  5. <titleabbrev>Disable user profile</titleabbrev>
  6. ++++
  7. beta::[]
  8. Disables a user profile so it's not visible in
  9. <<security-api-suggest-user-profile,user profile searches>>.
  10. [[security-api-disable-user-profile-request]]
  11. ==== {api-request-title}
  12. `POST /_security/profile/<uid>/_disable`
  13. `PUT /_security/profile/<uid>/_disable`
  14. [[security-api-disable-user-profile-prereqs]]
  15. ==== {api-prereq-title}
  16. To use this API, you must have the `manage_user_profile` cluster privilege.
  17. [[security-api-disable-user-profile-desc]]
  18. ==== {api-description-title}
  19. When you <<security-api-activiate-user-profile,activate a user profile>>, it's
  20. automatically enabled and visible in user profile searches. You can use the
  21. disable user profile API to disable a user profile so it's not visible in
  22. these searches.
  23. To re-enable a disabled user profile, use the
  24. <<security-api-enable-user-profile,enable user profile API>> .
  25. [[security-api-disable-user-profile-path-params]]
  26. ==== {api-path-parms-title}
  27. `<uid>`::
  28. (Required, string) Unique identifier for the user profile.
  29. [[security-api-disable-user-profile-query-params]]
  30. ==== {api-query-parms-title}
  31. include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=refresh]
  32. [[security-api-disable-user-profile-example]]
  33. ==== {api-examples-title}
  34. The following request disables the user profile for a `uid` matching
  35. `u_kd2JMqwUQwSCCOxMv7M1vw`:
  36. [source,console]
  37. ----
  38. POST /_security/profile/u_kd2JMqwUQwSCCOxMv7M1vw/_disable
  39. ----
  40. // TEST[skip:uid is random and no way to ensure this uid exists]