Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides › Objet group › Méthode get_newobj_acl (objet group)

Méthode get_newobj_acl (objet group)

Description

Affiche la définition de la liste de contrôle d'accès du nouvel objet associée à un groupe ou la partie de celle-ci qui se rapporte à un principal particulier.

Syntaxe

/api/v2/group/get_newobj_acl?group=group&principal=principal&vdc=vdc 

Arguments

groupe

Nom du groupe Ajoutez / au début du nom de groupe pour indiquer un groupe global.

principal

Nom du principal. <principal> est au format :

URL

Le principal est encodé au format :

<name> : utilisateur local ou groupe.

/<name> : utilisateur global ou groupe.

<scope>:<type>:<name> : nom complet de principal où <scope> est global ou local, <type> est group ou user et <name> est le nom du groupe ou de l'utilisateur.

Par exemple, local:user:api@3tera.com=full doit être passé sous la forme local%3Auser%3Aapi%403tera.com%3Dfull et

Si principal est une chaîne vide, la définition complète de la liste de contrôle d'accès du nouvel objet associée à un groupe est affichée. Dans le cas contraire, seule la partie de la définition de la liste de contrôle d'accès du nouvel objet se rapportant à un principal particulier est affichée.

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemples

GET http://192.168.123.200/api/v2/group/get_newobj_acl?group=apigroup&principal=&vdc=mygrid

Exemple de sortie

XML

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63",
            "full" : 1
         }
      ]
   }
}

Codes d'erreur HTTP

404

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

404.1

Entité [nom_ressource] introuvable. Aucune correspondance de nom de principal n'a été trouvée pour principal.

400.4

Missing required arguments (group). La requête ne contient pas l'argument group=group.

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