List Policy Summaries

bedrockagentcorecontrol_list_policy_summaries

R Documentation

Retrieves a paginated list of metadata-only policy summaries within a policy engine without decrypting customer content¶

Description¶

Retrieves a paginated list of metadata-only policy summaries within a policy engine without decrypting customer content. This lightweight read operation returns resource identifiers, status, and timestamps for each policy, but does not include policy definitions, descriptions, or status reasons. Because this operation does not require access to the customer's KMS key, it is suitable for resource discovery, inventory, and integration scenarios where only metadata is needed.

Usage¶

bedrockagentcorecontrol_list_policy_summaries(nextToken, maxResults,
  policyEngineId, targetResourceScope)

Arguments¶

nextToken

A pagination token returned from a previous list_policy_summaries call. Use this token to retrieve the next page of results when the response is paginated.

maxResults

The maximum number of policy summaries to return in a single response.

policyEngineId

[required] The identifier of the policy engine whose policy summaries to retrieve.

targetResourceScope

Optional filter to list policy summaries that apply to a specific resource scope or resource type. This helps narrow down results to those relevant for particular Amazon Web Services resources, agent tools, or operational contexts within the policy engine ecosystem.

Value¶

A list with the following syntax:

list(
  policies = list(
    list(
      policyId = "string",
      name = "string",
      policyEngineId = "string",
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      updatedAt = as.POSIXct(
        "2015-01-01"
      ),
      policyArn = "string",
      status = "CREATING"|"ACTIVE"|"UPDATING"|"DELETING"|"CREATE_FAILED"|"UPDATE_FAILED"|"DELETE_FAILED"
    )
  ),
  nextToken = "string"
)

Request syntax¶

svc$list_policy_summaries(
  nextToken = "string",
  maxResults = 123,
  policyEngineId = "string",
  targetResourceScope = "string"
)