List Policy Generation Assets

bedrockagentcorecontrol_list_policy_generation_assets

R Documentation

Retrieves a list of generated policy assets from a policy generation request within the AgentCore Policy system¶

Description¶

Retrieves a list of generated policy assets from a policy generation request within the AgentCore Policy system. This operation returns the actual Cedar policies and related artifacts produced by the AI-powered policy generation process, allowing users to review and select from multiple generated policy options.

Usage¶

bedrockagentcorecontrol_list_policy_generation_assets(
  policyGenerationId, policyEngineId, nextToken, maxResults)

Arguments¶

policyGenerationId

[required] The unique identifier of the policy generation request whose assets are to be retrieved. This must be a valid generation ID from a previous start_policy_generation call that has completed processing.

policyEngineId

[required] The unique identifier of the policy engine associated with the policy generation request. This provides the context for the generation operation and ensures assets are retrieved from the correct policy engine.

nextToken

A pagination token returned from a previous list_policy_generation_assets call. Use this token to retrieve the next page of assets when the response is paginated due to large numbers of generated policy options.

maxResults

The maximum number of policy generation assets to return in a single response. If not specified, the default is 10 assets per page, with a maximum of 100 per page. This helps control response size when dealing with policy generations that produce many alternative policy options.

Value¶

A list with the following syntax:

list(
  policyGenerationAssets = list(
    list(
      policyGenerationAssetId = "string",
      definition = list(
        cedar = list(
          statement = "string"
        ),
        policyGeneration = list(
          policyGenerationId = "string",
          policyGenerationAssetId = "string"
        )
      ),
      rawTextFragment = "string",
      findings = list(
        list(
          type = "VALID"|"INVALID"|"NOT_TRANSLATABLE"|"ALLOW_ALL"|"ALLOW_NONE"|"DENY_ALL"|"DENY_NONE",
          description = "string"
        )
      )
    )
  ),
  nextToken = "string"
)

Request syntax¶

svc$list_policy_generation_assets(
  policyGenerationId = "string",
  policyEngineId = "string",
  nextToken = "string",
  maxResults = 123
)