ai_guardrail_versions

Creates, updates, deletes, gets or lists an ai_guardrail_versions resource.

Overview

Name	ai_guardrail_versions
Type	Resource
Id	aws.qconnect.ai_guardrail_versions

Fields

The following fields are returned by SELECT queries:

list_ai_guardrail_versions

Name	Datatype	Description
ai_guardrail_summary	object	The summary of the AI Guardrail.
version_number	integer (int64)	The version number for this AI Guardrail version.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_ai_guardrail_versions	select	assistant_id, ai_guardrail_id, region	nextToken, maxResults	Lists AI Guardrail versions.
create_ai_guardrail_version	insert	assistant_id, ai_guardrail_id, region		Creates an Amazon Q in Connect AI Guardrail version.
delete_ai_guardrail_version	delete	assistant_id, ai_guardrail_id, version_number, region		Delete and Amazon Q in Connect AI Guardrail version.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
ai_guardrail_id	string	The identifier of the Amazon Q in Connect AI Guardrail.
assistant_id	string	The identifier of the Amazon Q in Connect assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
region	string	AWS region (default: us-east-1)
version_number	integer (int64)	The version number of the AI Guardrail version to be deleted.
maxResults	integer	The maximum number of results to return per page.
nextToken	string	The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

SELECT examples

list_ai_guardrail_versions

Lists AI Guardrail versions.

SELECT
ai_guardrail_summary,
version_number
FROM aws.qconnect.ai_guardrail_versions
WHERE assistant_id = '{{ assistant_id }}' -- required
AND ai_guardrail_id = '{{ ai_guardrail_id }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;

INSERT examples

create_ai_guardrail_version

Creates an Amazon Q in Connect AI Guardrail version.

INSERT INTO aws.qconnect.ai_guardrail_versions (
modifiedTime,
clientToken,
assistant_id,
ai_guardrail_id,
region
)
SELECT 
'{{ modifiedTime }}',
'{{ clientToken }}',
'{{ assistant_id }}',
'{{ ai_guardrail_id }}',
'{{ region }}'
RETURNING
ai_guardrail,
version_number
;

Manifest

# Description fields are for documentation purposes
- name: ai_guardrail_versions
props:
  - name: assistant_id
    value: "{{ assistant_id }}"
    description: Required parameter for the ai_guardrail_versions resource.
  - name: ai_guardrail_id
    value: "{{ ai_guardrail_id }}"
    description: Required parameter for the ai_guardrail_versions resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the ai_guardrail_versions resource.
  - name: modifiedTime
    value: "{{ modifiedTime }}"
  - name: clientToken
    value: "{{ clientToken }}"

DELETE examples

delete_ai_guardrail_version

Delete and Amazon Q in Connect AI Guardrail version.

DELETE FROM aws.qconnect.ai_guardrail_versions
WHERE assistant_id = '{{ assistant_id }}' --required
AND ai_guardrail_id = '{{ ai_guardrail_id }}' --required
AND version_number = '{{ version_number }}' --required
AND region = '{{ region }}' --required
;