Kuota di Amazon Cognito

Amazon Cognito memiliki kuota default, sebelumnya disebut sebagai batas, untuk jumlah maksimum operasi yang dapat Anda lakukan di akun Anda. Amazon Cognito juga memiliki kuota untuk jumlah dan ukuran maksimum sumber daya Amazon Cognito.

Setiap kuota Amazon Cognito mewakili volume maksimum permintaan dalam satu Wilayah AWS dalam satu Akun AWS. Misalnya, aplikasi Anda dapat membuat permintaan API hingga tingkat Kuota Def ault (RPS) untuk UserAuthentication operasi terhadap semua kumpulan pengguna Anda di AS Timur (Virginia Utara). Aplikasi Anda di Asia Pasifik (Tokyo) dapat menghasilkan volume permintaan yang sama terhadap semua kumpulan pengguna Anda di Wilayah mereka sendiri. AWS hanya dapat memberikan permintaan kenaikan kuota di satu Wilayah pada satu waktu. Peningkatan kuota yang berhasil di AS Timur (Virginia Utara) tidak berpengaruh pada tingkat permintaan maksimum Anda di Asia Pasifik (Tokyo).

Memahami kuota tarif permintaan API

Kategorisasi kuota

Amazon Cognito memberlakukan tingkat permintaan maksimum untuk operasi API. Untuk informasi selengkapnya tentang operasi API yang disediakan Amazon Cognito, lihat panduan referensi API untuk kumpulan pengguna dan kumpulan identitas. Untuk kumpulan pengguna, operasi ini dikelompokkan ke dalam kategori kasus penggunaan umum seperti UserAuthentication atauUserCreation. Untuk daftar operasi API kumpulan pengguna berdasarkan kategori, lihatPengguna Amazon Cognito mengumpulkan kategori operasi API dan kuota tarif permintaan.

Di konsol Kuota Layanan, Anda dapat melacak penggunaan kuota berdasarkan kumpulan pengguna kategori dan kumpulan identitas.Jika tingkat permintaan kumpulan pengguna Amazon Cognito Anda atau melebihi kuota, Anda dapat membeli kapasitas tambahan. Anda dapat melacak penggunaan kuota kumpulan pengguna berdasarkan kategori dan peningkatan kuota pembelian di konsol Kuota Layanan.

Kuota operasi didefinisikan sebagai jumlah maksimum permintaan per detik (RPS) untuk semua operasi dalam kategori. Layanan kolam pengguna Amazon Cognito menerapkan kuota untuk semua operasi di setiap kategori. Misalnya, kategori UserCreation mencakup empat operasi:SignUp,ConfirmSignUp,AdminCreateUser, danAdminConfirmSignUp. Ini dialokasikan dengan kuota gabungan 50 RPS. Jika beberapa operasi berlangsung pada saat yang sama, setiap operasi dalam kategori ini dapat memanggil hingga 50 RPS secara terpisah atau digabungkan.

Pengguna Amazon Cognito mengumpulkan operasi API dengan penanganan tarif permintaan khusus

Kuota operasi diukur dan diberlakukan untuk permintaan total gabungan di tingkat kategori, kecuali untuk RespondToAuthChallenge operasi AdminRespondToAuthChallenge dan, di mana aturan penanganan khusus diterapkan.

UserAuthenticationKategori ini mencakup empat operasi di API kumpulan pengguna Amazon Cognito:AdminInitiateAuth,, InitiateAuthAdminRespondToAuthChallenge, danRespondToAuthChallenge. Selain itu, otentikasi pengguna di UI yang dihosting berkontribusi pada kuota ini. Operasi InitiateAuth dan AdminInitiateAuth diukur dan diberlakukan per kuota kategori. Operasi pencocokan RespondToAuthChallenge dan AdminRespondToAuthChallenge tunduk pada kuota terpisah yang tiga kali batas UserAuthentication kategori. Kuota yang ditingkatkan ini mengakomodasi beberapa tantangan otentikasi yang disiapkan di aplikasi Anda. Kuota cukup untuk mencakup sebagian besar kasus penggunaan. Setelah aplikasi Anda memberikan hingga tiga tanggapan terhadap tantangan otentikasi, permintaan tambahan diperhitungkan dalam kuota UserAuthentication kategori. Multi-factor otentikasi (MFA), otentikasi perangkat, dan otentikasi khusus adalah semua contoh prompt tantangan yang mungkin Anda rekayasa ke kumpulan pengguna Anda.

Misalnya, jika kuota Anda untuk UserAuthentication kategori adalah 80 RPS, Anda dapat menelepon RespondToAuthChallenge atau AdminRespondToAuthChallenge dengan tarif hingga 240 RPS (3 * 80 RPS). Jika kumpulan pengguna Anda meminta empat putaran tantangan per otentikasi dan 70 pengguna masuk per detik, maka totalnya RespondToAuthChallenge adalah 280 RPS (70 x 4), yaitu 40 RPS di atas kuota. Tambahan 40 RPS ditambahkan ke 70 InitiateAuth panggilan, membuat total penggunaan UserAuthentication kategori 110 RPS (40 + 70). Karena nilai ini melebihi kuota kategori yang ditetapkan pada 80 RPS dengan 30 RPS, Amazon Cognito membatasi permintaan dari aplikasi Anda.

Pengguna aktif bulanan

Saat Amazon Cognito menghitung tagihan kumpulan pengguna, Amazon akan mengenakan tarif untuk setiap pengguna aktif bulanan (MAU). Pertimbangkan jumlah MAU Anda saat ini dan yang diproyeksikan dalam perencanaan Anda untuk permintaan peningkatan kuota. Pengguna dihitung sebagai MAU jika, dalam satu bulan kalender, ada operasi identitas yang terkait dengan pengguna tersebut. Saat Anda menautkan pengguna federasi ke pengguna lokal, dengan federasi SAML atau OIDC, pengguna lokal akan dihitung sebagai direktori perusahaan MAU atauEnterpriseMAU, terlepas dari apakah pengguna masuk secara langsung atau melalui federasi. Lihat Harga Amazon Cognito untuk informasi selengkapnya.

Anda tidak dikenakan biaya untuk sesi tambahan oleh pengguna aktif mana pun, atau untuk pengguna mana pun yang tidak aktif dalam satu bulan kalender. Dalam bulan di mana Anda telah mengubah paket fitur kumpulan pengguna di antara opsi Lite, Essentials, dan Plus yang tersedia, tagihan Anda untuk bulan tersebut dihitung dari jumlah pengguna aktif bulanan (MAU) di setiap tingkat, dengan setiap MAU ditetapkan ke tingkat yang ditetapkan dengan harga tertinggi saat pengguna aktif. Contoh:

Dalam skenario ini, pengguna A dan pengguna B adalah Plus MAU dan pengguna C adalah MAU Essentials.

Untuk informasi selengkapnya, lihat Paket fitur kumpulan pengguna.

Mengelola kuota tingkat permintaan API

Mengidentifikasi persyaratan kuota

Untuk menghitung persyaratan kuota, tentukan berapa banyak pengguna aktif yang akan berinteraksi dengan aplikasi Anda dalam jangka waktu tertentu. Misalnya, jika Anda mengharapkan aplikasi Anda masuk rata-rata satu juta pengguna aktif dalam periode delapan jam, maka Anda harus dapat mengotentikasi rata-rata 35 pengguna per detik.

Selain itu, jika Anda berasumsi bahwa sesi pengguna rata-rata adalah dua jam, dan Anda mengonfigurasi token untuk kedaluwarsa setelah satu jam, setiap pengguna harus menyegarkan token mereka sekali selama sesi mereka. Kuota rata-rata yang diperlukan untuk UserAuthentication kategori untuk mendukung beban ini adalah 70 RPS.

Jika Anda mengasumsikan rasio puncak-ke-rata-rata 3:1 dengan memperhitungkan varians frekuensi masuk pengguna selama periode delapan jam, maka Anda memerlukan kuota 200 RPS yang diinginkan. UserAuthentication

Optimalkan tingkat permintaan untuk batas kuota

Karena peningkatan batas tarif API menambah biaya pada AWS tagihan Anda, pertimbangkan penyesuaian model penggunaan sebelum meminta kenaikan kuota. Berikut ini adalah beberapa contoh arsitektur aplikasi yang mengoptimalkan tarif permintaan.

Untuk informasi selengkapnya tentang bekerja dengan tarif permintaan API di AWS, lihat M engelola dan memantau pelambatan API dalam beban kerja Anda. Untuk informasi tentang mengoptimalkan operasi Amazon Cognito yang menambah biaya ke AWS tagihan Anda, lihatMengelola biaya.

Lacak penggunaan kuota

Amazon Cognito menghasilkan CallCount dan ThrottleCount metrik di Amazon CloudWatch untuk setiap kategori operasi API di tingkat akun. Anda dapat menggunakan CallCount untuk melacak jumlah total panggilan yang dilakukan pelanggan terkait dengan suatu kategori. Anda dapat menggunakan ThrottleCount untuk melacak jumlah total panggilan yang di-throttle yang terkait dengan suatu kategori. Anda dapat menggunakan metrik CallCount dan ThrottleCount dengan statistik Sum untuk menghitung jumlah total panggilan dalam suatu kategori. Untuk informasi selengkapnya, lihat metrik CloudWatch penggunaan.

Saat memantau kuota layanan, pemanfaatan adalah persentase kuota layanan yang digunakan. Misalnya, jika nilai kuota adalah 200 sumber daya, dan 150 sumber daya digunakan, pemanfaatannya adalah 75%. Penggunaan adalah jumlah sumber daya atau operasi yang digunakan untuk kuota layanan.

Melacak penggunaan melalui CloudWatch metrik

Anda dapat melacak dan mengumpulkan metrik pemanfaatan kumpulan pengguna Amazon Cognito dengan CloudWatch. CloudWatchDasbor menampilkan metrik tentang setiap Layanan AWS yang Anda gunakan. Dengan CloudWatch, Anda dapat membuat alarm metrik untuk memberi tahu Anda atau mengubah sumber daya tertentu yang Anda pantau. Untuk informasi selengkapnya tentang CloudWatch metrik, lihat Melacak metrik CloudWatch penggunaan Anda.

Pelacakan pemanfaatan melalui metrik Service Quotas

Kumpulan pengguna Amazon Cognito terintegrasi dengan Kuota Layanan, antarmuka konsol untuk menampilkan dan mengelola penggunaan kuota layanan Anda. Di konsol Kuota Layanan, Anda dapat mencari nilai kuota tertentu, melihat informasi pemantauan, meminta kenaikan kuota, atau mengatur CloudWatch alarm. Setelah akun Anda aktif untuk sementara waktu, Anda dapat melihat grafik pemanfaatan sumber daya Anda.

Kolom nilai kuota tingkat akun yang diterapkan di konsol Kuota Layanan untuk kumpulan pengguna Amazon Cognito dan kumpulan identitas Amazon Cognito menampilkan kuota Anda saat ini. Kolom Pemanfaatan menampilkan tingkat penggunaan kuota Anda saat ini. Kuota permintaan per detik (RPS) kumpulan pengguna Amazon Cognito yang dapat disesuaikan menampilkan penggunaannya saat ini. Konsol Kuota Layanan juga dapat mengarahkan Anda ke CloudWatch metrik untuk melihat lebih dekat metrik kuota yang dipilih. Untuk informasi selengkapnya tentang melihat kuota di konsol Service Quotas, lihat Melihat Service Quotas.

Melacak pengguna aktif bulanan (MAU)

Jumlah pengguna aktif bulanan (MAU) di kumpulan pengguna menyumbangkan data penting untuk perencanaan peningkatan kuota tingkat permintaan. Anda dapat membandingkan tarif permintaan API dengan jumlah pengguna yang aktif dalam periode waktu tertentu. Dengan pengetahuan itu, Anda dapat menghitung bagaimana peningkatan pengguna aktif aplikasi Anda akan memengaruhi kuota Anda dalam model penggunaan Anda. Misalnya, bayangkan bahwa aplikasi gabungan Anda di AS Barat (Oregon) menghasilkan 2 juta pengguna aktif dalam sebulan dan UserAuthentication kategori Anda sesekali menerima kesalahan pelambatan pada kuota default 120 permintaan per detik (RPS). Pada bulan sebelumnya, sebelum kampanye iklan Anda berhasil, Anda memiliki 1 juta MAU dan aplikasi Anda tidak pernah melebihi 80 RPS. Jika Anda mengantisipasi lonjakan serupa sebagai akibat dari spot TV baru, Anda dapat membeli 40 RPS tambahan untuk mengakomodasi jutaan pengguna berikutnya dengan kuota 160 RPS yang disesuaikan.

Untuk meninjau MAU Anda

Akses AWS Billing konsol dan tinjau tagihan baru-baru ini. Di bawah biaya berdasarkan layanan, Anda dapat memfilter di Cognito untuk melihat rincian MAU Anda untuk periode penagihan tersebut.

Meminta peningkatan kuota

Amazon Cognito memiliki kuota untuk jumlah maksimum operasi per detik yang dapat Anda lakukan di kumpulan pengguna dan kumpulan identitas di masing-masing Wilayah AWS. Anda dapat membeli peningkatan kuota tarif permintaan API kumpulan pengguna Amazon Cognito yang dapat disesuaikan. Untuk kategori kumpulan pengguna yang dapat disesuaikan, Anda dapat meminta batas maksimum tingkat akun yang lebih tinggi di Kuota Layanan, lalu menggunakan API penyediaan Amazon Cognito untuk menetapkan tarif yang Anda inginkan. Untuk informasi selengkapnya, lihat Mengelola batas yang disediakan.

Untuk meminta batas maksimum tingkat akun yang lebih tinggi, gunakan konsol Kuota Layanan atau operasi ListAWSDefaultServiceQuotas API Kuota Layanan dan. RequestServiceQuotaIncrease

Mengelola batas yang disediakan

Kumpulan pengguna Amazon Cognito mendukung model kuota dua tingkat untuk kuota tarif API yang dapat disesuaikan. Dengan model ini, Anda dapat secara terprogram meningkatkan atau mengurangi tingkat permintaan yang disediakan tanpa menghubungi Dukungan. AWS Kedua tingkatan bekerja sebagai berikut:

Misalnya, jika batas maksimum UserAuthentication tingkat akun Anda adalah 500 RPS, Anda dapat menggunakan operasi UpdateProvisionedLimit API untuk menetapkan batas yang disediakan menjadi 300 RPS. Anda nantinya dapat mengurangi batas yang disediakan kembali ke default, dan Anda hanya ditagih untuk waktu tersebut dengan tarif yang lebih tinggi.

Mengelola batas yang disediakan di konsol

Anda dapat melihat dan mengelola batas yang disediakan di konsol Amazon Cognito. Buka halaman Kumpulan pengguna dan pilih tab B atas yang disediakan. Pada tab ini, Anda dapat melihat batas yang disediakan saat ini dan batas maksimum tingkat akun untuk setiap kategori API yang dapat disesuaikan. Anda dapat menambah atau mengurangi tarif yang disediakan dalam batas maksimum tingkat akun yang disetujui.

Operasi API penyediaan

Amazon Cognito menyediakan operasi API berikut untuk mengelola batas yang disediakan. Operasi ini memerlukan otentikasi dan izin IAM yang sesuai.

Kedua operasi mengambil LimitDefinition parameter yang mengidentifikasi batas untuk dikelola. Untuk batas tarif API kumpulan pengguna, definisi batas memiliki kelas API_CATEGORY dan peta atribut dengan Category kunci. Misalnya, untuk mengelola UserAuthentication batas, tentukan definisi batas dengan{"Category": "UserAuthentication"}.

{
    "LimitDefinition": {
        "LimitClass": "API_CATEGORY",
        "Attributes": {"Category": "UserAuthentication"}
    }
}

{
    "Limit": {
        "LimitDefinition": {
            "LimitClass": "API_CATEGORY",
            "Attributes": {"Category": "UserAuthentication"}
        },
        "ProvisionedLimitValue": 120,
        "FreeLimitValue": 120
    }
}

{
    "LimitDefinition": {
        "LimitClass": "API_CATEGORY",
        "Attributes": {"Category": "UserAuthentication"}
    },
    "RequestedLimitValue": 300
}

{
    "Limit": {
        "LimitDefinition": {
            "LimitClass": "API_CATEGORY",
            "Attributes": {"Category": "UserAuthentication"}
        },
        "ProvisionedLimitValue": 300,
        "FreeLimitValue": 120
    }
}

Tindakan IAM berikut mengontrol akses ke operasi ini:

Alur kerja penyediaan

Alur kerja berikut menjelaskan cara meningkatkan batas yang disediakan.

Pertimbangan-pertimbangan

Pengguna Amazon Cognito mengumpulkan kategori operasi API dan kuota tarif permintaan

Karena Amazon Cognito memiliki kelas operasi API yang tumpang tindih dengan model otorisasi yang berbeda, setiap operasi termasuk dalam kategori. Setiap kategori memiliki kuota gabungan sendiri untuk semua operasi API anggota, di semua kumpulan pengguna dalam satu Wilayah AWS di akun Anda. Anda hanya dapat meminta peningkatan kuota kategori yang dapat disesuaikan. Untuk informasi selengkapnya, lihat Meminta peningkatan kuota. Penyesuaian kuota berlaku untuk kumpulan pengguna di akun Anda di satu Wilayah. Amazon Cognito membatasi operasi dalam beberapa kategori ³ hingga 5 permintaan per detik (RPS), per kumpulan pengguna. Kuota default (RPS) juga berlaku untuk semua kumpulan pengguna dalam. Akun AWS

Kuota operasi kategori diterapkan di semua pengguna di semua kumpulan pengguna dalam satu Wilayah AWS. Amazon Cognito juga mempertahankan kuota untuk jumlah permintaan yang dapat dihasilkan aplikasi Anda terhadap satu pengguna. Anda harus membatasi permintaan API per pengguna seperti yang ditunjukkan pada tabel berikut.

Pengguna Amazon Cognito mengumpulkan kuota tarif permintaan per pengguna

Anda harus membatasi permintaan API per kategori seperti yang ditunjukkan pada tabel berikut.

Pengguna Amazon Cognito mengumpulkan kuota tarif permintaan per kategori

¹ A RespondToAuthChallenge atau AdminRespondToAuthChallenge tanggapan dengan ChallengeName NEW_PASSWORD_REQUIRED hitungan terhadap UserAccountRecovery kategori. Semua tanggapan tantangan lainnya dihitung dalam UserAuthentication kategori.

² Setiap login terkelola atau operasi UI yang dihosting klasik selama masuk berkontribusi satu permintaan ke kuota. Misalnya, pengguna yang masuk dan memberikan kode MFA berkontribusi 2 permintaan. Penukaran token dalam pemberian kode otorisasi tunduk pada alokasi kuota tambahan dengan tarif yang sama dengan kuota Anda dalam kategori tersebut. UserAuthentication

³ Setiap operasi individu dalam kategori ini memiliki batasan yang mencegah operasi dipanggil pada tingkat yang lebih tinggi dari 5 RPS untuk kumpulan pengguna tunggal.

Batas tarif permintaan massal untuk domain kumpulan pengguna

Kuota berikut berlaku untuk volume permintaan keseluruhan ke domain kumpulan pengguna.

Kumpulan identitas Amazon Cognito (identitas federasi) Kuota tarif permintaan operasi API

¹ Kuota default adalah kuota tarif permintaan minimum untuk kumpulan identitas di mana pun Wilayah AWS di Anda Akun AWS. Kuota RPS Anda mungkin lebih tinggi di beberapa Wilayah.

Kuota pada jumlah dan ukuran sumber daya

Kuota sumber daya adalah jumlah atau ukuran maksimum sumber daya, bidang input, durasi waktu, dan fitur lain-lain lainnya di Amazon Cognito.

Anda dapat meminta penyesuaian pada beberapa kuota sumber daya di konsol Kuota Layanan atau dari formulir peningkatan batas Layanan. Untuk meminta kuota dari konsol Service Quotas, lihat Meminta kenaikan kuota di Panduan Pengguna Service Quotas. Jika kuota tidak tersedia di Kuota Layanan, gunakan formulir Pen ingkatan Batas Layanan.

Tabel berikut menunjukkan kuota sumber daya default, dan apakah kuota tersebut dapat disesuaikan.

Pengguna Amazon Cognito mengumpulkan kuota sumber daya

Kuota berikut menjelaskan jumlah atau panjang maksimum item yang dapat Anda buat di kumpulan pengguna.

¹ Kuota ini mungkin ditemui dalam token dari aPemicu Lambda generasi pra token. Jumlah klaim yang ada dan ditambahkan ditambah cakupan dalam token akses dan identitas dalam satu transaksi harus bertambah hingga jumlah yang lebih kecil dari atau sama dengan kuota ini. Klaim dan cakupan yang ditekan tidak berkontribusi pada kuota ini.

² Kuota ini hanya berlaku jika Anda menggunakan fitur email default untuk kumpulan pengguna Amazon Cognito. Untuk volume pengiriman email yang lebih tinggi, konfigurasikan kumpulan pengguna Anda untuk menggunakan konfigurasi email Amazon SES Anda. Pembatasan ini diatur ulang setiap hari pada 0900 UTC. Untuk informasi selengkapnya, lihat Pengaturan email untuk kumpulan pengguna Amazon Cognito.

Parameter validitas sesi kumpulan pengguna Amazon Cognito

Kuota berikut menjelaskan pengaturan yang tersedia untuk durasi artefak otentikasi dan sesi pengguna di kumpulan pengguna.

Kuota sumber daya keamanan kode kumpulan pengguna Amazon Cognito (tidak dapat disesuaikan)

Kuota berikut menjelaskan periode waktu yang tersedia terkait dengan kode untuk masuk, mendaftar, dan mengatur ulang kata sandi.

¹ Amazon Cognito mengevaluasi faktor risiko dalam permintaan untuk memperbarui kata sandi dan menetapkan kuota yang terkait dengan tingkat risiko yang dievaluasi. Untuk informasi selengkapnya, lihat Lupa perilaku kata sandi.

Pengguna Amazon Cognito mengumpulkan kuota sumber daya pekerjaan impor pengguna

Kuota berikut menjelaskan sumber daya dan batasan yang tersedia untuk pekerjaan impor pengguna.

Kuota sumber daya kumpulan identitas Amazon Cognito (identitas federasi)

Kuota berikut menjelaskan jumlah atau panjang maksimum item yang dapat Anda buat di kumpulan identitas.

Kuota sumber daya Amazon Cognito Sync

Kuota berikut menjelaskan jumlah atau panjang maksimum item yang dapat Anda buat di Amazon Cognito Sync.