action conjur_show_role {
  label: "Get role information"
  description: "Gets detailed information about a specific role, including the role members.\n\nIf a role A is granted to a role B, then role A is said to have role B as a member.\nThese relationships are described in the “members” portion of the returned JSON.\n\n##### Listing members\n\nIf `members` is provided, you will get the members of a role.\n\nIf a `kind` query parameter is given, narrows results to only resources of that kind.\n\nIf a `limit` is given, returns no more than that number of results. Providing an `offset`\nskips a number of resources before returning the rest. In addition, providing an `offset`\nwill give limit a default value of 10 if none other is provided. These two parameters\ncan be combined to page through results.\n\nIf the parameter `count` is true, returns only the number of items in the list.\n\n##### Text search\n\nIf the search parameter is provided, narrows results to those pertaining to the search query.\nSearch works across resource IDs and the values of annotations. It weights results so that\nthose with matching id or a matching value of an annotation called name appear first, then\nthose with another matching annotation value, and finally those with a matching kind.\n\n##### Parameter Priority\n\nIf Conjur is given any combination of optional parameters, it responds with ONLY results\nfor the parameter of the highest priority.\n\n1. `graph`\n2. `all`\n3. `memberships`\n4. `members`\n"
  provider: conjur
  method: GET
  path: "/roles/{account}/{kind}/{identifier}"
  encoding: json
  input: {
    type: "object"
    properties: {
      account: {
        type: "string"
        description: "Conjur account name"
      }
      all: {
        type: "string"
      }
      count: {
        type: "boolean"
        description: "Return only the count of results"
      }
      graph: {
        type: "string"
      }
      identifier: {
        type: "string"
        description: "Resource identifier. Requires to be encoded when in path.\n\n##### Examples:\n\n- `myapp-01` -> `myapp-01` (unchanged)\n- `alice@devops` -> `alice%40devops`\n- `prod/aws/db-password` -> `prod%2Faws%2Fdb-password`\n- `research+development` -> `research%2Bdevelopment`\n- `sales&marketing` -> `sales%26marketing`\n"
      }
      kind: {
        type: "string"
      }
      limit: {
        type: "integer"
        description: "Return no more than this number of results"
      }
      members: {
        type: "string"
      }
      memberships: {
        type: "string"
      }
      offset: {
        type: "integer"
        description: "Skips this many items before returning the rest"
      }
      search: {
        type: "string"
      }
    }
    required: ["account", "identifier", "kind"]
    additionalProperties: false
  }
  output: {
    type: "object"
  }
}