Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Akses model fondasi Amazon Bedrock

Akses ke semua model foundation Amazon Bedrock diaktifkan secara default dengan izin AWS Marketplace yang benar. Untuk memulai, cukup pilih model dari katalog model di konsol Amazon Bedrock dan buka di taman bermain atau panggil model menggunakan operasi API InvokeModelatau Converse. Untuk informasi tentang berbagai model yang didukung di Amazon Bedrock, lihat informasi model dasar Amazon Bedrock. Untuk informasi tentang harga model, lihat Harga Amazon Bedrock.

Akses ke semua model foundation Amazon Bedrock diaktifkan secara default dengan izin AWS Marketplace yang benar di semua wilayah AWS komersial. Untuk akses program ke model pihak ketiga, lihatKelola akses model menggunakan SDK dan CLI.

Berikan izin IAM untuk meminta akses ke model foundation Amazon Bedrock dengan ID produk

Anda dapat mengelola izin akses model dengan membuat kebijakan IAM kustom. Untuk mengubah akses ke model foundation Amazon Bedrock, Anda harus terlebih dahulu melampirkan kebijakan IAM berbasis identitas dengan AWS Marketplace tindakan berikut ke peran IAM yang memungkinkan akses ke Amazon Bedrock.

Saat pertama kali memanggil model tanpa server Amazon Bedrock yang disajikan dari AWS Marketplace akun, Bedrock mencoba mengaktifkan model untuk akun Anda secara otomatis. Agar pengaktifan otomatis ini berfungsi, AWS Marketplace izin diperlukan.

Jika Anda tidak dapat menerima AWS Marketplace izin, seseorang dengan AWS Marketplace izin harus mengaktifkan model untuk akun sebagai langkah satu kali (baik secara manual atau melalui pengaktifan otomatis). Setelah diaktifkan, semua pengguna di akun dapat memanggil model tanpa memerlukan izin AWS Marketplace . Pengguna tidak memerlukan izin AWS Marketplace berlangganan untuk memanggil model setelah diaktifkan. Izin ini hanya diperlukan saat pertama kali model digunakan di akun.

Akses ke model foundation tanpa server Amazon Bedrock dengan ID produk dikendalikan oleh tindakan IAM berikut:

Untuk identitas IAM untuk meminta akses ke model dengan ID produk

Identitas harus memiliki kebijakan terlampir yang memungkinkanaws-marketplace:Subscribe.

Untuk informasi tentang membuat kebijakan, lihat Saya sudah memiliki Akun AWS.

Hanya untuk aws-marketplace:Subscribe tindakan, Anda dapat menggunakan tombol aws-marketplace:ProductId kondisi untuk membatasi langganan ke model tertentu.

Pilih bagian untuk melihat contoh kebijakan IAM untuk kasus penggunaan tertentu:

Mencegah identitas meminta akses ke model dengan ID produk

Untuk mencegah entitas IAM meminta akses ke model tertentu yang memiliki ID produk, lampirkan kebijakan IAM kepada pengguna yang menolak aws-marketplace:Subscribe tindakan dan cakupan Condition bidang ke ID produk model.

Misalnya, Anda dapat melampirkan kebijakan berikut ke identitas untuk mencegahnya berlangganan Anthropic Claude 3.5 Sonnet model:

JSON

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

Mencegah identitas menggunakan model setelah akses telah diberikan

Jika identitas IAM telah diberikan akses ke model, Anda dapat mencegah penggunaan model dengan menolak semua tindakan Amazon Bedrock dan melingkupi bidang Resource ke ARN model pondasi.

Misalnya, Anda dapat melampirkan kebijakan berikut ke identitas untuk mencegahnya menggunakan Anthropic Claude 3.5 Sonnet model di semua AWS Wilayah:

JSON

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

Kelola akses model menggunakan SDK dan CLI

Akses model dapat dikelola menggunakan SDK selain memanggil model. Langkah-langkah di bawah ini dapat digunakan untuk create/delete memodelkan akses serta memeriksa apakah akses sudah ada atau tidak. Catatan ini hanya berlaku untuk model pihak ketiga.

Ikuti langkah-langkah ini untuk mengelola akses model secara terprogram:

Prasyarat

Langkah 1: Daftar penawaran perjanjian model pondasi

Gunakan API ini untuk mendapatkan penawaran perjanjian untuk model tertentu. Ini akan memberikan OfferToken yang digunakan untuk membuat akses model pada langkah selanjutnya.

Dokumentasi

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

Langkah 2: [Diperlukan satu kali hanya untuk model Antropik] Letakkan kasus penggunaan untuk pengguna pertama kali

Digunakan untuk menempatkan formulir kasus penggunaan pengguna pertama kali yang diperlukan hanya untuk model Antropik. Ini adalah prasyarat untuk mendapatkan akses ke model Antropik di akun. API ini hanya diperlukan satu kali per akun atau per organisasi AWS di semua wilayah komersial, kecuali wilayah keikutsertaan di mana formulir ini perlu diisi kembali.

Dokumentasi

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)

Untuk CLI, data formulir adalah json yang dikodekan base64 dari formulir di bawah ini.

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

Langkah 3: Buat perjanjian model pondasi

Digunakan untuk membuat perjanjian (akses) untuk model pondasi. Gunakan token penawaran dan modelID dari atas.

Dokumentasi

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)

Langkah 4: Dapatkan ketersediaan model pondasi

Digunakan untuk memeriksa apakah model pondasi saat ini memiliki akses atau tidak. Gunakan modelID dari atas.

Dokumentasi

AWS CLI

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

Python

model_availability_response = bedrock_client.get_foundation_model_availability(modelId=model_id)

Respon yang diharapkan

agreementAvailability- AVAILABLE jika akses ada, NOT_AVAILABLE apakah akses tidak ada.

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

[Opsional] Langkah 5: Hapus perjanjian model pondasi

Digunakan untuk menghapus perjanjian model dasar (akses). Gunakan modelID dari atas.

Dokumentasi

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)

Akses model foundation Amazon Bedrock di AWS GovCloud (AS)

Akun AWS GovCloud (AS) ditautkan one-to-one berdasarkan akun komersial AWS standar. Akun komersial tertaut ini digunakan untuk penagihan, akses layanan, tujuan dukungan, dan akses ke Amazon Bedrock Model Marketplace. Untuk informasi selengkapnya tentang hubungan antara GovCloud dan akun komersial, lihat Penautan akun standar di AWS GovCloud (AS).

Untuk model pihak ketiga, akses model harus diaktifkan di kedua akun komersial AWS yang ditautkan selain GovCloud akun AWS. Untuk model yang disediakan oleh Amazon Bedrock, akses model hanya perlu diaktifkan di GovCloud akun. Ini adalah proses manual.

Mengaktifkan akses model untuk AWS GovCloud di akun komersial AWS tertaut (hanya untuk model pihak ketiga)

Akses model dapat diaktifkan di akun komersial AWS menggunakan 2 cara:

Mengaktifkan akses model untuk akun AWS GovCloud

Di AWS GovCloud (AS), Anda menggunakan halaman akses Model di konsol Amazon Bedrock di us-gov-west-1 wilayah tersebut untuk mengaktifkan model foundation seperti yang dijelaskan di bawah ini: