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

Méthode put_acl (objet app)

Description

Remplace l'intégralité de la liste de contrôle d'accès à l'application.

Syntaxe

/api/v2/app/put_acl?app=application&owner=<owner>&acl=<ACLs>&vdc=controller-name

Arguments

app

Nom de l'application

owner

Un attribut de propriétaire (encodé au format URL) de la liste de contrôle d'accès de l'application au principal spécifié. Par exemple, local:user:api@3tera.com doit être passé sous la forme local%3Auser%3Aapi%403tera.com

owner

Attribut de propriétaire (codé au format URL) de la liste de contrôle d'accès de la grille se rapportant au principal spécifié

acl

Liste codée au format URL de principaux séparés par une barre oblique (/)

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemples

Remplacer l'intégralité de la liste de contrôle d'accès pour l'application test par un propriétaire api@3tera.com

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=&vdc=mygrid 

Remplacer 'intégralité de la liste de contrôle d'accès pour l'application test par un propriétaire api@3tera.com et le principal local:user:api@3tera.com=full

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl= local%3Auser%3Aapi%403tera.com%3Dfull&vdc=mygrid

Remplacer l'intégralité de la liste de contrôle d'accès pour l'application squelette test par un propriétaire api@3tera.com et le principal local:user:api@3tera.com=full/local:user:test@3tera.com=configure

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=local%3Auser%3Aapi%403tera.com%3Dfull%2Flocal%3Auser%3Atest%403tera.com%3Dconfigure&vdc=mygrid

Exemple de sortie

JSON

{
   "message" : ""
} 

XML

<message></message>

Codes d'erreur HTTP

404

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 (app). 
- La requête ne contient pas l'argument app=application.

Missing required arguments (owner)

- Argument owner=owner manquant

Missing required arguments (acl)

- Argument acl=acl manquant

404.1

Entity not found - Application test does not exist.

- Une application spécifiée n'existe pas sur mygrid.

Entity not found - Failed to put application ACL - invalid principal data - principal local user 'test@3tera.com' does not exist.

- Un propriétaire ou une liste de contrôle d'accès non valide a été spécifié(e)

Notes

Cette API est disponible avec WS_API_r6-1.0.6-1 et supérieur.