Bucket-Kontingent

Bucket-Kontingente von RustFS begrenzen die gesamten Objektdaten, die in einem einzelnen Bucket gespeichert sind. Verwenden Sie ein Kontingent, damit ein Workload nicht mehr als die zugewiesene Kapazität verbraucht, während andere Buckets den übrigen Speicher nutzen können.

ÜberblickCopy Anchor Link

RustFS unterstützt derzeit harte, bytebasierte Kontingente. Bevor RustFS einen Schreibvorgang annimmt, vergleicht es die aktuelle Nutzung des Buckets zuzüglich der angeforderten Objektgröße mit dem konfigurierten Limit. Ein Schreibvorgang, der das Limit überschreiten würde, wird mit InvalidRequest und der Meldung Bucket quota exceeded abgelehnt.

Kontingentprüfungen umfassen diese Operationen:

Das Kontingent gilt für Objektdaten, nicht für die Anzahl der Objekte oder die Anfragerate. Ein Bucket ohne konfiguriertes Limit ist unbegrenzt.

In der Console konfigurierenCopy Anchor Link

1. Melden Sie sich an der RustFS-Console an und öffnen Sie Browser.
2. Suchen Sie den Bucket und wählen Sie Settings (Einstellungen).
3. Suchen Sie unter Capacity & Metadata (Kapazität und Metadaten) den Eintrag Bucket Quota (Bucket-Kontingent) und wählen Sie Edit (Bearbeiten).
4. Aktivieren Sie Bucket Quota.
5. Geben Sie die Kontingentgröße ein und wählen Sie MiB, GiB, TiB oder PiB.
6. Wählen Sie Save Quota (Kontingent speichern).

Um das Limit zu entfernen, öffnen Sie den Dialog erneut, deaktivieren Sie Bucket Quota und speichern Sie die Änderung.

rc verwendenCopy Anchor Link

Konfigurieren Sie einen Alias für Ihre RustFS-Bereitstellung:

rc alias set rustfs http://localhost:9000 \
	<your-access-key> <your-secret-key> \
	--region us-east-1 --bucket-lookup path

Ersetzen Sie localhost durch die Adresse des RustFS-Servers, wenn rc auf einem anderen Host läuft.

BerechtigungenCopy Anchor Link

Kontingentoperationen erfordern diese Richtlinienaktionen:

Die Root-Anmeldedaten besitzen diese Berechtigungen. Hängen Sie für die delegierte Administration nur die Aktionen an, die der Ablauf benötigt.

Kontingent setzenCopy Anchor Link

Setzen Sie ein hartes Kontingent von 1 GiB. rc akzeptiert Bytewerte oder Einheiten wie 1G, 500M und 10KB:

rc bucket quota set rustfs/my-bucket 1G

Die Antwort enthält das konfigurierte Limit und die aktuelle Nutzung:

Bucket: my-bucket
Quota: 1 GiB
Usage: 0 B
Type:  HARD

Kontingent lesenCopy Anchor Link

rc bucket quota info rustfs/my-bucket

Verwenden Sie --json, wenn ein anderes Werkzeug das Ergebnis verarbeiten muss:

rc bucket quota info rustfs/my-bucket --json

Wenn kein Limit konfiguriert ist, meldet die lesbare Ausgabe Quota: unlimited.

Kontingent löschenCopy Anchor Link

Entfernen Sie das Limit, ohne Objekte zu löschen:

rc bucket quota clear rustfs/my-bucket
rc bucket quota info rustfs/my-bucket

Der Bucket wird unbegrenzt, nachdem die Konfigurationsänderung angewendet wurde.

Erweiterte KontingentprüfungenCopy Anchor Link

rc 0.1.29 stellt keine Befehle für detaillierte Nutzungsstatistiken oder unverbindliche Prüfungen geplanter Schreibvorgänge bereit. Verwenden Sie für diese Operationen die RustFS-Admin-API. Anfragen müssen AWS Signature Version 4 mit aktiven RustFS-Zugangsdaten verwenden.

Die Beispiele verwenden diese Shell-Variablen:

export RUSTFS_ENDPOINT=http://localhost:9000
export RUSTFS_ACCESS_KEY=<your-access-key>
export RUSTFS_SECRET_KEY=<your-secret-key>
export BUCKET_NAME=my-bucket

Detaillierte Nutzungsstatistik lesenCopy Anchor Link

Verwenden Sie den Statistikendpunkt, um das Limit, die aktuelle Nutzung, die verbleibenden Bytes und den genutzten Prozentsatz abzurufen:

curl --fail-with-body \
	--aws-sigv4 "aws:amz:us-east-1:s3" \
	--user "${RUSTFS_ACCESS_KEY}:${RUSTFS_SECRET_KEY}" \
	"${RUSTFS_ENDPOINT}/rustfs/admin/v3/quota-stats/${BUCKET_NAME}"

{
	"bucket": "my-bucket",
	"quota_limit": 1073741824,
	"current_usage": 1048576,
	"remaining_quota": 1072693248,
	"usage_percentage": 0.09765625
}

Die Nutzungswerte stammen aus der Datennutzungsabrechnung von RustFS. Warten Sie, bis diese Sicht sehr aktuelle Änderungen widerspiegelt, bevor Sie die Statistikantwort für externe Abrechnung oder Orchestrierung verwenden.

Geplanten Upload prüfenCopy Anchor Link

Prüfen Sie, ob ein Upload von 64 MiB passen würde, ohne ein Objekt zu schreiben:

curl --fail-with-body \
	--aws-sigv4 "aws:amz:us-east-1:s3" \
	--user "${RUSTFS_ACCESS_KEY}:${RUSTFS_SECRET_KEY}" \
	--request POST \
	--header "Content-Type: application/json" \
	--data '{"operation_type":"PUT","operation_size":67108864}' \
	"${RUSTFS_ENDPOINT}/rustfs/admin/v3/quota-check/${BUCKET_NAME}"

Das Feld allowed meldet die Entscheidung. Diese Prüfung ist unverbindlich: Ein anderer Schreibvorgang kann Kapazität verbrauchen, bevor der geplante Upload beginnt. Deshalb bleibt der tatsächliche Upload maßgeblich.

ÜberprüfungCopy Anchor Link

Setzen Sie ein kleines Testkontingent, laden Sie ein Objekt hoch, das hineinpasst, und versuchen Sie anschließend, ein Objekt hochzuladen, das die verbleibende Kapazität überschreitet:

rc bucket quota set rustfs/my-bucket 1M

dd if=/dev/zero of=/tmp/quota-small.bin bs=1024 count=256
dd if=/dev/zero of=/tmp/quota-large.bin bs=1048576 count=2

rc object copy /tmp/quota-small.bin rustfs/my-bucket/hello.bin
rc object copy /tmp/quota-large.bin rustfs/my-bucket/too-large.bin

Das Objekt von 256 KiB gelingt. Das Objekt von 2 MiB überschreitet das Bucket-Kontingent von 1 MiB. Deshalb endet rc mit einem Fehler, und RustFS erstellt too-large.bin nicht.

Löschen Sie das erste Objekt und entfernen Sie das Testkontingent:

rc object remove rustfs/my-bucket/hello.bin --force
rc bucket quota clear rustfs/my-bucket
rc bucket quota info rustfs/my-bucket

Prüfen Sie, dass die letzte Abfrage Quota: unlimited meldet.

Wenn die Kontingentdurchsetzung ihre interne Konfiguration nicht lesen oder auswerten kann, protokolliert RustFS Bucket quota check degraded to allow und lässt den Schreibvorgang zu. Überwachen Sie diese Warnung, weil sie bedeutet, dass die Kontingentdurchsetzung vorübergehend nicht verfügbar ist.

Nächste SchritteCopy Anchor Link

• Bucket erstellen
• Lebenszyklusregeln verwalten
• Observability konfigurieren