Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Richiedi l'accesso ai modelli

L’accesso a tutti i modelli di fondazione Amazon Bedrock è abilitato per impostazione predefinita con le autorizzazioni AWS Marketplace corrette. Per iniziare, è sufficiente selezionare un modello dal catalogo dei modelli nella console Amazon Bedrock e aprirlo nel playground o richiamare il modello utilizzando le operazioni dell'API Converse InvokeModel o Converse. Per informazioni sui diversi modelli supportati in Amazon Bedrock, consulta Informazioni sul modello di fondazione Amazon Bedrock. Per ulteriori informazioni sul modello dei prezzi, consulta Prezzi di Amazon Bedrock.

L'accesso a tutti i modelli Amazon Bedrock Foundation è abilitato di default con le autorizzazioni AWS Marketplace corrette in tutte le regioni commerciali. AWS Per l'accesso programmatico a modelli di terze parti, consulta. Gestisci l'accesso al modello utilizzando SDK e CLI

Concedi le autorizzazioni IAM per richiedere l’accesso ai modelli di fondazione Amazon Bedrock con un ID prodotto

Puoi gestire le autorizzazioni di accesso al modello creando policy IAM personalizzate. Per modificare l'accesso ai modelli base di Amazon Bedrock, devi prima allegare una policy IAM basata sull'identità con AWS Marketplace le seguenti azioni al ruolo IAM che consente l'accesso ad Amazon Bedrock.

Quando richiami per la prima volta un modello serverless di Amazon Bedrock fornito da AWS Marketplace un account, Bedrock tenta di abilitare automaticamente il modello per il tuo account. Affinché questa attivazione automatica funzioni, sono necessarie le autorizzazioni. AWS Marketplace

Se non puoi pretendere l' AWS Marketplace autorizzazione, qualcuno con AWS Marketplace le autorizzazioni deve abilitare il modello per l'account in un'unica operazione (manualmente o tramite attivazione automatica). Dopo aver abilitato il modello, puoi richiamarlo senza bisogno di autorizzazioni. AWS Marketplace Gli utenti non necessitano delle autorizzazioni di AWS Marketplace abbonamento per richiamare i modelli dopo che sono stati abilitati. Queste autorizzazioni sono richieste solo la prima volta che un modello viene utilizzato in un account.

L’accesso ai modelli di fondazione serverless di Amazon Bedrock con un ID di prodotto è controllato dalle seguenti azioni IAM:

Affinché un’identità IAM richieda l’accesso ai modelli con un ID prodotto

L’identità deve avere una policy allegata che abiliti aws-marketplace:Subscribe.

Per informazioni sulla creazione della policy, consulta Guida introduttiva Quickstart.

Solo per questa azione aws-marketplace:Subscribe, puoi utilizzare il tasto di condizione aws-marketplace:ProductId per limitare la sottoscrizione a modelli specifici.

Seleziona una sezione per visualizzare esempi di policy IAM per un caso d’uso specifico:

Impedisci a un’identità di richiedere l’accesso a un modello con un ID prodotto

Per impedire a un’entità IAM di richiedere l’accesso a un modello specifico dotato di un ID prodotto, allega all’utente una policy IAM che neghi l’azione aws-marketplace:Subscribe e definisca l’ambito del campo Condition per l’ID prodotto del modello.

Ad esempio, puoi collegare la seguente policy a un’identità per impedirle di effettuare la sottoscrizione al modello Anthropic Claude 3.5 Sonnet:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "aws-marketplace:Subscribe"
            ],
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "aws-marketplace:ProductId": [
                        "prod-m5ilt4siql27k"
                    ]
                }
            }
        }
    ]
}

Impedire a un’identità di utilizzare un modello dopo che l’accesso è già stato concesso

Se a un’identità IAM è già stato concesso l’accesso a un modello, puoi impedirne l’utilizzo negando tutte le azioni di Amazon Bedrock e definendo l’ambito del campo Resource all’ARN del modello di fondazione.

Ad esempio, puoi allegare la seguente policy a un'identità per impedirle di utilizzare il Anthropic Claude 3.5 Sonnet modello in tutte le AWS regioni:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "bedrock:*"
            ],
            "Resource": [
                "arn:aws:bedrock:*::foundation-model/anthropic.claude-3-5-sonnet-20240620-v1:0"
            ]
        }
    ]
}

Gestisci l'accesso al modello utilizzando SDK e CLI

L'accesso al modello può essere gestito tramite SDK oltre a richiamare il modello. I passaggi seguenti possono essere utilizzati per create/delete modellare l'accesso e verificare se l'accesso esiste già o meno. Nota che questo è applicabile solo ai modelli di terze parti.

Segui questi passaggi per gestire l'accesso al modello in modo programmatico:

Prerequisiti

Fase 1: Elencare le offerte relative al modello di base

Usa questa API per ottenere le offerte di contratto per un particolare modello. Ciò fornirà l'OfferToken utilizzato per creare l'accesso al modello nei passaggi successivi.

Documentazione

AWS CLI

aws bedrock list-foundation-model-agreement-offers --model-id <ModelId>

Python

# Placeholder for modelId
model_id = "<enter model id here>" 
# Placeholder for offerId
offer_id = "<enter offer id here>"
try:
    # offerType= "ALL" means both public and private offers, if offerType isn't defined, the default would be "PUBLIC"
    model_agreement_offers_response = bedrock_client.list_foundation_model_agreement_offers(modelId=model_id,offerType="ALL")
    print(model_agreement_offers_response)
except ClientError as e:
    print(f"Failed to list foundation model offers for modelId: {model_id} due to the following error: {e}")

Passaggio 2: [Richiesto una tantum solo per i modelli Anthropic] Specifica il caso d'uso per l'utente alle prime armi

Utilizzato per inserire il modulo del caso d'uso per la prima volta richiesto solo per i modelli Anthropic. Questo è un prerequisito per accedere ai modelli Anthropic nell'account. Questa API è richiesta solo una volta per account o per AWS organizzazione in tutte le aree commerciali, ad eccezione delle regioni con opt-in in cui è necessario compilare nuovamente questo modulo. Questo requisito non si applica ai modelli Anthropic a cui si accede tramite l'bedrock-mantleendpoint.

Documentazione

AWS CLI

aws bedrock put-use-case-for-model-access \
  --form-data <Base64EncodedFormData>

Python

# Placeholder for form data, replace the names
COMPANY_NAME = "<enter company name here>"
COMPANY_WEBSITE = "<enter company website here>"
INTENDED_USERS = "1" #for external users
INDUSTRY_OPTION = "<enter industry option here>"
OTHER_INDUSTRY_OPTION = "<enter other industry option here>"
USE_CASES = "<enter use cases here>"
form_data = {
    "companyName": COMPANY_NAME,
    "companyWebsite": COMPANY_WEBSITE,
    "intendedUsers": INTENDED_USERS,
    "industryOption": INDUSTRY_OPTION,
    "otherIndustryOption": OTHER_INDUSTRY_OPTION,
    "useCases": USE_CASES
}
form_data_json = json.dumps(form_data)
model_access_response = bedrock_client.put_use_case_for_model_access(formData=form_data_json)

Per la CLI, i dati del modulo sono in formato json codificato in base64 del modulo seguente.

{
    "companyName": COMPANY_NAME,
    "companyWebsite": COMPANY_WEBSITE,
    "intendedUsers": INTENDED_USERS,
    "industryOption": INDUSTRY_OPTION,
    "otherIndustryOption": OTHER_INDUSTRY_OPTION,
    "useCases": USE_CASES
}

Fase 3: Creare un contratto modello di base

Utilizzato per creare un accordo (accesso) per il modello di base. Usa il token di offerta e il ModelID indicati sopra.

Documentazione

AWS CLI

aws bedrock create-foundation-model-agreement \
  --model-id <ModelId> \
  --offer-token <OfferToken>

Python

offer_token= ''

for agreement_offer in model_agreement_offers_response['offers']:
    if  agreement_offer['offerId'] == offer_id:
            
            offer_token = agreement_offer['offerToken']
            print(f"offer token found. Offer token is {offer_token}")
            break


if(not offer_token):
    print(f"Offer token for  modelId: {model_id} is not found")
    
foundation_model_agreement_reponse = bedrock_client.create_foundation_model_agreement(offerToken= offer_token , modelId= model_id)

Fase 4: Ottieni la disponibilità del modello di base

Utilizzato per verificare se il modello di base è attualmente accessibile o meno. Usa il ModelID indicato sopra.

Documentazione

AWS CLI

aws bedrock get-foundation-model-availability \
  --model-id <ModelId>

Python

model_availability_response = bedrock_client.get_foundation_model_availability(modelId=model_id)

Risposta prevista

agreementAvailability- AVAILABLE se l'accesso NOT_AVAILABLE esiste, l'accesso non esiste.

{
  "modelId": "anthropic.claude-sonnet-4-20250514-v1:0",
  "agreementAvailability": {
    "status": "AVAILABLE"
  },
  "authorizationStatus": "AUTHORIZED",
  "entitlementAvailability": "AVAILABLE",
  "regionAvailability": "AVAILABLE"
}

[Facoltativo] Fase 5: Eliminare il contratto modello di base

Utilizzato per eliminare il contratto del modello di base (accesso). Usa il ModelID indicato sopra.

Documentazione

AWS CLI

aws bedrock delete-foundation-model-agreement \
  --model-id <ModelId>

Python

delete_foundation_model_agreement_reponse = bedrock_client.delete_foundation_model_agreement(modelId= model_id)

Accedi ai modelli base di Amazon Bedrock in AWS (Stati Uniti) GovCloud

Gli account AWS GovCloud (Stati Uniti) sono collegati uno a uno agli account commerciali AWS standard. Questo account commerciale collegato viene utilizzato per la fatturazione, l'accesso ai servizi, il supporto e l'accesso ad Amazon Bedrock Model Marketplace. Per ulteriori informazioni sulla relazione tra GovCloud gli account commerciali, consulta Collegamento degli account standard in AWS GovCloud (Stati Uniti).

Per i modelli di terze parti, l'accesso ai modelli deve essere abilitato sia nell'account commerciale AWS collegato che nell' GovCloud account AWS. Per i modelli forniti da Amazon Bedrock, l'accesso ai modelli deve essere abilitato solo nell' GovCloud account. Questo è un processo manuale.

Abilitazione dell'accesso ai modelli per AWS GovCloud nell'account commerciale AWS collegato (solo per modelli di terze parti)

L'accesso ai modelli può essere abilitato in un account AWS commerciale in 2 modi:

Abilitazione dell'accesso al modello per l' GovCloud account AWS

In AWS GovCloud (Stati Uniti), utilizzi la pagina di accesso ai modelli nella console Amazon Bedrock nella us-gov-west-1 regione per abilitare i modelli di base come descritto di seguito: