Denominazione degli oggetti API

Modifica in linea

Stabilire una convenzione di denominazione congruente per i nomi oggetto API. La convenzione di denominazione deve soddisfare il nome dello spazio file, il qualificatore di alto livello e il qualificatore di basso livello. Il nome dello spazio file e i qualificatori di alto livello possono fare riferimento ai nomi di directory effettivi. Ogni nome oggetto può essere costituito da più di un nome indirizzario che si applica al qualificatore di basso livello.

Per comodità, utilizzare il nome dell'oggetto che non è preceduto da informazioni sull'indirizzario come qualificatore di basso livello. Per ulteriori informazioni, consultare ID e nomi oggetto.

I nomi spazio file devono essere completi quando si fa riferimento ad essi dall'API o dalla riga comandi di backup - archiviazione. Ad esempio, su un sistema operativo UNIX o Linux® , registrare i seguenti spazi file:

/a
/a/b

Quando si fa riferimento a /a, vengono visualizzati gli oggetti relativi solo allo spazio file /a . Per visualizzare gli oggetti correlati a /a/b, è necessario specificare /a/b come nome spazio file.

Dopo aver registrato entrambi gli spazi file, se si esegue il backup dell'oggetto b nello spazio file /a, una query per /a/b continua a visualizzare gli oggetti correlati solo allo spazio file /a/b.

L'eccezione a questa limitazione si verifica nei riferimenti dello spazio file quando si tenta di interrogare o eliminare gli spazi file con l'API. In entrambi i casi, i nomi degli spazi file non devono essere completi se si utilizza un carattere jolly. Ad esempio, /a* fa riferimento sia a /a che a /a/b.

Suggerimento: se l'interoperabilità è importante per l'utente, evitare i nomi degli spazi file che si sovrappongono.

Su sistemi Windows, racchiudere i nomi spazio file tra parentesi graffe { } per gli oggetti API quando si accede agli oggetti dall'interfaccia della riga comandi di backup - archivio. I sistemi operativi Windows collocano automaticamente i nomi degli spazi file in lettere maiuscole quando si registrano o fanno riferimento ai nomi. Tuttavia, questa funzione automatica non si verifica per il resto della specifica del nome oggetto. Se si desidera l'interoperabilità completa, inserire il qualificatore di alto livello e il qualificatore di basso livello in lettere maiuscole nell'applicazione quando si esegue il backup degli oggetti API. Se l'applicazione non utilizza qualificatori di alto livello in maiuscolo (nomi indirizzario) e qualificatori di basso livello (nomi file) prima di inviare gli oggetti al server, non sarà possibile accedere agli oggetti direttamente per nome tramite il client di backup - archivio.

Ad esempio, se un oggetto è memorizzato sul server come {"FileSpacename"}\TEST\MYDIRNAME\file.txt, non è possibile ripristinare o interrogare direttamente l'oggetto file.txt perché l'applicazione non ha maiuscolo il nome file prima che il file fosse copiato sul server. L'unico modo per manipolare questi oggetti è utilizzare caratteri jolly. Ad esempio, per eseguire la query di \TEST\MYDIRNAME\file.txt, un utente del client di backup - archivio deve utilizzare caratteri jolly per tutte le parti del nome oggetto non maiuscole prima di essere inviate al server. Il seguente comando deve essere utilizzato per eseguire la query di questo file file.txt :

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

Se anche altri qualificativi vengono salvati in testo in minuscolo, è necessario eseguire la query di tali qualificativi utilizzando i caratteri jolly. Ad esempio, per interrogare un oggetto memorizzato come {"FileSpaceName"}\TEST\mydirname\file.txt, utilizzare il seguente comando:

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

Gli esempi che seguono dimostrano questi concetti. In entrambi gli ambienti Windows e UNIX o Linux , non è necessario specificare il qualificatore completo di livello superiore o inferiore. Tuttavia, se non si specifica il qualificatore completo, è necessario utilizzare il carattere jolly.

Piattaforma	Esempio
Windows	Per interrogare tutti i file di cui è stato eseguito il backup nello spazio file `MYFS`, immettere la seguente stringa: `dsmc q ba "{MYFS}\\"` È necessario utilizzare almeno un asterisco (*) per ogni qualificatore di livello superiore e di livello inferiore.
UNIX o Linux	Per interrogare tutti i file di cui è stato eseguito il backup nello spazio file `/A`, immettere la seguente stringa: `dsmc q ba "/A//"` È necessario utilizzare almeno un asterisco (*) per ogni qualificatore di livello superiore e di livello inferiore.