Applagring

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 strukturerade data som lagras i din Databas, filer som laddas upp i Chat och de filer som utgör projektets kod.

Viktiga termer

• 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.
• Folder: 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 enklare att hantera.
• Object: En enskild fil som lagras i en bucket eller mapp, till exempel en bild, ett dokument, en video eller en annan uppladdad fil.
• Object key: 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 object key 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 type	Use it for
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 för 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 kommer att behöva ä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 folder 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 inte vara längre än 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 folder 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 igen 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 ner. Om alla credits är använda visar File Details ett läge för slut på credits, och Download för en enskild fil leder dig till Upgrade i stället för att ladda ner.

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 är använda leder den här åtgärden dig till Upgrade i stället.
• Rename för att ändra filnamnet. Det nya namnet kan innehålla 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 ner, 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 ner 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 object key. Uppdatera alla 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 name och object key. Object key visar var filen finns i bucketen. Till exempel kan images/profile/avatar.png vara object key för en bild som lagras i en images/profile-mapp.

Lagra bucket name och object key i appens databas så att appen kan hitta filen senare. När appen behöver visa eller ladda ner 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 object key 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örning i Keys and secrets. Endast arbetsytans ägare kan hantera privata autentiseringsuppgifter för körning där. Om du är en Editor ber du arbetsytans ägare att lägga till eller uppdatera autentiseringsuppgiften.

Aktuella gränser

Limit	Current value
Buckets per app	10
Size of each uploaded file	100 MB

För aktuell information om Cloud-användning och kapacitet, 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 ner 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 och 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.