Fouten bij gastbewerkingen

Oorzaken en oplossingen voor de foutcodes van gastbewerkingen op bestanden en programma's in een virtuele machine.

`error.guest_operations_unavailable`

Tekst in de console: Gastbewerkingen zijn niet beschikbaar: de virtuele machine staat uit, heeft geen gastagent, of de agent blokkeert de opdracht.
Betekenis voor API-clients: Guest operations are not available (powered off, no agent, or agent blocks the command).
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. De gastagent kan de bewerking niet uitvoeren. Of de virtuele machine is uitgeschakeld, ze heeft geen gastagent of de agent antwoordt niet, of de agent is ingesteld om dit soort bewerking (programma's of bestanden) te weigeren. Het bericht van het API-antwoord bevat de reden die de agent meldde.

Oplossing.

Schakel de virtuele machine in wanneer ze uit staat: kyvernon vm power-on <id>.
Controleer of de gastagent in de gast draait. Installeer of herstart hem als dat niet zo is. kyvernon vm guest validate <id> --username <user> test of gastbewerkingen beschikbaar zijn.
Blokkeert de agent de bewerking, dan wijzigt een beheerder van de virtuele machine de gasttoegang met Gasttoegang bewerken.
Geef de reden uit het antwoord door wanneer de oorzaak nog niet duidelijk is.

`error.guest_file_exists`

Tekst in de console: Het bestand bestaat al in de gast. Kies overschrijven om het te vervangen.
Betekenis voor API-clients: The file already exists in the guest (use overwrite).
Code: ALREADY_EXISTS, HTTP 409

Oorzaak. Het bestand bestaat al in de gast, en de bewerking overschrijft niet.

Oplossing.

Kies een andere bestandsnaam.
Om het bestand bewust te vervangen, schrijft u het opnieuw met overschrijven toegestaan. Met de CLI overschrijft kyvernon vm guest write-file tenzij --no-overwrite is opgegeven, en kyvernon vm guest move-file <id> --src <path> --dst <path> --overwrite vervangt de bestemming.

`error.guest_path_not_found`

Tekst in de console: Het pad bestaat niet in de gast.
Betekenis voor API-clients: The path does not exist in the guest.
Code: NOT_FOUND, HTTP 404

Oorzaak. Het pad bestaat niet in de gast, of een map onderweg ernaartoe bestaat niet.

Oplossing.

Toon de bovenliggende map in de gast: kyvernon vm guest list-files <id> --path <folder>.
Gebruik een pad zoals de gast het schrijft. Paden volgen het besturingssysteem van de gast.
Maak eerst de ontbrekende map aan: kyvernon vm guest mkdir <id> --path <folder> --parents.

`error.guest_path_is_directory`

Tekst in de console: Het pad is een map in de gast.
Betekenis voor API-clients: The path is a directory in the guest.
Code: INVALID_ARGUMENT, HTTP 400

Oorzaak. Het pad is een map in de gast, en de bewerking werkt alleen met bestanden, bijvoorbeeld het lezen of verwijderen van een bestand.

Oplossing.

Geef het pad van een bestand op.
Gebruik kyvernon vm guest rmdir <id> --path <folder> om een map te verwijderen. Gebruik kyvernon vm guest move-dir om een map te verplaatsen.

`error.guest_path_not_directory`

Tekst in de console: Het pad is geen map in de gast.
Betekenis voor API-clients: The path is not a directory in the guest.
Code: INVALID_ARGUMENT, HTTP 400

Oorzaak. Het pad is een bestand in de gast, en de bewerking werkt alleen met mappen, bijvoorbeeld het tonen van de inhoud of het aanmaken van bestanden eronder.

Oplossing.

Geef het pad van een map op.
Gebruik de bewerking voor bestanden om met het bestand zelf te werken, bijvoorbeeld kyvernon vm guest read-file <id> --path <file>.

`error.guest_directory_not_empty`

Tekst in de console: De map in de gast is niet leeg.
Betekenis voor API-clients: The directory is not empty in the guest.
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. De map in de gast bevat nog bestanden, en de bewerking verwijdert niet recursief.

Oplossing.

Verwijder eerst de inhoud, of verwijder de map met haar inhoud: kyvernon vm guest rmdir <id> --path <folder> --recursive.
Controleer de inhoud voordat u recursief verwijdert. De bewerking kan niet ongedaan worden gemaakt.