NOT_EMPTY_LOOKUP
NOT_EMPTY_LOOKUP: { lookupPath }
Description
The NOT_EMPTY_LOOKUP operation is the inverse of IS_EMPTY_LOOKUP. It checks whether a lookup field, or a chain of lookups, is fully populated with objects. This operation is also designed to address scenarios described in the Object Relationships documentation, focusing on ensuring that a lookup path successfully resolves to a non-empty object.
NOT_EMPTY_LOOKUP returns true if the entire lookup path is successfully resolved and leads to a non-empty object. It returns false if any part of the lookup path is broken, incomplete, or resolves to a null or empty object.
This operation is essential for policies that require verification of complete and valid object relationships, ensuring data integrity and reliability in policy evaluations.
Parameters
lookupPath(string, required):- Specifies the lookup path to be checked for non-emptiness.
- The path is a string that can include relationship names to traverse lookups (e.g.,
CA10__vpc__r.CA10__subnet__r). - The path should point to a lookup field or a chain of lookup fields. Only
lookup__rfields can be used in the chain of lookups. - Example paths:
CA10__vpc__rCA10__vpc__r.CA10__subnet__r
Return Type
Examples
-
Checking if a lookup field
CA10__vpc__ris not empty:NOT_EMPTY_LOOKUP: CA10__vpc__rThis example verifies that the VPC lookup on an EC2 instance is successfully resolved and the VPC data is available.
-
Checking a chain of lookups
CA10__vpc__r.CA10__subnet__rfor non-emptiness:NOT_EMPTY_LOOKUP: CA10__vpc__r.CA10__subnet__rThis example ensures that the entire lookup chain from instance to subnet (via VPC) is valid and data is available at each step.