uip gov aops-policy - Déploiement et Déployé-Politique

Syntaxe et options permettant d'attribuer des politiques de gouvernance AOps aux locataires, aux utilisateurs et aux groupes, et pour résoudre la politique effective au moment de l'exécution, à l'aide de `uip gov aops-policy` et `uip gov aops-policy-policy`.

uip gov aops-policy deployment attribue des politiques de gouvernance AOps aux sujets de gouvernance (locataires, utilisateurs, groupes); uip gov aops-policy deployed-policy résout quelle stratégie s'applique réellement au moment de l'exécution après la suppression de l'héritage. Pour créer les enregistrements de stratégie, consultez aops-policy. Pour la vue d’ensemble de l’outil parent, consultez uip gov.

Concepts

• L'ordre de résolution est utilisateur → groupe → locataire (l'utilisateur surpasse le groupe. Un sujet sans affectation explicite pour un (product, license type) hérite du niveau suivant.
• null épingle « Aucune politique» — la transmission de null comme configure d'une entrée policyIdentifier bloque explicitement l'héritage du niveau inférieur, plutôt que de laisser l'entrée non définie (qui hérite normalement).
• Chaque configure verbe est un remplacement complet, et non une fusion. Les entrées omises dans le fichier d'entrée sont supprimées de la liste d'attributions de ce sujet. Pour ajouter une affectation tout en conservant les autres, commencez par la sortie get de ce sujet, modifiez-la et soumettez à nouveau l'ensemble du tableau.
• L'étendue diffère par niveau: les affectations de locataires sont limitées à (productIdentifier, licenseTypeIdentifier) — une politique par type de licence par produit. Les remplacements d'utilisateur et de groupe sont limités à productIdentifier (pas spécifiques au type de licence).
• La suppression de la dernière affectation sur un locataire est refusée, et non ignorée en mode silencieux - le service de gouvernance traite l'enregistrement d'un tableau d'affectation vide comme une exception, donc deployment tenant remove explicitement des erreurs plutôt que de signaler un succès tout en laissant l'affectation en place. Épinglez "policyIdentifier": null via configure à la place.
• Pour vérifier ce qui s’applique réellement, utilisez deployed-policy, et non deployment ... get — ce dernier affiche uniquement les remplacements explicites à un niveau, et non le résultat résolu.

Synthèse

uip gov aops-policy deployment tenant list [--product-name <name>] [--limit <n>] [--offset <n>]
uip gov aops-policy deployment tenant get <tenantIdentifier>
uip gov aops-policy deployment tenant configure <tenantIdentifier> --tenant-name <name> --input <path>
uip gov aops-policy deployment tenant remove <tenantIdentifier> --product-name <name> [--license-type <type>]

uip gov aops-policy deployment user list [--limit <n>] [--offset <n>]
uip gov aops-policy deployment user get <userIdentifier>
uip gov aops-policy deployment user configure <userIdentifier> --user <name> --input <path> [--source <source>] [--email <email>]
uip gov aops-policy deployment user delete <userIdentifier>

uip gov aops-policy deployment group list [--limit <n>] [--offset <n>]
uip gov aops-policy deployment group get <groupIdentifier>
uip gov aops-policy deployment group configure <groupIdentifier> --group <name> --input <path> [--source <source>]
uip gov aops-policy deployment group delete <groupIdentifier>

uip gov aops-policy deployed-policy get <license-type> <product-name> <tenantIdentifier> [--s2s-token <token> [--user-id <id> | --tenant-only]]
uip gov aops-policy deployed-policy list <license-type> <product-name> <tenantIdentifier>

Chaque verbe accepte également --login-validity <minutes> (ignoré sur deployed-policy get lorsque --s2s-token est défini).

Locataire de déploiement uip gov aops-policy

Attributions de politique de base par locataire, étendues par (productIdentifier, licenseTypeIdentifier). Les affectations d'utilisateurs et de groupes les remplacent.

liste des locataires de déploiement uip gov aops-policy

Répertorie les locataires enregistrés dans le système de gouvernance avec leurs affectations actuelles. Déclenche une synchronisation en amont depuis OMS avant de revenir, de sorte que le résultat reflète le dernier catalogue de locataires (nouveaus locataires, état désactivé/réactivé) et pas seulement le cache local de la gouvernance.

Options

Long	Valeur (Value)	Description
--product-name <product-name>	string	Renvoyez uniquement les locataires ayant une affectation pour ce produit.
--limit <n>	Integer	Taille de la page. Par défaut 20.
--offset <n>	Integer	Index de page de base zéro.

Exemple

uip gov aops-policy deployment tenant list --product-name StudioX --limit 2

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeploymentTenantList",
  "Data": [
    {
      "identifier": "a1b2c3d4-0000-0000-0000-000000000100",
      "name": "Acme Tenant",
      "tenantPolicies": [
        { "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }
      ]
    }
  ]
}

uip gov aops-policy - Obtenir le locataire

Arguments

Nom	Requis	Objectif
<tenantIdentifier>	oui	GUID du locataire, à partir de tenant list.

Exemple

uip gov aops-policy deployment tenant get a1b2c3d4-0000-0000-0000-000000000100

Format des données (--sortie json)

Même forme qu'une entrée tenant list.

uip gov aops-policy configuration du locataire

Remplacez les affectations (product, license type) d'un locataire à partir d'un fichier JSON. Remplacement complet — les entrées qui ne sont pas dans le fichier sont supprimées. Déclenche une synchronisation OMS en amont avant l’enregistrement, de sorte qu’un locataire nouvellement créé (ou dont le statut a changé) soit réconcilié en premier.

Arguments

Nom	Requis	Objectif
<tenantIdentifier>	oui	GUID du locataire à configurer.

Options

Long	Valeur (Value)	Requis	Description
--tenant-name <tenantName>	string	oui	Nom complet — doit correspondre au nom du locataire dans le service de gouvernance.
--input <path>	Chemin d'accès	oui	Tableau JSON de {productIdentifier, licenseTypeIdentifier, policyIdentifier}. policyIdentifier: null épingles &`;Aucune politique`; omettez une entrée pour hériter normalement.

Exemple

uip gov aops-policy deployment tenant configure a1b2c3d4-0000-0000-0000-000000000100 --tenant-name "Acme Tenant" --input tenant-policies.json

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeploymentTenantConfigure",
  "Data": [
    { "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }
  ]
}

suppression de locataire de déploiement uip gov aops-policy

Supprimez la ou les affectations d'un locataire pour un produit sans réécrire vous-même la liste complète — un enregistrement de filtre de lecture côté client.

Remarque :

Non forme atomique. Cela est lu → filtrer → enregistrer; une modification simultanée vers le même locataire entre la lecture et l'enregistrement est perdue. Évitez d’exécuter simultanément sur le même locataire. Impossible d’effacer la dernière affectation — le service traite l’enregistrement d’un tableau vide comme une exception, de sorte que cette commande refuse ce cas plutôt que de signaler un faux succès. Épinglez "policyIdentifier": null via configure à la place.

Arguments

Nom	Requis	Objectif
<tenantIdentifier>	oui	GUID du locataire.

Options

Long	Valeur (Value)	Requis	Description
--product-name <product-name>	string	oui	Produit à désépingler.
--license-type <license-type>	string	non	Diminuer la suppression d'un type de licence. Omit pour supprimer chaque entrée de type de licence pour le produit.

Échec avec « Aucune affectation de stratégie correspondante à supprimer» si rien ne correspond.

Exemple

uip gov aops-policy deployment tenant remove a1b2c3d4-0000-0000-0000-000000000100 --product-name StudioX

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeploymentTenantRemove",
  "Data": {
    "removed": [{ "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }],
    "tenantPolicies": []
  }
}

utilisateur de déploiement uip gov aops-policy

Remplacements par utilisateur, étendus par productIdentifier uniquement (pas de type de licence). Les affectations d'utilisateur l'influencent sur le groupe et le locataire.

liste des utilisateurs de déploiement uip gov aops-policy

Répertorie les utilisateurs que le service de gouvernance a consultés (attribués une politique, ou importés), et non une liste complète du fournisseur d’identité.

Options

Long	Valeur (Value)	Description
--limit <n>	Integer	Taille de la page. Par défaut 20.
--offset <n>	Integer	Index de page de base zéro.

Exemple

uip gov aops-policy deployment user list --limit 2

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentUserList", "Data": [{ "identifier": "a1b2c3d4-0000-0000-0000-000000000201", "name": "[e-mail]", "source": "cloud" }] }

uip gov aops-policy utilisateur obtenir

Remplacements par produit explicitement attribués à un utilisateur — l'héritage locataire/groupe n'est pas résolu ici (utilisez deployed-policy get pour la valeur effective). Renvoie [] si l'utilisateur n'a pas de remplacement.

Arguments

Nom	Requis	Objectif
<userIdentifier>	oui	GUID de l’utilisateur, à partir de user list.

Exemple

uip gov aops-policy deployment user get a1b2c3d4-0000-0000-0000-000000000201

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentUserGet", "Data": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }

uip gov aops-policy configuration utilisateur

Remplacez les remplacements par produit d'un utilisateur. Enregistre automatiquement l’utilisateur (via un appel d’ajout d’utilisateur) s’il n’est pas déjà connu pour la gouvernance; dans le cas contraire, s’exécute comme une mise à jour et un remplacement complets.

Arguments

Nom	Requis	Objectif
<userIdentifier>	oui	GUID utilisateur à configurer — à partir de user list ou du fournisseur d'identité en amont.

Options

Long	Valeur (Value)	Requis	Description
--user <user>	string	oui	Nom affiché stocké avec le remplacement (affiché dans les journaux d'audit/l'IU).
--input <path>	Chemin d'accès	oui	Tableau JSON de {productIdentifier, policyIdentifier}. policyIdentifier: null épingles "Aucune politique".
--source <source>	string	non	Source du fournisseur d’identité (par exemple local, aad, cloud). local par défaut. Utilisé uniquement sur le chemin d’insertion — l’enregistrement lors de la première résolution résout plutôt la source du SIS.
--email <email>	string	non	Adresse e-mail utilisée uniquement lors de l'enregistrement d'un nouvel utilisateur. Ignoré une fois que l'utilisateur est déjà connu. La valeur par défaut est --user.

Exemple

uip gov aops-policy deployment user configure a1b2c3d4-0000-0000-0000-000000000201 --user [e-mail] --input user-policies.json

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeploymentUserConfigure",
  "Data": { "identifier": "a1b2c3d4-0000-0000-0000-000000000201", "userPolicies": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }
}

uip gov aops-policy suppression d'utilisateurs

Effacer chaque remplacement par produit pour un utilisateur en un seul appel — équivalent à configure avec un tableau vide, sans avoir besoin d'un fichier JSON. L’utilisateur revient à l’héritage du groupe/du locataire pour tous les produits par la suite.

Arguments

Nom	Requis	Objectif
<userIdentifier>	oui	GUID de l’utilisateur, à partir de user list.

Exemple

uip gov aops-policy deployment user delete a1b2c3d4-0000-0000-0000-000000000201

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentUserDelete", "Data": { "Status": "Deleted", "identifier": "a1b2c3d4-0000-0000-0000-000000000201" } }

groupe de déploiement uip gov aops-policy

Remplacements par groupe, étendus par productIdentifier. Se situe entre l’utilisateur et le locataire dans l’ordre de résolution (l’utilisateur gagne le groupe, le groupe gagne le locataire). La forme du verbe est identique à deployment user (list/get/configure/delete) — seul l'objet diffère.

liste des groupes de déploiement uip gov aops-policy

Options

Identique à deployment user list (--limit, --offset).

Exemple

uip gov aops-policy deployment group list --limit 2

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentGroupList", "Data": [{ "identifier": "a1b2c3d4-0000-0000-0000-000000000301", "name": "Engineering", "source": "cloud" }] }

uip gov aops-policy - Obtenir le groupe

Arguments

Nom	Requis	Objectif
<groupIdentifier>	oui	GUID de groupe, à partir de group list.

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentGroupGet", "Data": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }

Renvoie [] lorsque le groupe ne contient aucun remplacement.

configuration de groupe de déploiement uip gov aops-policy

Mêmes forme et comportement d’enregistrement automatique que deployment user configure, avec --group <name> à la place de --user <name> (aucune sémantique --email/--source ne diffère — --source a ici la même valeur par défaut/signification). Les membres du groupe se replient sur l'héritage du locataire pour tout produit non présent dans le fichier d'entrée.

Arguments

Nom	Requis	Objectif
<groupIdentifier>	oui	GUID de groupe à configurer.

Options

Long	Valeur (Value)	Requis	Description
--group <group>	string	oui	Nom complet stocké avec le remplacement.
--input <path>	Chemin d'accès	oui	Tableau JSON de {productIdentifier, policyIdentifier}.
--source <source>	string	non	Source du fournisseur d’identité. Par défaut local.

Exemple

uip gov aops-policy deployment group configure a1b2c3d4-0000-0000-0000-000000000301 --group Engineering --input group-policies.json

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeploymentGroupConfigure",
  "Data": { "identifier": "a1b2c3d4-0000-0000-0000-000000000301", "groupPolicies": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }
}

uip gov aops-policy - Suppression de groupes

Supprime le groupe et tous ses remplacements de politique de la gouvernance. Le groupe lui-même reste dans le fournisseur d’identité en amont — cela efface uniquement l’état de gouvernance. Les membres se replient sur des affectations au niveau de l'utilisateur ou du locataire.

Arguments

Nom	Requis	Objectif
<groupIdentifier>	oui	GUID de groupe, à partir de group list.

Format des données (--sortie json)

{ "Code": "AopsPolicyDeploymentGroupDelete", "Data": { "Status": "Deleted", "identifier": "a1b2c3d4-0000-0000-0000-000000000301" } }

uip gov aops-policy-policy

En lecture seule. Résout la politique efficace unique pour un sujet après la suppression de l'héritage — la réponse à « ce qui s'applique réellement à l'instant».

uip gov aops-policy-policy-get

Arguments

Nom	Requis	Objectif
<license-type>	oui	Nom du type de licence (par ex. Attended) — à partir de license-type list.
<product-name>	oui	Nom du produit (par ex. StudioX) — à partir de product list.
<tenantIdentifier>	oui	GUID du locataire — à partir de deployment tenant list.

Options

Long	Valeur (Value)	Description
--s2s-token <token>	string	Jeton du porteur de service à service, remplaçant le jeton de l'utilisateur pour cet appel uniquement. Préférez la variable d'environnement UIP_S2S_TOKEN sur cet indicateur - un jeton d'argument CLI est visible dans les listes de processus (ps aux, /proc/*/cmdline).
--user-id <userId>	string	Résolvez la politique effective pour cet utilisateur spécifique (parcours complet de l’utilisateur → du groupe → du locataire). Nécessite un jeton S2S. Capture mutuellement exclusive avec --tenant-only.
--tenant-only	Drapeau	Résolvez la politique au niveau du locataire uniquement, en ignorant les remplacements d'utilisateur/de groupe. Nécessite un jeton S2S. Capture mutuellement exclusive avec --user-id.

Trois modes de résolution: par défaut (jeton d'utilisateur de l'appelant, résolutions pour l'appelant), S2S + --user-id (résoudre pour un utilisateur spécifique), S2S + --tenant-only (au niveau du locataire uniquement). --user-id/--tenant-only sans jeton S2S échoue côté client.

Exemple

uip gov aops-policy deployed-policy get Attended StudioX a1b2c3d4-0000-0000-0000-000000000100

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeployedPolicyGet",
  "Data": { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Baseline StudioX Policy", "data": { "allowAnalytics": true, "maxProjects": 5 } }
}

Lorsqu'aucune règle ne correspond et qu'il n'y a pas de valeur par défaut, Data est { "Message": "No policy applies." } à la place (204 du serveur).

uip gov aops-policy - liste de politiques déployées

Contrairement à get (politique efficace de priorité supérieure uniquement), renvoie chaque règle qui s'applique à une (license type, product, tenant) pour l'utilisateur appelant, dans l'ordre de priorité — utile pour comprendre pourquoi une valeur particulière l'emporte. Jeton d'utilisateur uniquement; Le S2S/emprunt d’identité n’est pas pris en charge ici.

Arguments

Trois mêmes arguments positionnels que deployed-policy get.

Exemple

uip gov aops-policy deployed-policy list Attended StudioX a1b2c3d4-0000-0000-0000-000000000100

Format des données (--sortie json)

{
  "Code": "AopsPolicyDeployedPolicyList",
  "Data": [
    { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Baseline StudioX Policy", "priority": 10, "source": "Tenant" },
    { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000002", "name": "Restricted StudioX Policy", "priority": 20, "source": "User" }
  ]
}

Renvoie [] lorsqu’aucune règle ne s’applique.

Associé

• uip gov — Présentation de l’outil et Politiques d’accès.
• aops-policy — politique CRUD, catalogues de type de produit/licence, modèles.
• compliance-packs — regroupent les stratégies dans une infrastructure nommée.

Voir également

• Outils (extensions)
• Options globales
• Codes de sortie