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

Méthode put_acl (objet cat)

Description

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

Syntaxe

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

Arguments

cat

Nom du catalogue

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 (/)

Type de transaction

Synchrone

Type de requête

GET

Exemples

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

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

Remplacer l'intégralité de la liste de contrôle d'accès pour le catalogue 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/cat/put_acl?cat=/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 le catalogue 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/cat/put_acl?cat=/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

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 (cat)
- Argument cat=cat manquant

Missing required arguments (owner)

- Argument owner=owner manquant

Missing required arguments (acl)

- Argument acl=acl manquant

404.1

Entity not found - Catalog test does not exist.

- Un catalogue spécifié n'existe pas sur mygrid.

Entity not found - Failed to put catalog 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)

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