BedrockAgentCoreControl / Client / list_registry_records

list_registry_records

BedrockAgentCoreControl.Client.list_registry_records(**kwargs)

Lists registry records within a registry. You can optionally filter results using the name, status, and descriptorType parameters. When multiple filters are specified, they are combined using AND logic.

See also: AWS API Documentation

Request Syntax

response = client.list_registry_records(
    registryId='string',
    maxResults=123,
    nextToken='string',
    name='string',
    status='DRAFT'|'PENDING_APPROVAL'|'APPROVED'|'REJECTED'|'DEPRECATED'|'CREATING'|'UPDATING'|'CREATE_FAILED'|'UPDATE_FAILED',
    descriptorType='MCP'|'A2A'|'CUSTOM'|'AGENT_SKILLS'
)
Parameters:

  • registryId (string) –

    [REQUIRED]

    The identifier of the registry to list records from. You can specify either the Amazon Resource Name (ARN) or the ID of the registry.

  • 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.

  • name (string) – Filter registry records by name.

  • status (string) – Filter registry records by their current status. Possible values include CREATING, DRAFT, APPROVED, PENDING_APPROVAL, REJECTED, DEPRECATED, UPDATING, CREATE_FAILED, and UPDATE_FAILED.

  • descriptorType (string) – Filter registry records by their descriptor type. Possible values are MCP, A2A, CUSTOM, and AGENT_SKILLS.

Return type:

dict

Returns:

Response Syntax

{
    'registryRecords': [
        {
            'registryArn': 'string',
            'recordArn': 'string',
            'recordId': 'string',
            'name': 'string',
            'description': 'string',
            'descriptorType': 'MCP'|'A2A'|'CUSTOM'|'AGENT_SKILLS',
            'recordVersion': 'string',
            'status': 'DRAFT'|'PENDING_APPROVAL'|'APPROVED'|'REJECTED'|'DEPRECATED'|'CREATING'|'UPDATING'|'CREATE_FAILED'|'UPDATE_FAILED',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • registryRecords (list) –

      The list of registry record summaries. For details about the fields in each summary, see the RegistryRecordSummary data type.

      • (dict) –

        Contains summary information about a registry record.

        • registryArn (string) –

          The Amazon Resource Name (ARN) of the registry that contains the record.

        • recordArn (string) –

          The Amazon Resource Name (ARN) of the registry record.

        • recordId (string) –

          The unique identifier of the registry record.

        • name (string) –

          The name of the registry record.

        • description (string) –

          The description of the registry record.

        • descriptorType (string) –

          The descriptor type of the registry record. Possible values are MCP, A2A, CUSTOM, and AGENT_SKILLS.

        • recordVersion (string) –

          The version of the registry record.

        • status (string) –

          The current status of the registry record. Possible values include CREATING, DRAFT, APPROVED, PENDING_APPROVAL, REJECTED, DEPRECATED, UPDATING, CREATE_FAILED, and UPDATE_FAILED.

        • createdAt (datetime) –

          The timestamp when the registry record was created.

        • updatedAt (datetime) –

          The timestamp when the registry record 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