Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides pour l'API CA AppLogic › Objet template › Méthode get_acl (objet template)

Méthode get_acl (objet template)

Description

Récupérer la liste de contrôle d'accès du modèle ou la partie de cette liste qui se rapporte à un principal spécifique

Syntaxe

/api/v1/template/get_acl?template=squelette&principal=<principal>&vdc=nom-contrôleur 

Arguments

template

Nom du squelette.

principal

Principal codé au format URL

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemple : récupération de la liste de contrôle d'accès de l'application

Récupérer la liste de contrôle d'accès de l'application pour le modèle VDS_CentOS

GET http://192.168.123.200/api/v1/template/get_acl?template=VDS_CentOS&principal=&vdc=mygrid 

Exemple de sortie

JSON

{
   "acl" : {
      "owner" : {
         "id" : "b543eff7-db88-4d79-a11c-4de22d5e6d3b"
      },
      "entries" : {
         "entries[0]" : {
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7",
            "full" : 1
         },
         "entries[1]" : {
            "id" : "b543eff7-db88-4d79-a11c-4de22d5e6d3b",
            "full" : 1
         }
      }
   }
}

XML

<acl>
  <entries>
    <name>entries[0]</name>
    <full>1</full>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
  </entries>
  <entries>
    <name>entries[1]</name>
    <configure>1</configure>
    <id>b543eff7-db88-4d79-a11c-4de22d5e6d3b</id>
  </entries>
  <owner>
    <id>b543eff7-db88-4d79-a11c-4de22d5e6d3b</id>
  </owner>
</acl> 

Exemple : affichage des données de liste de contrôle d'accès pour le principal

Afficher les données de la liste de contrôle d'accès pour le principal local:user:api@3tera.com pour le squelette VDS_CentOS

GET http://192.168.123.200/api/v1/template/get_acl?template=VDS_CentOS&principal=local%3Auser%3Aapi%403tera.com&vdc=mygrid

Exemple de sortie

JSON

{
   "acl" : {
      "entries" : {
         "entries[0]" : {
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7",
            "full" : 1
         }
      }
   }

XML

<acl>
  <entries>
    <name>entries[0]</name>
    <full>1</full>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
  </entries>
</acl>

Codes d'erreur HTTP

400

L'entité vdc mygrid est introuvable - Le nom de VDC spécifié n'est pas configuré dans l'application WS_API.

400.4

Missing required arguments (template)

- Argument app=app manquant

Missing required arguments (principal)

- Argument principal=principal manquant

404.1

Entity not found - Application test does not exist.

- Un squelette spécifié n'existe pas sur mygrid

Entity not found - Failed to retrieve application ACL - ACL does not contain principal local user 'test@3tera.com'.

- Un principal non valide a été spécifié

Remarque : Cette API est disponible avec WS_API_r6-1.0.6-1 et les versions ultérieures.