M3m3ter-com
PermissionPolicy

Create Permission Policy

Changed on

Create a new Permission Policy

NOTE: When you set up a policy statement for this call using the permissionPolicy request parameter to specify the effect, action, and resource, you must use all lower case and the format as shown in this example for a Permission Policy statement that grants full CRUD access to all meters:

"permissionPolicy" : [
	{
		"effect" : "allow",
		"action" : [
		"config:create",
		"config:delete",
		"config:retrieve",
		"config:update"
		]
		"resource" : [
		"config:meter/*"
		]
	}
]

For more details and further examples, see Understanding, Creating, and Managing Permission Policies in our main Documentation.

post/organizations/{orgId}/permissionpolicies

Request

Path parameters

orgIdstring required

UUID of the organization

Request body

versioninteger

The version number of the entity:

  • Create entity: Not valid for initial insertion of new entity - do not use for Create. On initial Create, version is set at 1 and listed in the response.
  • Update Entity: On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.
namestring required

Response

Returns the new Permission Policy

idstring required

The UUID of the entity.

versioninteger

The version number:

  • Create: On initial Create to insert a new entity, the version is set at 1 in the response.
  • Update: On successful Update, the version is incremented by 1 in the response.
namestring

The name of the Permission Policy.

managedPolicyboolean

Indicates whether this is a system generated Managed Permission Policy.

dtCreatedstring date-time

The date and time (in ISO-8601 format) when the Permission Policy was created.

dtLastModifiedstring date-time

The date and time (in ISO-8601 format) when the Permission Policy was last modified.

createdBystring

The unique identifier (UUID) of the user who created this Permission Policy.

lastModifiedBystring

The unique identifier (UUID) of the user who last modified this Permission Policy.

Changes

  • 85c514abc692Revision changes
    • breaking

      the response's property type changed from no type to object for status

  • ac93d1a9e6d9Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new AUDIT_RETRIEVE enum value to the request property ///

    • info

      added subschema #2 to the response body allOf list for the response status