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

Minta akses ke model

Akses ke semua model dasar 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 InvokeModel atau 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 dasar Amazon Bedrock diaktifkan secara default dengan izin AWS Marketplace yang benar di semua Wil AWS ayah komersial. Untuk akses terprogram ke model pihak ketiga, lihatKelola akses model menggunakan SDK dan CLI.

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

Anda dapat mengelola izin akses model dengan membuat kebijakan IAM khusus. Untuk mengubah akses ke model dasar 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 Anda 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 mengambil 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 model diaktifkan, Anda dapat memanggil model tanpa memerlukan AWS Marketplace izin. 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 dasar 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 yang dilampirkan yang memungkinkanaws-marketplace:Subscribe.

Untuk informasi tentang cara membuat kebijakan, lihat Mulai cepat.

Untuk aws-marketplace:Subscribe tindakan saja, Anda dapat menggunakan kunci 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 ke pengguna yang menolak aws-marketplace:Subscribe tindakan dan lingkup 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 mencakupi Resource bidang ke ARN model pondasi.

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

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. Perhatikan 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 menyediakan OfferToken yang digunakan untuk membuat akses model di 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 Anthropic] Masukkan 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 AWS organisasi di semua wilayah komersial, dengan pengecualian wilayah opt-in di mana formulir ini perlu diisi lagi. Persyaratan ini tidak berlaku untuk model Antropik yang diakses melalui bedrock-mantle titik akhir.

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 dasar

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 dasar Amazon Bedrock di AWS GovCloud (AS)

Akun AWS GovCloud (AS) ditautkan secara satu-ke-satu dengan 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 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 AWS komersial menggunakan 2 cara:

Mengaktifkan akses model untuk GovCloud akun AWS

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