---
title: "PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}"
tags: ["Maccs"]
---

# PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Create MACC.

## Path parameters

- `subscriptionId` string, uuid, required
- `resourceGroupName` string, required
- `maccName` string, required

## Query parameters

- `api-version` string, required

## Request body

- Macc: Microsoft Azure Consumption Commitment.
  - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
  - `name` string: The name of the resource
  - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
  - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
    - `createdBy` string: The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
    - `createdAt` string, date-time: The timestamp of resource creation (UTC).
    - `lastModifiedBy` string: The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
    - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
  - `tags` object: Resource tags.
  - `location` string, required: The geo-location where the resource lives
  - `properties` MaccModelProperties: MACC properties
    - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Pending': Provisioning state for billing benefit resources. Includes the standard terminal states (Succeeded, Failed, Canceled) plus benefit-specific transition states.
    - `status` 'Unknown' | 'Scheduled' | 'Active' | 'Pending' | 'Failed' | 'Canceled' | 'Completed' | 'Stopped' | 'PendingSettlement' | 'ShortfallCharged' | 'ShortfallWaived': Represents the current status of the MACC.
    - `entityType` 'Primary' | 'Contributor', required: Represents type of the object being operated on. Possible values are primary or contributor.
    - `displayName` string: Display name
    - `productCode` string: Represents catalog UPN.
    - `billingAccountResourceId` string, arm-id: Fully-qualified identifier of the billing account where the MACC is applied. Present only for Enterprise Agreement customers. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}
    - `commitment` Commitment: Commitment towards the benefit.
      - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
      - `amount` number, double
      - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
    - `startAt` string, date-time: Must be start of month. Timestamp must be in the ISO date format YYYY-MM-DDT00:00:00Z.
    - `endAt` string, date-time: Must be end of month. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z.
    - `systemId` string: This is the globally unique identifier of the MACC which will not change for the lifetime of the MACC.
    - `automaticShortfall` 'Unknown' | 'Enabled' | 'Disabled': Represents the enablement status of a feature or settings.
    - `automaticShortfallSuppressReason` AutomaticShortfallSuppressReason: Optional field to record suppression reason for automatic shortfall.
      - `code` string: Code for the suppression reason.
      - `message` string: Message for suppression reason.
    - `shortfall` Shortfall: MACC shortfall
      - `productCode` string: Represents catalog UPN.
      - `charge` Commitment: Commitment towards the benefit.
        - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
        - `amount` number, double
        - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
      - `startAt` string, date-time: Start DateTime.
      - `endAt` string, date-time: End DateTime in UTC.
      - `resourceId` string, arm-id: Fully-qualified resource identifier of the credits associated with the shortfall.
      - `balanceVersion` number, float: Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created.
      - `systemId` string: This is an identifier of the shortfall which will not change for its lifetime.
    - `milestones` MaccMilestone[]: List of milestones associated with this MACC.
      - `milestoneId` string: Globally unique identifier for the milestone. Format: {guid}
      - `commitment` Price
        - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
        - `amount` number, double
      - `endAt` string, date-time: End date time for the milestone. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z.
      - `automaticShortfall` 'Unknown' | 'Enabled' | 'Disabled': Represents the enablement status of a feature or settings.
      - `automaticShortfallSuppressReason` AutomaticShortfallSuppressReason: Optional field to record suppression reason for automatic shortfall.
        - `code` string: Code for the suppression reason.
        - `message` string: Message for suppression reason.
      - `status` 'Unknown' | 'Scheduled' | 'Active' | 'Pending' | 'Failed' | 'Completed' | 'Canceled' | 'Removed' | 'PendingSettlement' | 'ShortfallCharged' | 'ShortfallWaived': Represents the current status of the Milestone.
      - `shortfall` Shortfall: MACC shortfall
        - `productCode` string: Represents catalog UPN.
        - `charge` Commitment: Commitment towards the benefit.
          - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
          - `amount` number, double
          - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
        - `startAt` string, date-time: Start DateTime.
        - `endAt` string, date-time: End DateTime in UTC.
        - `resourceId` string, arm-id: Fully-qualified resource identifier of the credits associated with the shortfall.
        - `balanceVersion` number, float: Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created.
        - `systemId` string: This is an identifier of the shortfall which will not change for its lifetime.
    - `resourceId` string, arm-id: This is the resource identifier of either the primary MACC or the contributor. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.
    - `allowContributors` boolean: Setting this to true means multi-entity.
    - `primaryResourceId` string, arm-id: Fully-qualified resource identifier of the primary MACC. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.
    - `primaryBillingAccountResourceId` string, arm-id: Fully-qualified billing account resource identifier of the primary MACC. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}.
    - `productDetails` ProductDetailsBase: Common product detail properties shared across all benefit resources
      - `skuTitle` string: SKU title of the product
      - `productFamily` string: The product family, for example "Azure" or "M365".
      - `productType` string: The type of the product.
    - `appliedScopeType` 'BillingAccount' | 'BillingProfile' | 'Customer': List of applied scope types supported for benefit resources.
    - `invitationId` string: Invitation identifier
    - `consumed` Price
      - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
      - `amount` number, double
  - `managedBy` string: The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.
  - `kind` string: Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. E.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.
  - `etag` string: The etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
  - `identity` ManagedServiceIdentity2: Managed service identity (system assigned and/or user assigned identities)
    - `principalId` string, uuid: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    - `tenantId` string, uuid: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned,UserAssigned', required: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    - `userAssignedIdentities` object: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
  - `sku` Sku: The resource model definition representing SKU
    - `name` string, required: The name of the SKU. E.g. P3. It is typically a letter+number code
    - `tier` 'Free' | 'Basic' | 'Standard' | 'Premium': This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
    - `size` string: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.
    - `family` string: If the service has different generations of hardware, for the same SKU, then that can be captured here.
    - `capacity` integer: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.
  - `plan` Plan: Plan for the resource.
    - `name` string, required: A user defined name of the 3rd Party Artifact that is being procured.
    - `publisher` string, required: The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic
    - `product` string, required: The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding.
    - `promotionCode` string: A publisher provided promotion code as provisioned in Data Market for the said product/artifact.
    - `version` string: The version of the desired product/artifact.

## Response `200`

Resource 'Macc' update operation succeeded

- Macc: Microsoft Azure Consumption Commitment.
  - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
  - `name` string: The name of the resource
  - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
  - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
    - `createdBy` string: The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
    - `createdAt` string, date-time: The timestamp of resource creation (UTC).
    - `lastModifiedBy` string: The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
    - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
  - `tags` object: Resource tags.
  - `location` string, required: The geo-location where the resource lives
  - `properties` MaccModelProperties: MACC properties
    - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Pending': Provisioning state for billing benefit resources. Includes the standard terminal states (Succeeded, Failed, Canceled) plus benefit-specific transition states.
    - `status` 'Unknown' | 'Scheduled' | 'Active' | 'Pending' | 'Failed' | 'Canceled' | 'Completed' | 'Stopped' | 'PendingSettlement' | 'ShortfallCharged' | 'ShortfallWaived': Represents the current status of the MACC.
    - `entityType` 'Primary' | 'Contributor', required: Represents type of the object being operated on. Possible values are primary or contributor.
    - `displayName` string: Display name
    - `productCode` string: Represents catalog UPN.
    - `billingAccountResourceId` string, arm-id: Fully-qualified identifier of the billing account where the MACC is applied. Present only for Enterprise Agreement customers. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}
    - `commitment` Commitment: Commitment towards the benefit.
      - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
      - `amount` number, double
      - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
    - `startAt` string, date-time: Must be start of month. Timestamp must be in the ISO date format YYYY-MM-DDT00:00:00Z.
    - `endAt` string, date-time: Must be end of month. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z.
    - `systemId` string: This is the globally unique identifier of the MACC which will not change for the lifetime of the MACC.
    - `automaticShortfall` 'Unknown' | 'Enabled' | 'Disabled': Represents the enablement status of a feature or settings.
    - `automaticShortfallSuppressReason` AutomaticShortfallSuppressReason: Optional field to record suppression reason for automatic shortfall.
      - `code` string: Code for the suppression reason.
      - `message` string: Message for suppression reason.
    - `shortfall` Shortfall: MACC shortfall
      - `productCode` string: Represents catalog UPN.
      - `charge` Commitment: Commitment towards the benefit.
        - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
        - `amount` number, double
        - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
      - `startAt` string, date-time: Start DateTime.
      - `endAt` string, date-time: End DateTime in UTC.
      - `resourceId` string, arm-id: Fully-qualified resource identifier of the credits associated with the shortfall.
      - `balanceVersion` number, float: Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created.
      - `systemId` string: This is an identifier of the shortfall which will not change for its lifetime.
    - `milestones` MaccMilestone[]: List of milestones associated with this MACC.
      - `milestoneId` string: Globally unique identifier for the milestone. Format: {guid}
      - `commitment` Price
        - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
        - `amount` number, double
      - `endAt` string, date-time: End date time for the milestone. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z.
      - `automaticShortfall` 'Unknown' | 'Enabled' | 'Disabled': Represents the enablement status of a feature or settings.
      - `automaticShortfallSuppressReason` AutomaticShortfallSuppressReason: Optional field to record suppression reason for automatic shortfall.
        - `code` string: Code for the suppression reason.
        - `message` string: Message for suppression reason.
      - `status` 'Unknown' | 'Scheduled' | 'Active' | 'Pending' | 'Failed' | 'Completed' | 'Canceled' | 'Removed' | 'PendingSettlement' | 'ShortfallCharged' | 'ShortfallWaived': Represents the current status of the Milestone.
      - `shortfall` Shortfall: MACC shortfall
        - `productCode` string: Represents catalog UPN.
        - `charge` Commitment: Commitment towards the benefit.
          - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
          - `amount` number, double
          - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
        - `startAt` string, date-time: Start DateTime.
        - `endAt` string, date-time: End DateTime in UTC.
        - `resourceId` string, arm-id: Fully-qualified resource identifier of the credits associated with the shortfall.
        - `balanceVersion` number, float: Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created.
        - `systemId` string: This is an identifier of the shortfall which will not change for its lifetime.
    - `resourceId` string, arm-id: This is the resource identifier of either the primary MACC or the contributor. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.
    - `allowContributors` boolean: Setting this to true means multi-entity.
    - `primaryResourceId` string, arm-id: Fully-qualified resource identifier of the primary MACC. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.
    - `primaryBillingAccountResourceId` string, arm-id: Fully-qualified billing account resource identifier of the primary MACC. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}.
    - `productDetails` ProductDetailsBase: Common product detail properties shared across all benefit resources
      - `skuTitle` string: SKU title of the product
      - `productFamily` string: The product family, for example "Azure" or "M365".
      - `productType` string: The type of the product.
    - `appliedScopeType` 'BillingAccount' | 'BillingProfile' | 'Customer': List of applied scope types supported for benefit resources.
    - `invitationId` string: Invitation identifier
    - `consumed` Price
      - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
      - `amount` number, double
  - `managedBy` string: The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.
  - `kind` string: Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. E.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.
  - `etag` string: The etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
  - `identity` ManagedServiceIdentity2: Managed service identity (system assigned and/or user assigned identities)
    - `principalId` string, uuid: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    - `tenantId` string, uuid: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned,UserAssigned', required: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    - `userAssignedIdentities` object: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
  - `sku` Sku: The resource model definition representing SKU
    - `name` string, required: The name of the SKU. E.g. P3. It is typically a letter+number code
    - `tier` 'Free' | 'Basic' | 'Standard' | 'Premium': This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
    - `size` string: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.
    - `family` string: If the service has different generations of hardware, for the same SKU, then that can be captured here.
    - `capacity` integer: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.
  - `plan` Plan: Plan for the resource.
    - `name` string, required: A user defined name of the 3rd Party Artifact that is being procured.
    - `publisher` string, required: The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic
    - `product` string, required: The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding.
    - `promotionCode` string: A publisher provided promotion code as provisioned in Data Market for the said product/artifact.
    - `version` string: The version of the desired product/artifact.

## Other responses

- `201`: Resource 'Macc' create operation succeeded
- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `524c785862c5`: 3 breaking
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2022-11-01) `47d61aaf3262`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2022-11-01) `88f404443c4f`: 1 info
  - endpoint added
- **2022-11-14** (2022-11-01) `2a40ceec2c00`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.BillingBenefits/maccs/:maccName/put.md)

---

[API](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits.md) - [All operations](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/revisions/524c785862c5?raw)
