relman CLI: Mail
← Back to the relman CLI command overview
list mailfolder (aliases: mailfolders, mf)
Fetches the id and name of every mail folder owned by your own account (resolved from the client certificate). Unlike every other “list” command, this one takes no organization/project-group/project token, since mail folders do not sit anywhere under that tree.
import mail <mailfolder-token> <path>
Imports one local .eml file, or – if <path> is a directory – every .eml file directly inside it (not recursive), into the folder identified by <mailfolder-token>. Each file’s MD5 (matching the hash the web UI’s own drag-and-drop importer computes client-side) and filename are sent as query-string parameters, its raw bytes as the request body – the import is delegated to the exact same importer the web UI itself uses, so a file already imported (matching hash) or one whose sender/recipients have no mail-permission on the target folder is reported the same way for either caller.
Exit code is 0 if every file’s HTTP request succeeded, regardless of whether the server logically imported it or not (see the per-file “imported” field printed for each); 1 if any request itself failed; 2 on a usage error.
Examples
1. Listing your mail folders
Global flags omitted below – see Utility & global flags. No org/project chain needed here – a mail folder belongs to your account directly.
$ relman list mailfolder
- id: mf-3xQa9K
name: Support Inbox
- id: mf-Ht72Wm
name: ArchiveEdge case: this always resolves against your own account (from the client certificate) – there is no way to list another account’s mail folders with this command.
2. Importing an .eml file
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importing ./inbox/ticket-4821.eml ...
imported: trueEdge case: pointing <path> at a directory instead of a file imports every .eml file directly inside it – not recursively into subdirectories.
3. Importing the same file twice
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importing ./inbox/ticket-4821.eml ...
imported: falseEdge case: the exit code is still 0 here – the HTTP request itself succeeded, the server just logically rejected it (matching MD5 hash already on file, or no mail-permission for the sender/recipients on that folder). Always check the printed imported field, not just the exit code, when scripting bulk imports.
← Zurück zur Übersicht über die relman-CLI-Befehle
Mail-Ordner (Aliase: mailfolders, mf)
Ruft die ID und den Namen jedes E-Mail-Ordners ab, der zu Ihrem eigenen Konto gehört (abgeleitet aus dem Client-Zertifikat). Im Gegensatz zu allen anderen „list“-Befehlen benötigt dieser Befehl kein Organisations-/Projektgruppen-/Projekt-Token, da sich E-Mail-Ordner nicht in dieser Struktur befinden.
E-Mails importieren
Importiert eine lokale .eml -Datei oder – falls .eml Datei direkt darin (nicht rekursiv) in den durch
Der Exit-Code ist 0, wenn die HTTP-Anfrage für jede Datei erfolgreich war, unabhängig davon, ob der Server sie logisch importiert hat oder nicht (siehe das für jede Datei ausgegebene Feld „imported“); 1, wenn eine Anfrage selbst fehlgeschlagen ist; 2 bei einem Anwendungsfehler.
Beispiele
1. Auflisten Ihrer E-Mail-Ordner
Globale Flags werden im Folgenden weggelassen – siehe Dienstprogramm & globale FlagsHier ist keine Organisations-/Projektkette erforderlich – ein E-Mail-Ordner gehört direkt zu Ihrem Konto.
$ relman list mailfolder
- ID: mf-3xQa9K
Name: Support-Posteingang
- ID: mf-Ht72Wm
Name: ArchivSonderfall: Dies wird stets mit Ihr eigenes Konto (aus dem Client-Zertifikat) – es gibt keine Möglichkeit, mit diesem Befehl die E-Mail-Ordner eines anderen Kontos aufzulisten.
2. Importieren einer .eml Datei
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importieren von ./inbox/ticket-4821.eml …
importiert: trueSonderfall: Verweist .eml-Datei Datei direkt darin – nicht rekursiv in Unterverzeichnisse.
3. Zweimaliges Importieren derselben Datei
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Import von ./inbox/ticket-4821.eml …
importiert: falseSonderfall: Der Exit-Code lautet weiterhin 0 – die HTTP-Anfrage selbst war erfolgreich, der Server hat sie jedoch aus logischen Gründen abgelehnt (übereinstimmender MD5-Hash bereits vorhanden oder keine E-Mail-Berechtigung für den Absender/die Empfänger in diesem Ordner). Überprüfen Sie stets den ausgegebenen imported Feld, nicht nur den Exit-Code, wenn Sie Skripte für Massenimporte erstellen.
← Retour à la présentation des commandes de l’interface en ligne de commande (CLI) de relman
Courrier
liste des dossiers de messagerie (alias : mailfolders, mf)
Récupère l’identifiant et le nom de chaque dossier de messagerie appartenant à votre propre compte (déterminé à partir du certificat client). Contrairement à toutes les autres commandes « list », celle-ci ne prend pas en charge de jeton d’organisation/groupe de projet/projet, car les dossiers de messagerie ne se trouvent nulle part dans cette arborescence.
import mail
Importe un fichier local .eml , ou — si fichier .eml qui s’y trouve directement (pas de manière récursive), dans le dossier identifié par
Le code de sortie est 0 si la requête HTTP de chaque fichier a abouti, que le serveur l’ait logiquement importé ou non (voir le champ « imported » affiché pour chaque fichier) ; 1 si une requête a échoué ; 2 en cas d’erreur d’utilisation.
Exemples
1. Liste de vos dossiers de messagerie
Les indicateurs globaux sont omis ci-dessous — voir Utilitaires et indicateurs globaux. Aucune chaîne d’organisation/projet n’est nécessaire ici : un dossier de messagerie appartient directement à votre compte.
$ relman list mailfolder
- id : mf-3xQa9K
nom : Boîte de réception du support
- id : mf-Ht72Wm
nom : ArchiveCas particulier : cela renvoie toujours vers votre propre (à partir du certificat client) – il n’est pas possible de lister les dossiers de messagerie d’un autre compte à l’aide de cette commande.
2. Importation d’un fichier fichier .eml fichier
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importation de ./inbox/ticket-4821.eml...
importé : vraiCas particulier : le fait de fichiers .eml fichier qui s’y trouve directement, sans recherche récursive dans les sous-répertoires.
3. Importation d’un même fichier deux fois
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importation de ./inbox/ticket-4821.eml ...
importé : fauxCas particulier : le code de sortie reste 0 ici : la requête HTTP elle-même a abouti, mais le serveur l’a logiquement rejetée (hachage MD5 déjà présent dans le fichier, ou absence d’autorisation d’accès au courrier pour l’expéditeur/les destinataires dans ce dossier). Vérifiez toujours la valeur affichée de « importé » , et pas seulement le code de sortie, lorsque vous automatisez des importations en masse.
← Volver al resumen de los comandos de la CLI de relman
Correo
lista de correo carpeta de correo (alias: carpetas de correo, mf)
Obtiene el identificador y el nombre de todas las carpetas de correo que pertenecen a su propia cuenta (determinadas a partir del certificado de cliente). A diferencia de cualquier otro comando «list», este no admite ningún token de organización, grupo de proyectos o proyecto, ya que las carpetas de correo no se encuentran en ningún nivel de ese árbol.
importar correo
Importa un archivo local .eml , o —si archivo .eml que se encuentre directamente en su interior (sin recursividad), a la carpeta identificada por
El código de salida es 0 si todas las solicitudes HTTP de los archivos se han realizado con éxito, independientemente de si el servidor los ha importado lógicamente o no (véase el campo «importado» de cada archivo que se muestra para cada uno de ellos); 1 si alguna solicitud ha fallado; 2 en caso de error de uso.
Ejemplos
1. Listado de sus carpetas de correo
A continuación se omiten los indicadores globales; consulte Utilidades y indicadores globales. Aquí no se requiere ninguna cadena de organización/proyecto: una carpeta de correo pertenece directamente a su cuenta.
$ relman list mailfolder
- id: mf-3xQa9K
nombre: Bandeja de entrada de asistencia
- id: mf-Ht72Wm
nombre: ArchivoCaso especial: esto siempre se resuelve con su propia (a partir del certificado de cliente); no hay forma de mostrar las carpetas de correo de otra cuenta con este comando.
2. Importación de un archivo .eml :
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importando ./inbox/ticket-4821.eml ...
importado: trueCaso especial: al archivo .eml directamente en su interior, no de forma recursiva en los subdirectorios.
3. Importar el mismo archivo dos veces
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
Importando ./inbox/ticket-4821.eml ...
importado: falsoCaso extremo: el código de salida sigue siendo 0 en este caso: la solicitud HTTP en sí se ha realizado correctamente, pero el servidor la ha rechazado por motivos lógicos (el hash MD5 coincide con uno ya existente en el archivo, o el remitente o los destinatarios no disponen de permisos de correo en dicha carpeta). Compruebe siempre el valor de «importado» , y no solo el código de salida, al crear scripts para importaciones masivas.
邮件
邮件列表 邮件文件夹 (别名： mailfolders, mf)
获取您本人账户拥有的每个邮件文件夹的 ID 和名称（根据客户端证书解析得出）。与其他所有“list”命令不同，此命令不接受组织/项目组/项目参数，因为邮件文件夹并不位于该树结构的任何子节点下。
导入邮件
导入一个本地 .eml 文件；若 .eml 文件（不进行递归），导入到由
如果所有文件的 HTTP 请求均成功，则返回代码为 0，无论服务器是否实际将其导入（请参阅为每个文件打印的“imported”字段）；如果任何请求本身失败，则返回代码为 1；若发生用法错误，则返回代码为 2。
示例
1. 列出您的邮件文件夹
以下省略了全局标志——请参阅 实用程序与全局标志。此处无需组织/项目链——邮件文件夹直接属于您的账户。
$ relman list mailfolder
- id: mf-3xQa9K
名称：支持收件箱
- id：mf-Ht72Wm
名称：归档边界情况： 这始终会解析为 您自己的 账户（来自客户端证书）进行解析——无法通过此命令列出其他账户的邮件文件夹。
2. 导入一个 .eml 文件
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
正在导入 ./inbox/ticket-4821.eml ...
已导入：true边界情况： 指向 .eml 文件——不会递归导入子目录中的文件。
3. 同一文件被导入两次
$ relman import mail mf-3xQa9K ./inbox/ticket-4821.eml
正在导入 ./inbox/ticket-4821.eml ...
已导入：false边界情况： 退出代码仍然是 0 ——这表示 HTTP 请求本身成功了，但服务器从逻辑上拒绝了该请求（文件中已存在匹配的 MD5 哈希值，或者发件人/收件人对此文件夹没有邮件权限）。请务必检查输出的 imported 字段，而不仅仅是退出代码。