Note:

You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . bedrock-runtime ]

apply-guardrail

Description

The action to apply a guardrail.

For troubleshooting some of the common errors you might encounter when using the ApplyGuardrail API, see Troubleshooting Amazon Bedrock API Error Codes in the Amazon Bedrock User Guide

See also: AWS API Documentation

Synopsis

  apply-guardrail
--guardrail-identifier <value>
--guardrail-version <value>
--source <value>
--content <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--guardrail-identifier (string)

The guardrail identifier used in the request to apply the guardrail.

--guardrail-version (string)

The guardrail version used in the request to apply the guardrail.

--source (string)

The source of data used in the request to apply the guardrail.

Possible values:

  • INPUT
  • OUTPUT

--content (list)

The content details used in the request to apply the guardrail.

(tagged union structure)

The content block to be evaluated by the guardrail.

Note

This is a Tagged Union structure. Only one of the following top level keys can be set: text, image.

text -> (structure)

Text within content block to be evaluated by the guardrail.

text -> (string)

The input text details to be evaluated by the guardrail.

qualifiers -> (list)

The qualifiers describing the text block.

(string)

image -> (structure)

Image within guardrail content block to be evaluated by the guardrail.

format -> (string)

The format details for the file type of the image blocked by the guardrail.

source -> (tagged union structure)

The image source (image bytes) details of the image blocked by the guardrail.

Note

This is a Tagged Union structure. Only one of the following top level keys can be set: bytes.

bytes -> (blob)

The bytes details of the guardrail image source. Object used in independent api.

Shorthand Syntax:

text={text=string,qualifiers=[string,string]},image={format=string,source={bytes=blob}} ...

JSON Syntax:

[
  {
    "text": {
      "text": "string",
      "qualifiers": ["grounding_source"|"query"|"guard_content", ...]
    },
    "image": {
      "format": "png"|"jpeg",
      "source": {
        "bytes": blob
      }
    }
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command's default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

  • json
  • text
  • table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

usage -> (structure)

The usage details in the response from the guardrail.

topicPolicyUnits -> (integer)

The topic policy units processed by the guardrail.

contentPolicyUnits -> (integer)

The content policy units processed by the guardrail.

wordPolicyUnits -> (integer)

The word policy units processed by the guardrail.

sensitiveInformationPolicyUnits -> (integer)

The sensitive information policy units processed by the guardrail.

sensitiveInformationPolicyFreeUnits -> (integer)

The sensitive information policy free units processed by the guardrail.

contextualGroundingPolicyUnits -> (integer)

The contextual grounding policy units processed by the guardrail.

action -> (string)

The action taken in the response from the guardrail.

outputs -> (list)

The output details in the response from the guardrail.

(structure)

The output content produced by the guardrail.

text -> (string)

The specific text for the output content produced by the guardrail.

assessments -> (list)

The assessment details in the response from the guardrail.

(structure)

A behavior assessment of the guardrail policies used in a call to the Converse API.

topicPolicy -> (structure)

The topic policy.

topics -> (list)

The topics in the assessment.

(structure)

Information about a topic guardrail.

name -> (string)

The name for the guardrail.

type -> (string)

The type behavior that the guardrail should perform when the model detects the topic.

action -> (string)

The action the guardrail should take when it intervenes on a topic.

contentPolicy -> (structure)

The content policy.

filters -> (list)

The content policy filters.

(structure)

The content filter for a guardrail.

type -> (string)

The guardrail type.

confidence -> (string)

The guardrail confidence.

filterStrength -> (string)

The filter strength setting for the guardrail content filter.

action -> (string)

The guardrail action.

wordPolicy -> (structure)

The word policy.

customWords -> (list)

Custom words in the assessment.

(structure)

A custom word configured in a guardrail.

match -> (string)

The match for the custom word.

action -> (string)

The action for the custom word.

managedWordLists -> (list)

Managed word lists in the assessment.

(structure)

A managed word configured in a guardrail.

match -> (string)

The match for the managed word.

type -> (string)

The type for the managed word.

action -> (string)

The action for the managed word.

sensitiveInformationPolicy -> (structure)

The sensitive information policy.

piiEntities -> (list)

The PII entities in the assessment.

(structure)

A Personally Identifiable Information (PII) entity configured in a guardrail.

match -> (string)

The PII entity filter match.

type -> (string)

The PII entity filter type.

action -> (string)

The PII entity filter action.

regexes -> (list)

The regex queries in the assessment.

(structure)

A Regex filter configured in a guardrail.

name -> (string)

The regex filter name.

match -> (string)

The regesx filter match.

regex -> (string)

The regex query.

action -> (string)

The region filter action.

contextualGroundingPolicy -> (structure)

The contextual grounding policy used for the guardrail assessment.

filters -> (list)

The filter details for the guardrails contextual grounding filter.

(structure)

The details for the guardrails contextual grounding filter.

type -> (string)

The contextual grounding filter type.

threshold -> (double)

The threshold used by contextual grounding filter to determine whether the content is grounded or not.

score -> (double)

The score generated by contextual grounding filter.

action -> (string)

The action performed by the guardrails contextual grounding filter.

invocationMetrics -> (structure)

The invocation metrics for the guardrail assessment.

guardrailProcessingLatency -> (long)

The processing latency details for the guardrail invocation metrics.

usage -> (structure)

The usage details for the guardrail invocation metrics.

topicPolicyUnits -> (integer)

The topic policy units processed by the guardrail.

contentPolicyUnits -> (integer)

The content policy units processed by the guardrail.

wordPolicyUnits -> (integer)

The word policy units processed by the guardrail.

sensitiveInformationPolicyUnits -> (integer)

The sensitive information policy units processed by the guardrail.

sensitiveInformationPolicyFreeUnits -> (integer)

The sensitive information policy free units processed by the guardrail.

contextualGroundingPolicyUnits -> (integer)

The contextual grounding policy units processed by the guardrail.

guardrailCoverage -> (structure)

The coverage details for the guardrail invocation metrics.

textCharacters -> (structure)

The text characters of the guardrail coverage details.

guarded -> (integer)

The text characters that were guarded by the guardrail coverage.

total -> (integer)

The total text characters by the guardrail coverage.

images -> (structure)

The guardrail coverage for images (the number of images that guardrails guarded).

guarded -> (integer)

The count (integer) of images guardrails guarded.

total -> (integer)

Represents the total number of images (integer) that were in the request (guarded and unguarded).

guardrailCoverage -> (structure)

The guardrail coverage details in the apply guardrail response.

textCharacters -> (structure)

The text characters of the guardrail coverage details.

guarded -> (integer)

The text characters that were guarded by the guardrail coverage.

total -> (integer)

The total text characters by the guardrail coverage.

images -> (structure)

The guardrail coverage for images (the number of images that guardrails guarded).

guarded -> (integer)

The count (integer) of images guardrails guarded.

total -> (integer)

Represents the total number of images (integer) that were in the request (guarded and unguarded).