Drop a policy from the catalog

delete

{scheme}://{host}/{basePath}/polaris/v1/{prefix}/namespaces/{namespace}/policies/{policy-name}

Remove a policy from the catalog.

A policy can only be dropped if it is not attached to any resource entity. To remove the policy along with all its attachments, set detach-all to true.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

204

Success, no content

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400Bad Request - the policy to be dropped is attached to one or more targets and detach-all is not set to true

401Unauthorized. The REST Catalog SHOULD respond with the 401 UnauthorizedResponse when the access token provided is expired, revoked, malformed, or invalid for other reasons. The client MAY request a new access token and retry the request.

403Forbidden. Authenticated user does not have the necessary permissions.

404Not Found - NoSuchPolicyException, policy to get does not exist

503The service is not ready to handle the request, request could have been partially processed. The service may additionally send a Retry-After header to indicate when to retry, a non idempotent request should only be retried by the client when the Retry-After header is present.

5XXA server-side problem that might not be addressable from the client side. Used for server 5xx errors without more specific documentation in individual routes.