En este capítulo, se destaca la compatibilidad de la API de DIVArchive de DIVAnet y se proporciona información sobre cómo proporcionar información específica de DIVAnet mediante la API de DIVArchive. Este capítulo está destinado a uso con la documentación de la API de DIVArchive C++, la API de DIVArchive o la API del servicio web de DIVArchive.
DIVAnet admite un subjuego del juego de comandos completo de la API de DIVArchive. Algunos comandos de la API de DIVArchive (como EjectTape
) se rechazarán en el modo MultiDiva de DIVAnet. DIVAnet 2.0 no admite conexiones de cliente de los clientes de la API de DIVArchive versión 7.3 y versiones posteriores. DIVAnet 2.0 no admitirá las funciones nuevas agregadas a la API después de la versión 7.3.
La invocación de llamadas de la API de DIVA contra un servidor DIVAnet es, en gran parte, lo mismo que la invocación de llamadas contra DIVArchive. Sin embargo, hay algunas diferencias: DIVAnet en ocasiones acepta los parámetros de la API de DIVA de una manera levemente diferente. Además, el contenido de los campos devuelto por DIVAnet puede ser levemente diferente del de DIVArchive, o tener un formato diferente. En esta sección, se destacan esas diferencias.
DIVAnet 2.0 requiere la instalación de sitios conectados de DIVArchive con DIVArchive 7.3.1 o una versión posterior. Luego, se podrá cambiar la versión de los sitios de DIVArchive de manera independiente sin requerir un cambio de versión de DIVAnet.
En esta sección, se destacan las solicitudes que involucran la transferencia (o la supresión) de contenido archivado, incluidas las solicitudes de archivo, restauración, supresión o copia. Estos comandos se pueden invocar mediante la API de DIVArchive. Algunos también se pueden invocar desde DIVAnetUI. Consulte el Manual de referencia de la API de Oracle DIVArchive C++ para obtener más información sobre qué hace cada comando dentro de la API de DIVArchive.
Nota:
En el modo MultiDiva de DIVAnet, las solicitudes de DIVAnet a menudo requieren pequeñas partes de información que las solicitudes ejecutadas directamente a DIVArchive no requieren.Las solicitudes de DIVAnet a menudo requieren información adicional debido a la funcionalidad admitida. Por ejemplo, puede usar el comando Copy en DIVAnet para copiar contenido desde un sistema DIVA a otros. DIVAnet necesita saber, como mínimo, cuál es el sitio de destino. Sin embargo, el comando de la API de DIVA CopyToGroup
no contiene un parámetro del sitio de destino. En las siguientes secciones, se detalla cómo especificar esta información adicional. Para obtener más información sobre cómo configurar el modo MultiDiva de DIVAnet, consulte Configuración de puertos de la API del cliente.
Tabla 7-1 identifica las solicitudes de contenido de la API de DIVArchive admitidas por DIVAnet. A los clientes que ejecutan estas solicitudes se les proporciona una ID de solicitud, que puede consultar de manera periódica el estado de una solicitud.
Tabla 7-1 Solicitudes de contenido de DIVArchive admitidas
Solicitud | Comportamiento en DIVAnet |
---|---|
Archive |
Archivado en el sitio local de DIVArchive o, de manera opcional, en otro sitio elegido. Para obtener más información, consulte Solicitudes de archivado". |
Restore Restore Instance |
Restauración de un objeto archivado en un Source/Destination (Origen/destino) específico. Una instancia específica o un sitio específico se puede usar como contenido de origen para la restauración. DIVAnet decide si deberá (1) restaurar un objeto desde la instancia local de DIVArchive, (2) restaurar directamente un objeto mediante una instancia remota de DIVArchive o (3) tomar un objeto desde una instancia remota de DIVArchive ay, a continuación, transferirlo al Source/Destination (Origen/destino) elegido. Una instancia de restauración permite la restauración de una instancia específica en el sitio que se restaurará. Si se produce un fallo, puede configurar DIVAnet para reintentar en otros sitios. Para obtener más información, consulte Solicitudes de restauración. |
Partial Restore Partial Restore Instance |
Restauración parcial de un objeto de manera similar a una restauración completa. Una instancia específica (en un sitio específico) se puede usar como origen para la restauración parcial de archivo. Si se ejecuta una restauración parcial de archivo en un sistema remoto, se deberá configurar el sitio de DIVA para restauración parcial de manera similar en el sitio local. Para obtener más información, consulte Solicitudes de restauración parcial de archivos de Oracle. |
Copy (CopyToGroup) |
Copia de contenido de un sitio de DIVA a otro (una copia entre sitios) o creación de otra instancia de un objeto en un sitio de DIVA (equivalente a la ejecución de Se puede copiar una instancia específica en un sitio de destino. No se admite el mensaje Para obtener más información, consulte Solicitudes de copiado. |
Delete DeleteInstance |
Supresión de contenido desde todos los sitios o desde un sitio específico, o supresión de una instancia específica en un sitio específico. Si los objetos se bloquean en los sitios que se suprimirán, puede configurar DIVAnet para reintento durante un período determinado. Para obtener más información, consulte Supresión de solicitudes. |
Las solicitudes de archivado permiten que el emisor de la llamada archive contenido que existe en un Source/Destination (Origen/destino) determinado (configurado en DIVArchive). La API de DIVA prepara la transferencia desde el Source/Destination (Origen/destino) hacia DIVArchive. Esto difiere de una API en la nube basada en Web donde el contenido se transfiere directamente desde el solicitante mediante HTTPS. Por defecto, DIVAnet realiza archivados en el sitio local.
Las solicitudes de archivado ejecutadas en DIVAnet son similares a las ejecutadas directamente en DIVArchive, pero con algunas adiciones al nombre de sitio de destino, el sitio de DIVArchive donde archivará contenido. Normalmente, DIVAnet realizará archivado en el sitio local. Sin embargo, puede archivar directamente en otro sitio en una de dos maneras:
Mediante la opción -site [sitename] del campo de opciones. Un ejemplo sería -site diva1.
Mediante la colocación de un prefijo de nombre de sitio de destino en el parámetro de medio de la solicitud de archivado. Por ejemplo, sitename1_TapeGroup1 indica un sitio de destino denominado sitename1 y un medio TapeGroup1.
DIVAnet no admite reintentos continuos para comandos de archivado, pero admite la opción <BackupArchiveSite>
, que proporciona un sitio de archivado alternativo en caso de que el sitio principal esté inactivo.
Una solicitud de restauración permite que el cliente restaure contenido que existe en el sistema de archivado. El contenido llega al Source/Destination (Origen/destino) determinado elegido en la solicitud. La API de DIVA prepara una transferencia desde un sitio de DIVArchive directamente a un Source/Destination (Origen/destino) (como FTP o disco CIFS). Esto difiere de una API en la nube basada en Web donde el contenido se transfiere directamente al solicitante mediante HTTPS.
Cuando se restaura contenido mediante DIVAnet, el emisor de la llamada necesita saber cuál sistema DIVA en particular tiene el contenido. Si se producen fallos al recuperar contenido de un sitio de DIVA, se podrá consultar otro sitio de DIVA automáticamente para recuperar el contenido.
DIVAnet admite la restauración a cualquier Source/Destination (Origen/destino) que esté disponible en el sitio local. DIVAnet recuperará contenido de sitios remotos según sea necesario para satisfacer la solicitud y, en última instancia, transferirá el contenido al destino de Source/Destination (Origen/destino).
Las solicitudes de restauración ejecutadas en DIVAnet son similares a las ejecutadas directamente en DIVArchive, pero con algunas pocas adiciones al nombre de sitio de origen, el sitio de DIVArchive donde restaurará el contenido.
-site: Normalmente, DIVAnet elegirá el sitio desde el que se realizará la restauración. Sin embargo, puede intentar realizar una restauración desde un sitio determinado mediante el suministro de la opción -site [nombre del sitio] en el campo de opciones de la solicitud. De hecho, si el contenido no se encuentra en el sitio elegido, la operación fallará.
Instance Id (ID de instancia): Si necesita un control completo en el origen, puede proporcionar un número de instancia en la solicitud de restauración. Esto le permitirá seleccionar el sitio de origen y la instancia de DIVA desde la que se realizará la restauración (consulte la sección siguiente). El ID de instancia se puede obtener mediante una llamada a la API de getObjectInfo()
, suministrando el nombre del objeto que se copiará.
En ambos casos, los reintentos están desactivados.
Para satisfacer una solicitud de restauración, DIVAnet usa los métodos de restauración de la Tabla 7-2. DIVAnet seleccionará de forma dinámica cuál flujo de trabajo de restauración se usará según los parámetros, como el destino de Source/Destination (Origen/destino) y el objeto de origen. Para decidir cuál sitio se usará para restauraciones, DIVAnet realiza una serie de preguntas, entre otras:
¿El objeto está disponible en el sistema DIVArchive local?
¿El objeto tiene una instancia de disco?
¿Es posible acceder al Source/Destination (Origen/destino) desde el sistema DIVArchive remoto?
¿Es posible acceder al Source/Destination (Origen/destino) desde el sistema local?
¿DIVArchive se ejecuta en los sitios de origen o destino?
¿Se prefiere un sitio a otro en el archivo de configuración?
Tabla 7-2 Métodos de restauración de DIVAnet
Método | Descripción |
---|---|
Local |
Se usa cuando un objeto existe en el sitio local. El sitio local es el nombre de sitio del sistema DIVArchive al que envía los mensajes. Un sistema DIVArchive local también se considera parte del sitio local. |
Direct Remote |
DIVAnet puede preparar un sistema DIVA remoto para que lleve a cabo una operación de restauración. Hará esto únicamente si el destino del Source/Destination (Origen/destino) también está configurado en el sistema DIVA remoto. Los nombres de Source/Destination (Origen/destino) deben coincidir y ambos deben hacer referencia al mismo servidor o disco (y a la ruta del disco, si corresponde). Cuando está disponible, DIVAnet prefiere este método a realizar una restauración mediante una copia entre sitios. |
Uso del copiado entre sitios |
Si el contenido no es local y si un sistema remoto de DIVA no puede realizar una restauración directamente en el destino del Source/Destination (Origen/destino), DIVAnet puede preparar la entrega del contenido en dos saltos. Primero, la instancia de DIVA remoto realiza la restauración en un Source/Destination (Origen/destino) compartido entre los sitios remoto y local. A continuación, la instancia local de DIVA archivará el objeto y, finalmente, realizará la restauración en el destino Source/Destination (Origen/destino). De esta manera, las solicitudes futuras de contenido se recuperarán con mayor rapidez. DIVAnet no entregará contenido mediante este proceso a un Source/Destination (Origen/destino) que solamente exista en el sitio de DIVA. Siempre se recomienda realizar restauraciones remotas mediante la creación de una copia nearline. Configure |
Uso de transferencia entre sitios |
En algunos casos, si no puede llevar a cabo una restauración remota directa, DIVAnet entregará el contenido en dos saltos (como la restauración cuando se usa el copiado entre sitios) pero no archivará el contenido de manera local. Este caso involucra la restauración parcial de archivos de Oracle. En primer lugar, DIVAnet indicará a la instancia de DIVA de origen que transfiera contenido al Source/Destination (Origen/destino) accesible mediante los sitios DIVA de origen y destino. A continuación, el sitio local de DIVA transferirá el contenido al destino del Source/Destination (Origen/destino) sin archivarlo. |
DIVAnet permite restaurar un Source/Destination (Origen/destino) que está disponible en el sitio local. DIVAnet puede transferir contenido de un sitio a otros si el sitio de origen y el sitio de destino comparten un nombre de Source/Destination (Origen/destino) en común. DIVAnet supone que, si existe un Source/Destination (Origen/destino) en los sitios de origen y destino, ambas configuraciones apuntan a la misma instancia física de Server\Device\Path
(Servidor\dispositivo\ruta). Por defecto, los usuarios debe tener cuidado con los nombres que asignan a las instancias de Source/Destination (Origen/destino) en los sitios.
Si el sistema DIVA remoto no puede realizar directamente una restauración en el destino de Source/Destination (Origen/destino), DIVAnet puede preparar la entrega del contenido en dos saltos (consulte Restauración mediante transferencia entre sitios). DIVAnet preparará esto únicamente si el Source/Destination (Origen/destino) existen en el sitio local y es el sitio preferido para el Source/Destination (Origen/destino) determinado. (Consulte Asignaciones de origen/destino preferidas).
Puede configurar el comando Restore para que reintente la restauración varias veces si la primera restauración falla. Si el contenido que se restaurará existe en varios sitios, DIVAnet reintentará la restauración automáticamente con esos sitios. Puede configurar el número máximo de reintentos. En algunos casos, DIVAnet decidirá reintentar con el mismo sitio antes de pasar a otros sitios. En este caso, DIVAnet examinará el valor <RestoreRetryIntervalMins>
para determinar cuánto esperará antes de reintentar con el mismo sitio.
DIVAnet 2.0 admite un subjuego de la API de DIVArchive. Consulte este capítulo para obtener una lista de los mensajes admitidos.
DIVAnet 2.0 tiene compatibilidad limitada con la función de restauración múltiple. DIVAnet no permite restauraciones múltiples para Source/Destinations (Origen/destinos) remotos y no permite la visualización o la supervisión de varias instancias de Source/Destinations (Origen/destinos) mediante la interfaz del usuario. La opción de restauración múltiple se puede usar si el objeto existe de manera local, pero no se puede acceder (por ejemplo, se ha externalizado de manera local).
DIVAnet 2.0 no admite relaciones de sitios de par a par, incluido el equilibrio de carga.
Además de restauraciones completas de contenido, DIVAnet también admite restauraciones parciales de archivos. DIVAnet determina el sitio donde se encuentra el contenido y prepara la restauración de la parte.
Si existe un objeto en un sistema DIVA remoto y no es posible acceder al Source/Destination (Origen/destino) para restauración mediante un sistema DIVA remoto, DIVAnet transfiere el contenido en dos pasos: primero mediante el sistema DIVA remoto para obtener el contenido en el sistema DIVA local (sin transferir el objeto completo) y, a continuación, mediante el sistema DIVA local para restaurar el contenido en el destino de Source/Destination (Origen/destino).
Al igual que con la restauración, puede especificar el número de instancia o el parámetro -site para llevar a cabo una restauración desde un sitio específico o especificar reintentos cuando falla el sitio inicial. Además, al igual que con la restauración, no se admite la restauración en varios destinos dentro de la misma solicitud de restauración.
Una solicitud de copiado crea una nueva instancia del contenido archivado desde una instancia existente. DIVAnet permite copiar el contenido de un sitio de DIVA a otro. El comando CopyToGroup
de la API de DIVArchive (1) copia un objeto desde un sitio de DIVA a otro o (2) simplemente crea una nueva instancia en un único sitio. Para las copias, DIVAnet necesita derivar algunos parámetros que no están disponibles en la API de DIVA. En la Tabla 7-3 se describen estos parámetros.
Tabla 7-3 Parámetros derivados de copias de DIVAnet
Atributo derivado | Descripción |
---|---|
Nombre del sitio de destino |
Indica en qué sitio se deberá copiar el objeto. El nombre de sitio destino no existe como campo con arquitectura en la API de DIVA. Puede transmitir esto a DIVAnet mediante una de dos maneras:
Si no especifica ningún nombre de sitio, se tomará el sitio local. La palabra clave -site funcionará únicamente con una API versión 7.3 o posterior. |
Media |
Media (Medios) indica el tipo de medios que se usarán para almacenar el objeto copiado. DIVAnet también permite proporcionar un plan de almacenamiento de DIVA como nombre de medio. El plan de almacenamiento solamente funcionará si la copia es una copia entre sitios. Puede anteponer el nombre de sitio de destino al medio para indicar también el nombre de sitio de destino. Si no está seguro sobre cuál medio proporcionar, puede proporcionar la opción any (cualquier medio) para permitir que el sistema elija cuál medio almacenará en el sitio de destino. Por ejemplo, el medio diva1_any copia en el sitio diva1, pero DIVAnet elige el medio. Es posible que el valor por defecto que proporciona DIVAnet no sea adecuado para algunos casos de uso. Si el objeto ya está en un sitio de destino y se especifica any (cualquiera), el sistema simplemente devolverá una acción correcta. |
Source Sitename |
Normalmente, DIVAnet elegirá el sitio desde el que desea copiar. Sin embargo, si necesita un control completo en el origen, puede proporcionar un número de instancia en la solicitud de copiado. Esto activa de manera implícita la elección del sitio de origen y la instancia de DIVA desde la que se copiará (consulte la sección siguiente). Este ID se puede obtener mediante una llamada a la API de |
En una solicitud de copiado de DIVAnet, si el sitio de origen es igual al sitio de destino, DIVAnet simplemente puede ejecutar una instancia de CopyToGroup
al sitio DIVA de destino. Para copias entre sitios, DIVAnet permite la configuración del método usado para realizar estas copias. Para cada par de nombre de sitio de origen y destino (por ejemplo, site1 asite2), Tabla 7-4 muestra una lista de los métodos de transferencia disponibles.
Además del método de copiado, cada emparejamiento de nombre de sitio de origen y destino contiene la información de Source/Destinations (Origen/destinos) usada para el área de almacenamiento común. También es posible configurar el medio de destino por defecto (para RestoreAndArchive), los parámetros de opción (que se transmiten a DIVArchive) y otros parámetros.
Tabla 7-4 Métodos de copiado de sitio a sitio
Tipo | Descripción |
---|---|
RestoreAndArchive |
Con esta opción, DIVAnet restaura el contenido del sitio de origen a un Source/Destination (Origen/destino) que es común para los sitios de origen y destino. A continuación, DIVAnet indica al sistema DIVArchive que archive el contenido que ahora se encuentra en el área de almacenamiento común. Esta es una alternativa al uso de carpetas de entrega. |
RestoreAndMonitor |
Mediante este método, DIVAnet realizará la copia primero mediante la restauración del contenido en un destino específico. DIVAnet luego supervisará el sistema DIVArchive de destino para determinar si el contenido se ha archivado correctamente en el sitio de destino. La solicitud se completará correctamente solamente si el contenido se ha archivado correctamente en el sitio de destino. Por supuesto que esto confía en otro proceso o programa que tomará el contenido y lo archivará en el sistema DIVA de destino. Esta opción es útil en combinación con software de supervisor de carpetas de entrega de DIVArchive. Cada carpeta del supervisor de carpetas de entrega se configura para archivo mediante un medio preseleccionado. Esto significa que cuando se emplea el supervisor de carpetas de entrega para copias, el parámetro de medios se omite de manera eficaz. |
Restore |
Mediante este método, DIVAnet realizará la copia mediante la restauración en un destino específico y, a continuación, devolverá un mensaje de operación correcta. Este método no confirma que el contenido se ha archivado correctamente en el sitio de destino y posiblemente causará fallos si se intenta la restauración mediante flujos de trabajo de copiado entre sitios. |
El comando Copy de DIVAnet devolverá un mensaje de operación correcta si la instancia del objeto ya existe en el sitio de destino del medio solicitado. En este caso, DIVArchive finalizará la solicitud.
Si se solicita la copia de un objeto en un sitio donde el objeto ya existe, pero no tiene el medio solicitado, DIVAnet creará otra instancia del objeto en el sitio mediante el medio especificado en la solicitud. La excepción a esto es si any se proporciona como medio. En este caso, DIVAnet no creará otra instancia.
En DIVAnetUI, hay una opción para que DIVAnet asigne el medio de destino en una operación de copiado (use un medio de <Selected By DIVAnet>
[Seleccionado por DIVAnet]). Puede lograr esto de la misma manera en una solicitud de la API de DIVA mediante la especificación de un medio any en la solicitud de copiado. DIVAnet usará esta configuración para determinar cuáles medios usar para la copia (consulte Asignaciones de sitio a sitio para obtener más información).
Cuando se transmite any y el objeto ya existe en el sitio de destino, DIVAnet no crea otra instancia del objeto. No se realizan más acciones y la solicitud se lleva a cabo correctamente.
DIVAnet también admite reintentos periódicos en las copias. Si está activado en el perfil de flujo de trabajo, DIVAnet reintentará las operaciones de copiado que fallaron. En el perfil de flujo de trabajo, puede configurar durante cuánto tiempo DIVAnet reintentará la solicitud y el período de espera entre reintentos. Consulte Configuración de perfiles de flujo de trabajo para obtener más información.
Una solicitud de supresión de DIVArchive permite que el emisor de la llamada elimine un objeto archivado. Una solicitud de supresión de DIVAnet, por defecto, suprimirá el objeto de todos los sitios de DIVArchive. Una solicitud de DeleteInstance de DIVAnet puede suprimir una o más instancias de un único sitio de DIVA. De modo que, en realidad, DIVAnet puede realizar tres clases de supresiones. En la Tabla 7-5 se describen los tipos de supresiones y parámetros requeridos.
Tipo | Atributos derivados | Descripción |
---|---|---|
Global Delete |
N/D |
Suprime todas las instancias del objeto en todos los sitios. En la API, si no se especifica un medio o una ID de instancia en la solicitud, el objeto especificado se suprimirá de todos los sitios. |
Instance Delete |
Nombre del sitio de destino |
Suprime una única instancia del objeto en un sitio determinado. En la API, especifique un ID de instancia o un medio para suprimir una instancia de objeto específica de un sitio específico. Si especifica una ID de instancia, tendrá como destino una instancia específica en un sitio específico. La transmisión de parámetros de medios u opciones no es necesaria. Si especifica un medio, DIVAnet deberá saber desde cuál sitio desea realizar la supresión. Puede especificar el sitio de una de tres maneras:
|
Supresión de sitio |
Nombre del sitio de destino |
Suprime todas las instancias de un objeto que reside en un sitio determinado. Esto se puede lograr mediante una de tres maneras:
|
Como se menciona en la tabla anterior, si se proporciona un nombre de sitio y un medio any (cualquiera), esto causará que se supriman todas las instancias del objeto del sitio seleccionado. Esto también se puede lograr mediante la transmisión de -site [sitename] en el campo de opciones.
DIVAnet no permitirá que se realice correctamente una supresión de instancia cuando se intenta suprimir la última instancia de un objeto archivado (la última instancia que existe en la base de datos de DIVAnet). En este caso, se deberá ejecutar una supresión global o una supresión de sitio. Tenga en cuenta que una supresión de sitio permitirá la supresión de la última instancia o de las últimas instancias. Puede usar las reglas de acceso para protegerse contra supresiones de instancias o supresiones de sitios que son realmente supresiones globales (consulte Configuración de las reglas de acceso para obtener más información).
Además, si un usuario ejecuta una supresión directamente en DIVArchive, es posible que haya una ventana de tiempo donde DIVAnet no podrá garantizar que se conservará la última instancia.
Si DIVAnet recibe una supresión y DIVAnet está realizando una copia entre sitios del objeto, se cancelará la solicitud de DIVAnet que generó la copia. La copia puede ser el resultado de un comando Copy o puede ser el resultado de un comando Restore que realiza una copia para concretar la restauración. No se cancelarán otros tipos de solicitudes de DIVAnet.
Si se ejecuta una solicitud de DIVArchive en nombre de una solicitud de DIVAnet, DIVArchive bloquea el objeto y evita que se suprima. Por lo tanto, si se bloquea un objeto antes de que DIVAnet pueda enviar un mensaje de supresión a DIVArchive, la solicitud de supresión fallará.
DIVAnet admite reintentos periódicos en supresiones cuando las supresiones fallan. Si está activado en el perfil de flujo de trabajo, DIVAnet continuará intentando suprimir sitios donde (por ejemplo) las instancias o los objetos para suprimir están bloqueados. Puede configurar la duración de los reintentos dentro DIVAnet.
La Tabla 7-6 identifica los comandos de la API de DIVArchive no relacionados con el contenido. Estos comandos obtienen información acerca de objetos o solicitudes y no están asignados a una ID de solicitud.
Tabla 7-6 Otros comandos de DIVArchive no relacionados con el contenido
Solicitud | Descripción | Comportamiento en DIVAnet |
---|---|---|
|
Cancela una solicitud de DIVAnet. |
La opción -site no se aplica para este comando. |
|
Use la base de datos de DIVAnet para obtener información acerca de un objeto archivado. DIVAnet devuelve todas las instancias del objeto en todos los sitios de DIVAnet. Se proporcionan los campos Object Name (Nombre de objeto) y Object Category (Categoría de objeto). (Puede dejar la categoría en blanco, pero si varios objetos tienen el mismo nombre de objeto, la llamada fallará). DIVAnet usa la base de datos de DIVAnet para devolver información acerca del objeto archivado. En la respuesta |
La opción -site no se admite para este comando. |
|
Recupera información acerca de una solicitud de DIVAnet desde la base de datos de DIVAnet. Nota: El parámetro de información adicional tiene limitaciones. La información adicional es proporcionada por DIVArchive y representa información de la última solicitud de DIVA procesada. La información no refleja otros sitios de la red de DIVAnet. |
Cuando DIVAnet recibe una llamada de La opción -site no se aplica para este comando. |
|
Recupera información directamente dese DIVArchive acerca de los archivos y las carpetas que se encuentran dentro de un objeto archivado determinado. |
Acepta la opción -site para consultar un sitio específico o ningún sitio para permitir que DIVAnet elija (recomendado). |
|
Recupera información de DIVArchive acerca de objetos y eventos de objetos. DIVAnet recupera la información del objeto directamente desde cada sistema DIVArchive de a un sitio por vez, en modo de asignación en rueda, de a un lote por sitio. Cada lote contiene información acerca de un sitio de DIVA. Si el mismo objeto existe en dos sitios, recibirá el objeto dos veces (una vez para cada sitio), una vez en cada lote. Nota: No se garantiza el orden de las entradas devueltas. Si un sitio de DIVA está inactivo, |
Puede recuperar información desde un sitio si agrega un el nombre de sitio como prefijo al campo de medio, separado por un guión bajo (_). Si no desea consultar un medio, pero aún desea recuperar información de un sitio, puede proporcionar solamente el nombre del sitio en el campo de medio. Este comando no acepta la opción -site. |
|
Consulta la base de datos de DIVAnet para obtener una lista de nombres y categorías de objeto ( |
Hay compatibilidad limitada para este comando dentro de DIVAnet. No se admiten las consultas sobre información de cintas y hay límites sobre el número de consultas simultáneas. La opción -site no se admite. |
|
Devuelve una lista de nombres de matrices de todos los sitios, incluidos los discos de cada matriz, y devuelve las capacidades del sitio actual. |
El parámetro -site, que se transmite en el campo de opciones, puede devolver información sobre un sitio específico. |
|
Devuelve una lista de los nombres de grupos de cintas de todos los sitios. Se agrega un prefijo con el nombre de sitio al nombre del grupo. |
Nota: Este comando no tiene un campo de opciones. Como resultado, no se admiten las opciones de -site. |
|
Devuelve una lista de la información de origen y destino de todos los sitios. |
En la lista devuelta, el nombre de sitio del origen o el destino se agregan como prefijo al nombre de origen o destino, separados por un guión bajo (_). El parámetro -site, que se transmite en el campo de opciones, puede devolver información sobre un sitio específico. |
|
Recupera el estado de un único sitio de DIVArchive (por defecto, se devuelve el sitio local). No devuelve una vista global de todos los sitios. |
El parámetro -site, que se transmite en el campo de opciones, selecciona desde cuál sitio se recuperará información. Por ejemplo, -site diva1 enrutará la solicitud de |
Por motivos de compatibilidad de aplicación, estos comandos siempre devolverán un mensaje de operación correcta, aunque DIVAnet no realice ninguna acción para lograrlo.
Change Priority (Cambiar prioridad)
Lock Object (Bloquear objeto)
Unlock Object (Desbloquear objeto)
Link Objects (Enlazar objetos)
Require Instance (Requerir instancia)
Release Instance (Liberar instancia)
DIVAnet códigos de estado que son similares a lo que devuelve DIVArchive. Sin embargo, DIVAnet en ocasiones aceptará solicitudes que DIVArchive rechazará de inmediato, ya que DIVAnet a menudo no tiene la información necesaria para realizar la comprobación hasta más tarde, durante el procesamiento de la solicitud.
Además, DIVAnet devolverá el estado ACCESS_DENIED para diversos comandos. Este estado no es devuelto por DIVArchive. DIVAnet rechazará las solicitudes que no transmitan comprobaciones de reglas de acceso y rechazará los mensajes que no estén configurados en WorkflowProfile. Para fines de compatibilidad, la versión 5.8 de la API y las versiones anteriores devolverán el estado INVALID_PARAMETER en lugar del estado ACCESS_DENIED.