Création et gestion d'une version d'un garde-corps

Les rubriques suivantes expliquent comment créer une version de votre garde-corps lorsqu'il est prêt à être déployé, comment afficher les informations le concernant et comment le supprimer lorsque vous n'en avez plus besoin.

Note

Les versions de Guardrail ne sont pas considérées comme des ressources et ne possèdent donc pas d'ARN. Les politiques IAM qui s'appliquent à un garde-corps s'appliquent à toutes ses versions.

Création d'une version d'un garde-corps Amazon Bedrock

Pour savoir comment créer une version d'un garde-corps, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Pour créer une version

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Sélectionnez Gardrails dans le volet de navigation de gauche de la console Amazon Bedrock et choisissez le nom du garde-corps que vous souhaitez modifier dans la section Rambardes.

3. Effectuez l'une des étapes suivantes.

   • Dans la section Versions, sélectionnez Créer.

   • Choisissez le brouillon de travail et sélectionnez Créer une version en haut de la page

4. Fournissez une description facultative de la version, puis sélectionnez Créer une version.

5. En cas de succès, vous serez redirigé vers l'écran avec une liste des versions et votre nouvelle version y sera ajoutée.

API

Pour créer une version de votre garde-corps, envoyez une CreateGuardrailVersiondemande. Incluez l'identifiant et une description facultative.

Le format de demande est le suivant :

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


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

Le format de réponse est le suivant :

HTTP/1.1 202
Content-type: application/json

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

Afficher des informations sur les versions de garde-corps Amazon Bedrock

Pour savoir comment afficher les informations relatives à une ou plusieurs versions d'un garde-corps, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Pour consulter les informations relatives à vos versions de garde-corps

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Choisissez Guardrails dans le volet de navigation de gauche. Sélectionnez ensuite un garde-corps dans la section Rambardes.

3. Dans la section Versions, sélectionnez une version pour afficher les informations la concernant.

API

Pour obtenir des informations sur une version de garde-corps, envoyez une GetGuardraildemande en indiquant l'ID et la version du garde-corps. Si vous ne spécifiez aucune version, la réponse renvoie les détails de la DRAFT version.

Le format de demande est le suivant :

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

Le format de réponse est le suivant :

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"
}

Pour répertorier les informations relatives à tous vos garde-corps, envoyez une ListGuardrailsdemande.

Le format de demande est le suivant :

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

• Pour répertorier la DRAFT version de tous vos garde-corps, ne spécifiez pas le guardrailIdentifier champ.

• Pour répertorier toutes les versions d'un garde-corps, spécifiez l'ARN du garde-corps dans le champ. guardrailIdentifier

Vous pouvez définir le nombre maximum de résultats à renvoyer dans une réponse dans le maxResults champ. Si le nombre de résultats est supérieur à ce que vous avez défini, la réponse renvoie un nextToken que vous pouvez envoyer dans une autre demande ListGuardrails afin de voir le lot suivant de résultats.

Le format de réponse est le suivant :

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"
}

Supprimer une version d'un garde-corps Amazon Bedrock

Pour savoir comment supprimer une version d'un garde-corps, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Si vous n'avez plus besoin d'une version, vous pouvez la supprimer en procédant comme suit.

Pour supprimer une version

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Choisissez Guardrails dans le volet de navigation de gauche. Sélectionnez ensuite un garde-corps dans la section Rambardes.

3. Dans la section Versions, sélectionnez la version que vous souhaitez supprimer et choisissez Supprimer.

4. Un modal apparaît pour vous avertir des ressources qui dépendent de cette version du garde-corps. Dissociez la version des ressources avant de la supprimer pour éviter les erreurs.

5. Entrez delete dans le champ de saisie utilisateur et choisissez Supprimer pour supprimer la version du garde-corps.

API

Pour supprimer une version d'un garde-corps, envoyez une DeleteGuardraildemande. Spécifiez l'ARN du garde-corps dans le guardrailIdentifier champ et la version dans le guardrailVersion champ.

Le format de demande est le suivant :

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

Si la suppression est réussie, la réponse renvoie un code d'état HTTP 200.