# deleteResourceV1alpha3DeviceTaintRule

From **Kubernetes**.

`DELETE /apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}`

delete a DeviceTaintRule

## Parameters

### `name`

- Location: path
- Required: true
- Type: `string`
- uniqueItems: `true`

name of the DeviceTaintRule

### `pretty`

- Location: query
- Required: false
- Type: `string`
- uniqueItems: `true`

If 'true', then the output is pretty printed. Defaults to 'false' unless the user-agent indicates a browser or command-line HTTP tool (curl and wget).

### `dryRun`

- Location: query
- Required: false
- Type: `string`
- uniqueItems: `true`

When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed

### `gracePeriodSeconds`

- Location: query
- Required: false
- Type: `integer`
- uniqueItems: `true`

The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.

### `ignoreStoreReadErrorWithClusterBreakingPotential`

- Location: query
- Required: false
- Type: `boolean`
- uniqueItems: `true`

if set to true, it will trigger an unsafe deletion of the resource in case the normal deletion flow fails with a corrupt object error. A resource is considered corrupt if it can not be retrieved from the underlying storage successfully because of a) its data can not be transformed e.g. decryption failure, or b) it fails to decode into an object. NOTE: unsafe deletion ignores finalizer constraints, skips precondition checks, and removes the object from the storage. WARNING: This may potentially break the cluster if the workload associated with the resource being unsafe-deleted relies on normal deletion flow. Use only if you REALLY know what you are doing. The default value is false, and the user must opt in to enable it

### `orphanDependents`

- Location: query
- Required: false
- Type: `boolean`
- uniqueItems: `true`

Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object's finalizers list. Either this field or PropagationPolicy may be set, but not both.

### `propagationPolicy`

- Location: query
- Required: false
- Type: `string`
- uniqueItems: `true`

Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy. Acceptable values are: 'Orphan' - orphan the dependents; 'Background' - allow the garbage collector to delete the dependents in the background; 'Foreground' - a cascading policy that deletes all dependents in the foreground.

## Request body

- Required: false
### `*/*`

- Type: `object`

DeleteOptions may be provided when deleting an API object.

```json
{"description":"DeleteOptions may be provided when deleting an API object.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"dryRun":{"description":"When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed","items":{"type":"string"},"type":"array","x-kubernetes-list-type":"atomic"},"gracePeriodSeconds":{"description":"The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.","format":"int64","type":"integer"},"ignoreStoreReadErrorWithClusterBreakingPotential":{"description":"if set to true, it will trigger an unsafe deletion of the resource in case the normal deletion flow fails with a corrupt object error. A resource is considered corrupt if it can not be retrieved from the underlying storage successfully because of a) its data can not be transformed e.g. decryption failure, or b) it fails to decode into an object. NOTE: unsafe deletion ignores finalizer constraints, skips precondition checks, and removes the object from the storage. WARNING: This may potentially break the cluster if the workload associated with the resource being unsafe-deleted relies on normal deletion flow. Use only if you REALLY know what you are doing. The default value is false, and the user must opt in to enable it","type":"boolean"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"orphanDependents":{"description":"Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the \"orphan\" finalizer will be added to/removed from the object's finalizers list. Either this field or PropagationPolicy may be set, but not both.","type":"boolean"},"preconditions":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Preconditions"}],"description":"Must be fulfilled before a deletion is carried out. If not possible, a 409 Conflict status will be returned."},"propagationPolicy":{"description":"Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy. Acceptable values are: 'Orphan' - orphan the dependents; 'Background' - allow the garbage collector to delete the dependents in the background; 'Foreground' - a cascading policy that deletes all dependents in the foreground.","type":"string"}},"type":"object","x-kubernetes-group-version-kind":[{"group":"","kind":"DeleteOptions","version":"v1"},{"group":"resource.k8s.io","kind":"DeleteOptions","version":"v1alpha3"}]}
```

## Responses

### `200`

OK

### `application/cbor`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/json`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/vnd.kubernetes.protobuf`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/yaml`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `202`

Accepted

### `application/cbor`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/json`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/vnd.kubernetes.protobuf`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `application/yaml`

- Type: `object`

DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

```json
{"description":"DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.","properties":{"apiVersion":{"description":"APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources","type":"string"},"kind":{"description":"Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta"}],"default":{},"description":"Standard object metadata"},"spec":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleSpec"}],"default":{},"description":"Spec specifies the selector and one taint.\n\nChanging the spec automatically increments the metadata.generation number."},"status":{"allOf":[{"$ref":"#/components/schemas/io.k8s.api.resource.v1alpha3.DeviceTaintRuleStatus"}],"default":{},"description":"Status provides information about what was requested in the spec."}},"required":["spec"],"type":"object","x-kubernetes-group-version-kind":[{"group":"resource.k8s.io","kind":"DeviceTaintRule","version":"v1alpha3"}]}
```

### `401`

Unauthorized

## Request examples

### cURL

```shell
curl --request DELETE \
  --header 'content-type: */*' \
  --url '/apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}'
```