Recherche dans <book_title>…

Notes de mise à jour de Veritas NetBackup™

Last Published: 2021-07-28

Product(s): NetBackup (9.1)

API RESTful incluses dans NetBackup 9.1

NetBackup 9.1 inclut les nouvelles interfaces de programmation d'application (API) RESTful mises à jour. Ces API fournissent une interface de service Web qui vous permet de configurer et de gérer NetBackup dans vos environnements.

La documentation relative aux API NetBackup est disponible aux emplacements suivants :

Sur le serveur maître
Les API sont enregistrées dans les fichiers YAML sur le serveur maître :
https://<serveur_principal>/api-docs/index.html
Les API sont documentées au format Swagger. Ce format permet d'examiner le code et d'en tester la fonctionnalité en effectuant des appels réels avec les API. Vous devez disposer des autorisations de sécurité appropriées pour accéder au serveur maître et aux API afin d'utiliser les API Swagger.
Attention :
Veritas recommande de tester les API uniquement dans un environnement de développement. Étant donné que vous pouvez effectuer des appels d'API réels à partir des fichiers Swagger, vous ne devez pas tester les API dans un environnement de production.
Sur SORT
La documentation relative aux API NetBackup est également disponible sur SORT :
ACCUEIL > BASE DE CONNAISSANCES > Documents > Version du produit > 9.1
Vérifiez dans Référence de l'API. Le document Prise en main fournit des informations générales sur l'utilisation des API NetBackup. Les fichiers YAML d'API sont également disponibles à titre de référence, mais ils ne sont pas fonctionnels. Vous ne pouvez pas tester les API à partir des documents contenus sur SORT.

Contrôle d'accès aux travaux

La version actuelle de plusieurs API de travaux fournit un contrôle d'accès plus précis basé sur les biens de charge de travail. L'accès aux travaux est toujours configurable globalement en accordant des opérations à tous les travaux à l'aide de l'espace de noms |MANAGE|JOBS|. Désormais, l'accès aux travaux peut être limité à des charges de travail spécifiques, ou même à des biens spécifiques pour lesquels les travaux ont été exécutés. L'accès de niveau objet aux travaux de sauvegarde et de restauration est appliqué en fonction de l'ID de contrôle d'accès (espace de noms) du bien pour lequel le travail a été créé.

Auparavant, l'autorisation de modification de l'état du travail était contrôlée par une opération de mise à jour unique. D'autres opérations spécifiques aux travaux ont été ajoutées pour permettre à un administrateur d'interrompre, de redémarrer, de reprendre et d'annuler des travaux de manière indépendante.

Les versions antérieures des API de travaux incluaient la notion de contrôle d'accès « basé sur l'initiateur » selon laquelle un utilisateur dispose de privilèges complets sur le travail de sauvegarde qu'il lance, quelles que soient les opérations accordées par un administrateur. Dans cette version, l'accès basé sur l'initiateur a été supprimé et remplacé par le contrôle d'accès au niveau objet basé sur le bien.

Nouvelles API

NetBackup 9.1 inclut les nouveautés et améliorations suivantes apportées aux API :

Hôtes sans agent : gestion des hôtes sans agent.
Paramètres iSCSI : gestion des paramètres iSCSI globaux pour les charges de travail AHV.
Politiques : prise en charge du type de politique VMware et nouvelle validation de configuration de snapshot.
Certificats SAML : gestion des certificats SAML pour l'authentification unique.
SLP : mise à jour et recherche de conflits avec les politiques de cycle de vie du stockage (SLP).
Paramètres SLP : gestion des paramètres globaux de politique de cycle de vie du stockage (SLP).
Fenêtres SLP : gestion des fenêtres de politique de cycle de vie du stockage (SLP).
Extensions de serveur de gestion de snapshots : gestion des extensions enregistrées auprès du serveur CloudPoint.
Fournisseurs de snapshots - Domaines Azure : récupération des informations sur les domaines Azure configurés.
Récupération
- Cloud : vérification de pré-récupération pour la récupération de biens cloud.
- Nutanix AHV : récupération complète de la VM AHV. Récupération de fichiers et dossiers spécifiques avec le client NetBackup et sans agent.
- Oracle : exécution de la récupération de la base de données Oracle.
- Physique : récupération granulaire de fichiers et de dossiers à partir d'un système physique.
- VMware : récupération de la VM à synchronisation instantanée.
Connexion au certificat utilisateur : authentification du certificat client à l'aide d'un certificat X.509.
GET /catalog/image-contents
Cette API existante a été améliorée pour prendre en charge l'en-tête de demande X-NetBackup-All-Copies. Cet en-tête est un booléen indiquant que toutes les sauvegardes de chaque chemin d'accès dans la plage de dates doivent être renvoyées, pas uniquement les dernières.

Suivi de version des API

Travaux

Les attributs suivants ont été supprimés de la réponse de détails des travaux dans la version v6.0 :

initiatorId

Les attributs suivants ont été ajoutés à la réponse de détails des travaux dans la version v6.0 :

Attribut	Type
dteMode	Chaîne
dedupSpaceRatio	Valeur flottante
compressionSpaceRatio	Valeur flottante
workloadDisplayName	Chaîne

Autres modifications apportées aux API de travaux :

GET:/admin/jobs
Une nouvelle stratégie de pagination basée sur le curseur a été implémentée pour les API de travaux de liste.
L'application de RBAC a été étendue pour inclure l'application de niveau objet basée sur les biens de la charge de travail.
La nouvelle opération |OPERATIONS|MANAGE|JOBS|VIEW| a été introduite pour accorder l'autorisation d'affichage sur un travail basé sur un bien. Elle permet à un administrateur de déléguer l'accès à un travail quel que soit le bien pour lequel il est exécuté.
L'application basée sur l'initiateur a été supprimée, la prise en charge de l'application de niveau objet la rendant redondante.
```
GET:/admin/jobs/{jobId}
GET:/admin/jobs/{jobId}/progress-logs
GET:/admin/jobs/{jobId}/try-logs
GET:/admin/jobs/{jobId}/try-logs/{attempt}
GET:/admin/jobs/{jobId}/file-lists
```
L'application de RBAC a été étendue pour inclure l'application de niveau objet basée sur les biens de la charge de travail.
La nouvelle opération |OPERATIONS|MANAGE|JOBS|VIEW| a été introduite pour distinguer la capacité d'afficher un travail et le bien pour lequel il est exécuté.
L'application basée sur l'initiateur a été supprimée, la prise en charge de l'application de niveau objet la rendant redondante.
```
GET:/admin/jobs/{jobId}/cancel
GET:/admin/jobs/{jobId}/suspend
GET:/admin/jobs/{jobId}/resume
GET:/admin/jobs/{jobId}/restart
```
L'application de RBAC a été étendue pour inclure l'application de niveau objet basée sur les biens de la charge de travail.
La possibilité d'annuler, de suspendre, de reprendre et de redémarrer un travail peut désormais être accordée indépendamment au niveau API et objet.
L'application basée sur l'initiateur a été supprimée, la prise en charge de l'application de niveau objet la rendant redondante.