AgentsforBedrock / Client / list_agent_versions

list_agent_versions#

AgentsforBedrock.Client.list_agent_versions(**kwargs)#

Lists the versions of an agent and information about each version.

Request Syntax

response = client.list_agent_versions(
    agentId='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

agentId (string) –
[REQUIRED]

The unique identifier of the agent.
maxResults (integer) – The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.
nextToken (string) – If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.

Return type:

dict

Returns:

Response Syntax

{
    'agentVersionSummaries': [
        {
            'agentName': 'string',
            'agentStatus': 'CREATING'|'PREPARING'|'PREPARED'|'NOT_PREPARED'|'DELETING'|'FAILED'|'VERSIONING'|'UPDATING',
            'agentVersion': 'string',
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'guardrailConfiguration': {
                'guardrailIdentifier': 'string',
                'guardrailVersion': 'string'
            },
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- agentVersionSummaries (list) –
  
  A list of objects, each of which contains information about a version of the agent.
  - (dict) –
    
    Contains details about a version of an agent.
    - agentName (string) –
      
      The name of the agent to which the version belongs.
    - agentStatus (string) –
      
      The status of the agent to which the version belongs.
    - agentVersion (string) –
      
      The version of the agent.
    - createdAt (datetime) –
      
      The time at which the version was created.
    - description (string) –
      
      The description of the version of the agent.
    - guardrailConfiguration (dict) –
      
      The details of the guardrails configuration in the agent version summary.
      - guardrailIdentifier (string) –
        
        The guardrails identifier assigned to the guardrails configuration.
      - guardrailVersion (string) –
        
        The guardrails version assigned to the guardrails configuration.
    - updatedAt (datetime) –
      
      The time at which the version was last updated.
- nextToken (string) –
  
  If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.

Exceptions

AgentsforBedrock.Client.exceptions.ThrottlingException
AgentsforBedrock.Client.exceptions.AccessDeniedException
AgentsforBedrock.Client.exceptions.ValidationException
AgentsforBedrock.Client.exceptions.InternalServerException
AgentsforBedrock.Client.exceptions.ResourceNotFoundException