Crea e gestisci una versione di un guardrail

Nei seguenti argomenti viene illustrato come creare una versione del guardrail quando è pronta per l'implementazione, visualizzare le relative informazioni ed eliminarla quando non è più necessaria.

Nota

Le versioni di Guardrail non sono considerate risorse e quindi non dispongono di un ARN. Le politiche IAM che si applicano a un guardrail si applicano a tutte le sue versioni.

Crea una versione di un guardrail Amazon Bedrock

Per imparare a creare una versione di un guardrail, seleziona la scheda corrispondente al metodo che preferisci e segui i passaggi.

Console

Per creare una versione

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Seleziona Guardrails dal riquadro di navigazione a sinistra nella console Amazon Bedrock e scegli il nome del guardrail che desideri modificare nella sezione Guardrails.

3. Esegui una delle seguenti operazioni.

   • Nella sezione Versioni, seleziona Crea.

   • Scegli la bozza di lavoro e seleziona Crea versione nella parte superiore della pagina

4. Fornisci una descrizione opzionale per la versione, quindi seleziona Crea versione.

5. In caso di successo, verrai reindirizzato alla schermata con un elenco di versioni con la nuova versione aggiunta.

API

Per creare una versione del tuo guardrail, invia una CreateGuardrailVersionrichiesta. Includi l'ID e una descrizione opzionale.

Il formato della richiesta è il seguente:

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


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

Il formato di risposta è il seguente:

HTTP/1.1 202
Content-type: application/json

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

Visualizza informazioni sulle versioni del guardrail di Amazon Bedrock

Per imparare a visualizzare le informazioni su una o più versioni di un guardrail, seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

Console

Per visualizzare le informazioni sulle tue versioni di guardrail

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Scegli Guardrails dal riquadro di navigazione a sinistra. Quindi, seleziona un guardrail nella sezione Guardrails.

3. Nella sezione Versioni, seleziona una versione per visualizzarne le informazioni.

API

Per ottenere informazioni su una versione del guardrail, invia una GetGuardrailrichiesta e includi l'ID e la versione del guardrail. Se non specifichi una versione, la risposta restituisce i dettagli relativi alla DRAFT versione.

Di seguito è riportato il formato della richiesta:

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

Di seguito è riportato il formato della risposta:

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

Per elencare le informazioni su tutti i tuoi guardrail, invia una ListGuardrailsrichiesta.

Di seguito è riportato il formato della richiesta:

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

• Per elencare la DRAFT versione di tutti i tuoi guardrail, non specificare il guardrailIdentifier campo.

• Per elencare tutte le versioni di un guardrail, specificare l'ARN del guardrail nel campo. guardrailIdentifier

È possibile impostare il numero massimo di risultati da restituire in una risposta nel campo. maxResults Se i risultati sono superiori al numero impostato, la risposta restituisce un nextToken che puoi inviare in un'altra richiesta ListGuardrails per visualizzare il successivo batch di risultati.

Di seguito è riportato il formato della risposta:

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

Eliminare una versione di un guardrail Amazon Bedrock

Per sapere come eliminare una versione di un guardrail, seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

Console

Se non hai più bisogno di una versione, puoi eliminarla con i seguenti passaggi.

Per eliminare una versione 1.0

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Scegli Guardrails dal riquadro di navigazione a sinistra. Quindi, seleziona un guardrail nella sezione Guardrails.

3. Nella sezione Versioni, seleziona la versione che desideri eliminare e scegli Elimina.

4. Viene visualizzato un modale per avvisare l'utente delle risorse che dipendono da questa versione del guardrail. Dissocia la versione dalle risorse prima di eliminarla per evitare errori.

5. Entra delete nel campo di immissione utente e scegli Elimina per eliminare la versione del guardrail.

API

Per eliminare una versione di un guardrail, invia una DeleteGuardrailrichiesta. Specificare l'ARN del guardrail nel guardrailIdentifier campo e la versione nel campo. guardrailVersion

Di seguito è riportato il formato della richiesta:

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

Se l'eliminazione ha esito positivo, la risposta restituisce un codice di stato HTTP 200.