DELETE PKI/HashiCorp/Role/{guid}

Removes the policy enforcement settings for a HashiCorp Vault PKI role from Trust Protection Platform.

Requirements

  • Permissions:  The caller must have Delete permission to the role policy object.
  • Token scope:  Certificate:Delete

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

Input parameters

Name

Description

{guid}

In the request URL, specify the GUID that uniquely identifies a HashiCorp role. To get the GUID, call POST Config/FindObjectsOfClass with these parameters:

  • Class:Policy.
  • ObjectDN: The parent folder to search.
  • Recursive1.
  • Pattern: The role name as the pattern. For example, Pattern:*role.

Returns

Response description

Name

Description

HTTP 400

For invalid requests, this method returns:

Error: An error message for invalid parameters data, or syntax.

  • Failed to delete Role.
  • Invalid permissions. You do not have permission to delete policy object.

HTTP 200

For valid requests, this method returns a HTTP 200 message and the following message body:

  • Error: Null.
  • Guid: The unique GUID of the deleted role.

Example: Delete a HashiCorp role

Request for Example

DELETE https://test.venafi.example/vedsdk/PKI/HashiCorp/CA/{1ec53de0-8773-45a5-862f-f5ea56df8be2}
Authorization:Bearer 4MyGeneratedBearerTknz==

Response for Example

HTTP/1.1 200 OK
{
   "Error": null,
   "Guid": "{1951b602-ee26-4222-bd28-64f8b6f57db7}"
}