POST SecretStore/Dissociate
Dissociates name(s) and/or value pairs from the specified vault entry.
Requirements
- Permissions: Write permission to the owner.
- Token scope: Restricted:Manage
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
Name |
Description |
---|---|
IntValue |
(Optional) Retains the Name attribute and removes only the number that requires dissociation from the VaultID. |
Name |
(Optional). Removes just the data from the attribute Name that is associated with the VaultID. If there are multiple values associated with a single Name, specify a corresponding DateValue, StringValue, or IntValue. WARNING! If Name is missing, SecretStore/Dissociate removes all associations on the vault entry. |
Name (use with the IntValueparameter) |
(Optional) If the name from this list (below) has multiple values, specify an IntValue:
|
Name (use with the StringValue parameter) |
(Optional) If the name from this list (below) has multiple values, specify a StringValue:
|
Name (use with the ValueDate parameter) |
(Optional) If the name from this list (below) has multiple values, specify a ValueDate:
|
StringValue |
(Optional) Retains the Name attribute and removes only the number that requires dissociation from the VaultID. |
ValueDate |
(Optional) Retains the Name attribute and removes only the number that requires dissociation from the VaultID. Use Universal Time Coordinated (UTC) in the ISO 8601 format, for example YYYY-MM-DDTHH:MM:SS.mmmmmmmZ. |
VaultID |
Required. The integer that uniquely identifies the vault entry to alter. To get the correct VaultID, use the POST SecretStore/LookupByOwner method. |
Returns
Upon success SecretStore/Dissociate returns a HTTP 200 message. If successful, the event information appears in the Trust Protection Platform log.
Name |
Description |
---|---|
Result |
A number indicating the status:
|
Example
Request
POST https://tpp.venafi.example/vedsdk/SecretStore/Dissociate Authorization:Bearer 4MyGeneratedBearerTknz== { "VaultID":376, "Name":"Key Size", "IntValue":512 }
Response
HTTP/1.1 200 OK { "Result":0 }