Kyvernon

Werkwijze Voor: beheerders

Tenants

Maak tenants aan in de console, stel hun quotum in, beheer hun gebruikers en servers, onderbreek, hervat en sluit ze; de CLI en de API volgen.

Een tenant is een klant van de provider. Bij het aanmaken ontstaan de map en de resourcegroep van de tenant, en het quotum beperkt wat de gebruikers kunnen bestellen. Zie Concepten van self-service voor de objecten. De knop om een tenant aan te maken verschijnt alleen als u Kyvernon.Tenant.Create op de root hebt.

In de console

  1. Open de startpagina (Start) en selecteer Tenants onder Snelkoppelingen.

    Tenants met quotum, status en acties (Groter weergeven)

    De lijst Alle tenants toont Naam, ID, Portaalaccount, Status (Actief, Opgeschort of Gesloten), het gebruik van de quota VM's en vCPU's, en wanneer de tenant is aangemaakt (Aangemaakt).

  2. Ga naar de kaart Nieuwe tenant om een tenant aan te maken. Voer Korte naam in: kleine letters, cijfers en koppeltekens, maximaal 63 tekens, zonder koppelteken aan het begin of het einde. Voer eventueel Weergavenaam in en Portaalaccount-id, de account-id in uw portal.

    Kaart Nieuwe tenant met naam, portalaccount en quotumvelden (Groter weergeven)
  3. Vul de quotumvelden VM's, vCPU's, Geheugen (MiB), Schijf (GiB), Publieke IPv4, Snapshots en Verkeer per maand (GiB) in. Een leeg veld is onbeperkt.
  4. Selecteer Tenant aanmaken. De tenant verschijnt in de lijst en Kyvernon maakt de mappen en resourcegroepen van de tenant aan.

  5. Selecteer later Quotum in de rij van de tenant om een quotum te wijzigen, bewerk de velden en selecteer Quotum opslaan. Het nieuwe quotum vervangt het oude en een leeg veld is onbeperkt.

    Venster Quotum van een tenant (Groter weergeven)
  6. Selecteer Opschorten om een tenant tijdelijk te stoppen. De virtuele machines van de tenant worden afgesloten en de gebruikers krijgen alleen-lezen toegang; inschakelen en de console worden geweigerd. Hervatten start de virtuele machines die eerder draaiden.
  7. Selecteer Sluiten om een tenant te beëindigen. Het dialoogvenster vraagt u de naam van de tenant te typen. Bij het sluiten worden de virtuele machines direct uitgeschakeld en na de coulanceperiode met hun schijven vernietigd, en de gebruikers kunnen zich niet meer aanmelden. Dit kan niet ongedaan worden gemaakt.

  8. Om de accounts van een tenant te beheren, kiest u Gebruikers op zijn rij. Het dialoogvenster toont de accounts met hun Soort, Status, Tweestapsverificatie en Laatste aanmelding. Kies Nieuwe gebruiker, voer de Gebruikersnaam in (2 tot 63 kleine letters, cijfers, punten, streepjes of underscores; hij kan daarna niet meer veranderen), een Weergavenaam en E-mail, kies de Rol (Tenantbeheerder, Tenantgebruiker of Alleen lezen; hij wordt alleen op de mappen en pools van de tenant toegekend) en voer het Eerste wachtwoord tweemaal in, minstens 12 tekens. Laat Een nieuw wachtwoord vragen bij de eerste aanmelding aan staan zodat de persoon bij de eerste aanmelding een wachtwoord kiest. Schakel Serviceaccount in voor een automatiseringsaccount dat zich alleen met API-tokens aanmeldt. Kies Gebruiker maken. Verwijderen verwijdert een account nadat u de naam hebt getypt. Het scherm vereist de bevoegdheid Kyvernon.Tenant.ManageUsers op de map van de tenant.

    Venster met de gebruikers van een tenant, hun soort, status en laatste aanmelding (Groter weergeven)
  9. Om de servers van een tenant te bestellen en te bedienen, kiest u Servers op zijn rij, zoals beschreven in Servers.

Onderbreken, hervatten en sluiten zijn taken die even duren; volg ze in het takenvenster, zie Taken.

Resultaat

De tenant staat met zijn status in de lijst en de gebruikers zien en wijzigen alleen wat in de map en de resourcegroep van de tenant staat. Een verzoek waarmee de tenant boven zijn quotum zou komen, mislukt met error.quota.exceeded; een onderbroken tenant antwoordt error.tenant.suspended en een gesloten tenant error.tenant.closed. Zie de tenantfouten en de quotumfouten.

Een tenant heeft een factureringsperiode voor het maandelijkse verkeer, en de ankerdag wordt ingesteld wanneer de tenant via de API wordt aangemaakt. Servers krijgen hun publieke adressen uit de IP-pool van hun netwerk, zie IP-pools, en een verkeerslimiet van hun plan. Als u een server verwijdert, gaan de adressen terug naar de quarantaine van de pool. De coulanceperiode van een sluiting, standaard 7 dagen, en de tijd die een onderbreking wacht tot een gast is afgesloten, standaard 60 seconden, stelt u in via de sectie [tenancy] van de controllerconfiguratie.

Automatisering

Met de CLI

Shell
kyvernon tenants create acme --external-ref acct-1001 \
  --quota '{"vms":5,"vcpus":16,"memoryMib":32768}'
kyvernon tenants users acme create alice --role admin
kyvernon tenants quota acme --body '{"vms":10,"vcpus":32}'
kyvernon tenants suspend acme
kyvernon tenants close acme --grace-seconds 604800
kyvernon tenants usage acme --month 2026-11

Het wachtwoord van een nieuwe gebruiker komt uit KYVERNON_PASSWORD of uit standaardinvoer. De rol van een tenantgebruiker is admin, user of read-only en geldt alleen voor de mappen en resourcegroepen van de tenant. tenants quota vervangt het hele quotum; een veld dat u weglaat of op null zet, is onbeperkt.

Met de API

GET /v1/tenants en GET /v1/tenants/{tenant} tonen en lezen tenants, en POST /v1/tenants maakt er een aan. PUT /v1/tenants/{tenant}/quota stelt het quotum in, POST op .../suspend, .../resume en .../close wijzigt de status, en GET /v1/tenants/{tenant}/usage?month=2026-11 leest een maand. De gebruikers van een tenant zijn GET en POST /v1/tenants/{tenant}/users en DELETE /v1/tenants/{tenant}/users/{username}, en hun tokens staan onder .../users/{username}/api-tokens.

Versie 0.1. Laatst gewijzigd: 2026-11-14