Benennung von API-Objekten

Online bearbeiten

Erstellen Sie eine konsistente Namenskonvention für API-Objektnamen. Die Namenskonvention muss den Dateibereichsnamen, das übergeordnete Qualifikationsmerkmal und das untergeordnete Qualifikationsmerkmal berücksichtigen. Der Dateibereichsname und die übergeordneten Qualifikationsmerkmale können sich auf tatsächliche Verzeichnisnamen beziehen. Jeder Objektname kann aus mehreren Verzeichnisnamen bestehen, die für das untergeordnete Qualifikationsmerkmal gelten.

Am einfachsten ist es, als untergeordnetes Qualifikationsmerkmal den Namen des Objekts ohne Verzeichnisinformationen als Präfix zu verwenden. Weitere Informationen finden Sie unter Objektnamen und IDs.

Dateibereichsnamen müssen vollständig qualifiziert sein, wenn von der API oder der Befehlszeile für Sichern/Archivieren auf sie Bezug genommen wird. Unter einem UNIX-oder Linux® -Betriebssystem registrieren Sie beispielsweise die folgenden Dateibereiche:

/a
/a/b

Wenn Sie auf /a Bezug nehmen, werden Objekte angezeigt, die sich nur auf Dateibereich /a beziehen. Wenn Objekte angezeigt werden sollen, die sich auf /a/b beziehen, müssen Sie /a/b als Dateibereichsnamen angeben.

Wenn Sie, nachdem Sie beide Dateibereiche registriert haben, Objekt b in Dateibereich /a sichern, werden bei einer Abfrage für /a/b weiterhin Objekte angezeigt, die sich nur auf Dateibereich /a/b beziehen.

Eine Ausnahme von dieser Einschränkung sind Dateibereichsreferenzen, wenn Sie versuchen, Dateibereiche mit der API abzufragen oder zu löschen. In beiden Fällen müssen die Dateibereichsnamen nicht vollständig qualifiziert sein, wenn ein Platzhalterzeichen verwendet wird. Beispielsweise bezieht sich /a* sowohl auf /a als auch auf /a/b.

Tipp: Wenn Interoperabilität für Sie wichtig ist, vermeiden Sie Dateibereichsnamen, die sich überschneiden.

Auf Windows-Systemen schließen Sie Dateibereichsnamen für API-Objekte in geschweifte Klammern { } ein, wenn Sie über die Befehlszeilenschnittstelle für Sichern/Archivieren auf die Objekte zugreifen. Windows-Betriebssysteme schreiben Dateibereichsnamen automatisch in Großbuchstaben, wenn Sie die Namen registrieren oder auf sie verweisen. Diese automatische Funktion gibt es jedoch nicht für die restliche Objektnamensspezifikation. Wird vollständige Interoperabilität gewünscht, geben Sie beim Sichern von API-Objekten das übergeordnete Qualifikationsmerkmal und das untergeordnete Qualifikationsmerkmal in der Anwendung in Großbuchstaben an. Wenn Ihre Anwendung übergeordnete Qualifikationsmerkmale (Verzeichnisnamen) und untergeordnete Qualifikationsmerkmale (Dateinamen) vor dem Senden von Objekten an den Server nicht in Großbuchstaben umsetzt, können Sie über den Client für Sichern/Archivieren nicht direkt über den Namen auf die Objekte zugreifen.

Wenn beispielsweise ein Objekt auf dem Server als {"FileSpacename"}\TEST\MYDIRNAME\file.txtgespeichert ist, können Sie das Objekt file.txt nicht direkt zurückschreiben oder abfragen, da Ihre Anwendung den Dateinamen nicht in Großbuchstaben geschrieben hat, bevor die Datei auf den Server kopiert wurde. Die einzige Möglichkeit, mit diesen Objekten zu arbeiten, besteht in der Verwendung von Platzhalterzeichen. Beispielsweise muss ein Benutzer des Clients für Sichern/Archivieren bei einer Abfrage von \TEST\MYDIRNAME\file.txt Platzhalterzeichen für alle Teile des Objektnamens verwenden, die nicht in Großbuchstaben umgesetzt wurden, bevor sie an den Server gesendet wurden. Der folgende Befehl muss verwendet werden, um diese Datei file.txt abzufragen:

dsmc query backup {"FileSpaceName"}\TEST\MYDIRNAME\*

Wenn auch noch andere Qualifikationsmerkmale in Kleinschreibung gespeichert wurden, müssen auch sie unter Verwendung von Platzhalterzeichen abgefragt werden. Verwenden Sie beispielsweise den folgenden Befehl, um ein Objekt abzufragen, das als {"FileSpaceName"}\TEST\mydirname\file.txtgespeichert ist:

dsmc query backup {"FileSpaceName"}\TEST\*\*

Die nachfolgenden Beispiele veranschaulichen diese Konzepte. In Windows-und UNIX-oder Linux -Umgebungen müssen Sie weder das vollständige übergeordnete noch das untergeordnete Qualifikationsmerkmal angeben. Wenn Sie nicht das vollständige Qualifikationsmerkmal angeben, müssen Sie allerdings das Platzhalterzeichen verwenden.

Plattform	Beispiel
Fenster	Um alle gesicherten Dateien im Dateibereich `MYFS` abzufragen, geben Sie die folgende Zeichenfolge ein: `dsmc q ba "{MYFS}\\"` Sie müssen für jedes übergeordnete und untergeordnete Qualifikationsmerkmal mindestens 1 Stern (*) verwenden.
UNIX oder Linux	Um alle gesicherten Dateien im Dateibereich `/A` abzufragen, geben Sie die folgende Zeichenfolge ein: `dsmc q ba "/A//"` Sie müssen für jedes übergeordnete und untergeordnete Qualifikationsmerkmal mindestens 1 Stern (*) verwenden.