Crear y administrar una versión de una barandilla

En los temas siguientes se explica cómo crear una versión de la barandilla cuando esté lista para su implementación, ver información sobre ella y eliminarla cuando ya no la necesite.

nota

Las versiones de Guardrail no se consideran recursos y, por lo tanto, no tienen un ARN. Las políticas de IAM que se aplican a una barandilla se aplican a todas sus versiones.

Cree una versión de una barandilla Amazon Bedrock

Para aprender a crear una versión de una barandilla, selecciona la pestaña correspondiente al método que prefieras y sigue los pasos.

Console

Para crear una versión

1. Inicie sesión en la AWS Management Console consola Amazon Bedrock y ábrala en https://console.aws.amazon.com/bedrock/.

2. Seleccione Guardrails en el panel de navegación izquierdo de la consola de Amazon Bedrock y elija el nombre de la barandilla que desee editar en la sección Guardrails.

3. Realice uno de los siguientes pasos.

   • En la sección Versiones, selecciona Crear.

   • Elija el borrador de trabajo y seleccione Crear versión en la parte superior de la página

4. Proporcione una descripción opcional para la versión y, a continuación, seleccione Crear versión.

5. Si tiene éxito, se le redirigirá a la pantalla con una lista de versiones y se agregará allí la nueva versión.

API

Para crear una versión de su barandilla, envíe una CreateGuardrailVersionsolicitud. Incluye el ID y una descripción opcional.

El formato de la solicitud es el siguiente:

POST /guardrails/guardrailIdentifier HTTP/1.1
Content-type: application/json


{
  "clientRequestToken": "string",
  "description": "string"
}

El formato de respuesta es el siguiente:

HTTP/1.1 202
Content-type: application/json

{
   "guardrailId": "string",
   "version": "string"
}

Ver información sobre las versiones de barandillas Amazon Bedrock

Para obtener información sobre una o varias versiones de una barandilla, seleccione la pestaña correspondiente al método que prefiera y siga los pasos.

Console

Para ver información sobre las versiones de su barandilla

1. Inicie sesión en la AWS Management Console consola Amazon Bedrock y ábrala en https://console.aws.amazon.com/bedrock/.

2. Seleccione Guardrails en el panel de navegación izquierdo. A continuación, seleccione una barandilla en la sección Barandillas.

3. En la sección Versiones, seleccione una versión para ver información sobre ella.

API

Para obtener información sobre una versión de barandilla, envíe una GetGuardrailsolicitud e incluya el identificador y la versión de la barandilla. Si no especificas una versión, la respuesta devuelve los detalles de la versión. DRAFT

El formato de solicitud es el siguiente:

GET /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

El siguiente es el formato de respuesta:

HTTP/1.1 200
Content-type: application/json

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicy": { 
      "filters": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "pattern": "string",
        "action": "string"
      }
    ]
  },
   "createdAt": "string",
   "description": "string",
   "failureRecommendations": [ "string" ],
   "guardrailArn": "string",
   "guardrailId": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "status": "string",
   "statusReasons": [ "string" ],
   "topicPolicy": { 
      "topics": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   },
   "updatedAt": "string",
   "version": "string"
}

Para obtener información sobre todas sus barandillas, envíe una ListGuardrailssolicitud.

El formato de solicitud es el siguiente:

GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1

• Para mostrar la DRAFT versión de todas tus barandillas, no especifiques el guardrailIdentifier campo.

• Para ver todas las versiones de una barandilla, especifique el ARN de la barandilla en el campo. guardrailIdentifier

Puede establecer el número máximo de resultados que se devolverán en una respuesta en el campo. maxResults Si hay más resultados que la cantidad que ha establecido, la respuesta devuelve un nextToken que puede enviar en otra solicitud ListGuardrails para ver el siguiente lote de resultados.

El formato de respuesta es el siguiente:

HTTP/1.1 200
Content-type: application/json

{
   "guardrails": [ 
      { 
         "arn": "string",
         "createdAt": "string",
         "description": "string",
         "id": "string",
         "name": "string",
         "status": "string",
         "updatedAt": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}

Eliminar una versión de una barandilla Amazon Bedrock

Para saber cómo eliminar una versión de una barandilla, selecciona la pestaña correspondiente al método que prefieras y sigue los pasos.

Console

Si ya no necesitas una versión, puedes eliminarla siguiendo estos pasos.

Para eliminar una versión

1. Inicie sesión en la AWS Management Console consola Amazon Bedrock y ábrala en https://console.aws.amazon.com/bedrock/.

2. Seleccione Guardrails en el panel de navegación izquierdo. A continuación, seleccione una barandilla en la sección Barandillas.

3. En la sección Versiones, seleccione la versión que desee eliminar y elija Eliminar.

4. Aparece un modal para advertirle sobre los recursos que dependen de esta versión de la barandilla. Desasocie la versión de los recursos antes de eliminarla para evitar errores.

5. Ingrese delete en el campo de entrada del usuario y elija Eliminar para eliminar la versión de guardarrail.

API

Para eliminar una versión de una barandilla, envíe una solicitud. DeleteGuardrail Especifique el ARN de la barandilla en el guardrailIdentifier campo y la versión en el campo. guardrailVersion

El formato de solicitud es el siguiente:

DELETE /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

Si la eliminación se realiza correctamente, la respuesta devuelve un código de estado HTTP 200.