Använd Applagring för att lagra, organisera och hantera filer som används av din app när den körs, inklusive bilder, videor, dokument och användaruppladdningar.

Innan du använder Applagring ansluter du projektet till Atoms moln. Om det inte är anslutet ber du Agent att ansluta Atoms moln eller följer Atoms moln.

Förstå Applagring i Atoms moln

Applagring lagrar filer som ditt projekt behöver behålla och komma åt. Det är separat från strukturerad data som lagras i din Databas, filer som laddas upp i Chat och filerna som utgör projektets kod.

Nyckeltermer

• Bucket: Huvudbehållaren som används för att lagra och gruppera relaterade filer. Du kan tänka på en bucket som ett lagringsområde för en kategori av filer. Varje bucket är inställd på antingen Public eller Private, vilket styr vem som kan komma åt filerna i den.
• Mapp: Ett valfritt sätt att organisera filer inom en bucket. Mappar fungerar som mapparna på din dator och kan göra större samlingar av filer lättare att hantera.
• Objekt: En enskild fil som lagras i en bucket eller mapp, till exempel en bild, ett dokument, en video eller en annan uppladdad fil.
• Objektnyckel: Den unika sökvägen som används för att identifiera var en fil lagras i en bucket. Till exempel kan images/profile/avatar.png vara objektnyckeln för en bild som lagras i en images/profile-mapp.

Välj Public eller Private

Välj bucket-typ innan du skapar den:

Bucket-typ	Använd den för
Private	Känsliga, kontospecifika eller användaruppladdade filer.
Public	Icke-känsliga filer som avsiktligt är säkra att exponera offentligt.

Använd Private för känsliga eller användarspecifika filer. Om du stöter på ett åtkomstfel ska du inte ändra bucketen till Public bara för att göra filen tillgänglig. Se i stället till att din app kontrollerar att personen som begär filen har behörighet att komma åt den.

Öppna Applagring i Atoms moln

1. Öppna ditt projekt på en stationär enhet.
2. I samma verktygsfält i arbetsytan där App Viewer finns väljer du Atoms moln.
3. Välj Applagring i sidofältet i Atoms moln.

Behörigheter i Applagring

Applagring använder din arbetsyteroll. Både Editors och workspace owners kan hantera lagring för projekt som de kan öppna. Personer som inte är medlemmar i arbetsytan kan inte öppna eller hantera projektets Applagring.

Bucketens inställning Public eller Private ändrar inte vem som kan hantera den i Atoms moln. Den inställningen styr hur appen som körs kan ge åtkomst till filerna; arbetsytans behörigheter styr vem som kan hantera lagringen från arbetsytan i Atoms moln.

Skapa en bucket

En app kan ha upp till 10 buckets. Skapa separata buckets när olika grupper av filer behöver olika åtkomstinställningar eller bör hållas åtskilda för enklare organisering.

1. På sidan Applagring väljer du Create Bucket.
2. Under Bucket Name anger du ett unikt namn för bucketen. Namnet måste:
   • innehålla 3–63 tecken;
   • endast använda gemena bokstäver, siffror och bindestreck; och
   • börja och sluta med en bokstav eller siffra.
3. Under Bucket Type väljer du Private eller Public. Public är valt som standard, så se till att du väljer den åtkomstnivå du vill ha innan du fortsätter.
4. Välj Create.

Den nya bucketen visas på sidan Applagring med sitt namn, sin typ och sitt skapandedatum. Välj bucketen för att öppna den och visa dess innehåll.

Välj Create Bucket i Applagring.

Bucket-namn kan inte ändras efter att de har skapats, så välj ett tydligt namn som du inte behöver ändra senare. Om din app redan har 10 buckets kommer Create Bucket inte längre att vara tillgängligt.

Ladda upp och organisera filer

Inuti en bucket kan du ladda upp filer direkt eller skapa en tom mapp utan att först ladda upp några filer.

Skapa en ny mapp

1. Öppna den bucket eller mapp där du vill skapa den nya mappen.
2. Välj Add Folder.
3. Ange ett namn för mappen och välj sedan Create. Mappnamn kan innehålla bokstäver, siffror, punkter (.), bindestreck (-) och understreck (_) och får vara högst 100 tecken. Mappnamn kan inte ändras efter att de har skapats.

Namnge mappen och välj sedan Create.

Ladda upp filer

1. Öppna den bucket eller mapp där du vill lagra filerna.
2. Välj Upload och välj sedan en eller flera filer från din enhet. Varje fil kan vara upp till 100 MB.
3. Vänta tills uppladdningen är klar och kontrollera sedan att filerna visas i listan.

Fillistan visar varje objekts Name, Type, Size, datum för Last Modified och tillgängliga Actions. Om du behöver läsa in innehållet i den aktuella mappen på nytt väljer du knappen refresh.

Ladda upp filer till den valda bucketen eller mappen.

Förhandsgranska och hantera filer

Välj en fil för att öppna File Details. Bilder och videor som stöds kan förhandsgranskas i panelen. Andra filtyper visar sina tillgängliga detaljer och kan fortfarande laddas ned. Om alla credits har använts visar File Details ett läge för förbrukade credits, och Download för en enskild fil leder dig till Upgrade i stället för att ladda ned.

Hantera en fil

Öppna ... i filens kolumn Actions och välj sedan:

• Download för att spara en lokal kopia när credits är tillgängliga. Om alla credits har använts leder den här åtgärden dig i stället till Upgrade.
• Rename för att ändra filnamnet. Det nya namnet kan använda bokstäver, siffror, punkter, bindestreck och understreck.
• Delete för att ta bort filen efter bekräftelse.

Använd filens åtgärdsmeny för att ladda ned, byta namn på eller ta bort den.

Hantera flera filer

1. Markera kryssrutan bredvid varje fil. Mappar ingår inte i batchmarkering.
2. Välj Download för att ladda ned de valda filerna tillsammans, eller välj Delete.
3. Om du tar bort filer granskar du antalet valda filer och bekräftar Delete.

Borttagning kan inte ångras från Applagring. Innan du byter namn på eller tar bort en fil bör du kontrollera om appen fortfarande använder dess objektnyckel. Uppdatera eventuella lagrade referenser efteråt så att appen inte fortsätter att begära den gamla nyckeln.

Använd en lagrad fil i din app

Din app identifierar varje lagrad fil med hjälp av dess bucket-namn och objektnyckel. Objektnyckeln visar var filen finns i bucketen. Till exempel kan images/profile/avatar.png vara objektnyckeln för en bild som lagras i en images/profile-mapp.

Lagra bucket-namnet och objektnyckeln i appens databas så att appen kan hitta filen senare. När appen behöver visa eller ladda ned filen kan den använda dessa uppgifter för att begära en åtkomst-URL.

Åtkomst-URL:er kan vara tillfälliga. Spara dem inte som permanent appdata, hårdkoda dem inte i din app och dela dem inte i Chat, skärmbilder, loggar eller supportmeddelanden. Lagra i stället objektnyckeln och begär en ny åtkomst-URL när filen behöver nås.

Lagra inte API-nycklar, lösenord eller andra autentiseringsuppgifter i Applagring. Lagra privata autentiseringsuppgifter för körtid i Keys and secrets. Endast workspace owner kan hantera privata autentiseringsuppgifter för körtid där. Om du är en Editor ber du workspace owner att lägga till eller uppdatera autentiseringsuppgiften.

Aktuella gränser

Gräns	Aktuellt värde
Buckets per app	10
Storlek på varje uppladdad fil	100 MB

För aktuell information om användning och kapacitet i Cloud, se Cloud & AI Wallet.

Vanliga frågor

Mitt diskutrymme är fullt. Hur frigör jag lagringsutrymme?

1. Kontrollera den aktuella lagringsanvändningen och identifiera de största chattarna, projekten eller filerna.
2. Ladda ned eller säkerhetskopiera allt du kan behöva senare.
3. Ta bara bort sådant du inte längre behöver. Om borttagning av en chatt visar ett alternativ för att ta bort associerade diskdata väljer du det först efter att ha bekräftat att datan kan kasseras.
4. Ta bort stora filer som inte behövs, uppdatera sedan och kontrollera det tillgängliga utrymmet igen.

Borttagning kan vara permanent och kan påverka ett projekt som refererar till den borttagna filen. Om användningen inte minskar efter rensning kontaktar du Support med en skärmbild av lagringen, ditt abonnemang och det berörda kontot eller arbetsytan. Skicka inte filinnehåll om det inte begärs via en godkänd kanal.