2021-11-15 21:35:54 +05:30
|
|
|
# Policy
|
|
|
|
|
|
|
|
This schema defines the Policy entity. A Policy defines lifecycle or access control that needs to be applied across different Data Entities.
|
|
|
|
|
2021-11-29 21:15:30 +00:00
|
|
|
**$id:** [**https://open-metadata.org/schema/entity/policies/policy.json**](https://open-metadata.org/schema/entity/policies/policy.json)
|
2021-11-15 21:35:54 +05:30
|
|
|
|
|
|
|
Type: `object`
|
|
|
|
|
2021-12-09 18:19:32 +05:30
|
|
|
This schema <u>does not</u> accept additional properties.
|
|
|
|
|
2021-11-15 21:35:54 +05:30
|
|
|
## Properties
|
2022-01-25 22:19:15 +05:30
|
|
|
- **id** `required`
|
|
|
|
- Unique identifier that identifies this Policy.
|
|
|
|
- $ref: [../../type/basic.json#/definitions/uuid](../types/basic.md#uuid)
|
|
|
|
- **name** `required`
|
|
|
|
- Name that uniquely identifies this Policy.
|
|
|
|
- $ref: [#/definitions/policyName](#policyname)
|
|
|
|
- **fullyQualifiedName**
|
|
|
|
- Name that uniquely identifies a Policy.
|
|
|
|
- $ref: [#/definitions/policyName](#policyname)
|
|
|
|
- **displayName**
|
|
|
|
- Title for this Policy.
|
|
|
|
- Type: `string`
|
|
|
|
- **description**
|
|
|
|
- A short description of the Policy, comprehensible to regular users.
|
|
|
|
- Type: `string`
|
|
|
|
- **owner**
|
|
|
|
- Owner of this Policy.
|
|
|
|
- $ref: [../../type/entityReference.json](../types/entityreference.md)
|
|
|
|
- **policyUrl**
|
|
|
|
- Link to a well documented definition of this Policy.
|
|
|
|
- Type: `string`
|
|
|
|
- String format must be a "uri"
|
|
|
|
- **href**
|
|
|
|
- Link to the resource corresponding to this entity.
|
|
|
|
- $ref: [../../type/basic.json#/definitions/href](../types/basic.md#href)
|
|
|
|
- **policyType** `required`
|
|
|
|
- $ref: [#/definitions/policyType](#policytype)
|
|
|
|
- **enabled**
|
|
|
|
- Is the policy enabled.
|
|
|
|
- Type: `boolean`
|
|
|
|
- Default: _true_
|
|
|
|
- **version**
|
|
|
|
- Metadata version of the Policy.
|
|
|
|
- $ref: [../../type/entityHistory.json#/definitions/entityVersion](../types/entityhistory.md#entityversion)
|
|
|
|
- **updatedAt**
|
|
|
|
- Last update time corresponding to the new version of the Policy in Unix epoch time milliseconds.
|
|
|
|
- $ref: [../../type/basic.json#/definitions/timestamp](../types/basic.md#timestamp)
|
|
|
|
- **updatedBy**
|
|
|
|
- User who made the update.
|
|
|
|
- Type: `string`
|
|
|
|
- **changeDescription**
|
|
|
|
- Change that led to this version of the Policy.
|
|
|
|
- $ref: [../../type/entityHistory.json#/definitions/changeDescription](../types/entityhistory.md#changedescription)
|
|
|
|
- **rules**
|
|
|
|
- $ref: [#/definitions/rules](#rules)
|
|
|
|
- **location**
|
|
|
|
- $ref: [../../type/entityReference.json](../types/entityreference.md)
|
|
|
|
- **deleted**
|
|
|
|
- When `true` indicates the entity has been soft deleted.
|
|
|
|
- Type: `boolean`
|
|
|
|
- Default: _false_
|
2021-11-15 21:35:54 +05:30
|
|
|
|
|
|
|
|
|
|
|
## Type definitions in this schema
|
2021-12-09 18:19:32 +05:30
|
|
|
### policyName
|
|
|
|
|
2022-01-25 22:19:15 +05:30
|
|
|
- Name that identifies this Policy.
|
|
|
|
- Type: `string`
|
|
|
|
- Length: between 1 and 128
|
2021-11-15 21:35:54 +05:30
|
|
|
|
2021-12-14 15:26:34 +05:30
|
|
|
|
2021-11-15 21:35:54 +05:30
|
|
|
### policyType
|
|
|
|
|
2022-01-25 22:19:15 +05:30
|
|
|
- This schema defines the type used for describing different types of policies.
|
|
|
|
- Type: `string`
|
|
|
|
- The value is restricted to the following:
|
|
|
|
1. _"AccessControl"_
|
|
|
|
2. _"Lifecycle"_
|
2021-11-15 21:35:54 +05:30
|
|
|
|
2021-12-14 15:26:34 +05:30
|
|
|
|
|
|
|
### rules
|
|
|
|
|
2022-01-25 22:19:15 +05:30
|
|
|
- A set of rules associated with the Policy.
|
|
|
|
- Type: `array`
|
|
|
|
- **Items**
|
2021-12-14 15:26:34 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2022-03-10 12:55:35 +05:30
|
|
|
_This document was updated on: Wednesday, March 9, 2022_
|