Class PolicyGeneration
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<PolicyGeneration.Builder,PolicyGeneration>
Represents a policy generation request within the AgentCore Policy system. Tracks the AI-powered conversion of natural language descriptions into Cedar policy statements, enabling users to author policies by describing authorization requirements in plain English. The generation process analyzes the natural language input along with the Gateway's tool context and Cedar schema to produce one or more validated policy options. Each generation request tracks the status of the conversion process and maintains findings about the generated policies, including validation results and potential issues. Generated policy assets remain available for one week after successful generation, allowing time to review and create policies from the generated options.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic PolicyGeneration.Builderbuilder()final InstantThe timestamp when this policy generation request was created.final booleanfinal booleanequalsBySdkFields(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final Stringfindings()Findings and insights from this policy generation process.final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz) final inthashCode()final booleanFor responses, this returns true if the service returned a value for the StatusReasons property.final Stringname()The customer-assigned name for this policy generation request.final StringThe identifier of the policy engine associated with this generation request.final StringThe ARN of this policy generation request.final StringThe unique identifier for this policy generation request.final Resourceresource()The resource information associated with this policy generation.static Class<? extends PolicyGeneration.Builder> final PolicyGenerationStatusstatus()The current status of this policy generation request.final StringThe current status of this policy generation request.Additional information about the generation status.Take this object and create a builder that contains all of the current property values of this object.final StringtoString()Returns a string representation of this object.final InstantThe timestamp when this policy generation was last updated.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
policyEngineId
The identifier of the policy engine associated with this generation request.
- Returns:
- The identifier of the policy engine associated with this generation request.
-
policyGenerationId
The unique identifier for this policy generation request.
- Returns:
- The unique identifier for this policy generation request.
-
name
The customer-assigned name for this policy generation request.
- Returns:
- The customer-assigned name for this policy generation request.
-
policyGenerationArn
The ARN of this policy generation request.
- Returns:
- The ARN of this policy generation request.
-
resource
The resource information associated with this policy generation.
- Returns:
- The resource information associated with this policy generation.
-
createdAt
The timestamp when this policy generation request was created.
- Returns:
- The timestamp when this policy generation request was created.
-
updatedAt
The timestamp when this policy generation was last updated.
- Returns:
- The timestamp when this policy generation was last updated.
-
status
The current status of this policy generation request.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnPolicyGenerationStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The current status of this policy generation request.
- See Also:
-
statusAsString
The current status of this policy generation request.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnPolicyGenerationStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The current status of this policy generation request.
- See Also:
-
hasStatusReasons
public final boolean hasStatusReasons()For responses, this returns true if the service returned a value for the StatusReasons property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
statusReasons
Additional information about the generation status.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasStatusReasons()method.- Returns:
- Additional information about the generation status.
-
findings
Findings and insights from this policy generation process.
- Returns:
- Findings and insights from this policy generation process.
-
toBuilder
Description copied from interface:ToCopyableBuilderTake this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilderin interfaceToCopyableBuilder<PolicyGeneration.Builder,PolicyGeneration> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojoIndicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojoclass, and is generated based on a service model.If an
SdkPojoclass does not have any inherited fields,equalsBySdkFieldsandequalsare essentially the same.- Specified by:
equalsBySdkFieldsin interfaceSdkPojo- Parameters:
obj- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo- Returns:
- The mapping between the field name and its corresponding field.
-