Hoppa till innehållet
Stackship-dokumentation English

S3-lagringAnvändareMaskinöversatt

Buckets

Skapa buckets i ett lagringskonto, bläddra bland och ladda upp objekt i portalen, och ta bort buckets.

Kräver: s3buckets/write, s3sts/issue

Öppna S3-lagring i sidomenyn, välj lagringskontot och gå till fliken Buckets. Den listar kontots buckets med kolumnerna Källa — Portal eller S3Api, beroende på hur de skapades — Ägare, med de första tecknen i ägarens principal-ID, och Skapad.

Skapa en bucket

För att skapa en bucket krävs s3buckets/write; rollerna Owner, Contributor och Storage Operator har den.

  1. Välj Skapa bucket på fliken Buckets.
  2. Ange Namn: 3 till 63 tecken, gemener, siffror och bindestreck, med en bokstav eller siffra först och sist. Punkter är inte tillåtna, och inte heller ett namn som ser ut som en IPv4-adress. Namnet måste vara unikt i kontot.
  3. Välj Skapa.

Bucketen är tom och klar direkt. Det finns inga inställningar per bucket: ingen versionshantering, ingen bucket-policy och inga livscykelregler. Vem som kan använda den avgörs av inloggningsuppgifter — se Åtkomstnycklar.

S3-klienter kan också skapa buckets, med CreateBucket, så länge kontots Tillåt bucket-livscykel via S3-API är på — se Avancerade inställningar. Sådana buckets får källan S3Api.

Bläddra i en bucket

Välj en bucket på fliken Buckets för att öppna den. Portalen hämtar tillfälliga inloggningsuppgifter åt dig och talar med kontots slutpunkt direkt från din webbläsare, så att bläddra kräver s3sts/issue (Storage Operator, Contributor, Owner). Tills kontots slutpunkt är redo står det Lagringsendpunkten håller på att provisioneras. Objekt visas när den är klar. på sidan.

  • Mappar är nyckelprefix: välj en för att öppna den. Ny mapp skapar en på den aktuella platsen. En mapps åtgärder byter namn på den — dess objekt flyttas till det nya namnet — eller tar bort den med allt innehåll.
  • Ladda upp, eller dra filer till sidan, laddar upp till den aktuella mappen. Filer på 100 MB och mer skickas i delar; Uppladdningar visar förloppet, och en sådan uppladdning kan avbrytas medan den pågår.
  • Ett objekts åtgärder laddar ned eller tar bort det. Markera flera objekt och välj Ta bort (n) för att ta bort dem tillsammans.
  • Uppdatera läser in listan igen.

Behörigheter för en bucket

Behörigheter, på bucketens sida, listar rolltilldelningar på bucketen och låter dig lägga till sådana.

Varning

Rolltilldelningar på en enskild bucket tillämpas inte: de varken ger eller begränsar något, i portalen eller via S3-API:t. Tilldela roller på lagringskontots resursgrupp eller boundaryn i stället — se Behörigheter.

Ta bort en bucket

För att ta bort en bucket krävs s3buckets/delete, som ingår i s3buckets/write.

  1. Töm bucketen först — ta bort dess objekt i bucket-bläddraren, eller med en S3-klient, till exempel aws s3 rm s3://<bucket> --recursive.
  2. Välj borttagningsknappen på bucketens rad på fliken Buckets, och sedan Ta bort.

Med Tillåt bucket-livscykel via S3-API påslaget kan S3-klienter också ta bort buckets med DeleteBucket.

Viktigt

Plattformen kontrollerar inte att bucketen är tom. Tar du bort en bucket som fortfarande har objekt försvinner bucketen, men dess objekt ligger kvar på kontots volym och räknas fortsatt in i kontots användning. De går inte att nå förrän en bucket med samma namn skapas i kontot igen; den bucketen innehåller dem då. Ett DeleteBucket via S3-API:t tar bort bucketen från plattformen innan servern tittar på dess innehåll, så detsamma gäller där.

Med CLI:t

bash
stsh s3 bucket list my-storage -g my-resource-group
stsh s3 bucket create my-storage my-bucket -g my-resource-group
stsh s3 bucket get my-storage my-bucket -g my-resource-group
stsh s3 bucket delete my-storage my-bucket -g my-resource-group