Organizations
PolicyGroups

NewPolicyGroup

Creates a new Policy Group for an organization. Policy Groups define which Policy Packs are enforced on which stacks or cloud accounts, with configurable enforcement levels (advisory, mandatory, or disabled) per pack. This allows different policy strictness for different environments, such as advisory-only in development and mandatory in production.

post/api/orgs/{orgName}/policygroups

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/orgs/{orgName}/policygroups
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Request body

agentPoolIdstring

Agent pool ID for policy evaluation. Defaults to Pulumi hosted pool if not specified.

entityType'stacks' | 'accounts' required

The type of entities this policy group applies to (stacks or accounts). Fixed at creation; it cannot be changed later.

mode'audit' | 'preventative'

The enforcement mode for the policy group (audit or preventative). Defaults to 'audit' for account policy groups, 'preventative' for stack policy groups. Fixed at creation; it cannot be changed later.

namestring required

The name of the new policy group. Up to 100 characters, made up of letters, numbers, hyphens, underscores, periods, or spaces, and may not begin or end with a space.

Response

No Content

Changes

No recorded changes to this operation across all 1 revision of this API.