Allocation - Put Allocations V2

Service:

Power Platform API

API Version:

2024-10-01

Set the allocations for the scope.

PUT https://api.powerplatform.com/licensing/allocationsV2?api-version=2024-10-01

URI Parameters

Name	In	Required	Type	Description
api-version	query	True	string	The API version.

Request Body

Name	Type	Description
allocatedEntitlements	EntitlementAllocationModel[]	Allocated entitlements.
scope	ScopeModel

Responses

Name	Type	Description
200 OK	NeptuneOperationResult	Success
400 Bad Request		Bad Request
401 Unauthorized		Unauthorized
403 Forbidden		Forbidden

Security

oauth2

Microsoft Entra ID OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com

Scopes

Name	Description
.default	.default

Definitions

Name	Description
AllocationEnforcementRule
AllocationEnforcementRuleTypes	The type of an allocation enforcement rule.
AllocationModel
AllocationPutRequestModel	Allocation put request model.
EntitlementAllocationModel
EntitlementUnit	The unit of measure for an entitlement.
NeptuneOperationResult	The result of a Neptune operation.
ScopeModel

AllocationEnforcementRule

Object

Name	Type	Description
enabled	boolean
ruleType	AllocationEnforcementRuleTypes	The type of an allocation enforcement rule.

AllocationEnforcementRuleTypes

Enumeration

The type of an allocation enforcement rule.

Value	Description
NotSpecified
Alert
PayGo
TenantPool
Deny
Throttle

AllocationModel

Object

Name	Type	Description
autoAllocated	number (double)
quantity	number (double)
unit	EntitlementUnit	The unit of measure for an entitlement.

AllocationPutRequestModel

Object

Allocation put request model.

Name	Type	Description
allocatedEntitlements	EntitlementAllocationModel[]	Allocated entitlements.
scope	ScopeModel

EntitlementAllocationModel

Object

Name	Type	Description
allocation	AllocationModel
enforcementRules	AllocationEnforcementRule[]
entitlementId	string

EntitlementUnit

Enumeration

The unit of measure for an entitlement.

Value	Description
NotSpecified
MB
Count
Hour

NeptuneOperationResult

Object

The result of a Neptune operation.

Name	Type	Description
isErrorResult	boolean	Indicates whether the operation result represents an error.
statusCode	integer (int32)	The HTTP status code of the operation result.

ScopeModel

Object

Name	Type	Description
environmentGroupId	string
environmentId	string
resourceId	string
tenantId	string
userGroupId	string
userId	string