From ef9baa56d852dc13fb927790206b5fde7011c6d9 Mon Sep 17 00:00:00 2001 From: chchen3 Date: Fri, 19 Jun 2026 12:54:17 -0700 Subject: [PATCH 1/4] Add billingbenefits stable 2026-06-01 version with TypeSpec changes --- .../CatalogGroup.tsp | 95 + .../ConditionalCreditTransaction.tsp | 47 + .../BillingBenefits.Management/Credit.tsp | 14 + .../CreditTransaction.tsp | 47 + .../MaccTransaction.tsp | 47 + .../SavingsPlanModel.tsp | 2 +- .../back-compatible.tsp | 2 +- .../BillingBenefits.Management/client.tsp | 313 +- .../ApplicableConditionalCreditList.json | 145 + .../2026-06-01/ApplicableDiscountsList.json | 90 + .../2026-06-01/ApplicableMaccsList.json | 44 + .../CatalogGroupsBillingAccountGet.json | 57 + .../CatalogGroupsBillingAccountList.json | 110 + .../CatalogGroupsBillingProfileGet.json | 58 + .../CatalogGroupsBillingProfileList.json | 111 + .../CatalogGroupsSubscriptionGet.json | 57 + .../CatalogGroupsSubscriptionList.json | 110 + .../2026-06-01/ConditionalCreditCancel.json | 101 + .../ConditionalCreditContributorGet.json | 95 + ...tionalCreditContributorGetFromPrimary.json | 65 + ...rsListFromApplicableConditionalCredit.json | 67 + ...onalCreditContributorsListFromPrimary.json | 68 + .../ConditionalCreditCreateContributor.json | 134 + ...ionalCreditCreateContributorsDisabled.json | 137 + .../ConditionalCreditCreateCustomTags.json | 152 + ...editCreateMilestonesDifferentCurrency.json | 62 + ...onditionalCreditCreateMinimumDuration.json | 137 + ...itionalCreditCreateMultipleMilestones.json | 249 + ...onalCreditCreateOverlappingMilestones.json | 62 + .../ConditionalCreditCreatePrimary.json | 231 + .../2026-06-01/ConditionalCreditDelete.json | 22 + .../2026-06-01/ConditionalCreditGet.json | 94 + .../ConditionalCreditTransactionGet.json | 42 + .../ConditionalCreditTransactionsList.json | 73 + .../2026-06-01/ConditionalCreditUpdate.json | 180 + .../ConditionalCreditUpdateContributor.json | 108 + ...ionalCreditUpdateLastMilestoneEndDate.json | 133 + ...onditionalCreditUpdateRemoveMilestone.json | 86 + .../ConditionalCreditValidateCancel.json | 33 + .../ConditionalCreditValidateCreate.json | 65 + ...tionalCreditValidateCreateContributor.json | 32 + .../ConditionalCreditValidateCreateError.json | 68 + ...nditionalCreditValidateCreateMultiple.json | 109 + .../ConditionalCreditValidateUpdate.json | 67 + ...alCreditValidateUpdateRemoveMilestone.json | 69 + ...ConditionalCreditsListByResourceGroup.json | 132 + .../ConditionalCreditsListBySubscription.json | 235 + .../2026-06-01/ContributorCreate.json | 104 + .../2026-06-01/ContributorEndDateUpdate.json | 68 + .../examples/2026-06-01/ContributorGet.json | 54 + .../2026-06-01/ContributorGetFromPrimary.json | 44 + ...tributorWithMilestonesAndShortfallGet.json | 91 + ...hMilestonesAndShortfallGetFromPrimary.json | 81 + .../ContributorWithMilestonesGet.json | 78 + ...ntributorWithMilestonesGetFromPrimary.json | 68 + .../ContributorsListFromApplicableMacc.json | 45 + .../ContributorsListFromPrimary.json | 46 + ...MilestonesAndShortfallListFromPrimary.json | 83 + ...ributorsWithMilestonesListFromPrimary.json | 71 + .../examples/2026-06-01/CreditCancel.json | 66 + .../2026-06-01/CreditChangeSponsor.json | 23 + .../examples/2026-06-01/CreditCreate.json | 129 + .../CreditCreateWithInvitation.json | 135 + .../examples/2026-06-01/CreditDelete.json | 20 + .../examples/2026-06-01/CreditGet.json | 59 + .../CreditListApplicableCredits.json | 67 + .../2026-06-01/CreditSourceCreate.json | 85 + .../2026-06-01/CreditSourceDelete.json | 15 + .../examples/2026-06-01/CreditSourceGet.json | 41 + .../2026-06-01/CreditSourceTagsUpdate.json | 47 + .../2026-06-01/CreditSourcesListByCredit.json | 44 + .../examples/2026-06-01/CreditTagsUpdate.json | 73 + .../2026-06-01/CreditTransactionGet.json | 42 + .../2026-06-01/CreditTransactionsList.json | 72 + .../CreditTransferCreditCreate.json | 113 + .../CreditsListByResourceGroup.json | 62 + .../2026-06-01/CreditsListBySubscription.json | 61 + .../2026-06-01/CreditsValidateCreate.json | 39 + .../examples/2026-06-01/DiscountCancel.json | 67 + .../examples/2026-06-01/DiscountGet.json | 60 + .../examples/2026-06-01/DiscountList.json | 93 + .../2026-06-01/DiscountResourceGroupList.json | 93 + .../2026-06-01/DiscountsCreateAffiliate.json | 90 + .../2026-06-01/DiscountsCreatePrimary.json | 141 + .../DiscountsCreatePrimaryBackfill.json | 136 + ...countsCreatePrimaryWithAzurePromotion.json | 110 + ...DiscountsCreatePrimaryWithCustomPrice.json | 182 + ...tePrimaryWithCustomPriceMultiCurrency.json | 224 + ...countsCreatePrimaryWithPriceGuarantee.json | 150 + .../examples/2026-06-01/DiscountsDelete.json | 20 + .../examples/2026-06-01/DiscountsUpdate.json | 76 + .../2026-06-01/DiscountsUpdateEndAt.json | 67 + .../2026-06-01/DiscountsValidateCreate.json | 51 + ...EndCustomerInvestmentFundCreditCreate.json | 206 + .../2026-06-01/FreeServicesCreate.json | 96 + .../2026-06-01/FreeServicesDelete.json | 24 + .../examples/2026-06-01/FreeServicesGet.json | 46 + .../FreeServicesListByResourceGroup.json | 81 + .../FreeServicesListBySubscription.json | 112 + .../2026-06-01/FreeServicesUpdate.json | 62 + .../MaccAndMilestoneCommitmentUpdate.json | 112 + .../MaccAndMilestoneEndDateUpdate.json | 102 + .../MaccAndMilestoneMultiPropertyUpdate.json | 117 + .../examples/2026-06-01/MaccCancel.json | 65 + .../2026-06-01/MaccChargeShortfall.json | 85 + .../2026-06-01/MaccContributorRuleUpdate.json | 70 + .../examples/2026-06-01/MaccCreate.json | 128 + .../examples/2026-06-01/MaccDelete.json | 20 + .../2026-06-01/MaccDisplayNameUpdate.json | 70 + .../examples/2026-06-01/MaccGet.json | 58 + ...ccMilestoneSuppressAutomaticShortfall.json | 107 + ...MilestoneUnsuppressAutomaticShortfall.json | 101 + .../2026-06-01/MaccMultiPropertyUpdate.json | 77 + .../MaccNoMilestonesCommitmentUpdate.json | 74 + .../MaccNoMilestonesEndDateUpdate.json | 70 + .../MaccSellerViewContributors.json | 101 + ...cSellerViewContributorsWithMilestones.json | 136 + ...ontributorsWithMilestonesAndShortfall.json | 162 + .../MaccSellerViewNoContributors.json | 70 + ...ellerViewWithMilestonesNoContributors.json | 81 + .../MaccSuppressAutomaticShortfall.json | 78 + .../examples/2026-06-01/MaccTagsUpdate.json | 72 + .../2026-06-01/MaccTransactionGet.json | 42 + .../2026-06-01/MaccTransactionsList.json | 72 + .../MaccUnsuppressAutomaticShortfall.json | 72 + .../2026-06-01/MaccValidateCancel.json | 33 + .../MaccValidateCancelWithMilestones.json | 33 + .../2026-06-01/MaccValidateCreate.json | 41 + .../MaccValidateCreateBackfilledMacc.json | 32 + .../MaccValidateCreateContributor.json | 35 + ...alidateCreateMilestonesOnExistingMacc.json | 54 + .../MaccValidateCreateMultiEntity.json | 59 + ...accValidateCreateNewMaccWithMilestone.json | 57 + .../2026-06-01/MaccValidateUpdate.json | 58 + .../MaccValidateUpdateCommitment.json | 37 + ...eUpdateCommitmentEndAtContributorRule.json | 39 + .../MaccValidateUpdateContributor.json | 34 + .../MaccValidateUpdateContributorRule.json | 33 + .../MaccValidateUpdateDisplayName.json | 33 + .../2026-06-01/MaccValidateUpdateEndAt.json | 34 + ...idateUpdateMaccAndMilestoneCommitment.json | 53 + ...ValidateUpdateMaccAndMilestoneEndDate.json | 43 + ...MaccValidateUpdateMilestoneCommitment.json | 53 + .../MaccValidateUpdateMilestoneEndDate.json | 43 + .../MaccValidateUpdateRemoveMilestones.json | 43 + .../MaccValidateUpdateSuppressShortfall.json | 37 + ...ateUpdateSuppressShortfallOnMilestone.json | 43 + ...MaccValidateUpdateUnsuppressShortfall.json | 33 + ...eUpdateUnsuppressShortfallOnMilestone.json | 39 + .../MaccValidateWriteOffWithMilestones.json | 33 + .../MaccWithMilestonesAndShortfallGet.json | 107 + .../2026-06-01/MaccWithMilestonesCancel.json | 87 + .../2026-06-01/MaccWithMilestonesCreate.json | 190 + .../2026-06-01/MaccWithMilestonesGet.json | 82 + ...hMilestonesUpdateLastMilestoneEndDate.json | 107 + .../MaccWithMilestonesWriteOff.json | 90 + .../2026-06-01/MaccWithShortfallGet.json | 70 + .../examples/2026-06-01/MaccWriteOff.json | 66 + .../2026-06-01/MaccsListByResourceGroup.json | 61 + .../2026-06-01/MaccsListBySubscription.json | 60 + .../2026-06-01/MaccsValidateCreate.json | 40 + ...accsWithMilestonesListByResourceGroup.json | 85 + ...MaccsWithMilestonesListBySubscription.json | 84 + .../MilestonesCreateOnExistingMacc.json | 102 + .../2026-06-01/MilestonesRemoveFromMacc.json | 75 + .../examples/2026-06-01/OperationsGet.json | 114 + .../2026-06-01/PromotionalCreditCreate.json | 124 + .../ReservationOrderAliasCreate.json | 99 + ...onOrderAliasCreateWithRenewProperties.json | 102 + .../2026-06-01/ReservationOrderAliasGet.json | 41 + ...ationOrderAliasGetWithRenewProperties.json | 43 + .../SSCacoFlexibleValidateCreate.json | 65 + ...eValidateCreateMultipleInvalidOverlap.json | 115 + ...bleValidateCreateMultipleValidOverlap.json | 109 + .../SSCacoFlexibleValidateUpdate.json | 67 + .../SavingsPlanItemExpandedGet.json | 85 + .../2026-06-01/SavingsPlanItemGet.json | 65 + .../SavingsPlanOrderAliasCreate.json | 84 + ...avingsPlanOrderAliasCreateSingleScope.json | 93 + .../2026-06-01/SavingsPlanOrderAliasGet.json | 39 + .../2026-06-01/SavingsPlanOrderElevate.json | 21 + .../SavingsPlanOrderExpandedGet.json | 337 + .../2026-06-01/SavingsPlanOrderGet.json | 33 + .../2026-06-01/SavingsPlanOrderList.json | 36 + .../2026-06-01/SavingsPlanUpdate.json | 113 + .../SavingsPlanValidatePurchase.json | 69 + .../2026-06-01/SavingsPlanValidateUpdate.json | 43 + .../2026-06-01/SavingsPlansInOrderList.json | 71 + .../examples/2026-06-01/SavingsPlansList.json | 92 + .../SavingsPlansValidateCreate.json | 42 + .../BillingBenefits.Management/main.tsp | 8 +- .../BillingBenefits.Management/models.tsp | 730 +- .../sdk-suppressions.yaml | 7 + .../BillingBenefits.Management/tspconfig.yaml | 8 +- .../stable/2026-06-01/billingbenefits.json | 10263 ++++++++++++++++ .../ApplicableConditionalCreditList.json | 145 + .../examples/ApplicableDiscountsList.json | 90 + .../examples/ApplicableMaccsList.json | 44 + .../CatalogGroupsBillingAccountGet.json | 57 + .../CatalogGroupsBillingAccountList.json | 110 + .../CatalogGroupsBillingProfileGet.json | 58 + .../CatalogGroupsBillingProfileList.json | 111 + .../CatalogGroupsSubscriptionGet.json | 57 + .../CatalogGroupsSubscriptionList.json | 110 + .../examples/ConditionalCreditCancel.json | 101 + ...tionalCreditContributorGetFromPrimary.json | 65 + ...rsListFromApplicableConditionalCredit.json | 67 + ...onalCreditContributorsListFromPrimary.json | 68 + .../ConditionalCreditCreateContributor.json | 134 + .../ConditionalCreditCreatePrimary.json | 231 + .../examples/ConditionalCreditDelete.json | 22 + .../examples/ConditionalCreditGet.json | 94 + .../ConditionalCreditTransactionGet.json | 42 + .../ConditionalCreditTransactionsList.json | 73 + .../examples/ConditionalCreditUpdate.json | 180 + .../ConditionalCreditUpdateContributor.json | 108 + ...ionalCreditUpdateLastMilestoneEndDate.json | 133 + .../ConditionalCreditValidateCancel.json | 33 + .../ConditionalCreditValidateCreate.json | 65 + ...tionalCreditValidateCreateContributor.json | 32 + .../ConditionalCreditValidateCreateError.json | 68 + ...nditionalCreditValidateCreateMultiple.json | 109 + .../ConditionalCreditValidateUpdate.json | 67 + ...alCreditValidateUpdateRemoveMilestone.json | 69 + ...ConditionalCreditsListByResourceGroup.json | 132 + .../ConditionalCreditsListBySubscription.json | 235 + .../examples/ContributorCreate.json | 104 + .../examples/ContributorEndDateUpdate.json | 68 + .../2026-06-01/examples/ContributorGet.json | 54 + .../examples/ContributorGetFromPrimary.json | 44 + ...tributorWithMilestonesAndShortfallGet.json | 91 + ...hMilestonesAndShortfallGetFromPrimary.json | 81 + .../ContributorWithMilestonesGet.json | 78 + ...ntributorWithMilestonesGetFromPrimary.json | 68 + .../ContributorsListFromApplicableMacc.json | 45 + .../examples/ContributorsListFromPrimary.json | 46 + ...MilestonesAndShortfallListFromPrimary.json | 83 + ...ributorsWithMilestonesListFromPrimary.json | 71 + .../2026-06-01/examples/CreditCancel.json | 66 + .../examples/CreditChangeSponsor.json | 23 + .../2026-06-01/examples/CreditCreate.json | 129 + .../examples/CreditCreateWithInvitation.json | 135 + .../2026-06-01/examples/CreditDelete.json | 20 + .../stable/2026-06-01/examples/CreditGet.json | 59 + .../examples/CreditListApplicableCredits.json | 67 + .../examples/CreditSourceCreate.json | 85 + .../examples/CreditSourceDelete.json | 15 + .../2026-06-01/examples/CreditSourceGet.json | 41 + .../examples/CreditSourceTagsUpdate.json | 47 + .../examples/CreditSourcesListByCredit.json | 44 + .../2026-06-01/examples/CreditTagsUpdate.json | 73 + .../examples/CreditTransactionGet.json | 42 + .../examples/CreditTransactionsList.json | 72 + .../examples/CreditTransferCreditCreate.json | 113 + .../examples/CreditsListByResourceGroup.json | 62 + .../examples/CreditsListBySubscription.json | 61 + .../examples/CreditsValidateCreate.json | 39 + .../2026-06-01/examples/DiscountCancel.json | 67 + .../2026-06-01/examples/DiscountGet.json | 60 + .../2026-06-01/examples/DiscountList.json | 93 + .../examples/DiscountResourceGroupList.json | 93 + .../examples/DiscountsCreateAffiliate.json | 90 + .../examples/DiscountsCreatePrimary.json | 141 + .../DiscountsCreatePrimaryBackfill.json | 136 + ...countsCreatePrimaryWithAzurePromotion.json | 110 + ...DiscountsCreatePrimaryWithCustomPrice.json | 182 + ...tePrimaryWithCustomPriceMultiCurrency.json | 224 + ...countsCreatePrimaryWithPriceGuarantee.json | 150 + .../2026-06-01/examples/DiscountsDelete.json | 20 + .../2026-06-01/examples/DiscountsUpdate.json | 76 + .../examples/DiscountsUpdateEndAt.json | 67 + .../examples/DiscountsValidateCreate.json | 51 + ...EndCustomerInvestmentFundCreditCreate.json | 206 + .../examples/FreeServicesCreate.json | 96 + .../examples/FreeServicesDelete.json | 24 + .../2026-06-01/examples/FreeServicesGet.json | 46 + .../FreeServicesListByResourceGroup.json | 81 + .../FreeServicesListBySubscription.json | 112 + .../examples/FreeServicesUpdate.json | 62 + .../MaccAndMilestoneCommitmentUpdate.json | 112 + .../MaccAndMilestoneEndDateUpdate.json | 102 + .../MaccAndMilestoneMultiPropertyUpdate.json | 117 + .../2026-06-01/examples/MaccCancel.json | 65 + .../examples/MaccChargeShortfall.json | 85 + .../examples/MaccContributorRuleUpdate.json | 70 + .../2026-06-01/examples/MaccCreate.json | 128 + .../2026-06-01/examples/MaccDelete.json | 20 + .../examples/MaccDisplayNameUpdate.json | 70 + .../stable/2026-06-01/examples/MaccGet.json | 58 + ...ccMilestoneSuppressAutomaticShortfall.json | 107 + ...MilestoneUnsuppressAutomaticShortfall.json | 101 + .../examples/MaccMultiPropertyUpdate.json | 77 + .../MaccNoMilestonesCommitmentUpdate.json | 74 + .../MaccNoMilestonesEndDateUpdate.json | 70 + .../examples/MaccSellerViewContributors.json | 101 + ...cSellerViewContributorsWithMilestones.json | 136 + ...ontributorsWithMilestonesAndShortfall.json | 162 + .../MaccSellerViewNoContributors.json | 70 + ...ellerViewWithMilestonesNoContributors.json | 81 + .../MaccSuppressAutomaticShortfall.json | 78 + .../2026-06-01/examples/MaccTagsUpdate.json | 72 + .../examples/MaccTransactionGet.json | 42 + .../examples/MaccTransactionsList.json | 72 + .../MaccUnsuppressAutomaticShortfall.json | 72 + .../examples/MaccValidateCancel.json | 33 + .../MaccValidateCancelWithMilestones.json | 33 + .../examples/MaccValidateCreate.json | 41 + .../MaccValidateCreateBackfilledMacc.json | 32 + .../MaccValidateCreateContributor.json | 35 + ...alidateCreateMilestonesOnExistingMacc.json | 54 + .../MaccValidateCreateMultiEntity.json | 59 + ...accValidateCreateNewMaccWithMilestone.json | 57 + .../examples/MaccValidateUpdate.json | 58 + .../MaccValidateUpdateCommitment.json | 37 + ...eUpdateCommitmentEndAtContributorRule.json | 39 + .../MaccValidateUpdateContributor.json | 34 + .../MaccValidateUpdateContributorRule.json | 33 + .../MaccValidateUpdateDisplayName.json | 33 + .../examples/MaccValidateUpdateEndAt.json | 34 + ...idateUpdateMaccAndMilestoneCommitment.json | 53 + ...ValidateUpdateMaccAndMilestoneEndDate.json | 43 + ...MaccValidateUpdateMilestoneCommitment.json | 53 + .../MaccValidateUpdateMilestoneEndDate.json | 43 + .../MaccValidateUpdateRemoveMilestones.json | 43 + .../MaccValidateUpdateSuppressShortfall.json | 37 + ...ateUpdateSuppressShortfallOnMilestone.json | 43 + ...MaccValidateUpdateUnsuppressShortfall.json | 33 + ...eUpdateUnsuppressShortfallOnMilestone.json | 39 + .../MaccValidateWriteOffWithMilestones.json | 33 + .../MaccWithMilestonesAndShortfallGet.json | 107 + .../examples/MaccWithMilestonesCancel.json | 87 + .../examples/MaccWithMilestonesCreate.json | 190 + .../examples/MaccWithMilestonesGet.json | 82 + ...hMilestonesUpdateLastMilestoneEndDate.json | 107 + .../examples/MaccWithMilestonesWriteOff.json | 90 + .../examples/MaccWithShortfallGet.json | 70 + .../2026-06-01/examples/MaccWriteOff.json | 66 + .../examples/MaccsListByResourceGroup.json | 61 + .../examples/MaccsListBySubscription.json | 60 + .../examples/MaccsValidateCreate.json | 40 + ...accsWithMilestonesListByResourceGroup.json | 85 + ...MaccsWithMilestonesListBySubscription.json | 84 + .../MilestonesCreateOnExistingMacc.json | 102 + .../examples/MilestonesRemoveFromMacc.json | 75 + .../2026-06-01/examples/OperationsGet.json | 114 + .../examples/PromotionalCreditCreate.json | 124 + .../examples/ReservationOrderAliasCreate.json | 99 + ...onOrderAliasCreateWithRenewProperties.json | 102 + .../examples/ReservationOrderAliasGet.json | 41 + ...ationOrderAliasGetWithRenewProperties.json | 43 + .../SSCacoFlexibleValidateCreate.json | 65 + ...eValidateCreateMultipleInvalidOverlap.json | 115 + ...bleValidateCreateMultipleValidOverlap.json | 109 + .../SSCacoFlexibleValidateUpdate.json | 67 + .../examples/SavingsPlanItemExpandedGet.json | 85 + .../examples/SavingsPlanItemGet.json | 65 + .../examples/SavingsPlanOrderAliasCreate.json | 84 + ...avingsPlanOrderAliasCreateSingleScope.json | 93 + .../examples/SavingsPlanOrderAliasGet.json | 39 + .../examples/SavingsPlanOrderElevate.json | 21 + .../examples/SavingsPlanOrderExpandedGet.json | 337 + .../examples/SavingsPlanOrderGet.json | 33 + .../examples/SavingsPlanOrderList.json | 36 + .../examples/SavingsPlanUpdate.json | 113 + .../examples/SavingsPlanValidatePurchase.json | 69 + .../examples/SavingsPlanValidateUpdate.json | 43 + .../examples/SavingsPlansInOrderList.json | 71 + .../2026-06-01/examples/SavingsPlansList.json | 92 + .../examples/SavingsPlansValidateCreate.json | 42 + .../resource-manager/readme.md | 11 +- 370 files changed, 39559 insertions(+), 425 deletions(-) create mode 100644 specification/billingbenefits/BillingBenefits.Management/CatalogGroup.tsp create mode 100644 specification/billingbenefits/BillingBenefits.Management/ConditionalCreditTransaction.tsp create mode 100644 specification/billingbenefits/BillingBenefits.Management/CreditTransaction.tsp create mode 100644 specification/billingbenefits/BillingBenefits.Management/MaccTransaction.tsp create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableConditionalCreditList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableDiscountsList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableMaccsList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGetFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromApplicableConditionalCredit.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributorsDisabled.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateCustomTags.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMilestonesDifferentCurrency.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMinimumDuration.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMultipleMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateOverlappingMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreatePrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionsList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateContributor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateLastMilestoneEndDate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateRemoveMilestone.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateContributor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateError.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateMultiple.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdateRemoveMilestone.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListByResourceGroup.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListBySubscription.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorEndDateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGetFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGetFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGetFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromApplicableMacc.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesAndShortfallListFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesListFromPrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditChangeSponsor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreateWithInvitation.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditListApplicableCredits.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceTagsUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourcesListByCredit.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTagsUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionsList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransferCreditCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListByResourceGroup.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListBySubscription.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountResourceGroupList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreateAffiliate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimary.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryBackfill.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithAzurePromotion.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPrice.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithPriceGuarantee.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdateEndAt.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/EndCustomerInvestmentFundCreditCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListByResourceGroup.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListBySubscription.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneCommitmentUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneEndDateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneMultiPropertyUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccChargeShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccContributorRuleUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDelete.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDisplayNameUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneSuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneUnsuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMultiPropertyUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesCommitmentUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesEndDateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributors.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestonesAndShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewNoContributors.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewWithMilestonesNoContributors.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTagsUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionsList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccUnsuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancelWithMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateBackfilledMacc.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateContributor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMilestonesOnExistingMacc.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMultiEntity.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateNewMaccWithMilestone.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitment.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitmentEndAtContributorRule.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributor.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributorRule.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateDisplayName.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateEndAt.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneCommitment.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneEndDate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneCommitment.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneEndDate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateRemoveMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfallOnMilestone.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfall.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfallOnMilestone.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateWriteOffWithMilestones.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesAndShortfallGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCancel.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesUpdateLastMilestoneEndDate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesWriteOff.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithShortfallGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWriteOff.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListByResourceGroup.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListBySubscription.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListByResourceGroup.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListBySubscription.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesCreateOnExistingMacc.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesRemoveFromMacc.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/OperationsGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/PromotionalCreditCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreateWithRenewProperties.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGetWithRenewProperties.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleValidOverlap.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemExpandedGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreateSingleScope.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderElevate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderExpandedGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderGet.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidatePurchase.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidateUpdate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansInOrderList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansList.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansValidateCreate.json create mode 100644 specification/billingbenefits/BillingBenefits.Management/sdk-suppressions.yaml create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/billingbenefits.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableConditionalCreditList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableDiscountsList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableMaccsList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorGetFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromApplicableConditionalCredit.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreateContributor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreatePrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionsList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateContributor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateLastMilestoneEndDate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateContributor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateError.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateMultiple.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdateRemoveMilestone.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListByResourceGroup.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListBySubscription.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorEndDateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGetFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGetFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGetFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromApplicableMacc.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesAndShortfallListFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesListFromPrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditChangeSponsor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreateWithInvitation.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditListApplicableCredits.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceTagsUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourcesListByCredit.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTagsUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionsList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransferCreditCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListByResourceGroup.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListBySubscription.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountResourceGroupList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreateAffiliate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimary.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryBackfill.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithAzurePromotion.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPrice.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithPriceGuarantee.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdateEndAt.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/EndCustomerInvestmentFundCreditCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListByResourceGroup.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListBySubscription.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneCommitmentUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneEndDateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneMultiPropertyUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccChargeShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccContributorRuleUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDelete.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDisplayNameUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneSuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneUnsuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMultiPropertyUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesCommitmentUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesEndDateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributors.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestones.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestonesAndShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewNoContributors.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewWithMilestonesNoContributors.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTagsUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionsList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccUnsuppressAutomaticShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancelWithMilestones.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateBackfilledMacc.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateContributor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMilestonesOnExistingMacc.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMultiEntity.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateNewMaccWithMilestone.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitment.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitmentEndAtContributorRule.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributor.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributorRule.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateDisplayName.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateEndAt.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneCommitment.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneEndDate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneCommitment.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneEndDate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateRemoveMilestones.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfallOnMilestone.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfall.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfallOnMilestone.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateWriteOffWithMilestones.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesAndShortfallGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCancel.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesUpdateLastMilestoneEndDate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesWriteOff.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithShortfallGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWriteOff.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListByResourceGroup.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListBySubscription.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListByResourceGroup.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListBySubscription.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesCreateOnExistingMacc.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesRemoveFromMacc.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/OperationsGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/PromotionalCreditCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreateWithRenewProperties.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGetWithRenewProperties.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleValidOverlap.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemExpandedGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreateSingleScope.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderElevate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderExpandedGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderGet.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidatePurchase.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidateUpdate.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansInOrderList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansList.json create mode 100644 specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansValidateCreate.json diff --git a/specification/billingbenefits/BillingBenefits.Management/CatalogGroup.tsp b/specification/billingbenefits/BillingBenefits.Management/CatalogGroup.tsp new file mode 100644 index 000000000000..04c57c0b35e5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/CatalogGroup.tsp @@ -0,0 +1,95 @@ +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "@typespec/http"; +import "@typespec/rest"; +import "./models.tsp"; + +using TypeSpec.Http; +using TypeSpec.Rest; +using Azure.ResourceManager; +using TypeSpec.Versioning; + +namespace Microsoft.BillingBenefits; + +/** + * A catalog group represents a BenefitResourceType + Namespace grouping used for benefit SKU discovery. + */ +model CatalogGroup + is Azure.ResourceManager.ProxyResource { + ...ResourceNameParameter< + Resource = CatalogGroup, + KeyName = "catalogGroupName", + SegmentName = "catalogGroups", + NamePattern = "^[a-zA-Z0-9_\\-\\.]+$" + >; +} + +/** + * Additional parameters for the CatalogGroups list operation. + */ +model CatalogGroupsListParameters { + /** + * OData filter expression to narrow the list of catalog groups. + */ + @query("$filter") + $filter?: string; +} + +/** + * Reusable CatalogGroup extension operations for a specific target scope. + */ +interface CatalogGroupsExtensionOps { + /** + * List catalog groups at the target scope. + */ + list is Extension.ListByTarget< + Scope, + CatalogGroup, + CatalogGroupsListParameters + >; + + /** + * Get a specific catalog group at the target scope. + */ + get is Extension.Read; +} + +/** + * Subscription scope: /subscriptions/{subscriptionId} + */ +alias SubscriptionScope = Extension.Subscription; + +/** + * Billing account scope: /providers/Microsoft.Billing/billingAccounts/{billingAccountName} + */ +alias BillingAccountScope = Extension.ExternalResource< + TargetNamespace = "Microsoft.Billing", + ResourceType = "billingAccounts", + ResourceParameterName = "billingAccountName", + NamePattern = "^[a-zA-Z0-9_\\-\\.:]+$", + Description = "The name of the billing account.", + ParentType = "Tenant" +>; + +/** + * Billing profile scope: /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName} + */ +alias BillingProfileScope = Extension.ExternalChildResource< + BillingAccountScope, + "billingProfiles", + "billingProfileName", + NamePattern = "^[a-zA-Z0-9_\\-\\.]+$", + Description = "The name of the billing profile." +>; + +@armResourceOperations +interface SubscriptionCatalogGroupsOps + extends CatalogGroupsExtensionOps {} + +@armResourceOperations +interface BillingAccountCatalogGroupsOps + extends CatalogGroupsExtensionOps {} + +@armResourceOperations +interface BillingProfileCatalogGroupsOps + extends CatalogGroupsExtensionOps {} diff --git a/specification/billingbenefits/BillingBenefits.Management/ConditionalCreditTransaction.tsp b/specification/billingbenefits/BillingBenefits.Management/ConditionalCreditTransaction.tsp new file mode 100644 index 000000000000..5cbf4ed90187 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/ConditionalCreditTransaction.tsp @@ -0,0 +1,47 @@ +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "@typespec/openapi"; +import "@typespec/rest"; +import "./models.tsp"; +import "./ConditionalCredit.tsp"; + +using TypeSpec.Rest; +using Azure.ResourceManager; +using TypeSpec.Http; +using TypeSpec.OpenAPI; +using TypeSpec.Versioning; + +namespace Microsoft.BillingBenefits; + +/** + * Transaction resource definition for ConditionalCredits + */ +@parentResource(ConditionalCredit) +model ConditionalCreditTransaction + is Azure.ResourceManager.ProxyResource { + ...ResourceNameParameter< + Resource = ConditionalCreditTransaction, + KeyName = "transactionName", + SegmentName = "transactions", + NamePattern = "^[a-zA-Z0-9_\\-\\.]+$" + >; +} + +@armResourceOperations +interface ConditionalCreditTransactions { + /** + * Get a specific transaction for a conditional credit. + */ + get is ArmResourceRead; + + /** + * List all transactions for a conditional credit. + */ + listByParent is ArmResourceListByParent< + ConditionalCreditTransaction, + Response = ArmResponse + >; +} + +@@doc(ConditionalCreditTransaction.name, "Name of the transaction"); +@@doc(ConditionalCreditTransaction.properties, "Transaction properties"); diff --git a/specification/billingbenefits/BillingBenefits.Management/Credit.tsp b/specification/billingbenefits/BillingBenefits.Management/Credit.tsp index fceb7a73083f..8976ab864601 100644 --- a/specification/billingbenefits/BillingBenefits.Management/Credit.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/Credit.tsp @@ -136,6 +136,20 @@ interface Credits { | (ArmResponse & ArmAsyncOperationHeader) | ArmAcceptedLroResponse> >; + + /** + * Change the sponsor of a credit. + */ + #suppress "@azure-tools/typespec-azure-resource-manager/arm-post-operation-response-codes" "LintDiff PostResponseCodes requires 204 for no-content LRO final response" + @Azure.Core.useFinalStateVia("location") + changeSponsor is ArmResourceActionAsyncBase< + Credit, + Request = ChangeSponsorRequest, + BaseParameters = Azure.ResourceManager.Foundations.DefaultBaseParameters, + Response = + | ArmAcceptedLroResponse + | NoContentResponse + >; } @@doc(Credit.name, "Name of the credit"); diff --git a/specification/billingbenefits/BillingBenefits.Management/CreditTransaction.tsp b/specification/billingbenefits/BillingBenefits.Management/CreditTransaction.tsp new file mode 100644 index 000000000000..42d69d61924b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/CreditTransaction.tsp @@ -0,0 +1,47 @@ +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "@typespec/openapi"; +import "@typespec/rest"; +import "./models.tsp"; +import "./Credit.tsp"; + +using TypeSpec.Rest; +using Azure.ResourceManager; +using TypeSpec.Http; +using TypeSpec.OpenAPI; +using TypeSpec.Versioning; + +namespace Microsoft.BillingBenefits; + +/** + * Transaction resource definition for Credits + */ +@parentResource(Credit) +model CreditTransaction + is Azure.ResourceManager.ProxyResource { + ...ResourceNameParameter< + Resource = CreditTransaction, + KeyName = "transactionName", + SegmentName = "transactions", + NamePattern = "^[a-zA-Z0-9_\\-\\.]+$" + >; +} + +@armResourceOperations +interface CreditTransactions { + /** + * Get a specific transaction for a credit. + */ + get is ArmResourceRead; + + /** + * List all transactions for a credit. + */ + listByParent is ArmResourceListByParent< + CreditTransaction, + Response = ArmResponse + >; +} + +@@doc(CreditTransaction.name, "Name of the transaction"); +@@doc(CreditTransaction.properties, "Transaction properties"); diff --git a/specification/billingbenefits/BillingBenefits.Management/MaccTransaction.tsp b/specification/billingbenefits/BillingBenefits.Management/MaccTransaction.tsp new file mode 100644 index 000000000000..a944d9644c6d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/MaccTransaction.tsp @@ -0,0 +1,47 @@ +import "@azure-tools/typespec-azure-core"; +import "@azure-tools/typespec-azure-resource-manager"; +import "@typespec/openapi"; +import "@typespec/rest"; +import "./models.tsp"; +import "./Macc.tsp"; + +using TypeSpec.Rest; +using Azure.ResourceManager; +using TypeSpec.Http; +using TypeSpec.OpenAPI; +using TypeSpec.Versioning; + +namespace Microsoft.BillingBenefits; + +/** + * Transaction resource definition for Maccs + */ +@parentResource(Macc) +model MaccTransaction + is Azure.ResourceManager.ProxyResource { + ...ResourceNameParameter< + Resource = MaccTransaction, + KeyName = "transactionName", + SegmentName = "transactions", + NamePattern = "^[a-zA-Z0-9_\\-\\.]+$" + >; +} + +@armResourceOperations +interface MaccTransactions { + /** + * Get a specific transaction for a MACC. + */ + get is ArmResourceRead; + + /** + * List all transactions for a MACC. + */ + listByParent is ArmResourceListByParent< + MaccTransaction, + Response = ArmResponse + >; +} + +@@doc(MaccTransaction.name, "Name of the transaction"); +@@doc(MaccTransaction.properties, "Transaction properties"); diff --git a/specification/billingbenefits/BillingBenefits.Management/SavingsPlanModel.tsp b/specification/billingbenefits/BillingBenefits.Management/SavingsPlanModel.tsp index 297397c567a8..597540827fff 100644 --- a/specification/billingbenefits/BillingBenefits.Management/SavingsPlanModel.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/SavingsPlanModel.tsp @@ -97,5 +97,5 @@ interface SavingsPlanModels { { parameters: ExpandParameter, }, - "!go,!javascript,!csharp" + "!go,!javascript" ); diff --git a/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp b/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp index 0af15f58b700..10cc65a544a0 100644 --- a/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp @@ -5,7 +5,7 @@ using Microsoft.BillingBenefits; // @@clientLocation and @@clientName decorators for operations that originally had @operationId // All @operationId decorators have been removed and replaced with these client customizations -@@clientLocation(SavingsPlanOperationGroup.listAll, "SavingsPlan", "!csharp"); +@@clientLocation(SavingsPlanOperationGroup.listAll, "SavingsPlan"); @@clientLocation(DiscountsOperationGroup.scopeList, Discounts); @@clientLocation(ReservationOrderAliasResponses.get, "ReservationOrderAlias"); diff --git a/specification/billingbenefits/BillingBenefits.Management/client.tsp b/specification/billingbenefits/BillingBenefits.Management/client.tsp index d375fd05663e..30b3c972ffa9 100644 --- a/specification/billingbenefits/BillingBenefits.Management/client.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/client.tsp @@ -4,317 +4,46 @@ import "@azure-tools/typespec-client-generator-core"; using Azure.ClientGenerator.Core; using Microsoft.BillingBenefits; +// go +@@clientLocation(BenefitOperationGroup.validate, "RP", "go"); +@@clientName(Microsoft.BillingBenefits.ResourceSku, "SKU", "go"); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentity, "ServiceManagedIdentity", - "go,java,python,javascript" + "go" ); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentityType, "ServiceManagedIdentityType", - "go,java,python,javascript" + "go" ); -// go -@@clientLocation(BenefitOperationGroup.validate, "RP", "go"); - // java @@clientLocation(BenefitOperationGroup.validate, "ResourceProviders", "java"); - -// csharp @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentity, - "BillingBenefitsManagedServiceIdentity", - "csharp" + "ServiceManagedIdentity", + "java" ); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentityType, - "BillingBenefitsManagedServiceIdentityType", - "csharp" -); -@@clientName( - ReservationOrderAliasResponse, - "BillingBenefitsReservationOrderAlias", - "csharp" -); -@@clientName( - AppliedScopeProperties, - "BillingBenefitsAppliedScopeProperties", - "csharp" -); -@@clientName(AppliedScopeType, "BillingBenefitsAppliedScopeType", "csharp"); -@@clientName(BillingPlan, "BillingBenefitsBillingPlan", "csharp"); -@@clientName(ProvisioningState, "BillingBenefitsProvisioningState", "csharp"); -@@clientName( - InstanceFlexibility, - "BillingBenefitsInstanceFlexibility", - "csharp" -); -@@clientName( - ReservedResourceType, - "BillingBenefitsReservedResourceType", - "csharp" -); -@@clientName(Term, "BillingBenefitsTerm", "csharp"); -@@clientName(SavingsPlanModel, "BillingBenefitsSavingsPlan", "csharp"); -@@clientName(Commitment, "BillingBenefitsCommitment", "csharp"); -@@clientName(CommitmentGrain, "BillingBenefitsCommitmentGrain", "csharp"); -@@clientName(ExtendedStatusInfo, "BillingBenefitsExtendedStatusInfo", "csharp"); -@@clientName(Utilization, "BillingBenefitsSavingsPlanUtilization", "csharp"); -@@clientName( - UtilizationAggregates, - "BillingBenefitsSavingsPlanUtilizationAggregate", - "csharp" -); -@@clientName(PurchaseRequest, "BillingBenefitsPurchaseContent", "csharp"); -@@clientName( - SavingsPlanValidResponseProperty, - "SavingsPlanValidateResult", - "csharp" -); -@@clientName( - SavingsPlanOrderAliasModel, - "BillingBenefitsSavingsPlanOrderAlias", - "csharp" -); -@@clientName( - SavingsPlanOrderModel, - "BillingBenefitsSavingsPlanOrder", - "csharp" -); -@@clientName( - RoleAssignmentEntity, - "BillingBenefitsRoleAssignmentEntity", - "csharp" -); -@@clientName(Price, "BillingBenefitsPrice", "csharp"); -@@clientName(PaymentDetail, "SavingsPlanOrderPaymentDetail", "csharp"); -@@clientName(PaymentStatus, "BillingBenefitsPaymentStatus", "csharp"); -@@clientName( - SavingsPlanUpdateValidateRequest, - "SavingsPlanUpdateValidateContent", - "csharp" -); -@@clientName( - SavingsPlanPurchaseValidateRequest, - "SavingsPlanPurchaseValidateContent", - "csharp" -); -@@clientName( - ReservationOrderAliasRequest, - "ReservationOrderAliasContent", - "csharp" -); -@@clientName( - SavingsPlanUpdateRequestProperties, - "BillingBenefitsSavingsPlanPatchProperties", - "csharp" -); -@@clientName( - ReservationOrderAliasResponseProperties.renew, - "IsRenewed", - "csharp" -); -@@clientName( - ReservationOrderAliasRequestProperties.renew, - "IsRenewed", - "csharp" -); -@@clientName( - SavingsPlanModelProperties.effectiveDateTime, - "EffectOn", - "csharp" -); -@@clientName(SavingsPlanModelProperties.expiryDateTime, "ExpireOn", "csharp"); -@@clientName(SavingsPlanModelProperties.renew, "IsRenewed", "csharp"); -@@clientName(PurchaseRequestProperties.effectiveDateTime, "EffectOn", "csharp"); -@@clientName(PurchaseRequestProperties.renew, "IsRenewed", "csharp"); -@@clientName(SavingsPlanValidResponseProperty.valid, "IsValid", "csharp"); -@@clientName( - SavingsPlanOrderModelProperties.expiryDateTime, - "ExpireOn", - "csharp" -); -@@clientName(PaymentDetail.paymentDate, "PayOn", "csharp"); -@@clientName(SavingsPlanUpdateRequestProperties.renew, "IsRenewed", "csharp"); -@@clientName(SavingsPlanOrderAliasProperties.renew, "IsRenewed", "csharp"); -@@clientName(BenefitValidateResponseProperty.valid, "IsValid", "csharp"); -@@clientName( - SellerResourceListRequestProperties.contributors, - "IncludeContributors", - "csharp" -); -@@clientName( - SellerResourceListRequestProperties.milestones, - "IncludeMilestones", - "csharp" -); -@@clientName( - MaccModelProperties.allowContributors, - "IsAllowContributors", - "csharp" -); -@@clientName( - MaccPatchRequestProperties.allowContributors, - "IsAllowContributors", - "csharp" -); -@@clientName(DiscountProperties, "BillingBenefitsDiscountProperties", "csharp"); -@@clientName( - ConditionalCreditProperties, - "BillingBenefitsConditionalCreditProperties", - "csharp" -); -@@alternateType( - ReservationOrderAliasResponseProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - ReservationOrderAliasResponseProperties.reservationOrderId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - ReservationOrderAliasRequestProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - AppliedScopeProperties.managementGroupId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - AppliedScopeProperties.subscriptionId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - AppliedScopeProperties.resourceGroupId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanModelProperties.billingAccountId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanModelProperties.billingProfileId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanModelProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - PurchaseRequestProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanOrderModelProperties.billingAccountId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanOrderModelProperties.billingProfileId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - RoleAssignmentEntity.id, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - RoleAssignmentEntityProperties.roleDefinitionId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - RoleAssignmentEntityProperties.scope, - Azure.Core.armResourceIdentifier, - "csharp" -); - -@@clientName(ReservedResourceType.CosmosDb, "CosmosDB", "csharp"); -@@clientName(ReservedResourceType.MariaDb, "MariaDB", "csharp"); -@@clientName(ReservedResourceType.AVS, "Avs", "csharp"); -@@clientName( - ReservationOrderAliasRequest, - "BillingBenefitsReservationOrderAliasCreateOrUpdateContent", - "csharp" -); -@@clientName( - SavingsPlanOperationGroup.listAll, - "GetBillingBenefitsSavingsPlans", - "csharp" -); -@@alternateType( - ReservationOrderAliasResponse.location, - Azure.Core.azureLocation, - "csharp" -); -@@alternateType( - SavingsPlanOrderAliasProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanOrderAliasProperties.savingsPlanOrderId, - Azure.Core.armResourceIdentifier, - "csharp" -); -@@alternateType( - SavingsPlanOrderModelProperties.billingScopeId, - Azure.Core.armResourceIdentifier, - "csharp" -); - -@@usage(SavingsPlanModelProperties, Usage.input | Usage.output, "csharp"); -@@usage(SavingsPlanModel, Usage.input | Usage.output, "csharp"); -@@usage(ReservationOrderAliasRequest, Usage.input | Usage.output, "csharp"); -@@usage( - ReservationOrderAliasRequestProperties, - Usage.input | Usage.output, - "csharp" -); -@@usage(PaymentDetail, Usage.input | Usage.output, "csharp"); -@@usage(BillingPlanInformation, Usage.input | Usage.output, "csharp"); -@@usage(ReservationOrderAliasResponse, Usage.input | Usage.output, "csharp"); -@@usage(SavingsPlanOrderModel, Usage.input | Usage.output, "csharp"); - -@@alternateType(AppliedScopeProperties.tenantId, Azure.Core.uuid, "csharp"); -@@alternateType( - ReservationOrderAliasRequest.location, - Azure.Core.azureLocation, - "csharp" + "ServiceManagedIdentityType", + "java" ); -// python: client name mitigation -@@clientName(Microsoft.BillingBenefits, "BillingBenefitsMgmtClient", "python"); - -// python: enum value naming mitigations -@@clientName(BillingPlan.P1M, "P1_M", "python"); -@@clientName(Term.P1Y, "P1_Y", "python"); -@@clientName(Term.P3Y, "P3_Y", "python"); -@@clientName(Term.P5Y, "P5_Y", "python"); - +// python @@clientName( - DiscountsOperationGroup.scopeList, - "listDiscountByScope", - "csharp" + Microsoft.BillingBenefits.ManagedServiceIdentity, + "ServiceManagedIdentity", + "python" ); @@clientName( - ConditionalCreditsOperationGroup.scopeList, - "listConditionalCreditByScope", - "csharp" + Microsoft.BillingBenefits.ManagedServiceIdentityType, + "ServiceManagedIdentityType", + "python" ); - -// csharp: preserve original public property name after flatten/lift-to-nullable generator fix -@@clientName(MaccModelProperties.entityType, "MaccEntityType", "csharp"); -@@clientName(DiscountType, "DiscountTypeEnum", "go"); +@@clientName(Microsoft.BillingBenefits, "BillingBenefitsRP", "python"); +@@clientName(Microsoft.BillingBenefits.Term.P1Y, "P1_Y", "python"); +@@clientName(Microsoft.BillingBenefits.Term.P3Y, "P3_Y", "python"); +@@clientName(Microsoft.BillingBenefits.Term.P5Y, "P5_Y", "python"); +@@clientName(Microsoft.BillingBenefits.BillingPlan.P1M, "P1_M", "python"); diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableConditionalCreditList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableConditionalCreditList.json new file mode 100644 index 000000000000..5d5d48c9f785 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableConditionalCreditList.json @@ -0,0 +1,145 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "C20251028000000000000", + "type": "Microsoft.BillingBenefits/applicableConditionalCredits", + "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/providers/microsoft.billingbenefits/applicableConditionalCredits/C20251028000000000000", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/conditionalcredits/testprimaryconditionalcredit", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2026-03-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Q1 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-10-01T00:00:00Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Q2 Milestone", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "C20251028000000000000", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/providers/microsoft.billingbenefits/applicableConditionalCredits/C20251028000000000000", + "location": "global", + "properties": { + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/conditionalcredits/testprimaryconditionalcredit2", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250802", + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q3 Milestone", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-07-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2026-04-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000" + }, + "systemData": { + "createdAt": "2025-09-02T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-02T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key3": "value3" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ScopeList", + "title": "ConditionalCreditScopeList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableDiscountsList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableDiscountsList.json new file mode 100644 index 000000000000..12c18755849b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableDiscountsList.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "13810867107109237", + "type": "Microsoft.BillingBenefits/applicableDiscounts", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableDiscounts/13810867107109237", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "63810867107109237", + "type": "Microsoft.BillingBenefits/applicableDiscounts", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableDiscounts/63810867107109237", + "location": "global", + "properties": { + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "63810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_ScopeList", + "title": "DiscountScopeList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableMaccsList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableMaccsList.json new file mode 100644 index 000000000000..d1409cb93610 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ApplicableMaccsList.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "13810867107109237", + "type": "Microsoft.BillingBenefits/applicableMaccs", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableMaccs/13810867107109237", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "ApplicableMaccs_List", + "title": "DiscountScopeList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountGet.json new file mode 100644 index 000000000000..e24ced4f6cec --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountGet.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "BillingAccountCatalogGroupsOps_Get", + "title": "BillingAccountCatalogGroupsGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountList.json new file mode 100644 index 000000000000..2c0cc6facd37 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingAccountList.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "BillingAccountCatalogGroupsOps_List", + "title": "BillingAccountCatalogGroupsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileGet.json new file mode 100644 index 000000000000..4262f95c4b48 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileGet.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "billingProfileName": "xxxx-xxxx-xxx-xxx", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "BillingProfileCatalogGroupsOps_Get", + "title": "BillingProfileCatalogGroupsGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileList.json new file mode 100644 index 000000000000..c36cce0ccfc8 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsBillingProfileList.json @@ -0,0 +1,111 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "billingProfileName": "xxxx-xxxx-xxx-xxx" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "BillingProfileCatalogGroupsOps_List", + "title": "BillingProfileCatalogGroupsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionGet.json new file mode 100644 index 000000000000..4f13abf54ed0 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionGet.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "SubscriptionCatalogGroupsOps_Get", + "title": "SubscriptionCatalogGroupsGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionList.json new file mode 100644 index 000000000000..37b33e161f30 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CatalogGroupsSubscriptionList.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "SubscriptionCatalogGroupsOps_List", + "title": "SubscriptionCatalogGroupsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCancel.json new file mode 100644 index 000000000000..1c0bf4812e99 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCancel.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Canceled" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765433" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Canceled" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368189?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Cancel", + "title": "ConditionalCreditCancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGet.json new file mode 100644 index 000000000000..50e2e8d3a8a1 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGet.json @@ -0,0 +1,95 @@ +{ + "parameters": { + "subscriptionId": "20000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_02", + "conditionalCreditName": "conditionalCredit_contributor_20250801", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Contributor", + "displayName": "Contributor Conditional Credit 20250801", + "systemId": "CACO-SYSTEM-20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-09-01T00:00:00Z", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "endAt": "2025-12-31T23:59:59Z", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "name": "Milestone 1", + "status": "Completed", + "endAt": "2025-09-30T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "award": { + "duration": "P3M", + "credit": { + "grain": "FullTerm", + "amount": 5000, + "currencyCode": "USD" + }, + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2025-12-31T23:59:59Z", + "balanceVersion": 13, + "systemId": "credit98765432" + } + }, + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "name": "Milestone 2", + "status": "Active", + "endAt": "2025-12-31T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "award": { + "duration": "P3M", + "credit": { + "grain": "FullTerm", + "amount": 5000, + "currencyCode": "USD" + } + } + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global", + "tags": { + "environment": "dev", + "team": "finance" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z" + } + } + } + }, + "operationId": "ConditionalCreditContributorGet", + "title": "ConditionalCredit_ContributorGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGetFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGetFromPrimary.json new file mode 100644 index 000000000000..5919911e51d8 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorGetFromPrimary.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "contributorName": "caco_contributor_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801/contributors/{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "caco contributor 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + } + }, + "operationId": "ConditionalCreditContributors_GetFromPrimary", + "title": "ConditionalCreditContributor_GetFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromApplicableConditionalCredit.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromApplicableConditionalCredit.json new file mode 100644 index 000000000000..a860a5dd420d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromApplicableConditionalCredit.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "systemId": "C20251028000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "contributor_caco_20250801", + "type": "Microsoft.BillingBenefits/applicableContributors", + "id": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/providers/Microsoft.BillingBenefits/applicableConditionalCredits/C20251028000000000000/providers/Microsoft.BillingBenefits/applicableContributors/contributor_caco_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + ] + } + } + }, + "operationId": "ConditionalCreditContributors_ListFromApplicableConditionalCredit", + "title": "ConditionalCreditContributorsScopeList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromPrimary.json new file mode 100644 index 000000000000..11dbc069fed5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditContributorsListFromPrimary.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801/contributors/{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Contributor CACO 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + ] + } + } + }, + "operationId": "ConditionalCreditContributors_ListFromPrimary", + "title": "ConditionalCreditContributors_ListFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributor.json new file mode 100644 index 000000000000..cd0a5cdf16d7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributor.json @@ -0,0 +1,134 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "displayName": "Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-09-01T00:00:00Z" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + "conditionalCreditName": "conditionalCredit_contributor_20250801", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Milestone 1", + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "name": "Milestone 2", + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-001", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + } + }, + "201": { + "body": { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Pending", + "startAt": "2025-09-01T00:00:00Z", + "status": "Pending", + "systemId": "CACO-SYSTEM-001", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_CreateOrUpdate", + "title": "ConditionalCreditCreateContributor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributorsDisabled.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributorsDisabled.json new file mode 100644 index 000000000000..bbb6cad8745d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateContributorsDisabled.json @@ -0,0 +1,137 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_contributors_disabled_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Contributors Disabled Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Disabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + } + ] + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributors_disabled_20251027", + "name": "conditionalCredit_contributors_disabled_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Contributors Disabled Example", + "systemId": "CACO-SYSTEM-DISABLED-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Scheduled", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440051", + "name": "Milestone 1", + "status": "Scheduled", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + }, + "200": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributors_disabled_20251027", + "name": "conditionalCredit_contributors_disabled_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Contributors Disabled Example", + "systemId": "CACO-SYSTEM-DISABLED-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440051", + "name": "Milestone 1", + "status": "Active", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + } + }, + "operationId": "ConditionalCredit_CreateContributorsDisabled", + "title": "ConditionalCreditCreateContributorsDisabled" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateCustomTags.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateCustomTags.json new file mode 100644 index 000000000000..f7d7e0f3d297 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateCustomTags.json @@ -0,0 +1,152 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_custom_tags_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Custom Tags Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Enabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + } + ] + }, + "tags": { + "department": "finance", + "project": "cloud-migration", + "environment": "test" + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_custom_tags_20251027", + "name": "conditionalCredit_custom_tags_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Custom Tags Example", + "systemId": "CACO-SYSTEM-TAGS-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Scheduled", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440041", + "name": "Milestone 1", + "status": "Scheduled", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global", + "tags": { + "department": "finance", + "project": "cloud-migration", + "environment": "test" + } + } + }, + "200": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_custom_tags_20251027", + "name": "conditionalCredit_custom_tags_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Custom Tags Example", + "systemId": "CACO-SYSTEM-TAGS-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440041", + "name": "Milestone 1", + "status": "Active", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global", + "tags": { + "department": "finance", + "project": "cloud-migration", + "environment": "test" + } + } + } + }, + "operationId": "ConditionalCredit_CreateCustomTags", + "title": "ConditionalCreditCreateCustomTags" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMilestonesDifferentCurrency.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMilestonesDifferentCurrency.json new file mode 100644 index 000000000000..4c53ae28e86c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMilestonesDifferentCurrency.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_milestones_diff_currency_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Milestones Different Currency Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Enabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + }, + { + "name": "Milestone 2", + "spendTarget": { + "amount": 2000, + "currencyCode": "EUR" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 200, + "currencyCode": "EUR" + } + }, + "endAt": "2025-12-31T23:59:59Z" + } + ] + } + } + }, + "responses": { + "400": { + "body": { + "error": { + "code": "InvalidRequest", + "message": "All milestones in a conditional credit must use the same currency." + } + } + } + }, + "operationId": "ConditionalCredit_CreateMilestonesDifferentCurrency", + "title": "ConditionalCreditCreateMilestonesDifferentCurrency" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMinimumDuration.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMinimumDuration.json new file mode 100644 index 000000000000..c4b764f0ce76 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMinimumDuration.json @@ -0,0 +1,137 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_minimum_duration_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Minimum Duration Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Enabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + } + ] + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_minimum_duration_20251027", + "name": "conditionalCredit_minimum_duration_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Minimum Duration Example", + "systemId": "CACO-SYSTEM-MIN-DURATION-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Scheduled", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440010", + "name": "Milestone 1", + "status": "Scheduled", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + }, + "200": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_minimum_duration_20251027", + "name": "conditionalCredit_minimum_duration_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Minimum Duration Example", + "systemId": "CACO-SYSTEM-MIN-DURATION-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440010", + "name": "Milestone 1", + "status": "Active", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + } + }, + "operationId": "ConditionalCredit_CreateMinimumDuration", + "title": "ConditionalCreditCreateMinimumDuration" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMultipleMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMultipleMilestones.json new file mode 100644 index 000000000000..d365168c5140 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateMultipleMilestones.json @@ -0,0 +1,249 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_multiple_milestones_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Multiple Milestones Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Enabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + }, + { + "name": "Milestone 2", + "spendTarget": { + "amount": 3000, + "currencyCode": "USD" + }, + "award": { + "duration": "P2M", + "credit": { + "amount": 300, + "currencyCode": "USD" + } + }, + "endAt": "2025-12-31T23:59:59Z" + }, + { + "name": "Milestone 3", + "spendTarget": { + "amount": 5000, + "currencyCode": "USD" + }, + "award": { + "duration": "P3M", + "credit": { + "amount": 500, + "currencyCode": "USD" + } + }, + "endAt": "2026-02-28T23:59:59Z" + } + ] + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_multiple_milestones_20251027", + "name": "conditionalCredit_multiple_milestones_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Multiple Milestones Example", + "systemId": "CACO-SYSTEM-MULTI-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2026-02-28T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Scheduled", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440021", + "name": "Milestone 1", + "status": "Scheduled", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "grain": "FullTerm", + "amount": 100, + "currencyCode": "USD" + }, + "startAt": "2025-12-01T00:00:00Z", + "endAt": "2025-12-31T23:59:59Z", + "balanceVersion": 13, + "systemId": "credit98765432" + } + }, + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440022", + "name": "Milestone 2", + "status": "Scheduled", + "endAt": "2025-12-31T23:59:59Z", + "spendTarget": { + "amount": 3000, + "currencyCode": "USD" + }, + "award": { + "duration": "P2M", + "credit": { + "grain": "FullTerm", + "amount": 300, + "currencyCode": "USD" + } + } + }, + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440023", + "name": "Milestone 3", + "status": "Scheduled", + "endAt": "2026-02-28T23:59:59Z", + "spendTarget": { + "amount": 5000, + "currencyCode": "USD" + }, + "award": { + "duration": "P3M", + "credit": { + "grain": "FullTerm", + "amount": 500, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + }, + "200": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_multiple_milestones_20251027", + "name": "conditionalCredit_multiple_milestones_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Multiple Milestones Example", + "systemId": "CACO-SYSTEM-MULTI-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2026-02-28T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "milestones": [ + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440021", + "name": "Milestone 1", + "status": "Active", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "grain": "FullTerm", + "amount": 100, + "currencyCode": "USD" + }, + "startAt": "2025-12-01T00:00:00Z", + "endAt": "2025-12-31T23:59:59Z", + "balanceVersion": 13, + "systemId": "credit98765432" + } + }, + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440022", + "name": "Milestone 2", + "status": "Active", + "endAt": "2025-12-31T23:59:59Z", + "spendTarget": { + "amount": 3000, + "currencyCode": "USD" + }, + "award": { + "duration": "P2M", + "credit": { + "grain": "FullTerm", + "amount": 300, + "currencyCode": "USD" + } + } + }, + { + "milestoneId": "550e8400-e29b-41d4-a716-446655440023", + "name": "Milestone 3", + "status": "Active", + "endAt": "2026-02-28T23:59:59Z", + "spendTarget": { + "amount": 5000, + "currencyCode": "USD" + }, + "award": { + "duration": "P3M", + "credit": { + "grain": "FullTerm", + "amount": 500, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + } + }, + "operationId": "ConditionalCredit_CreateMultipleMilestones", + "title": "ConditionalCreditCreateMultipleMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateOverlappingMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateOverlappingMilestones.json new file mode 100644 index 000000000000..a88ea21e9539 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreateOverlappingMilestones.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_overlapping_milestones_20251027", + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Overlapping Milestones Example", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "allowContributors": "Enabled", + "milestones": [ + { + "name": "Milestone 1", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P2M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + }, + "endAt": "2025-12-31T23:59:59Z" + }, + { + "name": "Milestone 2", + "spendTarget": { + "amount": 2000, + "currencyCode": "USD" + }, + "award": { + "duration": "P2M", + "credit": { + "amount": 200, + "currencyCode": "USD" + } + }, + "endAt": "2025-11-30T23:59:59Z" + } + ] + } + } + }, + "responses": { + "400": { + "body": { + "error": { + "code": "InvalidRequest", + "message": "Milestone periods must not overlap." + } + } + } + }, + "operationId": "ConditionalCredit_CreateOverlappingMilestones", + "title": "ConditionalCreditCreateOverlappingMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreatePrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreatePrimary.json new file mode 100644 index 000000000000..bdfea22c0f49 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditCreatePrimary.json @@ -0,0 +1,231 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": "Enabled", + "displayName": "Conditional Credit 20250801", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-09-30T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "name": "Milestone 2", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Pending" + }, + { + "name": "Milestone 2", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Pending" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Pending", + "startAt": "2025-07-01T00:00:00Z", + "status": "Pending", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_CreateOrUpdate", + "title": "ConditionalCreditCreatePrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditDelete.json new file mode 100644 index 000000000000..f99fb3265e26 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditDelete.json @@ -0,0 +1,22 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/6d3hhhh9-d553-6hde-cd33-d7hc6b580300?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": { + "description": "The resource has been deleted." + } + }, + "operationId": "ConditionalCredits_Delete", + "title": "ConditionalCreditDelete" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditGet.json new file mode 100644 index 000000000000..13dc81388a5f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditGet.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765433" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "ConditionalCredits_Get", + "title": "ConditionalCreditGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionGet.json new file mode 100644 index 000000000000..7dd589cc737a --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "benefits-rg", + "conditionalCreditName": "caco-20250101-001", + "transactionName": "txn-67890", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-67890", + "name": "txn-67890", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-20T10:30:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-X001540275", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 300.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 300.0 + }, + "productCode": "UPN24243", + "productDetails": { + "skuTitle": "Premium Block Blob Storage", + "productFamily": "Azure", + "productType": "Premium Block Blob Storage", + "serviceFamily": "Storage", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "ConditionalCreditTransactions_Get", + "title": "ConditionalCreditTransactionGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionsList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionsList.json new file mode 100644 index 000000000000..c75dfb550740 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditTransactionsList.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "caco-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-caco-001", + "name": "txn-caco-001", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "productCode": "UPN242547", + "productDetails": { + "skuTitle": "GPT-4 API", + "productFamily": "Azure", + "productType": "Azure OpenAI", + "serviceFamily": "AI + Machine Learning", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-caco-002", + "name": "txn-caco-002", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 250.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 250.0 + }, + "productCode": "UPN242548", + "productDetails": { + "skuTitle": "Multi-region writes", + "productFamily": "Azure", + "productType": "Azure Cosmos DB", + "serviceFamily": "Databases", + "publisherType": "Microsoft" + } + } + } + ], + "nextLink": null + } + } + }, + "operationId": "ConditionalCreditTransactions_ListByParent", + "title": "ConditionalCreditTransactionsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdate.json new file mode 100644 index 000000000000..3de6c46ea124 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdate.json @@ -0,0 +1,180 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated Conditional Credit 20250801", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 3", + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + } + } + ] + }, + "tags": { + "key1": "updated_value1", + "key3": "value3" + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Updated Conditional Credit 20250801", + "endAt": "2026-04-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "updated_value1", + "key3": "value3" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateContributor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateContributor.json new file mode 100644 index 000000000000..c6687f1fcab9 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateContributor.json @@ -0,0 +1,108 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated Contributor Conditional Credit 20250801" + }, + "tags": { + "environment": "test", + "team": "finance" + } + }, + "conditionalCreditName": "conditionalCreditContributor_20250801", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCreditContributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCreditContributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Updated Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "test", + "team": "finance" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/7e3ffff7-b331-4fcb-ab11-b5fa49368199?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdateContributor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateLastMilestoneEndDate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateLastMilestoneEndDate.json new file mode 100644 index 000000000000..dc69e7b296cd --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateLastMilestoneEndDate.json @@ -0,0 +1,133 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003" + } + ] + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2026-04-30T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M", + "endAt": "2026-02-28T23:59:59Z", + "startAt": "2026-02-01T00:00:00Z", + "systemId": "credit98765431" + }, + "endAt": "2026-01-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "name": "Milestone 1", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M", + "endAt": "2026-03-31T23:59:59Z", + "startAt": "2026-03-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2026-02-28T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "name": "Milestone 2", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "name": "Milestone 3", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + }, + "status": "Completed" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-11-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdateLastMilestoneEndDate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateRemoveMilestone.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateRemoveMilestone.json new file mode 100644 index 000000000000..450f7e36504e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditUpdateRemoveMilestone.json @@ -0,0 +1,86 @@ +{ + "parameters": { + "subscriptionId": "10000000-0000-0000-0000-000000000000", + "resourceGroupName": "resource_group_name_01", + "conditionalCreditName": "conditionalCredit_update_remove_milestone_20251027", + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Conditional Credit Update Remove Milestone Example", + "milestones": [ + { + "name": "Milestone 1", + "milestoneId": "550e8400-e29b-41d4-a716-446655440081", + "status": "Removed", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "credit": { + "grain": "FullTerm", + "amount": 100, + "currencyCode": "USD" + }, + "duration": "P1M" + } + } + ] + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_update_remove_milestone_20251027", + "name": "conditionalCredit_update_remove_milestone_20251027", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "properties": { + "entityType": "Primary", + "displayName": "Conditional Credit Update Remove Milestone Example", + "systemId": "CACO-SYSTEM-UPDATE-REMOVE-001", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-11-01T00:00:00Z", + "endAt": "2025-11-30T23:59:59Z", + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "provisioningState": "Succeeded", + "status": "Active", + "milestones": [ + { + "name": "Milestone 1", + "milestoneId": "550e8400-e29b-41d4-a716-446655440081", + "status": "Removed", + "endAt": "2025-11-30T23:59:59Z", + "spendTarget": { + "amount": 1000, + "currencyCode": "USD" + }, + "award": { + "duration": "P1M", + "credit": { + "amount": 100, + "currencyCode": "USD" + } + } + } + ], + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "location": "global" + } + } + }, + "operationId": "ConditionalCredit_UpdateRemoveMilestone", + "title": "ConditionalCreditUpdateRemoveMilestone" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCancel.json new file mode 100644 index 000000000000..36aa9428f5c3 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCancel.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "entityType": "Primary", + "resourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "status": "Canceled", + "systemId": "CACO-SYSTEM-20250801" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreate.json new file mode 100644 index 000000000000..d64941e3334c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreate.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Validation Test CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateContributor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateContributor.json new file mode 100644 index 000000000000..2a95df48b88b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateContributor.json @@ -0,0 +1,32 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "displayName": "Contributor CACO Test", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47/resourceGroups/primaryRG/providers/Microsoft.BillingBenefits/conditionalCredits/primaryCACO", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-09-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateContributor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateError.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateError.json new file mode 100644 index 000000000000..2faba94a5853 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateError.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "Invalid CACO Test", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 100000, + "currencyCode": "USD" + }, + "endAt": "2021-12-31T00:00:00Z", + "startAt": "2022-01-01T00:00:00Z" + }, + "endAt": "2022-12-31T00:00:00Z", + "spendTarget": { + "amount": -1000, + "currencyCode": "INVALID" + } + } + ], + "productCode": "b8473ce57f1d", + "startAt": "2023-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "displayName": "Invalid Contributor CACO", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/nonexistent", + "primaryResourceId": "/subscriptions/invalid/resourceGroups/invalid/providers/Microsoft.BillingBenefits/conditionalCredits/nonexistent", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2023-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "reason": "The billing account resource ID is missing or invalid", + "reasonCode": "InvalidBillingAccountId", + "valid": false + }, + { + "reason": "Start date must be the first day of the current or a future month", + "reasonCode": "InvalidStartAt", + "valid": false + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateError" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateMultiple.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateMultiple.json new file mode 100644 index 000000000000..cafeb04c39c5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateCreateMultiple.json @@ -0,0 +1,109 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "Standard CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "High Value CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "Special Product CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateMultiple" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdate.json new file mode 100644 index 000000000000..8c7c51d1b610 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdate.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Validation Test Update CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdateRemoveMilestone.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdateRemoveMilestone.json new file mode 100644 index 000000000000..84d7498861ba --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditValidateUpdateRemoveMilestone.json @@ -0,0 +1,69 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Validation Test Update CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Removed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Removed" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateUpdateRemoveMilestone" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListByResourceGroup.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListByResourceGroup.json new file mode 100644 index 000000000000..0bd498005644 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListByResourceGroup.json @@ -0,0 +1,132 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "nextLink": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits?api-version=2026-06-01&$skiptoken=abcd1234", + "value": [ + { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "conditionalCredit_simple_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_simple_20250801", + "location": "global", + "properties": { + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Simple Conditional Credit", + "entityType": "Primary", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-SIMPLE-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "production" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ListByResourceGroup", + "title": "ConditionalCreditsListByResourceGroup" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListBySubscription.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListBySubscription.json new file mode 100644 index 000000000000..c703382480be --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ConditionalCreditsListBySubscription.json @@ -0,0 +1,235 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "nextLink": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/conditionalCredits?api-version=2026-06-01&$skiptoken=xyz5678", + "value": [ + { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + { + "name": "conditionalCredit_simple_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_03/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_simple_20250801", + "location": "global", + "properties": { + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Simple Conditional Credit", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 2500, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 25000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-SIMPLE-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "production" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ListBySubscription", + "title": "ConditionalCreditsListBySubscription" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorCreate.json new file mode 100644 index 000000000000..f7df2b2d2348 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorCreate.json @@ -0,0 +1,104 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "Contributor_Create" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorEndDateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorEndDateUpdate.json new file mode 100644 index 000000000000..c0e865f91645 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorEndDateUpdate.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2023-07-10T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "contributor_macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/contributor_macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Contributor", + "milestones": [], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "Contributor_UpdateEndDate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGet.json new file mode 100644 index 000000000000..a7af428b0d09 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGet.json @@ -0,0 +1,54 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "Contributor_Get" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGetFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGetFromPrimary.json new file mode 100644 index 000000000000..a643781ed8c7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorGetFromPrimary.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGet.json new file mode 100644 index 000000000000..baba1c46c84c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGet.json @@ -0,0 +1,91 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 9, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall32109876" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "ContributorWithMilestonesAndShortfall_GetFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGetFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGetFromPrimary.json new file mode 100644 index 000000000000..fc93ec5bc791 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesAndShortfallGetFromPrimary.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 10, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "13810867107109238" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary_WithMilestonesAndShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGet.json new file mode 100644 index 000000000000..491411dcb678 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGet.json @@ -0,0 +1,78 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "ContributorWithMilestones_GetFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGetFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGetFromPrimary.json new file mode 100644 index 000000000000..23d78c7f128c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorWithMilestonesGetFromPrimary.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary_WithMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromApplicableMacc.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromApplicableMacc.json new file mode 100644 index 000000000000..996e3d1797d2 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromApplicableMacc.json @@ -0,0 +1,45 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "systemId": "13810867107109237" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "contributor_20230614", + "type": "Microsoft.BillingBenefits/applicableContributors", + "id": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/providers/Microsoft.BillingBenefits/applicableMaccs/13810867107109237/providers/Microsoft.BillingBenefits/applicableContributors/contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromApplicableMacc", + "title": "ContributorsScopeList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromPrimary.json new file mode 100644 index 000000000000..e1daf4578e3c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsListFromPrimary.json @@ -0,0 +1,46 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "Contributors_ListFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesAndShortfallListFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesAndShortfallListFromPrimary.json new file mode 100644 index 000000000000..99aff7c424aa --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesAndShortfallListFromPrimary.json @@ -0,0 +1,83 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 13, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "13810867107109238" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "ContributorsWithMilestonesAndShortfall_ListFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesListFromPrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesListFromPrimary.json new file mode 100644 index 000000000000..89808f245ad7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ContributorsWithMilestonesListFromPrimary.json @@ -0,0 +1,71 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "ContributorsWithMilestones_ListFromPrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCancel.json new file mode 100644 index 000000000000..ff805487b3c6 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCancel.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Canceled", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Cancel", + "title": "CreditCancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditChangeSponsor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditChangeSponsor.json new file mode 100644 index 000000000000..0d70dc467eb7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditChangeSponsor.json @@ -0,0 +1,23 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "body": { + "sponsorId": "P30000001" + } + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Credits_ChangeSponsor", + "title": "CreditChangeSponsor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreate.json new file mode 100644 index 000000000000..27ab8fa0f849 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreate.json @@ -0,0 +1,129 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreateWithInvitation.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreateWithInvitation.json new file mode 100644 index 000000000000..412425e5bd04 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditCreateWithInvitation.json @@ -0,0 +1,135 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "invitationId": "sampleInvitationId", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_invitation_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_invitation_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_invitation_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "invitationId": "sampleInvitationId", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_invitation_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_invitation_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "invitationId": "sampleInvitationId", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditCreateWithInvitation" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditDelete.json new file mode 100644 index 000000000000..3f8b83be1559 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Credits_Delete", + "title": "CreditDelete" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditGet.json new file mode 100644 index 000000000000..5e2161866856 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditGet.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Credits_Get", + "title": "CreditGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditListApplicableCredits.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditListApplicableCredits.json new file mode 100644 index 000000000000..ec671d12e6d7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditListApplicableCredits.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/applicableCredits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/applicableCredits/{systemId}", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/12345678", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/1185c37e-d180-5aea-03a3-07e2489791a8:3c9f6394-2029-4f58-bf47-76ebbb03136e_2019-05-31/billingProfiles/6EB6-D7AQ-BG7-TGB", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T23:59:59Z", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "reason": { + "description": "Outage credit (SLA)", + "code": "125" + }, + "resourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/credits/testprimarydiscount", + "startAt": "2023-07-01T00:00:00Z", + "status": "Succeeded", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/1185c37e-d180-5aea-03a3-07e2489791a8:3c9f6394-2029-4f58-bf47-76ebbb03136e_2019-05-31/customers/5334c5c9-e4b0-4170-a015-fa8fff5c226a", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListApplicable", + "title": "CreditSourcesListByCredit" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceCreate.json new file mode 100644 index 000000000000..84f3d85e8394 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceCreate.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Sources_Create", + "title": "CreditSourceCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceDelete.json new file mode 100644 index 000000000000..71de8b3c03d9 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceDelete.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": {}, + "204": {} + }, + "operationId": "Sources_Delete", + "title": "CreditSourceDelete" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceGet.json new file mode 100644 index 000000000000..7e9527152409 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceGet.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Sources_Get", + "title": "CreditSourceGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceTagsUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceTagsUpdate.json new file mode 100644 index 000000000000..919ba39688f5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourceTagsUpdate.json @@ -0,0 +1,47 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + } + }, + "operationId": "Sources_Update", + "title": "CreditSourceTagsUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourcesListByCredit.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourcesListByCredit.json new file mode 100644 index 000000000000..48872c8d92de --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditSourcesListByCredit.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Sources_ListByCredit", + "title": "CreditSourcesListByCredit" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTagsUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTagsUpdate.json new file mode 100644 index 000000000000..fd587ca416d1 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTagsUpdate.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileResourceId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/customers/{customerId}", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Update", + "title": "CreditTagsUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionGet.json new file mode 100644 index 000000000000..1f772e7e9df3 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "credit-rg", + "creditName": "credit-20250101-001", + "transactionName": "txn-mc-001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/credit-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-001", + "name": "txn-mc-001", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-12345", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "CreditTransactions_Get", + "title": "CreditTransactionGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionsList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionsList.json new file mode 100644 index 000000000000..6e7787c8eb96 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransactionsList.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-001", + "name": "txn-mc-001", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-002", + "name": "txn-mc-002", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 125.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 125.0 + }, + "productCode": "UPN242545", + "productDetails": { + "skuTitle": "P30 Disk", + "productFamily": "Azure", + "productType": "Premium SSD Managed Disks", + "serviceFamily": "Storage", + "publisherType": "Microsoft" + } + } + } + ] + } + } + }, + "operationId": "CreditTransactions_ListByParent", + "title": "CreditTransactionsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransferCreditCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransferCreditCreate.json new file mode 100644 index 000000000000..3a136deeda47 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditTransferCreditCreate.json @@ -0,0 +1,113 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "credit": { + "grain": "FullTerm", + "amount": 20000, + "currencyCode": "USD" + }, + "displayName": "Transfer Credit" + } + }, + "creditName": "credit_transfer_20260301", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_transfer_20260301", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_transfer_20260301", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-03-01T00:00:00Z", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Transfer Credit", + "startAt": "2026-03-01T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + } + }, + "systemData": { + "createdAt": "2026-03-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + } + } + }, + "201": { + "body": { + "name": "credit_transfer_20260301", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_transfer_20260301", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-03-01T00:00:00Z", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Transfer Credit", + "startAt": "2026-03-01T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + } + }, + "systemData": { + "createdAt": "2026-03-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditTransferCreditCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListByResourceGroup.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListByResourceGroup.json new file mode 100644 index 000000000000..bc3c98709183 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListByResourceGroup.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListByResourceGroup", + "title": "CreditsListByResourceGroup" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListBySubscription.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListBySubscription.json new file mode 100644 index 000000000000..e8a32cd9657c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsListBySubscription.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListBySubscription", + "title": "CreditsListBySubscription" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsValidateCreate.json new file mode 100644 index 000000000000..0645750e3751 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/CreditsValidateCreate.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Credits", + "properties": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2026-12-12T00:00:00Z" + } + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "CreditsValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountCancel.json new file mode 100644 index 000000000000..9c0c49dfe02b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountCancel.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testdiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Discounts_Cancel", + "title": "DiscountCancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountGet.json new file mode 100644 index 000000000000..b8870f316b7b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountGet.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discount_Get", + "title": "DiscountGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountList.json new file mode 100644 index 000000000000..27f06ed646cc --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountList.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_SubscriptionList", + "title": "DiscountSubscriptionList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountResourceGroupList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountResourceGroupList.json new file mode 100644 index 000000000000..f9d6faf59662 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountResourceGroupList.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_ResourceGroupList", + "title": "DiscountResourceGroupList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreateAffiliate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreateAffiliate.json new file mode 100644 index 000000000000..2691a5f4c247 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreateAffiliate.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "displayName": "Virtual Machines D Series", + "entityType": "Affiliate", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testaffiliatediscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreateAffiliate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimary.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimary.json new file mode 100644 index 000000000000..486b4d772c83 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimary.json @@ -0,0 +1,141 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimary" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryBackfill.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryBackfill.json new file mode 100644 index 000000000000..9a44b47de7e6 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryBackfill.json @@ -0,0 +1,136 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryBackfill" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithAzurePromotion.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithAzurePromotion.json new file mode 100644 index 000000000000..1655f895c05b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithAzurePromotion.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testazurepromotiondiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testazurepromotiondiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testazurepromotiondiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "systemId": "DISC-20250801-00000001" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testazurepromotiondiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testazurepromotiondiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "systemId": "DISC-20250801-00000001" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithAzurePromotion" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPrice.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPrice.json new file mode 100644 index 000000000000..2dd8a30a15f1 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPrice.json @@ -0,0 +1,182 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPrice", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPrice", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithCustomPrice" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json new file mode 100644 index 000000000000..a17a1a6f5659 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json @@ -0,0 +1,224 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithCustomPriceMultiCurrency" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithPriceGuarantee.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithPriceGuarantee.json new file mode 100644 index 000000000000..41b67e69e133 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsCreatePrimaryWithPriceGuarantee.json @@ -0,0 +1,150 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series Discount", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithPriceGuarantee" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsDelete.json new file mode 100644 index 000000000000..10a4ef4fce97 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testdiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Discounts_Delete", + "title": "ReservationOrderAliasCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdate.json new file mode 100644 index 000000000000..02f65870c972 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdate.json @@ -0,0 +1,76 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Virtual Machines D Series" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-Asyncoperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": "5" + } + } + }, + "operationId": "Discount_Update", + "title": "DiscountGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdateEndAt.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdateEndAt.json new file mode 100644 index 000000000000..47a4c465b986 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsUpdateEndAt.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2025-07-01T23:59:59Z" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2025-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + }, + "202": { + "headers": { + "Azure-Asyncoperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": "5" + } + } + }, + "operationId": "Discount_Update", + "title": "DiscountsUpdateEndAt" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsValidateCreate.json new file mode 100644 index 000000000000..d1e042b17dfb --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/DiscountsValidateCreate.json @@ -0,0 +1,51 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Discounts", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series Discount", + "endAt": "2027-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2026-07-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "DiscountsValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/EndCustomerInvestmentFundCreditCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/EndCustomerInvestmentFundCreditCreate.json new file mode 100644 index 000000000000..80f0d0161912 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/EndCustomerInvestmentFundCreditCreate.json @@ -0,0 +1,206 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "startAt": "2025-08-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2025-08-01T00:00:00Z", + "status": "Succeeded", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2025-08-01T00:00:00Z", + "status": "Pending", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "EndCustomerInvestmentFundCreditCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesCreate.json new file mode 100644 index 000000000000..0da6ddd16a74 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesCreate.json @@ -0,0 +1,96 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01", + "body": { + "location": "global", + "tags": { + "environment": "production" + }, + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + } + }, + "201": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "FreeServices_Create", + "title": "FreeServicesCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesDelete.json new file mode 100644 index 000000000000..e5c305eba140 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesDelete.json @@ -0,0 +1,24 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001?api-version=2025-12-01-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + }, + "204": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview" + } + } + }, + "operationId": "FreeServices_Delete", + "title": "FreeServicesDelete" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesGet.json new file mode 100644 index 000000000000..91f9e1a6fb31 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesGet.json @@ -0,0 +1,46 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + } + } + }, + "operationId": "FreeServices_Get", + "title": "FreeServicesGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListByResourceGroup.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListByResourceGroup.json new file mode 100644 index 000000000000..cd3f41a5fdec --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListByResourceGroup.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250901", + "name": "freeservice_20250901", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "b2c3d4e5-f6a7-8901-bcde-fa2345678901", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z" + } + } + ] + } + } + }, + "operationId": "FreeServices_ListByResourceGroup", + "title": "FreeServicesListByResourceGroup" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListBySubscription.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListBySubscription.json new file mode 100644 index 000000000000..db423cc58fb1 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesListBySubscription.json @@ -0,0 +1,112 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250901", + "name": "freeservice_20250901", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "b2c3d4e5-f6a7-8901-bcde-fa2345678901", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250801", + "name": "freeservice_20250801", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "c3d4e5f6-a7b8-9012-cdef-ab3456789012", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "development" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-08-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-08-01T01:01:01.1075056Z" + } + } + ] + } + } + }, + "operationId": "FreeServices_ListBySubscription", + "title": "FreeServicesListBySubscription" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesUpdate.json new file mode 100644 index 000000000000..8479b777973d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/FreeServicesUpdate.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2026-12-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-12-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "updated" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-11-01T01:01:01.1075056Z" + } + } + }, + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001?api-version=2025-12-01-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "FreeServices_Update", + "title": "FreeServicesUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneCommitmentUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneCommitmentUpdate.json new file mode 100644 index 000000000000..3a162ccda676 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneCommitmentUpdate.json @@ -0,0 +1,112 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneCommitment_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneEndDateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneEndDateUpdate.json new file mode 100644 index 000000000000..50afe9073e90 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneEndDateUpdate.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2029-05-01T23:59:59Z", + "milestones": [ + { + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2028-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2029-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2028-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneEndDate_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneMultiPropertyUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneMultiPropertyUpdate.json new file mode 100644 index 000000000000..229c9c3fcbbb --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccAndMilestoneMultiPropertyUpdate.json @@ -0,0 +1,117 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false, + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated with milestones", + "endAt": "2029-10-31T23:59:59Z", + "milestones": [ + { + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-06-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 35000, + "currencyCode": "USD" + }, + "endAt": "2028-06-30T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated with milestones", + "endAt": "2029-10-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-06-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 35000, + "currencyCode": "USD" + }, + "endAt": "2028-06-30T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneMultiProperty_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCancel.json new file mode 100644 index 000000000000..62c0a62feb8f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCancel.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Cancel", + "title": "Macc_Cancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccChargeShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccChargeShortfall.json new file mode 100644 index 000000000000..8b7032a59c70 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccChargeShortfall.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Canceled", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/{rgName}/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 3, + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall87654321" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_ChargeShortfall", + "title": "Maccs_ChargeShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccContributorRuleUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccContributorRuleUpdate.json new file mode 100644 index 000000000000..3cfa8f927f6b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccContributorRuleUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccEndContributorRule_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCreate.json new file mode 100644 index 000000000000..9b763523c357 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccCreate.json @@ -0,0 +1,128 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": true, + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "Macc_Create" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDelete.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDelete.json new file mode 100644 index 000000000000..06a198fedfdb --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Maccs_Delete", + "title": "ServiceSpecificIncentives_Delete" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDisplayNameUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDisplayNameUpdate.json new file mode 100644 index 000000000000..10460b6b594d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccDisplayNameUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated MACC Display Name" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Updated MACC Display Name", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccDisplayName_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccGet.json new file mode 100644 index 000000000000..71b074902d2d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccGet.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "Macc_Get" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneSuppressAutomaticShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneSuppressAutomaticShortfall.json new file mode 100644 index 000000000000..8bd4e893c70b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneSuppressAutomaticShortfall.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + }, + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMilestoneSuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneUnsuppressAutomaticShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneUnsuppressAutomaticShortfall.json new file mode 100644 index 000000000000..3b0071695a02 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMilestoneUnsuppressAutomaticShortfall.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "PendingSettlement" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-07-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMilestoneUnsuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMultiPropertyUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMultiPropertyUpdate.json new file mode 100644 index 000000000000..1cbe5db8b442 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccMultiPropertyUpdate.json @@ -0,0 +1,77 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false, + "commitment": { + "amount": 45000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated", + "endAt": "2024-10-01T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 45000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated", + "endAt": "2024-10-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMultiProperty_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesCommitmentUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesCommitmentUpdate.json new file mode 100644 index 000000000000..bf18c242b602 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesCommitmentUpdate.json @@ -0,0 +1,74 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + } + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccCommitment_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesEndDateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesEndDateUpdate.json new file mode 100644 index 000000000000..24186dc8ac49 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccNoMilestonesEndDateUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2023-07-10T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccEndDate_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributors.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributors.json new file mode 100644 index 000000000000..b17e5328d85f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributors.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 4, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall56789012" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor 1", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributors" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestones.json new file mode 100644 index 000000000000..aebe84df8f41 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestones.json @@ -0,0 +1,136 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "milestones": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc Contributor 1", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributorsWithMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestonesAndShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestonesAndShortfall.json new file mode 100644 index 000000000000..899e3bd1a86c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewContributorsWithMilestonesAndShortfall.json @@ -0,0 +1,162 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "milestones": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 5, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall76543210" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc Contributor 1", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "shortfall": { + "balanceVersion": 6, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall65432109" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributorsWithMilestonesAndShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewNoContributors.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewNoContributors.json new file mode 100644 index 000000000000..acc84e21b67f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewNoContributors.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/{rgName}/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 5, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall67890123" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewNoContributors" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewWithMilestonesNoContributors.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewWithMilestonesNoContributors.json new file mode 100644 index 000000000000..5c6b7458e402 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSellerViewWithMilestonesNoContributors.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "milestones": true + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewWithMilestonesNoContributors" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSuppressAutomaticShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSuppressAutomaticShortfall.json new file mode 100644 index 000000000000..a66ec0ad2ff2 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccSuppressAutomaticShortfall.json @@ -0,0 +1,78 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + } + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall." + }, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccSuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTagsUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTagsUpdate.json new file mode 100644 index 000000000000..b3650b204d69 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTagsUpdate.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": {}, + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccTags_Update" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionGet.json new file mode 100644 index 000000000000..aad2f367e0fd --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "macc-rg", + "maccName": "macc-20250101-001", + "transactionName": "txn-macc-001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/macc-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-001", + "name": "txn-macc-001", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-20T10:30:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-X001540275", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series Windows", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "MaccTransactions_Get", + "title": "MaccTransactionGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionsList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionsList.json new file mode 100644 index 000000000000..335dcd17c1b5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccTransactionsList.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-001", + "name": "txn-macc-001", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 150.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 150.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D4s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-002", + "name": "txn-macc-002", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 225.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 225.0 + }, + "productCode": "UPN242546", + "productDetails": { + "skuTitle": "Standard Firewall", + "productFamily": "Azure", + "productType": "Azure Firewall", + "serviceFamily": "Networking", + "publisherType": "Microsoft" + } + } + } + ] + } + } + }, + "operationId": "MaccTransactions_ListByParent", + "title": "MaccTransactionsList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccUnsuppressAutomaticShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccUnsuppressAutomaticShortfall.json new file mode 100644 index 000000000000..bfb942b09d57 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccUnsuppressAutomaticShortfall.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "PendingSettlement", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccUnsuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancel.json new file mode 100644 index 000000000000..8961b51bc992 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancel.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "Canceled", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancelWithMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancelWithMilestones.json new file mode 100644 index 000000000000..c904ccc6de57 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCancelWithMilestones.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "Canceled", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCancelWithMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreate.json new file mode 100644 index 000000000000..e38e85ec79e5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreate.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateBackfilledMacc.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateBackfilledMacc.json new file mode 100644 index 000000000000..49a9fea65840 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateBackfilledMacc.json @@ -0,0 +1,32 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateBackfilledMacc" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateContributor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateContributor.json new file mode 100644 index 000000000000..059dca6605e0 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateContributor.json @@ -0,0 +1,35 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateContributor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMilestonesOnExistingMacc.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMilestonesOnExistingMacc.json new file mode 100644 index 000000000000..87614c1dee0d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMilestonesOnExistingMacc.json @@ -0,0 +1,54 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 7000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z" + }, + { + "commitment": { + "amount": 13000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateMilestonesOnExistingMacc" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMultiEntity.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMultiEntity.json new file mode 100644 index 000000000000..fd83b8d5093d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateMultiEntity.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + }, + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + }, + { + "reason": "Error message", + "reasonCode": "ErrorCode", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": false + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateMultiEntity" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateNewMaccWithMilestone.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateNewMaccWithMilestone.json new file mode 100644 index 000000000000..48d3d732199b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateCreateNewMaccWithMilestone.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 5000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-07-31T23:59:59Z" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateNewMaccWithMilestone" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdate.json new file mode 100644 index 000000000000..6b62c9f75df1 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdate.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Test MACC Benefit", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-07-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitment.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitment.json new file mode 100644 index 000000000000..97146fa060f6 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitment.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateCommitment" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitmentEndAtContributorRule.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitmentEndAtContributorRule.json new file mode 100644 index 000000000000..37fbcd400e1c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateCommitmentEndAtContributorRule.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateCommitmentEndAtContributorRule" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributor.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributor.json new file mode 100644 index 000000000000..c5420b5af100 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributor.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Test MACC Benefit", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Contributor", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateContributor" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributorRule.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributorRule.json new file mode 100644 index 000000000000..cf82f97bb96e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateContributorRule.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateContributorRule" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateDisplayName.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateDisplayName.json new file mode 100644 index 000000000000..beddfea93942 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateDisplayName.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Updated Macc Name", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateDisplayName" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateEndAt.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateEndAt.json new file mode 100644 index 000000000000..341fd228d8ab --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateEndAt.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateEndAt" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneCommitment.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneCommitment.json new file mode 100644 index 000000000000..6ed24e3daf3d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneCommitment.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 40000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMaccAndMilestoneCommitment" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneEndDate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneEndDate.json new file mode 100644 index 000000000000..f63db5b2ba9e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMaccAndMilestoneEndDate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "endAt": "2027-11-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2029-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMaccAndMilestoneEndDate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneCommitment.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneCommitment.json new file mode 100644 index 000000000000..bb0e8522a042 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneCommitment.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 40000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMilestoneCommitment" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneEndDate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneEndDate.json new file mode 100644 index 000000000000..3a159e98e684 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateMilestoneEndDate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "endAt": "2027-11-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2029-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMilestoneEndDate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateRemoveMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateRemoveMilestones.json new file mode 100644 index 000000000000..239ceda38c18 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateRemoveMilestones.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Removed" + }, + { + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Removed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateRemoveMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfall.json new file mode 100644 index 000000000000..229a9363cd8a --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfall.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequest", + "message": "Customer requested to suppress automatic shortfall" + }, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateSuppressShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfallOnMilestone.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfallOnMilestone.json new file mode 100644 index 000000000000..c9153508537f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateSuppressShortfallOnMilestone.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequest", + "message": "Customer requested to suppress automatic shortfall" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateSuppressShortfallOnMilestone" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfall.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfall.json new file mode 100644 index 000000000000..359f2f19a373 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfall.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateUnsuppressShortfall" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfallOnMilestone.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfallOnMilestone.json new file mode 100644 index 000000000000..2512c808d729 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateUpdateUnsuppressShortfallOnMilestone.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateUnsuppressShortfallOnMilestone" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateWriteOffWithMilestones.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateWriteOffWithMilestones.json new file mode 100644 index 000000000000..15b6436a392e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccValidateWriteOffWithMilestones.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "PendingSettlement", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateWriteOffWithMilestones" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesAndShortfallGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesAndShortfallGet.json new file mode 100644 index 000000000000..1988a1388462 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesAndShortfallGet.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": { + "balanceVersion": 1, + "charge": { + "amount": 2000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-07-01T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2026-07-01T00:00:00Z", + "systemId": "lotId" + }, + "status": "ShortfallCharged" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 3, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall98765432" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithMilestonesAndShortfall_Get" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCancel.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCancel.json new file mode 100644 index 000000000000..e933cada1968 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCancel.json @@ -0,0 +1,87 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Canceled" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Canceled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Cancel", + "title": "MaccWithMilestones_Cancel" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCreate.json new file mode 100644 index 000000000000..b6f711d6c531 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesCreate.json @@ -0,0 +1,190 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": true, + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2025-05-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Scheduled" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2025-05-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "MaccWithMilestones_Create" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesGet.json new file mode 100644 index 000000000000..652182e39b09 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesGet.json @@ -0,0 +1,82 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithMilestones_Get" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesUpdateLastMilestoneEndDate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesUpdateLastMilestoneEndDate.json new file mode 100644 index 000000000000..4f8bd44158b6 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesUpdateLastMilestoneEndDate.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "33333333-3333-3333-3333-333333333333" + } + ] + } + }, + "maccName": "macc_20250614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20250614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20250614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 30000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20250614", + "endAt": "2026-04-30T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-01-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Completed" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Completed" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "33333333-3333-3333-3333-333333333333", + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-11-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109238", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-06-14T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccWithMilestonesUpdateLastMilestoneEndDate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesWriteOff.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesWriteOff.json new file mode 100644 index 000000000000..b7881df957b5 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithMilestonesWriteOff.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "PendingSettlement" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": null, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallWaived", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_WriteOff", + "title": "MaccWithMilestones_WriteOff" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithShortfallGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithShortfallGet.json new file mode 100644 index 000000000000..6e09c4c885ab --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWithShortfallGet.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc_20230614", + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "shortfall": { + "balanceVersion": 2, + "charge": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-09-30T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2024-09-01T00:00:00Z", + "systemId": "shortfall12345678" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithShortfall_Get" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWriteOff.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWriteOff.json new file mode 100644 index 000000000000..7a049cf029c8 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccWriteOff.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": null, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallWaived", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_WriteOff", + "title": "Macc_WriteOff" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListByResourceGroup.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListByResourceGroup.json new file mode 100644 index 000000000000..1926d9a9853e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListByResourceGroup.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListByResourceGroup", + "title": "Maccs_ListByResourceGroup" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListBySubscription.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListBySubscription.json new file mode 100644 index 000000000000..19e9f4705436 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsListBySubscription.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListBySubscription", + "title": "Maccs_ListBySubscription" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsValidateCreate.json new file mode 100644 index 000000000000..81656cc49c64 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsValidateCreate.json @@ -0,0 +1,40 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Maccs", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Test MACC Benefit", + "endAt": "2028-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2026-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccsValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListByResourceGroup.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListByResourceGroup.json new file mode 100644 index 000000000000..6056f8ea14eb --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListByResourceGroup.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListByResourceGroup", + "title": "MaccsWithMilestones_ListByResourceGroup" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListBySubscription.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListBySubscription.json new file mode 100644 index 000000000000..e5a69359de09 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MaccsWithMilestonesListBySubscription.json @@ -0,0 +1,84 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListBySubscription", + "title": "MaccsWithMilestones_ListBySubscription" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesCreateOnExistingMacc.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesCreateOnExistingMacc.json new file mode 100644 index 000000000000..984ead80ceee --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesCreateOnExistingMacc.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MilestonesCreate_OnExistingMacc" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesRemoveFromMacc.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesRemoveFromMacc.json new file mode 100644 index 000000000000..d936b4d8913b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/MilestonesRemoveFromMacc.json @@ -0,0 +1,75 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "milestoneId": "12000000-0000-0000-0000-000000000000", + "status": "Removed" + }, + { + "milestoneId": "13000000-0000-0000-0000-000000000001", + "status": "Removed" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MilestonesRemove_FromMacc" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/OperationsGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/OperationsGet.json new file mode 100644 index 000000000000..2fdf9b6b4e06 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/OperationsGet.json @@ -0,0 +1,114 @@ +{ + "parameters": { + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "Microsoft.BillingBenefits/savingsPlanOrderAliases/read", + "display": { + "description": "Read all savings plan order aliases", + "operation": "Get Savings plan order alias", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrderAliases" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrderAliases/write", + "display": { + "description": "Create a Savings plan order alias", + "operation": "Create SavingsPlanOrderAliases", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrderAliases" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/read", + "display": { + "description": "Read all savings plan orders", + "operation": "Get Savings plan orders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/write", + "display": { + "description": "Patch a Savings plan order", + "operation": "Patch SavingsPlanOrders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/action", + "display": { + "description": "Update a Savings plan order", + "operation": "Update SavingsPlanOrders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans/read", + "display": { + "description": "Read All SavingsPlans", + "operation": "Get SavingsPlans", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans/write", + "display": { + "description": "Patch an existing Savings plan", + "operation": "Patch SavingsPlans", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/register/action", + "display": { + "description": "Registers the Benefits resource provider and enables the creation of Benefits resources.", + "operation": "Registers the Benefits Resource Provider.", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/read", + "display": { + "description": "Get a conditional credit", + "operation": "Get Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/write", + "display": { + "description": "Create or update a conditional credit", + "operation": "Create or Update Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/delete", + "display": { + "description": "Delete a conditional credit", + "operation": "Delete Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + } + ] + } + } + }, + "operationId": "Operations_List", + "title": "OperationsGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/PromotionalCreditCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/PromotionalCreditCreate.json new file mode 100644 index 000000000000..0a9fa9fd2a53 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/PromotionalCreditCreate.json @@ -0,0 +1,124 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Promotional Credit" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "18eb6fdd-37c1-479b-b9be-550dbc461842", + "displayName": "Promotional Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "18eb6fdd-37c1-479b-b9be-550dbc461842", + "displayName": "Promotional Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "PromotionalCreditCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreate.json new file mode 100644 index 000000000000..a7293cfbacfa --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreate.json @@ -0,0 +1,99 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "quantity": 5, + "renew": true, + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + }, + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + }, + "201": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-06-02-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "ReservationOrderAlias_Create", + "title": "ReservationOrderAliasCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreateWithRenewProperties.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreateWithRenewProperties.json new file mode 100644 index 000000000000..76100b94d1a6 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasCreateWithRenewProperties.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + }, + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + } + }, + "201": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ReservationOrderAlias_Create", + "title": "ReservationOrderAliasCreateWithRenewProperties" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGet.json new file mode 100644 index 000000000000..343b140b3f6b --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGet.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + } + }, + "operationId": "ReservationOrderAlias_Get", + "title": "ReservationOrderAliasGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGetWithRenewProperties.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGetWithRenewProperties.json new file mode 100644 index 000000000000..508eb94d8d2e --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/ReservationOrderAliasGetWithRenewProperties.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Succeeded", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "renewalPurchaseDateTime": "2025-06-15T10:30:00Z", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + } + }, + "operationId": "ReservationOrderAlias_Get", + "title": "ReservationOrderAliasGetWithRenewProperties" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreate.json new file mode 100644 index 000000000000..c844785b9059 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreate.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Validation Test SSCACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json new file mode 100644 index 000000000000..9259db612476 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json @@ -0,0 +1,115 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 1", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "SS CACO 2", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 3", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + }, + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + }, + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreateMultipleInvalidOverlap" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleValidOverlap.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleValidOverlap.json new file mode 100644 index 000000000000..84722adf4ac7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateCreateMultipleValidOverlap.json @@ -0,0 +1,109 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 1", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "SS CACO 2", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "100187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 3", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "200187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreateMultipleValidOverlap" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateUpdate.json new file mode 100644 index 000000000000..6bdbe196b783 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SSCacoFlexibleValidateUpdate.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-2", + "displayName": "Validation Test Update SSCACO - update endAt", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-04-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-04-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/SSCACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/SSCACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemExpandedGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemExpandedGet.json new file mode 100644 index 000000000000..4e6b278855ab --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemExpandedGet.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "$expand": "renewProperties", + "api-version": "2026-06-01", + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeType": "Shared", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-21T18:15:42.4098626Z", + "expiryDateTime": "2025-10-18T21:16:13.1854959Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-18T21:14:26.8279361Z", + "renew": true, + "renewProperties": { + "purchaseProperties": { + "properties": { + "appliedScopeType": "Shared", + "billingPlan": "Upfront", + "billingScopeId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2_renewed", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Shared", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 84, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 83.87, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlan_Get", + "title": "SavingsPlanItemWithExpandedRenewPropertiesGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemGet.json new file mode 100644 index 000000000000..638f42a0bd14 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanItemGet.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeType": "Shared", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-21T18:15:42.4098626Z", + "expiryDateTime": "2025-10-18T21:16:13.1854959Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-18T21:14:26.8279361Z", + "renew": true, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Shared", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 84, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 83.87, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlan_Get", + "title": "SavingsPlanItemGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreate.json new file mode 100644 index 000000000000..6226eeb42194 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreate.json @@ -0,0 +1,84 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "201": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "SavingsPlanOrderAlias_Create", + "title": "SavingsPlanOrderAliasCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreateSingleScope.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreateSingleScope.json new file mode 100644 index 000000000000..c9ac0a2650de --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasCreateSingleScope.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "201": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "SavingsPlanOrderAlias_Create", + "title": "SavingsPlanOrderAliasCreateSingleScope" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasGet.json new file mode 100644 index 000000000000..d6605615c5c7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderAliasGet.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "spAlias123", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/spAlias123", + "kind": null, + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000000", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrderAlias_Get", + "title": "SavingsPlanOrderAliasGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderElevate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderElevate.json new file mode 100644 index 000000000000..3a9374b15afa --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderElevate.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "70000000-0000-0000-0000-000000000005", + "id": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009/providers/Microsoft.Authorization/roleAssignments/70000000-0000-0000-0000-000000000005", + "properties": { + "principalId": "50000000-0000-0000-0000-000000000000", + "roleDefinitionId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009/providers/Microsoft.Authorization/roleDefinitions/30000000-0000-0000-0000-000000000008", + "scope": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009" + } + } + } + }, + "operationId": "SavingsPlanOrder_Elevate", + "title": "SavingsPlanOrderElevate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderExpandedGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderExpandedGet.json new file mode 100644 index 000000000000..f3c0c474530d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderExpandedGet.json @@ -0,0 +1,337 @@ +{ + "parameters": { + "$expand": "schedule", + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000003", + "displayName": "Compute_SavingsPlan_10-19-2022_11-01", + "expiryDateTime": "2025-10-19T18:03:55.2519794Z", + "planInformation": { + "nextPaymentDueDate": "2022-11-19", + "pricingCurrencyTotal": { + "amount": 26.28, + "currencyCode": "USD" + }, + "startDate": "2022-10-19", + "transactions": [ + { + "billingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "dueDate": "2022-10-19", + "paymentDate": "2022-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "dueDate": "2022-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2022-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + } + ] + }, + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrder_Get", + "title": "SavingsPlanOrderWithExpandedPaymentsGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderGet.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderGet.json new file mode 100644 index 000000000000..0ace1e745da7 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderGet.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "20000000-0000-0000-0000-000000000005", + "displayName": "Compute_SavingsPlan_10-19-2022_11-01", + "expiryDateTime": "2025-10-19T18:03:55.2519794Z", + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrder_Get", + "title": "SavingsPlanOrderGet" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderList.json new file mode 100644 index 000000000000..cdf91f005ba0 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanOrderList.json @@ -0,0 +1,36 @@ +{ + "parameters": { + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000004:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000004:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "20000000-0000-0000-0000-000000000005", + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "expiryDateTime": "2025-10-28T23:40:30.6028303Z", + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/20000000-0000-0000-0000-000000000001" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlanOrder_List", + "title": "SavingsPlanOrderList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanUpdate.json new file mode 100644 index 000000000000..651bb6e9359c --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanUpdate.json @@ -0,0 +1,113 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "displayName": "TestDisplayName", + "renew": true, + "renewProperties": { + "purchaseProperties": { + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "TestDisplayName_renewed", + "renew": false, + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + } + }, + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "30000000-0000-0000-0000-000000000000", + "type": "microsoft.billingbenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "displayName": "Azure subscription 1", + "subscriptionId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "benefitStartTime": "2022-10-27T00:34:33.6697600Z", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "riName", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-11-10T00:12:54.549373Z", + "expiryDateTime": "2025-10-27T00:34:33.6697600Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-27T00:32:45.5823486Z", + "renew": true, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Single", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 37, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 53.85, + "valueUnit": "percentage" + } + ], + "trend": "DOWN" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "202": { + "description": "The request is completed.", + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/locations/eastus/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-07-01" + } + }, + "404": {} + }, + "operationId": "SavingsPlan_Update", + "title": "SavingsPlanUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidatePurchase.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidatePurchase.json new file mode 100644 index 000000000000..5bfd8038021d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidatePurchase.json @@ -0,0 +1,69 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "SavingsPlan", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + { + "benefitType": "SavingsPlan", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/RG", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 20, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "reason": "Your provider has not enabled Savings Plan purchase on this subscription.", + "reasonCode": "CustomerCannotPurchaseSavingsPlan", + "valid": false + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SavingsPlanValidatePurchase" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidateUpdate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidateUpdate.json new file mode 100644 index 000000000000..15ecfa239a7f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlanValidateUpdate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "appliedScopeProperties": { + "managementGroupId": "/providers/Microsoft.Management/managementGroups/30000000-0000-0000-0000-000000000100", + "tenantId": "30000000-0000-0000-0000-000000000100", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "ManagementGroup" + }, + { + "appliedScopeProperties": { + "managementGroupId": "/providers/Microsoft.Management/managementGroups/MockMG", + "tenantId": "30000000-0000-0000-0000-000000000100", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "ManagementGroup" + } + ] + }, + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "SavingsPlan_ValidateUpdate", + "title": "SavingsPlanValidateUpdate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansInOrderList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansInOrderList.json new file mode 100644 index 000000000000..ee2428047144 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansInOrderList.json @@ -0,0 +1,71 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47/resourcegroups/3ppRG", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.002, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-24-2022_15-44", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-24T22:47:04.8539493Z", + "expiryDateTime": "2023-10-24T22:47:04.6196635Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-24T22:45:13.6202486Z", + "renew": false, + "term": "P1Y", + "userFriendlyAppliedScopeType": "ResourceGroup", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlan_List", + "title": "SavingsPlansInOrderList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansList.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansList.json new file mode 100644 index 000000000000..b43dac758169 --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansList.json @@ -0,0 +1,92 @@ +{ + "parameters": { + "$filter": "(properties%2farchived+eq+false)", + "$orderby": "properties/displayName asc", + "$skiptoken": "50", + "api-version": "2026-06-01", + "refreshsummary": "true", + "take": "1" + }, + "responses": { + "200": { + "body": { + "additionalProperties": [ + { + "name": "summary", + "value": { + "cancelledCount": 0, + "expiredCount": 0, + "expiringCount": 0, + "failedCount": 0, + "noBenefitCount": 0, + "pendingCount": 0, + "processingCount": 0, + "succeededCount": 1, + "warningCount": 0 + } + } + ], + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "displayName": "Azure subscription 1", + "subscriptionId": "/subscriptions/20000000-0000-0000-0000-000000000005", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-19-2022_11-03", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-19T18:05:37.1034288Z", + "expiryDateTime": "2023-10-19T18:05:36.5252231Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-19T18:03:56.4032132Z", + "renew": false, + "term": "P1Y", + "userFriendlyAppliedScopeType": "Single", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 78, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 78.12, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlan_ListAll", + "title": "SavingsPlansList" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansValidateCreate.json b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansValidateCreate.json new file mode 100644 index 000000000000..5cd28fef223f --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/examples/2026-06-01/SavingsPlansValidateCreate.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "SavingsPlans", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2026-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SavingsPlansValidateCreate" +} diff --git a/specification/billingbenefits/BillingBenefits.Management/main.tsp b/specification/billingbenefits/BillingBenefits.Management/main.tsp index 724d527f772d..e045125d8654 100644 --- a/specification/billingbenefits/BillingBenefits.Management/main.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/main.tsp @@ -26,6 +26,10 @@ import "./ConditionalCredit.tsp"; import "./ConditionalCreditContributor.tsp"; import "./CreditSource.tsp"; import "./FreeServices.tsp"; +import "./CreditTransaction.tsp"; +import "./MaccTransaction.tsp"; +import "./ConditionalCreditTransaction.tsp"; +import "./CatalogGroup.tsp"; import "./client.tsp"; using TypeSpec.Rest; @@ -48,9 +52,9 @@ namespace Microsoft.BillingBenefits; */ enum Versions { /** - * The 2025-12-01-preview API version. + * The 2026-06-01 API version. */ - v2025_12_01_preview: "2025-12-01-preview", + v2026_06_01: "2026-06-01", } interface Operations extends Azure.ResourceManager.Operations {} diff --git a/specification/billingbenefits/BillingBenefits.Management/models.tsp b/specification/billingbenefits/BillingBenefits.Management/models.tsp index cc5fce88e37b..8654b240de82 100644 --- a/specification/billingbenefits/BillingBenefits.Management/models.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/models.tsp @@ -13,6 +13,77 @@ using TypeSpec.Versioning; namespace Microsoft.BillingBenefits; +/** + * Common versioned properties added to all benefit resources. + * Spread this model into any benefit resource's properties to include these fields. + * New cross-cutting properties for future versions should be added here. + */ +model BenefitCommonVersionedProperties { + /** + * Invitation identifier + */ + @visibility(Lifecycle.Read, Lifecycle.Create) + invitationId?: string; +} + +/** + * Versioned expansion properties for Credit, MACC, and ConditionalCredit resources. + * Contains properties common to these three resource types but not applicable to Discount or FreeServices. + * Spreads BenefitCommonVersionedProperties to include all cross-cutting versioned properties. + */ +model BenefitVersionedExpansionProperties { + ...BenefitCommonVersionedProperties; + + /** + * Amount of benefit that has been consumed + */ + @visibility(Lifecycle.Read) + consumed?: Price; +} + +/** + * Canonical billing scope properties for benefit resources. + * Contains readOnly billing account, billing profile, customer identifiers, plus versioned common properties. + * Use `...BenefitBillingScopeProperties` in new resource properties models. + * Currently used by Discount and FreeServices; recommended for all future benefit resources. + */ +model BenefitBillingScopeProperties { + /** + * Fully-qualified identifier of the billing account where the benefit is applied. + */ + @visibility(Lifecycle.Read) + billingAccountResourceId?: Azure.Core.armResourceIdentifier<[ + { + scopes: ["Tenant"]; + type: "Microsoft.Billing/billingAccounts"; + } + ]>; + + /** + * Fully-qualified identifier of the billing profile where the benefit is applied. + */ + @visibility(Lifecycle.Read) + billingProfileResourceId?: Azure.Core.armResourceIdentifier<[ + { + scopes: ["Tenant"]; + type: "Microsoft.Billing/billingAccounts/billingProfiles"; + } + ]>; + + /** + * Customer resource id where the benefit is scoped to. + */ + @visibility(Lifecycle.Read) + customerResourceId?: Azure.Core.armResourceIdentifier<[ + { + scopes: ["Tenant"]; + type: "Microsoft.Billing/billingAccounts/customers"; + } + ]>; + + ...BenefitCommonVersionedProperties; +} + /** * Represents the result of listing savings plan models */ @@ -62,6 +133,17 @@ union ProvisioningState { Failed: "Failed", } +/** + * Provisioning state for billing benefit resources. Includes the standard terminal states + * (Succeeded, Failed, Canceled) plus benefit-specific transition states. + */ +union BenefitProvisioningState { + ResourceProvisioningState, + + /** The resource provisioning request has been accepted but processing has not yet started. */ + Pending: "Pending", +} + /** * Represent benefit term in ISO 8601 format. */ @@ -198,31 +280,27 @@ union InstanceFlexibility { } /** - * This defines whether the entity being created is primary or affiliate. Supported values: primary, affiliate. Validation: Required, must match one of the 2 values. + * Represents the renewal action for a reservation to be a new purchase or existing renewal. */ -union DiscountEntityType { +union RenewAction { string, - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Primary: "Primary", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Affiliate: "Affiliate", + + /** Represents a new purchase renewal action. */ + CreateNew: "CreateNew", + + /** Represents renewal of an existing reservation. */ + RenewExisting: "RenewExisting", } /** - * Provisioning states of Discount. + * This defines whether the entity being created is primary or affiliate. Supported values: primary, affiliate. Validation: Required, must match one of the 2 values. */ -union DiscountProvisioningState { +union DiscountEntityType { string, #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Unknown: "Unknown", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Pending: "Pending", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Succeeded: "Succeeded", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Canceled: "Canceled", + Primary: "Primary", #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Failed: "Failed", + Affiliate: "Affiliate", } /** @@ -243,9 +321,9 @@ union DiscountStatus { } /** - * List of applied scopes supported for discounts. + * List of applied scope types supported for benefit resources. */ -union DiscountAppliedScopeType { +union BenefitAppliedScopeType { string, #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" BillingAccount: "BillingAccount", @@ -298,6 +376,11 @@ union DiscountType { CustomPrice: "CustomPrice", #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" CustomPriceMultiCurrency: "CustomPriceMultiCurrency", + + /** + * Azure promotion discount type. + */ + AzurePromotion: "AzurePromotion", } /** @@ -545,23 +628,6 @@ union ConditionalCreditEntityType { Contributor: "Contributor", } -/** - * The provisioning state of the resource - */ -union ConditionalCreditsProvisioningState { - string, - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Unknown: "Unknown", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Succeeded: "Succeeded", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Failed: "Failed", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Canceled: "Canceled", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - Pending: "Pending", -} - /** * The status of the conditional credit */ @@ -615,18 +681,45 @@ union MilestoneStatus { } /** - * Represents benefit model type for validation. + * Represents benefit model type for validation. Includes all resource types + * plus legacy singular-form values used by the validate API. */ union BenefitType { - string, - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" + ResourceType, + + /** Savings Plan (singular form, used by validate API) */ SavingsPlan: "SavingsPlan", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" + + /** MACC (legacy form, used by validate API) */ MACC: "MACC", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" - ConditionalCredits: "ConditionalCredits", - #suppress "@azure-tools/typespec-azure-core/documentation-required" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" +} + +/** + * The top-level ARM resource type for a billing benefit (e.g., maccs, credits, savingsPlans, reservations). + */ +union ResourceType { + string, + + /** Microsoft Azure Consumption Commitments */ + Maccs: "Maccs", + + /** Credits applied to the customer's billing account */ Credits: "Credits", + + /** Conditional Credits */ + ConditionalCredits: "ConditionalCredits", + + /** Discounts that reduce charges on eligible services */ + Discounts: "Discounts", + + /** Services provided at no charge under the billing agreement */ + FreeServices: "FreeServices", + + /** Savings Plan */ + SavingsPlans: "SavingsPlans", + + /** Reserved capacity or reserved instances */ + Reservations: "Reservations", } /** @@ -714,6 +807,12 @@ model AppliedScopeProperties { * Display name */ displayName?: string; + + /** + * A filter string passed to downstream services to categorize and apply usage benefits to specific resource models. Expected format: "key/value" (e.g., "contractId/2025 H2CPU"). The value is not validated by BillingBenefits and is forwarded as-is. + */ + @example("clusterId/2025 H2CPU") + benefitFilter?: string; } /** @@ -765,7 +864,7 @@ model SavingsPlanOrderModelProperties { billingProfileId?: Azure.Core.armResourceIdentifier<[ { scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; + type: "Microsoft.Billing/billingAccounts/billingProfiles"; } ]>; @@ -982,7 +1081,7 @@ model SavingsPlanModelProperties { billingProfileId?: Azure.Core.armResourceIdentifier<[ { scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; + type: "Microsoft.Billing/billingAccounts/billingProfiles"; } ]>; @@ -1207,6 +1306,11 @@ model PurchaseRequestProperties { */ renew?: boolean = false; + /** + * Represents the renewal action for a reservation to be a new purchase or existing renewal. + */ + renewAction?: RenewAction; + /** * Properties specific to applied scope type. Not required if not applicable. */ @@ -1438,6 +1542,11 @@ model ReservationOrderAliasRequestProperties { */ renew?: boolean = false; + /** + * Represents the renewal action for a reservation to be a new purchase or existing renewal. + */ + renewAction?: RenewAction; + /** * The type of the resource that is being reserved. */ @@ -1449,6 +1558,11 @@ model ReservationOrderAliasRequestProperties { // FIXME: (utcDateTime) Please double check that this is the correct type for your scenario. reviewDateTime?: utcDateTime; + /** + * This is the DateTime when the reservation benefit started. + */ + benefitStartTime?: utcDateTime; + /** * Properties specific to each reserved resource type. Not required if not applicable. */ @@ -1521,6 +1635,17 @@ model ReservationOrderAliasResponseProperties { */ renew?: boolean = false; + /** + * Represents the renewal action for a reservation to be a new purchase or existing renewal. + */ + renewAction?: RenewAction; + + /** + * This is the date-time when the reservation was renewed. + */ + @visibility(Lifecycle.Read) + renewalPurchaseDateTime?: utcDateTime; + /** * The type of the resource that is being reserved. */ @@ -1532,6 +1657,11 @@ model ReservationOrderAliasResponseProperties { // FIXME: (utcDateTime) Please double check that this is the correct type for your scenario. reviewDateTime?: utcDateTime; + /** + * This is the DateTime when the reservation benefit started. + */ + benefitStartTime?: utcDateTime; + /** * Properties specific to each reserved resource type. Not required if not applicable. */ @@ -1570,48 +1700,22 @@ model DiscountProperties { startAt: utcDateTime; /** - * This is the globally unique identifier of the Discount which will not change for the lifetime of the Discount. - */ - systemId?: string; - - /** - * The state of the resource. Supported values are Pending, Failed, Succeeded, Canceled. + * End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate. */ - @visibility(Lifecycle.Read) - provisioningState?: DiscountProvisioningState; + endAt?: utcDateTime; /** - * Billing account resource id where the discount metadata is present. + * This is the globally unique identifier of the Discount which will not change for the lifetime of the Discount. */ - @visibility(Lifecycle.Read) - billingAccountResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; - } - ]>; + systemId?: string; /** - * Billing profile resource id where the discount is scoped to. + * The state of the resource. Supported values are Pending, Failed, Succeeded, Canceled. */ @visibility(Lifecycle.Read) - billingProfileResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; - } - ]>; + provisioningState?: BenefitProvisioningState; - /** - * Customer resource id where the discount is scoped to. - */ - @visibility(Lifecycle.Read) - customerResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts/customers"; - } - ]>; + ...BenefitBillingScopeProperties; /** * This defines a user friendly display name for the discount. @@ -1638,7 +1742,13 @@ model DiscountProperties { /** * List of applied scopes supported for discounts. */ - appliedScopeType?: DiscountAppliedScopeType; + appliedScopeType?: BenefitAppliedScopeType; + + /** + * Product details including SKU title, product family, and product type. + */ + @visibility(Lifecycle.Read) + productDetails?: ProductDetailsBase; } /** @@ -1758,6 +1868,11 @@ model DiscountPatchRequestProperties { * Display name */ displayName?: string; + + /** + * End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate. + */ + endAt?: utcDateTime; } /** @@ -1921,6 +2036,21 @@ model ConditionsItem { type?: string; } +/** + * Discount type properties for Azure promotion discounts. + */ +model DiscountTypeAzurePromotion extends DiscountTypeProperties { + /** + * Product family for which the discount is given. Validation: Optional + */ + productFamilyName?: string; + + /** + * Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency. + */ + discountType: DiscountType.AzurePromotion; +} + /** * Discount type properties including product family name */ @@ -1933,7 +2063,7 @@ model DiscountTypeProductFamily extends DiscountTypeProperties { /** * Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency. */ - discountType: "ProductFamily"; + discountType: DiscountType.ProductFamily; } /** @@ -1953,7 +2083,7 @@ model DiscountTypeProduct extends DiscountTypeProperties { /** * Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency. */ - discountType: "Product"; + discountType: DiscountType.Product; } /** @@ -1978,7 +2108,7 @@ model DiscountTypeProductSku extends DiscountTypeProperties { /** * Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency. */ - discountType: "Sku"; + discountType: DiscountType.Sku; } alias DiscountCommonProperties = { @@ -2230,9 +2360,8 @@ model MaccModelProperties { /** * Provisioning state of MACC as assigned by RPaaS. This indicates the last operation's status. For all practical purposes, this can be ignored. For current status of MACC resource, refer to MaccStatus. */ - #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" @visibility(Lifecycle.Read) - provisioningState?: string; + provisioningState?: BenefitProvisioningState; /** * Represents the current status of the MACC. @@ -2344,6 +2473,19 @@ model MaccModelProperties { type: "Microsoft.Billing/billingAccounts"; } ]>; + + /** + * Product details including SKU title, product family, and product type. + */ + @visibility(Lifecycle.Read) + productDetails?: ProductDetailsBase; + + /** + * Type of the applied scope for the MACC. + */ + appliedScopeType?: BenefitAppliedScopeType; + + ...BenefitVersionedExpansionProperties; } /** @@ -2536,7 +2678,6 @@ model CreditReason { /** * The reason code for credit. */ - @typeChangedFrom(Versions.v2025_12_01_preview, float32) code?: string; /** @@ -2560,6 +2701,78 @@ model CreditPolicies { expiration?: CreditExpirationPolicy; } +/** + * Indicates where the credit benefit is applied + */ +union AppliedOn { + string, + + /** + * Applied on consume charges + */ + Consumption: "Consumption", + + /** + * Applied on invoice + */ + Invoice: "Invoice", + + /** + * Applied externally + */ + External: "External", +} + +/** Common product detail properties shared across all benefit resources */ +model ProductDetailsBase { + /** SKU title of the product */ + skuTitle?: string; + + /** + * The product family, for example "Azure" or "M365". + */ + productFamily?: string; + + /** + * The type of the product. + */ + productType?: string; +} + +/** + * Product details for a credit + */ +model CreditProductDetails { + ...ProductDetailsBase; + + /** + * Indicates where the credit benefit is applied (e.g., consume, invoice, or external application). + */ + appliedOn?: AppliedOn[]; + + /** + * Specifies which price point is used when applying the credit. Known values include "MarketPrice", "UnitPrice", and "BenefitGroupPrice:" where identifies the benefit group. + */ + appliedPrice?: string; +} + +/** + * Product details for a transaction + */ +model TransactionProductDetails { + ...ProductDetailsBase; + + /** + * Grouping of Azure services by core function (e.g., Compute, Databases). + */ + serviceFamily?: string; + + /** + * The publisher type of the product, for example "Microsoft" for first-party or a third-party publisher name. Additional values may be introduced in the future. + */ + publisherType?: string; +} + /** * Properties of a credit */ @@ -2574,6 +2787,11 @@ model CreditProperties { */ productCode?: string; + /** + * Display name + */ + displayName?: string; + /** * The reason for the credit. Not required if not applicable. */ @@ -2618,7 +2836,18 @@ model CreditProperties { billingProfileResourceId?: Azure.Core.armResourceIdentifier<[ { scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; + type: "Microsoft.Billing/billingAccounts/billingProfiles"; + } + ]>; + + /** + * Customer resource id where the benefit is scoped to. + */ + @visibility(Lifecycle.Read) + customerResourceId?: Azure.Core.armResourceIdentifier<[ + { + scopes: ["Tenant"]; + type: "Microsoft.Billing/billingAccounts/customers"; } ]>; @@ -2632,7 +2861,7 @@ model CreditProperties { * Provisioning state */ @visibility(Lifecycle.Read) - provisioningState?: ProvisioningState; + provisioningState?: BenefitProvisioningState; /** * System identifier @@ -2640,15 +2869,34 @@ model CreditProperties { systemId?: string; /** - * Fully-qualified identifier of the customer where the savings plan is applied. Present only for Partner-led customers. Format is /providers/Microsoft.Billing/billingAccounts/{acctId:orgId} + * Identifier of the $0 transaction created during credit acquisition. */ @visibility(Lifecycle.Read) - customerId?: string; + orderId?: string; + + /** + * Unique identifier (UUID) of the funding lot assigned by the benefit publisher. Used in credit transfer scenarios to trace the originating credit lot. + */ + @visibility(Lifecycle.Read, Lifecycle.Create) + fundingSystemId?: string; /** * Fully-qualified resource identifier of the resource. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/{benefitType}/{benefitName}. */ resourceId?: Azure.Core.armResourceIdentifier; + + ...BenefitVersionedExpansionProperties; + + /** + * Product details including SKU title, product kind, offer type, and application details + */ + @visibility(Lifecycle.Read) + productDetails?: CreditProductDetails; + + /** + * Type of the applied scope for the credit. + */ + appliedScopeType?: BenefitAppliedScopeType; } /** @@ -2738,6 +2986,116 @@ model CreditPatchProperties { */ model CreditsList is Azure.Core.Page; +/** + * Request body for the changeSponsor action on a credit. + */ +model ChangeSponsorRequest { + /** Financial code identifying the new sponsor. This is an alphanumeric identifier assigned by the billing system, for example P20567384. */ + @example("P30000001") + sponsorId?: string; +} + +/** + * The type of charge for a transaction. + */ +union TransactionChargeType { + string, + + /** Usage charge. Applicable to all benefits. */ + Usage: "Usage", + + /** Purchase charge. Applicable to MACC, CACO, ACO, MC only. */ + Purchase: "Purchase", + + /** Refund charge. Applicable to all benefits. */ + Refund: "Refund", +} + +/** + * Billing lifecycle status of a transaction. + */ +union TransactionBillingStatus { + string, + + /** Charge may still change. */ + Open: "Open", + + /** Charge is finalized. */ + Closed: "Closed", +} + +/** + * Properties of a transaction + */ +model TransactionProperties { + /** + * Provisioning state of the transaction as assigned by RPaaS. This indicates the last operation's status. + */ + @visibility(Lifecycle.Read) + provisioningState?: BenefitProvisioningState; + + /** + * This is the DateTime when the transaction occurred. + */ + date?: utcDateTime; + + /** + * The type of charge for this transaction. + */ + chargeType?: TransactionChargeType; + + /** + * Billing lifecycle status of this transaction. + */ + billingStatus?: TransactionBillingStatus; + + /** + * Fully-qualified identifier of the invoice. + */ + invoiceResourceId?: Azure.Core.armResourceIdentifier<[ + { + scopes: ["Tenant"]; + type: "Microsoft.Billing/billingAccounts"; + } + ]>; + + /** + * Transaction amount in billing currency. + */ + amountInBillingCurrency?: Price; + + /** + * Transaction amount in pricing currency. + */ + amountInPricingCurrency?: Price; + + /** + * Catalog UPN for the product associated with this transaction. + */ + productCode?: string; + + /** + * Product details including SKU title, SKU properties, product family, type, and publisher type. + */ + productDetails?: TransactionProductDetails; +} + +/** + * List of transactions + */ +model TransactionsList is Azure.Core.Page; + +/** + * List of Macc transactions + */ +model MaccTransactionsList is Azure.Core.Page; + +/** + * List of conditional credit transactions + */ +model ConditionalCreditTransactionsList + is Azure.Core.Page; + /** * List of applicable conditional credits */ @@ -2778,7 +3136,7 @@ model ConditionalCreditProperties { * The provisioning state of the resource */ @visibility(Lifecycle.Read) - provisioningState?: ConditionalCreditsProvisioningState; + provisioningState?: BenefitProvisioningState; /** * The status of the conditional credit @@ -2817,6 +3175,19 @@ model ConditionalCreditProperties { * Fully-qualified resource identifier of the resource. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/{benefitType}/{benefitName}. */ resourceId?: Azure.Core.armResourceIdentifier; + + /** + * Product details including SKU title, product family, and product type. + */ + @visibility(Lifecycle.Read) + productDetails?: ProductDetailsBase; + + /** + * Type of the applied scope for the conditional credit. + */ + appliedScopeType?: BenefitAppliedScopeType; + + ...BenefitVersionedExpansionProperties; } /** @@ -3238,9 +3609,22 @@ model MaccValidateModel extends BenefitValidateModel { } /** - * Savings plan validate model + * Maccs validate model */ -model SavingsPlanValidateModel extends BenefitValidateModel { +model MaccsValidateModel extends BenefitValidateModel { + /** + * MACC validate properties + */ + properties?: MaccModelProperties; + + /** + * Type of benefit to validate. This is used to determine the model type for validation. + */ + benefitType: "Maccs"; +} + +/** Shared properties for savings plan validate models. */ +alias SavingsPlanValidateProperties = { /** * Savings plan order alias properties */ @@ -3279,6 +3663,25 @@ model SavingsPlanValidateModel extends BenefitValidateModel { * Resource provider kind */ kind?: string; +}; + +/** + * Savings Plans validate model + */ +model SavingsPlansValidateModel extends BenefitValidateModel { + ...SavingsPlanValidateProperties; + + /** + * Type of benefit to validate. This is used to determine the model type for validation. + */ + benefitType: "SavingsPlans"; +} + +/** + * Savings plan validate model + */ +model SavingsPlanValidateModel extends BenefitValidateModel { + ...SavingsPlanValidateProperties; /** * Type of benefit to validate. This is used to determine the model type for validation. @@ -3286,6 +3689,21 @@ model SavingsPlanValidateModel extends BenefitValidateModel { benefitType: "SavingsPlan"; } +/** + * Discount validate model + */ +model DiscountValidateModel extends BenefitValidateModel { + /** + * Discount validate properties + */ + properties?: DiscountProperties; + + /** + * Type of benefit to validate. This is used to determine the model type for validation. + */ + benefitType: "Discounts"; +} + /** * Properties of free services */ @@ -3295,6 +3713,11 @@ model FreeServicesProperties { */ productCode?: string; + /** + * Display name + */ + displayName?: string; + /** * Current status of the free services */ @@ -3313,47 +3736,21 @@ model FreeServicesProperties { /** * Provisioning state of Free Services as assigned by RPaaS. This indicates the last operation's status. For all practical purposes, this can be ignored. For current status of Free Services resource, refer to FreeServicesStatus. */ - #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details" @visibility(Lifecycle.Read) - provisioningState?: string; + provisioningState?: BenefitProvisioningState; - /** - * Billing account resource id where the free services metadata is present. - */ - @visibility(Lifecycle.Read) - billingAccountResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; - } - ]>; + ...BenefitBillingScopeProperties; /** - * Billing profile resource id where the free services are scoped to. + * This is the globally unique identifier of the free services which will not change for its lifetime. Generated by the benefit publisher. */ - @visibility(Lifecycle.Read) - billingProfileResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts"; - } - ]>; + systemId?: string; /** - * Customer resource id where the free services are scoped to. + * Product details including SKU title, product family, and product type. */ @visibility(Lifecycle.Read) - customerResourceId?: Azure.Core.armResourceIdentifier<[ - { - scopes: ["Tenant"]; - type: "Microsoft.Billing/billingAccounts/customers"; - } - ]>; - - /** - * This is the globally unique identifier of the free services which will not change for its lifetime. - */ - systemId?: string; + productDetails?: ProductDetailsBase; } /** @@ -3432,3 +3829,90 @@ model FreeServicesList { @nextLink nextLink?: string; } + +// ─── CatalogGroup models ────────────────────────────────────────────────────── + +/** + * Properties of a catalog group. + */ +#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state" "Read-only proxy resource with no provisioning lifecycle" +model CatalogGroupProperties { + /** + * The top-level benefit resource type (e.g., maccs, credits, conditionalCredits, discounts, savingsPlans, reservations). + */ + benefitResourceType: ResourceType; + + /** + * Display name for the catalog group. + */ + displayName?: string; + + /** + * Short description of the catalog group. + */ + shortDescription?: string; + + /** + * Long description of the catalog group. + */ + longDescription?: string; + + /** + * Link to learn more about this catalog group. Uses the forward-link format https://go.microsoft.com/fwlink/?linkid=. + */ + learnMoreLink?: url; + + /** + * Manifest-sourced array of search terms for this catalog group. Omitted when empty. + */ + keywords?: string[]; + + /** + * The benefit type's icon as JSON-escaped SVG markup. After parsing, the value is a complete `…` element. + */ + @example("") + icon?: string; + + /** + * Capabilities of the catalog group as key-value pairs. Omitted when a benefit type has no defined capabilities. + */ + @identifiers(#[]) + capabilities?: CatalogGroupCapability[]; + + /** + * Optional disclaimers (legal or eligibility caveats) for the catalog group. Included only when caveats apply. + */ + disclaimers?: string[]; +} + +/** + * A key-value pair representing a capability of the catalog group (for example, exchange or renewal support). + */ +model CatalogGroupCapability { + /** + * The capability name (e.g., SelfServiceExchange, Renewability). + */ + name: string; + + /** + * The capability value (e.g., Supported, Not Supported). + */ + value: string; +} + +/** + * The list of catalog groups. + */ +model CatalogGroupList { + /** + * The list of catalog groups. + */ + @pageItems + value?: CatalogGroup[]; + + /** + * URL to get the next page of results, or `null` if this is the last page. + */ + @nextLink + nextLink?: url; +} diff --git a/specification/billingbenefits/BillingBenefits.Management/sdk-suppressions.yaml b/specification/billingbenefits/BillingBenefits.Management/sdk-suppressions.yaml new file mode 100644 index 000000000000..434b8b70a09d --- /dev/null +++ b/specification/billingbenefits/BillingBenefits.Management/sdk-suppressions.yaml @@ -0,0 +1,7 @@ +suppressions: + azure-sdk-for-go: + - package: "sdk/resourcemanager/billingbenefits/armbillingbenefits" + breaking-changes: + - Function `*RPClient.ValidatePurchase` has been removed + - Operation `*SavingsPlanClient.Update` has been changed to LRO, use `*SavingsPlanClient.BeginUpdate` instead. + - Struct `SavingsPlanPurchaseValidateRequest` has been removed diff --git a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml index 2820d8cad7f7..87fcd8299683 100644 --- a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml +++ b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml @@ -6,6 +6,7 @@ emit: options: "@azure-tools/typespec-autorest": omit-unreachable-types: true + use-read-only-status-schema: true emitter-output-dir: "{project-root}/.." azure-resource-provider-folder: "resource-manager" output-file: "{azure-resource-provider-folder}/{service-name}/{version-status}/{version}/billingbenefits.json" @@ -22,14 +23,11 @@ options: namespace: "com.azure.resourcemanager.billingbenefits" service-name: "BillingBenefits" # human-readable service name, whitespace allowed flavor: azure - "@azure-typespec/http-client-csharp-mgmt": - emitter-output-dir: "{output-dir}/{service-dir}/{namespace}" - namespace: "Azure.ResourceManager.BillingBenefits" "@azure-tools/typespec-ts": emitter-output-dir: "{output-dir}/{service-dir}/arm-billingbenefits" typespec-title-map: BillingBenefitsClient: BillingBenefitsRP - compatibility-lro: true + is-modular-library: true flavor: "azure" experimental-extensible-enums: true package-details: @@ -37,7 +35,7 @@ options: "@azure-tools/typespec-go": service-dir: "sdk/resourcemanager/billingbenefits" emitter-output-dir: "{output-dir}/{service-dir}/armbillingbenefits" - module: "github.com/Azure/azure-sdk-for-go/{service-dir}/armbillingbenefits/v2" + module: "github.com/Azure/azure-sdk-for-go/{service-dir}/armbillingbenefits" fix-const-stuttering: true flavor: "azure" generate-samples: true diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/billingbenefits.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/billingbenefits.json new file mode 100644 index 000000000000..0315ee2c650e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/billingbenefits.json @@ -0,0 +1,10263 @@ +{ + "swagger": "2.0", + "info": { + "title": "Billing benefits RP", + "version": "2026-06-01", + "description": "Azure Benefits RP let users create and manage benefits.", + "x-typespec-generated": [ + { + "emitter": "@azure-tools/typespec-autorest" + } + ] + }, + "schemes": [ + "https" + ], + "host": "management.azure.com", + "produces": [ + "application/json" + ], + "consumes": [ + "application/json" + ], + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "description": "Azure Active Directory OAuth2 Flow.", + "flow": "implicit", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + "tags": [ + { + "name": "Operations" + }, + { + "name": "SavingsPlanOrderAliasModels" + }, + { + "name": "SavingsPlanOrderModels" + }, + { + "name": "SavingsPlanModels" + }, + { + "name": "ReservationOrderAliasResponses" + }, + { + "name": "Discounts" + }, + { + "name": "Contributors" + }, + { + "name": "Credits" + }, + { + "name": "ConditionalCredits" + }, + { + "name": "ConditionalCreditContributors" + }, + { + "name": "Maccs" + }, + { + "name": "CreditSources" + }, + { + "name": "FreeServicesOperations" + }, + { + "name": "CreditTransactions" + }, + { + "name": "MaccTransactions" + }, + { + "name": "ConditionalCreditTransactions" + }, + { + "name": "SubscriptionCatalogGroupsOps" + }, + { + "name": "BillingAccountCatalogGroupsOps" + }, + { + "name": "BillingProfileCatalogGroupsOps" + } + ], + "paths": { + "/{scope}/providers/Microsoft.BillingBenefits/applicableConditionalCredits": { + "get": { + "operationId": "ConditionalCredits_ScopeList", + "description": "List conditional credits that are applicable for a given scope. Currently supported scopes: billing accounts", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "scope", + "in": "path", + "description": "The scope at which the benefits are listed.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditScopeList": { + "$ref": "./examples/ApplicableConditionalCreditList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/{scope}/providers/Microsoft.BillingBenefits/applicableCredits": { + "get": { + "operationId": "Credits_ListApplicable", + "description": "List applicable credits for the provided scope. Currently supported scopes: BillingAccountResourceId", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "scope", + "in": "path", + "description": "The scope at which the benefits are listed.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourcesListByCredit": { + "$ref": "./examples/CreditListApplicableCredits.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/{scope}/providers/Microsoft.BillingBenefits/applicableDiscounts": { + "get": { + "operationId": "Discounts_ScopeList", + "description": "List discounts that are applicable for a given scope. Currently supported scopes: billing accounts", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "scope", + "in": "path", + "description": "The scope at which the benefits are listed.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/DiscountList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountScopeList": { + "$ref": "./examples/ApplicableDiscountsList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.BillingBenefits/catalogGroups": { + "get": { + "operationId": "BillingProfileCatalogGroupsOps_List", + "tags": [ + "BillingProfileCatalogGroupsOps" + ], + "description": "List catalog groups at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountName", + "in": "path", + "description": "The name of the billing account.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "name": "billingProfileName", + "in": "path", + "description": "The name of the billing profile.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "$ref": "#/parameters/CatalogGroupsListParameters" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroupListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "BillingProfileCatalogGroupsList": { + "$ref": "./examples/CatalogGroupsBillingProfileList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.BillingBenefits/catalogGroups/{catalogGroupName}": { + "get": { + "operationId": "BillingProfileCatalogGroupsOps_Get", + "tags": [ + "BillingProfileCatalogGroupsOps" + ], + "description": "Get a specific catalog group at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountName", + "in": "path", + "description": "The name of the billing account.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "name": "billingProfileName", + "in": "path", + "description": "The name of the billing profile.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "catalogGroupName", + "in": "path", + "description": "The name of the CatalogGroup", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroup" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "BillingProfileCatalogGroupsGet": { + "$ref": "./examples/CatalogGroupsBillingProfileGet.json" + } + } + } + }, + "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.BillingBenefits/catalogGroups": { + "get": { + "operationId": "BillingAccountCatalogGroupsOps_List", + "tags": [ + "BillingAccountCatalogGroupsOps" + ], + "description": "List catalog groups at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountName", + "in": "path", + "description": "The name of the billing account.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "$ref": "#/parameters/CatalogGroupsListParameters" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroupListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "BillingAccountCatalogGroupsList": { + "$ref": "./examples/CatalogGroupsBillingAccountList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.BillingBenefits/catalogGroups/{catalogGroupName}": { + "get": { + "operationId": "BillingAccountCatalogGroupsOps_Get", + "tags": [ + "BillingAccountCatalogGroupsOps" + ], + "description": "Get a specific catalog group at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountName", + "in": "path", + "description": "The name of the billing account.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "name": "catalogGroupName", + "in": "path", + "description": "The name of the CatalogGroup", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroup" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "BillingAccountCatalogGroupsGet": { + "$ref": "./examples/CatalogGroupsBillingAccountGet.json" + } + } + } + }, + "/providers/Microsoft.BillingBenefits/listSellerResources": { + "post": { + "operationId": "SellerResource_List", + "description": "List maccs by billing account", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "description": "The request body", + "required": true, + "schema": { + "$ref": "#/definitions/SellerResourceListRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "type": "array", + "items": { + "$ref": "#/definitions/Macc" + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SellerViewContributors": { + "$ref": "./examples/MaccSellerViewContributors.json" + }, + "SellerViewContributorsWithMilestones": { + "$ref": "./examples/MaccSellerViewContributorsWithMilestones.json" + }, + "SellerViewContributorsWithMilestonesAndShortfall": { + "$ref": "./examples/MaccSellerViewContributorsWithMilestonesAndShortfall.json" + }, + "SellerViewNoContributors": { + "$ref": "./examples/MaccSellerViewNoContributors.json" + }, + "SellerViewWithMilestonesNoContributors": { + "$ref": "./examples/MaccSellerViewWithMilestonesNoContributors.json" + } + } + } + }, + "/providers/Microsoft.BillingBenefits/operations": { + "get": { + "operationId": "Operations_List", + "tags": [ + "Operations" + ], + "description": "List the operations for the provider", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/OperationListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "OperationsGet": { + "$ref": "./examples/OperationsGet.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.BillingBenefits/reservationOrderAliases/{reservationOrderAliasName}": { + "get": { + "operationId": "ReservationOrderAlias_Get", + "tags": [ + "ReservationOrderAliasResponses" + ], + "description": "Get a reservation order alias.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "reservationOrderAliasName", + "in": "path", + "description": "Name of the reservation order alias", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ReservationOrderAliasResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ReservationOrderAliasGet": { + "$ref": "./examples/ReservationOrderAliasGet.json" + }, + "ReservationOrderAliasGetWithRenewProperties": { + "$ref": "./examples/ReservationOrderAliasGetWithRenewProperties.json" + } + } + }, + "put": { + "operationId": "ReservationOrderAlias_Create", + "tags": [ + "ReservationOrderAliasResponses" + ], + "description": "Create a reservation order alias.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "reservationOrderAliasName", + "in": "path", + "description": "Name of the reservation order alias", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for creating a reservation order alias", + "required": true, + "schema": { + "$ref": "#/definitions/ReservationOrderAliasRequest" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ReservationOrderAliasResponse" + } + }, + "201": { + "description": "Resource 'ReservationOrderAliasResponse' create operation succeeded", + "schema": { + "$ref": "#/definitions/ReservationOrderAliasResponse" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ReservationOrderAliasCreate": { + "$ref": "./examples/ReservationOrderAliasCreate.json" + }, + "ReservationOrderAliasCreateWithRenewProperties": { + "$ref": "./examples/ReservationOrderAliasCreateWithRenewProperties.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/ReservationOrderAliasResponse" + }, + "x-ms-long-running-operation": true + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrderAliases/{savingsPlanOrderAliasName}": { + "get": { + "operationId": "SavingsPlanOrderAlias_Get", + "tags": [ + "SavingsPlanOrderAliasModels" + ], + "description": "Get a savings plan.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderAliasName", + "in": "path", + "description": "Name of the savings plan order alias", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanOrderAliasModel" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanOrderAliasGet": { + "$ref": "./examples/SavingsPlanOrderAliasGet.json" + } + } + }, + "put": { + "operationId": "SavingsPlanOrderAlias_Create", + "tags": [ + "SavingsPlanOrderAliasModels" + ], + "description": "Create a savings plan. Learn more about permissions needed at https://go.microsoft.com/fwlink/?linkid=2215851", + "externalDocs": { + "url": "https://go.microsoft.com/fwlink/?linkid=2215851/" + }, + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderAliasName", + "in": "path", + "description": "Name of the savings plan order alias", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for creating a savings plan order alias", + "required": true, + "schema": { + "$ref": "#/definitions/SavingsPlanOrderAliasModel" + } + } + ], + "responses": { + "200": { + "description": "Resource 'SavingsPlanOrderAliasModel' update operation succeeded", + "schema": { + "$ref": "#/definitions/SavingsPlanOrderAliasModel" + } + }, + "201": { + "description": "Resource 'SavingsPlanOrderAliasModel' create operation succeeded", + "schema": { + "$ref": "#/definitions/SavingsPlanOrderAliasModel" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanOrderAliasCreate": { + "$ref": "./examples/SavingsPlanOrderAliasCreate.json" + }, + "SavingsPlanOrderAliasCreateSingleScope": { + "$ref": "./examples/SavingsPlanOrderAliasCreateSingleScope.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/SavingsPlanOrderAliasModel" + }, + "x-ms-long-running-operation": true + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders": { + "get": { + "operationId": "SavingsPlanOrder_List", + "tags": [ + "SavingsPlanOrderModels" + ], + "description": "List all Savings plan orders.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanOrderModelList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanOrderList": { + "$ref": "./examples/SavingsPlanOrderList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}": { + "get": { + "operationId": "SavingsPlanOrder_Get", + "tags": [ + "SavingsPlanOrderModels" + ], + "description": "Get a savings plan order.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "$expand", + "in": "query", + "description": "May be used to expand the detail information of some properties.", + "required": false, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanOrderModel" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanOrderGet": { + "$ref": "./examples/SavingsPlanOrderGet.json" + }, + "SavingsPlanOrderWithExpandedPaymentsGet": { + "$ref": "./examples/SavingsPlanOrderExpandedGet.json" + } + } + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/elevate": { + "post": { + "operationId": "SavingsPlanOrder_Elevate", + "tags": [ + "SavingsPlanOrderModels" + ], + "description": "Elevate as owner on savings plan order based on billing permissions.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/RoleAssignmentEntity" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanOrderElevate": { + "$ref": "./examples/SavingsPlanOrderElevate.json" + } + } + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans": { + "get": { + "operationId": "SavingsPlan_List", + "tags": [ + "SavingsPlanModels" + ], + "description": "List savings plans in an order.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanModelList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlansInOrderList": { + "$ref": "./examples/SavingsPlansInOrderList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}": { + "get": { + "operationId": "SavingsPlan_Get", + "tags": [ + "SavingsPlanModels" + ], + "description": "Get savings plan.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "savingsPlanId", + "in": "path", + "description": "ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "$expand", + "in": "query", + "description": "May be used to expand the detail information of some properties.", + "required": false, + "type": "string" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanModel" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanItemGet": { + "$ref": "./examples/SavingsPlanItemGet.json" + }, + "SavingsPlanItemWithExpandedRenewPropertiesGet": { + "$ref": "./examples/SavingsPlanItemExpandedGet.json" + } + } + }, + "patch": { + "operationId": "SavingsPlan_Update", + "tags": [ + "SavingsPlanModels" + ], + "description": "Update savings plan.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "savingsPlanId", + "in": "path", + "description": "ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "description": "Request body for patching a savings plan order alias", + "required": true, + "schema": { + "$ref": "#/definitions/SavingsPlanUpdateRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanModel" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Location": { + "type": "string", + "description": "The Location header contains the URL where the status of the long running operation can be checked." + } + } + }, + "404": { + "description": "ARM not found response", + "x-ms-error-response": true + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanUpdate": { + "$ref": "./examples/SavingsPlanUpdate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location", + "final-state-schema": "#/definitions/SavingsPlanModel" + }, + "x-ms-long-running-operation": true + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate": { + "post": { + "operationId": "SavingsPlan_ValidateUpdate", + "tags": [ + "SavingsPlanModels" + ], + "description": "Validate savings plan patch.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "savingsPlanOrderId", + "in": "path", + "description": "Order ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "savingsPlanId", + "in": "path", + "description": "ID of the savings plan", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "description": "Request body for validating a savings plan patch request", + "required": true, + "schema": { + "$ref": "#/definitions/SavingsPlanUpdateValidateRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/SavingsPlanValidateResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlanValidateUpdate": { + "$ref": "./examples/SavingsPlanValidateUpdate.json" + } + } + } + }, + "/providers/Microsoft.BillingBenefits/savingsPlans": { + "get": { + "operationId": "SavingsPlan_ListAll", + "description": "List savings plans.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "$filter", + "in": "query", + "description": "May be used to filter by reservation properties. The filter supports 'eq', 'or', and 'and'. It does not currently support 'ne', 'gt', 'le', 'ge', or 'not'. Reservation properties include sku/name, properties/{appliedScopeType, archived, displayName, displayProvisioningState, effectiveDateTime, expiryDate, provisioningState, quantity, renew, reservedResourceType, term, userFriendlyAppliedScopeType, userFriendlyRenewState}", + "required": false, + "type": "string" + }, + { + "name": "$orderby", + "in": "query", + "description": "May be used to sort order by reservation properties.", + "required": false, + "type": "string" + }, + { + "name": "refreshSummary", + "in": "query", + "description": "To indicate whether to refresh the roll up counts of the savings plans group by provisioning states", + "required": false, + "type": "string" + }, + { + "name": "$skiptoken", + "in": "query", + "description": "The number of savings plans to skip from the list before returning results", + "required": false, + "type": "number", + "format": "float" + }, + { + "name": "selectedState", + "in": "query", + "description": "The selected provisioning state", + "required": false, + "type": "string" + }, + { + "name": "take", + "in": "query", + "description": "To number of savings plans to return", + "required": false, + "type": "number", + "format": "float" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/SavingsPlanModelListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SavingsPlansList": { + "$ref": "./examples/SavingsPlansList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/Microsoft.BillingBenefits/validate": { + "post": { + "operationId": "Benefit_Validate", + "description": "Validate savings plan purchase.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "description": "The request body", + "required": true, + "schema": { + "$ref": "#/definitions/BenefitValidateRequest" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/BenefitValidateResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditValidateCancel": { + "$ref": "./examples/ConditionalCreditValidateCancel.json" + }, + "ConditionalCreditValidateCreate": { + "$ref": "./examples/ConditionalCreditValidateCreate.json" + }, + "ConditionalCreditValidateCreateContributor": { + "$ref": "./examples/ConditionalCreditValidateCreateContributor.json" + }, + "ConditionalCreditValidateCreateError": { + "$ref": "./examples/ConditionalCreditValidateCreateError.json" + }, + "ConditionalCreditValidateCreateMultiple": { + "$ref": "./examples/ConditionalCreditValidateCreateMultiple.json" + }, + "ConditionalCreditValidateUpdate": { + "$ref": "./examples/ConditionalCreditValidateUpdate.json" + }, + "ConditionalCreditValidateUpdateRemoveMilestone": { + "$ref": "./examples/ConditionalCreditValidateUpdateRemoveMilestone.json" + }, + "CreditsValidateCreate": { + "$ref": "./examples/CreditsValidateCreate.json" + }, + "DiscountsValidateCreate": { + "$ref": "./examples/DiscountsValidateCreate.json" + }, + "MaccValidateCancel": { + "$ref": "./examples/MaccValidateCancel.json" + }, + "MaccValidateCancelWithMilestones": { + "$ref": "./examples/MaccValidateCancelWithMilestones.json" + }, + "MaccValidateCreate": { + "$ref": "./examples/MaccValidateCreate.json" + }, + "MaccValidateCreateBackfilledMacc": { + "$ref": "./examples/MaccValidateCreateBackfilledMacc.json" + }, + "MaccValidateCreateContributor": { + "$ref": "./examples/MaccValidateCreateContributor.json" + }, + "MaccValidateCreateMilestonesOnExistingMacc": { + "$ref": "./examples/MaccValidateCreateMilestonesOnExistingMacc.json" + }, + "MaccValidateCreateMultiEntity": { + "$ref": "./examples/MaccValidateCreateMultiEntity.json" + }, + "MaccValidateCreateNewMaccWithMilestone": { + "$ref": "./examples/MaccValidateCreateNewMaccWithMilestone.json" + }, + "MaccValidateUpdate": { + "$ref": "./examples/MaccValidateUpdate.json" + }, + "MaccValidateUpdateCommitment": { + "$ref": "./examples/MaccValidateUpdateCommitment.json" + }, + "MaccValidateUpdateCommitmentEndAtContributorRule": { + "$ref": "./examples/MaccValidateUpdateCommitmentEndAtContributorRule.json" + }, + "MaccValidateUpdateContributor": { + "$ref": "./examples/MaccValidateUpdateContributor.json" + }, + "MaccValidateUpdateContributorRule": { + "$ref": "./examples/MaccValidateUpdateContributorRule.json" + }, + "MaccValidateUpdateDisplayName": { + "$ref": "./examples/MaccValidateUpdateDisplayName.json" + }, + "MaccValidateUpdateEndAt": { + "$ref": "./examples/MaccValidateUpdateEndAt.json" + }, + "MaccValidateUpdateMaccAndMilestoneCommitment": { + "$ref": "./examples/MaccValidateUpdateMaccAndMilestoneCommitment.json" + }, + "MaccValidateUpdateMaccAndMilestoneEndDate": { + "$ref": "./examples/MaccValidateUpdateMaccAndMilestoneEndDate.json" + }, + "MaccValidateUpdateMilestoneCommitment": { + "$ref": "./examples/MaccValidateUpdateMilestoneCommitment.json" + }, + "MaccValidateUpdateMilestoneEndDate": { + "$ref": "./examples/MaccValidateUpdateMilestoneEndDate.json" + }, + "MaccValidateUpdateRemoveMilestones": { + "$ref": "./examples/MaccValidateUpdateRemoveMilestones.json" + }, + "MaccValidateUpdateSuppressShortfall": { + "$ref": "./examples/MaccValidateUpdateSuppressShortfall.json" + }, + "MaccValidateUpdateSuppressShortfallOnMilestone": { + "$ref": "./examples/MaccValidateUpdateSuppressShortfallOnMilestone.json" + }, + "MaccValidateUpdateUnsuppressShortfall": { + "$ref": "./examples/MaccValidateUpdateUnsuppressShortfall.json" + }, + "MaccValidateUpdateUnsuppressShortfallOnMilestone": { + "$ref": "./examples/MaccValidateUpdateUnsuppressShortfallOnMilestone.json" + }, + "MaccValidateWriteOffWithMilestones": { + "$ref": "./examples/MaccValidateWriteOffWithMilestones.json" + }, + "MaccsValidateCreate": { + "$ref": "./examples/MaccsValidateCreate.json" + }, + "SSCacoFlexibleValidateCreate": { + "$ref": "./examples/SSCacoFlexibleValidateCreate.json" + }, + "SSCacoFlexibleValidateCreateMultipleInvalidOverlap": { + "$ref": "./examples/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json" + }, + "SSCacoFlexibleValidateCreateMultipleValidOverlap": { + "$ref": "./examples/SSCacoFlexibleValidateCreateMultipleValidOverlap.json" + }, + "SSCacoFlexibleValidateUpdate": { + "$ref": "./examples/SSCacoFlexibleValidateUpdate.json" + }, + "SavingsPlanValidatePurchase": { + "$ref": "./examples/SavingsPlanValidatePurchase.json" + }, + "SavingsPlansValidateCreate": { + "$ref": "./examples/SavingsPlansValidateCreate.json" + } + } + } + }, + "/providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.BillingBenefits/applicableConditionalCredits/{systemId}/providers/microsoft.BillingBenefits/applicableContributors": { + "get": { + "operationId": "ConditionalCreditContributors_ListFromApplicableConditionalCredit", + "description": "List contributors under applicable conditional credits for a given billing account.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountId", + "in": "path", + "description": "The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "name": "systemId", + "in": "path", + "description": "System ID of the primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ConditionalCreditContributorList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditContributorsScopeList": { + "$ref": "./examples/ConditionalCreditContributorsListFromApplicableConditionalCredit.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.BillingBenefits/applicableMaccs": { + "get": { + "operationId": "ApplicableMaccs_List", + "description": "List maccs that are applicable for a given billing account.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountId", + "in": "path", + "description": "The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ApplicableMaccList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountScopeList": { + "$ref": "./examples/ApplicableMaccsList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.BillingBenefits/applicableMaccs/{systemId}/providers/microsoft.BillingBenefits/applicableContributors": { + "get": { + "operationId": "Contributors_ListFromApplicableMacc", + "description": "List contributors under applicable MACCs for a given billing account.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "name": "billingAccountId", + "in": "path", + "description": "The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.:]+$" + }, + { + "name": "systemId", + "in": "path", + "description": "System ID of the primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ContributorList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ContributorsScopeList": { + "$ref": "./examples/ContributorsListFromApplicableMacc.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups": { + "get": { + "operationId": "SubscriptionCatalogGroupsOps_List", + "tags": [ + "SubscriptionCatalogGroupsOps" + ], + "description": "List catalog groups at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/CatalogGroupsListParameters" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroupListResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SubscriptionCatalogGroupsList": { + "$ref": "./examples/CatalogGroupsSubscriptionList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups/{catalogGroupName}": { + "get": { + "operationId": "SubscriptionCatalogGroupsOps_Get", + "tags": [ + "SubscriptionCatalogGroupsOps" + ], + "description": "Get a specific catalog group at the target scope.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "name": "catalogGroupName", + "in": "path", + "description": "The name of the CatalogGroup", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CatalogGroup" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "SubscriptionCatalogGroupsGet": { + "$ref": "./examples/CatalogGroupsSubscriptionGet.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/conditionalCredits": { + "get": { + "operationId": "ConditionalCredits_ListBySubscription", + "tags": [ + "ConditionalCredits" + ], + "description": "List conditional credits by subscription.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditsListBySubscription": { + "$ref": "./examples/ConditionalCreditsListBySubscription.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/credits": { + "get": { + "operationId": "Credits_ListBySubscription", + "tags": [ + "Credits" + ], + "description": "List credits under a subscription from primary service tenant.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditsListBySubscription": { + "$ref": "./examples/CreditsListBySubscription.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/discounts": { + "get": { + "operationId": "Discounts_SubscriptionList", + "tags": [ + "Discounts" + ], + "description": "List discounts at subscription level", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/DiscountList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountSubscriptionList": { + "$ref": "./examples/DiscountList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/freeServices": { + "get": { + "operationId": "FreeServices_ListBySubscription", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation lists free services that are available under the specified subscription.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/FreeServicesList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesListBySubscription": { + "$ref": "./examples/FreeServicesListBySubscription.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/maccs": { + "get": { + "operationId": "Maccs_ListBySubscription", + "tags": [ + "Maccs" + ], + "description": "List MACCs under a subscription from primary service tenant.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/MaccList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccsWithMilestones_ListBySubscription": { + "$ref": "./examples/MaccsWithMilestonesListBySubscription.json" + }, + "Maccs_ListBySubscription": { + "$ref": "./examples/MaccsListBySubscription.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits": { + "get": { + "operationId": "ConditionalCredits_ListByResourceGroup", + "tags": [ + "ConditionalCredits" + ], + "description": "List conditional credits by resource group.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditsListByResourceGroup": { + "$ref": "./examples/ConditionalCreditsListByResourceGroup.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}": { + "get": { + "operationId": "ConditionalCredits_Get", + "tags": [ + "ConditionalCredits" + ], + "description": "Get a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCredit" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditGet": { + "$ref": "./examples/ConditionalCreditGet.json" + } + } + }, + "put": { + "operationId": "ConditionalCredits_CreateOrUpdate", + "tags": [ + "ConditionalCredits" + ], + "description": "Create or update a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for creating a conditional credit", + "required": true, + "schema": { + "$ref": "#/definitions/ConditionalCredit" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ConditionalCredit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "201": { + "description": "The request has succeeded and a new resource has been created as a result.", + "schema": { + "$ref": "#/definitions/ConditionalCredit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditCreateContributor": { + "$ref": "./examples/ConditionalCreditCreateContributor.json" + }, + "ConditionalCreditCreatePrimary": { + "$ref": "./examples/ConditionalCreditCreatePrimary.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/ConditionalCredit" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "ConditionalCredits_Update", + "tags": [ + "ConditionalCredits" + ], + "description": "Update a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for updating a conditional credit", + "required": true, + "schema": { + "$ref": "#/definitions/ConditionalCreditPatchRequest" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/ConditionalCredit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditUpdate": { + "$ref": "./examples/ConditionalCreditUpdate.json" + }, + "ConditionalCreditUpdateContributor": { + "$ref": "./examples/ConditionalCreditUpdateContributor.json" + }, + "ConditionalCreditUpdateLastMilestoneEndDate": { + "$ref": "./examples/ConditionalCreditUpdateLastMilestoneEndDate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/ConditionalCredit" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "ConditionalCredits_Delete", + "tags": [ + "ConditionalCredits" + ], + "description": "Delete a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful. ", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditDelete": { + "$ref": "./examples/ConditionalCreditDelete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}/cancel": { + "post": { + "operationId": "ConditionalCredits_Cancel", + "tags": [ + "ConditionalCredits" + ], + "description": "Cancel conditional credit. Stops applying the benefit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCredit" + } + }, + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditCancel": { + "$ref": "./examples/ConditionalCreditCancel.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/ConditionalCredit" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}/contributors": { + "get": { + "operationId": "ConditionalCreditContributors_ListFromPrimary", + "tags": [ + "ConditionalCreditContributors" + ], + "description": "List contributors under a primary conditional credit for primary service admin", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditContributorList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditContributors_ListFromPrimary": { + "$ref": "./examples/ConditionalCreditContributorsListFromPrimary.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}/contributors/{contributorName}": { + "get": { + "operationId": "ConditionalCreditContributors_GetFromPrimary", + "tags": [ + "ConditionalCreditContributors" + ], + "description": "Get a conditional credit contributor for primary service admin", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "contributorName", + "in": "path", + "description": "Unique name of contributor in the format {contributorCloudSubId}_{resourceGroupName}_{nameInContributorTenant}.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditContributor" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditContributor_GetFromPrimary": { + "$ref": "./examples/ConditionalCreditContributorGetFromPrimary.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}/transactions": { + "get": { + "operationId": "ConditionalCreditTransactions_ListByParent", + "tags": [ + "ConditionalCreditTransactions" + ], + "description": "List all transactions for a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditTransactionsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditTransactionsList": { + "$ref": "./examples/ConditionalCreditTransactionsList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}/transactions/{transactionName}": { + "get": { + "operationId": "ConditionalCreditTransactions_Get", + "tags": [ + "ConditionalCreditTransactions" + ], + "description": "Get a specific transaction for a conditional credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "conditionalCreditName", + "in": "path", + "description": "Name of the conditional credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "transactionName", + "in": "path", + "description": "Name of the transaction", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ConditionalCreditTransaction" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ConditionalCreditTransactionGet": { + "$ref": "./examples/ConditionalCreditTransactionGet.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits": { + "get": { + "operationId": "Credits_ListByResourceGroup", + "tags": [ + "Credits" + ], + "description": "List Credits under a resource group from primary service admin.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditsListByResourceGroup": { + "$ref": "./examples/CreditsListByResourceGroup.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}": { + "get": { + "operationId": "Credits_Get", + "tags": [ + "Credits" + ], + "description": "Get a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Credit" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditGet": { + "$ref": "./examples/CreditGet.json" + } + } + }, + "put": { + "operationId": "Credits_Create", + "tags": [ + "Credits" + ], + "description": "Create a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Credit create request", + "required": true, + "schema": { + "$ref": "#/definitions/Credit" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/Credit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "201": { + "description": "The request has succeeded and a new resource has been created as a result.", + "schema": { + "$ref": "#/definitions/Credit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditCreate": { + "$ref": "./examples/CreditCreate.json" + }, + "CreditCreateWithInvitation": { + "$ref": "./examples/CreditCreateWithInvitation.json" + }, + "CreditTransferCreditCreate": { + "$ref": "./examples/CreditTransferCreditCreate.json" + }, + "EndCustomerInvestmentFundCreditCreate": { + "$ref": "./examples/EndCustomerInvestmentFundCreditCreate.json" + }, + "PromotionalCreditCreate": { + "$ref": "./examples/PromotionalCreditCreate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "original-uri", + "final-state-schema": "#/definitions/Credit" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "Credits_Update", + "tags": [ + "Credits" + ], + "description": "Update a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Credit patch request", + "required": true, + "schema": { + "$ref": "#/definitions/CreditPatchRequest" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/Credit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditTagsUpdate": { + "$ref": "./examples/CreditTagsUpdate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Credit" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "Credits_Delete", + "tags": [ + "Credits" + ], + "description": "Delete a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful. ", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditDelete": { + "$ref": "./examples/CreditDelete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/cancel": { + "post": { + "operationId": "Credits_Cancel", + "tags": [ + "Credits" + ], + "description": "Cancels a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/Credit" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditCancel": { + "$ref": "./examples/CreditCancel.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location", + "final-state-schema": "#/definitions/Credit" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/changeSponsor": { + "post": { + "operationId": "Credits_ChangeSponsor", + "tags": [ + "Credits" + ], + "description": "Change the sponsor of a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "The content of the action request", + "required": true, + "schema": { + "$ref": "#/definitions/ChangeSponsorRequest" + } + } + ], + "responses": { + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditChangeSponsor": { + "$ref": "./examples/CreditChangeSponsor.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/sources": { + "get": { + "operationId": "Sources_ListByCredit", + "tags": [ + "CreditSources" + ], + "description": "List credit sources for a credit under a resource group from primary service admin.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditSourcesList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourcesListByCredit": { + "$ref": "./examples/CreditSourcesListByCredit.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/sources/{sourceName}": { + "get": { + "operationId": "Sources_Get", + "tags": [ + "CreditSources" + ], + "description": "Get a credit source.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "sourceName", + "in": "path", + "description": "Name of the credit source", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditSource" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourceGet": { + "$ref": "./examples/CreditSourceGet.json" + } + } + }, + "put": { + "operationId": "Sources_Create", + "tags": [ + "CreditSources" + ], + "description": "Create a credit source.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "sourceName", + "in": "path", + "description": "Name of the credit source", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Credit source create request", + "required": true, + "schema": { + "$ref": "#/definitions/CreditSource" + } + } + ], + "responses": { + "200": { + "description": "Resource 'CreditSource' update operation succeeded", + "schema": { + "$ref": "#/definitions/CreditSource" + } + }, + "201": { + "description": "Resource 'CreditSource' create operation succeeded", + "schema": { + "$ref": "#/definitions/CreditSource" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourceCreate": { + "$ref": "./examples/CreditSourceCreate.json" + } + } + }, + "patch": { + "operationId": "Sources_Update", + "tags": [ + "CreditSources" + ], + "description": "Update a credit source.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "sourceName", + "in": "path", + "description": "Name of the credit source", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Credit source patch request", + "required": true, + "schema": { + "$ref": "#/definitions/CreditSourcePatchRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditSource" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourceTagsUpdate": { + "$ref": "./examples/CreditSourceTagsUpdate.json" + } + } + }, + "delete": { + "operationId": "Sources_Delete", + "tags": [ + "CreditSources" + ], + "description": "Delete a credit source.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "sourceName", + "in": "path", + "description": "Name of the credit source", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Resource deleted successfully." + }, + "204": { + "description": "Resource does not exist." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditSourceDelete": { + "$ref": "./examples/CreditSourceDelete.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/transactions": { + "get": { + "operationId": "CreditTransactions_ListByParent", + "tags": [ + "CreditTransactions" + ], + "description": "List all transactions for a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/TransactionsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditTransactionsList": { + "$ref": "./examples/CreditTransactionsList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/credits/{creditName}/transactions/{transactionName}": { + "get": { + "operationId": "CreditTransactions_Get", + "tags": [ + "CreditTransactions" + ], + "description": "Get a specific transaction for a credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "creditName", + "in": "path", + "description": "Name of the credit", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "transactionName", + "in": "path", + "description": "Name of the transaction", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/CreditTransaction" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "CreditTransactionGet": { + "$ref": "./examples/CreditTransactionGet.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/discounts": { + "get": { + "operationId": "Discounts_ResourceGroupList", + "tags": [ + "Discounts" + ], + "description": "List discounts at resource group level", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/DiscountList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountResourceGroupList": { + "$ref": "./examples/DiscountResourceGroupList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/discounts/{discountName}": { + "get": { + "operationId": "Discount_Get", + "tags": [ + "Discounts" + ], + "description": "Get discount at resource group level", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "discountName", + "in": "path", + "description": "Name of the discount", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Discount" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountGet": { + "$ref": "./examples/DiscountGet.json" + } + } + }, + "put": { + "operationId": "Discounts_Create", + "tags": [ + "Discounts" + ], + "description": "Create discount.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "discountName", + "in": "path", + "description": "Name of the discount", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for creating a discount.", + "required": true, + "schema": { + "$ref": "#/definitions/Discount" + } + } + ], + "responses": { + "200": { + "description": "Resource 'Discount' update operation succeeded", + "schema": { + "$ref": "#/definitions/Discount" + } + }, + "201": { + "description": "Resource 'Discount' create operation succeeded", + "schema": { + "$ref": "#/definitions/Discount" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountsCreateAffiliate": { + "$ref": "./examples/DiscountsCreateAffiliate.json" + }, + "DiscountsCreatePrimary": { + "$ref": "./examples/DiscountsCreatePrimary.json" + }, + "DiscountsCreatePrimaryBackfill": { + "$ref": "./examples/DiscountsCreatePrimaryBackfill.json" + }, + "DiscountsCreatePrimaryWithAzurePromotion": { + "$ref": "./examples/DiscountsCreatePrimaryWithAzurePromotion.json" + }, + "DiscountsCreatePrimaryWithCustomPrice": { + "$ref": "./examples/DiscountsCreatePrimaryWithCustomPrice.json" + }, + "DiscountsCreatePrimaryWithCustomPriceMultiCurrency": { + "$ref": "./examples/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json" + }, + "DiscountsCreatePrimaryWithPriceGuarantee": { + "$ref": "./examples/DiscountsCreatePrimaryWithPriceGuarantee.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Discount" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "Discount_Update", + "tags": [ + "Discounts" + ], + "description": "Update discounts", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "discountName", + "in": "path", + "description": "Name of the discount", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for updating discounts", + "required": true, + "schema": { + "$ref": "#/definitions/DiscountPatchRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Discount" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountGet": { + "$ref": "./examples/DiscountsUpdate.json" + }, + "DiscountsUpdateEndAt": { + "$ref": "./examples/DiscountsUpdateEndAt.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Discount" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "Discounts_Delete", + "tags": [ + "Discounts" + ], + "description": "Delete discount. Clears the metadata from the user's view.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "discountName", + "in": "path", + "description": "Name of the discount", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ReservationOrderAliasCreate": { + "$ref": "./examples/DiscountsDelete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/discounts/{discountName}/cancel": { + "post": { + "operationId": "Discounts_Cancel", + "tags": [ + "Discounts" + ], + "description": "Cancel discount. Stops applying the benefit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "discountName", + "in": "path", + "description": "Name of the discount", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Discount" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "DiscountCancel": { + "$ref": "./examples/DiscountCancel.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Discount" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices": { + "get": { + "operationId": "FreeServices_ListByResourceGroup", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation lists the free services that are available under the specified resource group.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/FreeServicesList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesListByResourceGroup": { + "$ref": "./examples/FreeServicesListByResourceGroup.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices/{freeServiceName}": { + "get": { + "operationId": "FreeServices_Get", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation retrieves properties for free services.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "freeServiceName", + "in": "path", + "description": "Name of the free service", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/FreeServices" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesGet": { + "$ref": "./examples/FreeServicesGet.json" + } + } + }, + "put": { + "operationId": "FreeServices_Create", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation creates or updates free services in Azure", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "freeServiceName", + "in": "path", + "description": "Name of the free service", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Free services create request", + "required": true, + "schema": { + "$ref": "#/definitions/FreeServices" + } + } + ], + "responses": { + "200": { + "description": "Resource 'FreeServices' update operation succeeded", + "schema": { + "$ref": "#/definitions/FreeServices" + } + }, + "201": { + "description": "Resource 'FreeServices' create operation succeeded", + "schema": { + "$ref": "#/definitions/FreeServices" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesCreate": { + "$ref": "./examples/FreeServicesCreate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/FreeServices" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "FreeServices_Update", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation updates free services in Azure.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "freeServiceName", + "in": "path", + "description": "Name of the free service", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Free services patch request", + "required": true, + "schema": { + "$ref": "#/definitions/FreeServicesPatchRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/FreeServices" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesUpdate": { + "$ref": "./examples/FreeServicesUpdate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/FreeServices" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "FreeServices_Delete", + "tags": [ + "FreeServicesOperations" + ], + "description": "This operation deletes free services from the subscription. Only free services that are in an expired or cancelled states can be deleted.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "freeServiceName", + "in": "path", + "description": "Name of the free service", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful. ", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "FreeServicesDelete": { + "$ref": "./examples/FreeServicesDelete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "location" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs": { + "get": { + "operationId": "Maccs_ListByResourceGroup", + "tags": [ + "Maccs" + ], + "description": "List MACCs under a resource group for primary service admin.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/MaccList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccsWithMilestones_ListByResourceGroup": { + "$ref": "./examples/MaccsWithMilestonesListByResourceGroup.json" + }, + "Maccs_ListByResourceGroup": { + "$ref": "./examples/MaccsListByResourceGroup.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}": { + "get": { + "operationId": "Maccs_Get", + "tags": [ + "Maccs" + ], + "description": "Get a MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ContributorWithMilestonesAndShortfall_GetFromPrimary": { + "$ref": "./examples/ContributorWithMilestonesAndShortfallGet.json" + }, + "ContributorWithMilestones_GetFromPrimary": { + "$ref": "./examples/ContributorWithMilestonesGet.json" + }, + "Contributor_Get": { + "$ref": "./examples/ContributorGet.json" + }, + "MaccWithMilestonesAndShortfall_Get": { + "$ref": "./examples/MaccWithMilestonesAndShortfallGet.json" + }, + "MaccWithMilestones_Get": { + "$ref": "./examples/MaccWithMilestonesGet.json" + }, + "MaccWithShortfall_Get": { + "$ref": "./examples/MaccWithShortfallGet.json" + }, + "Macc_Get": { + "$ref": "./examples/MaccGet.json" + } + } + }, + "put": { + "operationId": "Maccs_Create", + "tags": [ + "Maccs" + ], + "description": "Create MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for creating MACC.", + "required": true, + "schema": { + "$ref": "#/definitions/Macc" + } + } + ], + "responses": { + "200": { + "description": "Resource 'Macc' update operation succeeded", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "201": { + "description": "Resource 'Macc' create operation succeeded", + "schema": { + "$ref": "#/definitions/Macc" + }, + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "description": "URL for checking the ongoing status of the operation." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Contributor_Create": { + "$ref": "./examples/ContributorCreate.json" + }, + "MaccWithMilestones_Create": { + "$ref": "./examples/MaccWithMilestonesCreate.json" + }, + "Macc_Create": { + "$ref": "./examples/MaccCreate.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Macc" + }, + "x-ms-long-running-operation": true + }, + "patch": { + "operationId": "Maccs_Update", + "tags": [ + "Maccs" + ], + "description": "Update MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for updating MACC.", + "required": true, + "schema": { + "$ref": "#/definitions/MaccPatchRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Contributor_UpdateEndDate": { + "$ref": "./examples/ContributorEndDateUpdate.json" + }, + "MaccAndMilestoneCommitment_Update": { + "$ref": "./examples/MaccAndMilestoneCommitmentUpdate.json" + }, + "MaccAndMilestoneEndDate_Update": { + "$ref": "./examples/MaccAndMilestoneEndDateUpdate.json" + }, + "MaccAndMilestoneMultiProperty_Update": { + "$ref": "./examples/MaccAndMilestoneMultiPropertyUpdate.json" + }, + "MaccCommitment_Update": { + "$ref": "./examples/MaccNoMilestonesCommitmentUpdate.json" + }, + "MaccDisplayName_Update": { + "$ref": "./examples/MaccDisplayNameUpdate.json" + }, + "MaccEndContributorRule_Update": { + "$ref": "./examples/MaccContributorRuleUpdate.json" + }, + "MaccEndDate_Update": { + "$ref": "./examples/MaccNoMilestonesEndDateUpdate.json" + }, + "MaccMilestoneSuppressAutomaticShortfall": { + "$ref": "./examples/MaccMilestoneSuppressAutomaticShortfall.json" + }, + "MaccMilestoneUnsuppressAutomaticShortfall": { + "$ref": "./examples/MaccMilestoneUnsuppressAutomaticShortfall.json" + }, + "MaccMultiProperty_Update": { + "$ref": "./examples/MaccMultiPropertyUpdate.json" + }, + "MaccSuppressAutomaticShortfall": { + "$ref": "./examples/MaccSuppressAutomaticShortfall.json" + }, + "MaccTags_Update": { + "$ref": "./examples/MaccTagsUpdate.json" + }, + "MaccUnsuppressAutomaticShortfall": { + "$ref": "./examples/MaccUnsuppressAutomaticShortfall.json" + }, + "MaccWithMilestonesUpdateLastMilestoneEndDate": { + "$ref": "./examples/MaccWithMilestonesUpdateLastMilestoneEndDate.json" + }, + "MilestonesCreate_OnExistingMacc": { + "$ref": "./examples/MilestonesCreateOnExistingMacc.json" + }, + "MilestonesRemove_FromMacc": { + "$ref": "./examples/MilestonesRemoveFromMacc.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Macc" + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "Maccs_Delete", + "tags": [ + "Maccs" + ], + "description": "Delete MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "204": { + "description": "There is no content to send for this request, but the headers may be useful." + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ServiceSpecificIncentives_Delete": { + "$ref": "./examples/MaccDelete.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/cancel": { + "post": { + "operationId": "Maccs_Cancel", + "tags": [ + "Maccs" + ], + "description": "Represents an operation to cancel MACC contract. This operation does not indicate deletion of the MACC, but rather stops applying the benefit to the account.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccWithMilestones_Cancel": { + "$ref": "./examples/MaccWithMilestonesCancel.json" + }, + "Macc_Cancel": { + "$ref": "./examples/MaccCancel.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Macc" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/chargeShortfall": { + "post": { + "operationId": "Maccs_ChargeShortfall", + "tags": [ + "Maccs" + ], + "description": "Operation to charge shortfall to a customer's account, ensuring they are charged for the outstanding amount of MACC credit.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "body", + "in": "body", + "description": "Request body for charging shortfall.", + "required": true, + "schema": { + "$ref": "#/definitions/ChargeShortfallRequest" + } + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Maccs_ChargeShortfall": { + "$ref": "./examples/MaccChargeShortfall.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Macc" + }, + "x-ms-long-running-operation": true + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/contributors": { + "get": { + "operationId": "Contributors_ListFromPrimary", + "tags": [ + "Contributors" + ], + "description": "List contributors under a MACC for primary service admin", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/ContributorList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "ContributorsWithMilestonesAndShortfall_ListFromPrimary": { + "$ref": "./examples/ContributorsWithMilestonesAndShortfallListFromPrimary.json" + }, + "ContributorsWithMilestones_ListFromPrimary": { + "$ref": "./examples/ContributorsWithMilestonesListFromPrimary.json" + }, + "Contributors_ListFromPrimary": { + "$ref": "./examples/ContributorsListFromPrimary.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/contributors/{contributorName}": { + "get": { + "operationId": "Contributors_GetFromPrimary", + "tags": [ + "Contributors" + ], + "description": "Get a contributor for primary service admin", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "contributorName", + "in": "path", + "description": "Unique name of contributor in the format {contributorCloudSubId}_{resourceGroupName}_{nameInContributorTenant}.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Contributor" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Contributor_GetFromPrimary": { + "$ref": "./examples/ContributorGetFromPrimary.json" + }, + "Contributor_GetFromPrimary_WithMilestones": { + "$ref": "./examples/ContributorWithMilestonesGetFromPrimary.json" + }, + "Contributor_GetFromPrimary_WithMilestonesAndShortfall": { + "$ref": "./examples/ContributorWithMilestonesAndShortfallGetFromPrimary.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/transactions": { + "get": { + "operationId": "MaccTransactions_ListByParent", + "tags": [ + "MaccTransactions" + ], + "description": "List all transactions for a MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/MaccTransactionsList" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccTransactionsList": { + "$ref": "./examples/MaccTransactionsList.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/transactions/{transactionName}": { + "get": { + "operationId": "MaccTransactions_Get", + "tags": [ + "MaccTransactions" + ], + "description": "Get a specific transaction for a MACC.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + }, + { + "name": "transactionName", + "in": "path", + "description": "Name of the transaction", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/MaccTransaction" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccTransactionGet": { + "$ref": "./examples/MaccTransactionGet.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}/writeOff": { + "post": { + "operationId": "Maccs_WriteOff", + "tags": [ + "Maccs" + ], + "description": "Operation to waive a customer's pending MACC balance (Shortfall) from their account, ensuring they are not charged for the outstanding amount.", + "parameters": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "maccName", + "in": "path", + "description": "Name of primary MACC.", + "required": true, + "type": "string", + "pattern": "^[a-zA-Z0-9_\\-\\.]+$" + } + ], + "responses": { + "200": { + "description": "Azure operation completed successfully.", + "schema": { + "$ref": "#/definitions/Macc" + } + }, + "202": { + "description": "Resource operation accepted.", + "headers": { + "Azure-AsyncOperation": { + "type": "string", + "format": "uri", + "description": "URL for checking the ongoing status of the operation." + }, + "Location": { + "type": "string", + "description": "Location URI to poll for result." + }, + "Retry-After": { + "type": "integer", + "format": "int32", + "description": "The Retry-After header can indicate how long the client should wait before polling the operation status." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "MaccWithMilestones_WriteOff": { + "$ref": "./examples/MaccWithMilestonesWriteOff.json" + }, + "Macc_WriteOff": { + "$ref": "./examples/MaccWriteOff.json" + } + }, + "x-ms-long-running-operation-options": { + "final-state-via": "azure-async-operation", + "final-state-schema": "#/definitions/Macc" + }, + "x-ms-long-running-operation": true + } + } + }, + "definitions": { + "ApplicableMacc": { + "type": "object", + "description": "Applicable MACC.", + "properties": { + "properties": { + "$ref": "#/definitions/MaccModelProperties", + "description": "Applicable MACC properties", + "x-ms-client-flatten": true + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "ApplicableMaccList": { + "type": "object", + "description": "Applicable MACC list", + "properties": { + "value": { + "type": "array", + "description": "List Applicable MACCs.", + "items": { + "$ref": "#/definitions/ApplicableMacc" + }, + "x-ms-identifiers": [] + }, + "nextLink": { + "type": "string", + "description": "Url to get the next page." + } + } + }, + "AppliedOn": { + "type": "string", + "description": "Indicates where the credit benefit is applied", + "enum": [ + "Consumption", + "Invoice", + "External" + ], + "x-ms-enum": { + "name": "AppliedOn", + "modelAsString": true, + "values": [ + { + "name": "Consumption", + "value": "Consumption", + "description": "Applied on consume charges" + }, + { + "name": "Invoice", + "value": "Invoice", + "description": "Applied on invoice" + }, + { + "name": "External", + "value": "External", + "description": "Applied externally" + } + ] + } + }, + "AppliedScopeProperties": { + "type": "object", + "description": "Properties specific to applied scope type. Not required if not applicable.", + "properties": { + "tenantId": { + "type": "string", + "description": "Tenant ID where the benefit is applied." + }, + "managementGroupId": { + "type": "string", + "description": "Fully-qualified identifier of the management group where the benefit must be applied." + }, + "subscriptionId": { + "type": "string", + "description": "Fully-qualified identifier of the subscription." + }, + "resourceGroupId": { + "type": "string", + "description": "Fully-qualified identifier of the resource group." + }, + "displayName": { + "type": "string", + "description": "Display name" + }, + "benefitFilter": { + "type": "string", + "description": "A filter string passed to downstream services to categorize and apply usage benefits to specific resource models. Expected format: \"key/value\" (e.g., \"contractId/2025 H2CPU\"). The value is not validated by BillingBenefits and is forwarded as-is.", + "example": "clusterId/2025 H2CPU" + } + } + }, + "AppliedScopeType": { + "type": "string", + "description": "Type of the Applied Scope.", + "enum": [ + "Single", + "Shared", + "ManagementGroup" + ], + "x-ms-enum": { + "name": "AppliedScopeType", + "modelAsString": true, + "values": [ + { + "name": "Single", + "value": "Single" + }, + { + "name": "Shared", + "value": "Shared" + }, + { + "name": "ManagementGroup", + "value": "ManagementGroup" + } + ] + } + }, + "ApplyDiscountOn": { + "type": "string", + "description": "The customer action on which the discount is applied. Supported values are Purchase, Consume, and Renew. Validation: Required, one of supported values.", + "enum": [ + "Purchase", + "Consume", + "Renew" + ], + "x-ms-enum": { + "name": "ApplyDiscountOn", + "modelAsString": true, + "values": [ + { + "name": "Purchase", + "value": "Purchase" + }, + { + "name": "Consume", + "value": "Consume" + }, + { + "name": "Renew", + "value": "Renew" + } + ] + } + }, + "AutomaticShortfallSuppressReason": { + "type": "object", + "description": "Optional field to record suppression reason for automatic shortfall.", + "properties": { + "code": { + "type": "string", + "description": "Code for the suppression reason." + }, + "message": { + "type": "string", + "description": "Message for suppression reason." + } + } + }, + "Award": { + "type": "object", + "description": "Award details for milestone completion", + "properties": { + "credit": { + "$ref": "#/definitions/Commitment", + "description": "Credit amount to be awarded" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start date when the credit becomes effective" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date when the credit expires" + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Resource ID for the awarded credit.", + "readOnly": true + }, + "systemId": { + "type": "string", + "description": "This is the globally unique identifier of the credit which will not change for its lifetime.", + "readOnly": true + }, + "balanceVersion": { + "type": "number", + "format": "float", + "description": "Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created.", + "readOnly": true + }, + "duration": { + "$ref": "#/definitions/Term", + "description": "Duration for which the benefit is active. Will be in format P{int}M or P{int}Y. Any values representing up to 12 years are valid. Upper limit examples: P144M, P12Y." + } + } + }, + "Azure.Core.armResourceType": { + "type": "string", + "description": "Represents an Azure Resource Type." + }, + "BenefitAppliedScopeType": { + "type": "string", + "description": "List of applied scope types supported for benefit resources.", + "enum": [ + "BillingAccount", + "BillingProfile", + "Customer" + ], + "x-ms-enum": { + "name": "BenefitAppliedScopeType", + "modelAsString": true, + "values": [ + { + "name": "BillingAccount", + "value": "BillingAccount" + }, + { + "name": "BillingProfile", + "value": "BillingProfile" + }, + { + "name": "Customer", + "value": "Customer" + } + ] + } + }, + "BenefitProvisioningState": { + "type": "string", + "description": "Provisioning state for billing benefit resources. Includes the standard terminal states\n(Succeeded, Failed, Canceled) plus benefit-specific transition states.", + "enum": [ + "Succeeded", + "Failed", + "Canceled", + "Pending" + ], + "x-ms-enum": { + "name": "BenefitProvisioningState", + "modelAsString": true, + "values": [ + { + "name": "Succeeded", + "value": "Succeeded", + "description": "Resource has been created." + }, + { + "name": "Failed", + "value": "Failed", + "description": "Resource creation failed." + }, + { + "name": "Canceled", + "value": "Canceled", + "description": "Resource creation was canceled." + }, + { + "name": "Pending", + "value": "Pending", + "description": "The resource provisioning request has been accepted but processing has not yet started." + } + ] + }, + "readOnly": true + }, + "BenefitType": { + "type": "string", + "description": "Represents benefit model type for validation. Includes all resource types\nplus legacy singular-form values used by the validate API.", + "enum": [ + "Maccs", + "Credits", + "ConditionalCredits", + "Discounts", + "FreeServices", + "SavingsPlans", + "Reservations", + "SavingsPlan", + "MACC" + ], + "x-ms-enum": { + "name": "BenefitType", + "modelAsString": true, + "values": [ + { + "name": "Maccs", + "value": "Maccs", + "description": "Microsoft Azure Consumption Commitments" + }, + { + "name": "Credits", + "value": "Credits", + "description": "Credits applied to the customer's billing account" + }, + { + "name": "ConditionalCredits", + "value": "ConditionalCredits", + "description": "Conditional Credits" + }, + { + "name": "Discounts", + "value": "Discounts", + "description": "Discounts that reduce charges on eligible services" + }, + { + "name": "FreeServices", + "value": "FreeServices", + "description": "Services provided at no charge under the billing agreement" + }, + { + "name": "SavingsPlans", + "value": "SavingsPlans", + "description": "Savings Plan" + }, + { + "name": "Reservations", + "value": "Reservations", + "description": "Reserved capacity or reserved instances" + }, + { + "name": "SavingsPlan", + "value": "SavingsPlan", + "description": "Savings Plan (singular form, used by validate API)" + }, + { + "name": "MACC", + "value": "MACC", + "description": "MACC (legacy form, used by validate API)" + } + ] + } + }, + "BenefitValidateModel": { + "type": "object", + "description": "Abstract benefit model to validate.", + "properties": { + "benefitType": { + "$ref": "#/definitions/BenefitType", + "description": "Type of benefit to validate. This is used to determine the model type for validation." + } + }, + "discriminator": "benefitType", + "required": [ + "benefitType" + ] + }, + "BenefitValidateRequest": { + "type": "object", + "description": "Request to validate any benefit.", + "properties": { + "benefits": { + "type": "array", + "description": "Defines benefits for validation.", + "items": { + "$ref": "#/definitions/BenefitValidateModel" + }, + "x-ms-identifiers": [] + } + } + }, + "BenefitValidateResponse": { + "type": "object", + "description": "Benefit validate response.", + "properties": { + "benefits": { + "type": "array", + "description": "Defines benefit validation response for benefits.", + "items": { + "$ref": "#/definitions/BenefitValidateResponseProperty" + }, + "x-ms-identifiers": [] + }, + "nextLink": { + "type": "string", + "description": "Url to get the next page." + } + } + }, + "BenefitValidateResponseProperty": { + "type": "object", + "description": "Benefit validate response property", + "properties": { + "valid": { + "type": "boolean", + "description": "Indicates if the provided input was valid" + }, + "reasonCode": { + "type": "string", + "description": "Failure reason code if the provided input was invalid" + }, + "reason": { + "type": "string", + "description": "Failure reason if the provided input was invalid" + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Resource identifier of the benefit that was validated.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/maccs" + } + ] + } + } + } + }, + "BillingPlan": { + "type": "string", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans.", + "enum": [ + "P1M" + ], + "x-ms-enum": { + "name": "BillingPlan", + "modelAsString": true, + "values": [ + { + "name": "P1M", + "value": "P1M" + } + ] + } + }, + "BillingPlanInformation": { + "type": "object", + "description": "Information describing the type of billing plan for this savings plan.", + "properties": { + "pricingCurrencyTotal": { + "$ref": "#/definitions/Price", + "description": "Amount of money to be paid for the Order. Tax is not included." + }, + "startDate": { + "type": "string", + "format": "date", + "description": "Date when the billing plan has started." + }, + "nextPaymentDueDate": { + "type": "string", + "format": "date", + "description": "For recurring billing plans, indicates the date when next payment will be processed. Null when total is paid off." + }, + "transactions": { + "type": "array", + "items": { + "$ref": "#/definitions/PaymentDetail" + }, + "x-ms-identifiers": [] + } + } + }, + "CatalogClaimsItem": { + "type": "object", + "description": "Catalog claim for a discount.", + "properties": { + "catalogClaimsItemType": { + "type": "string" + }, + "value": { + "type": "string" + } + } + }, + "CatalogGroup": { + "type": "object", + "description": "A catalog group represents a BenefitResourceType + Namespace grouping used for benefit SKU discovery.", + "properties": { + "properties": { + "$ref": "#/definitions/CatalogGroupProperties", + "description": "The resource-specific properties for this resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "CatalogGroupCapability": { + "type": "object", + "description": "A key-value pair representing a capability of the catalog group (for example, exchange or renewal support).", + "properties": { + "name": { + "type": "string", + "description": "The capability name (e.g., SelfServiceExchange, Renewability)." + }, + "value": { + "type": "string", + "description": "The capability value (e.g., Supported, Not Supported)." + } + }, + "required": [ + "name", + "value" + ] + }, + "CatalogGroupListResult": { + "type": "object", + "description": "The response of a CatalogGroup list operation.", + "properties": { + "value": { + "type": "array", + "description": "The CatalogGroup items on this page", + "items": { + "$ref": "#/definitions/CatalogGroup" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "CatalogGroupProperties": { + "type": "object", + "description": "Properties of a catalog group.", + "properties": { + "benefitResourceType": { + "$ref": "#/definitions/ResourceType", + "description": "The top-level benefit resource type (e.g., maccs, credits, conditionalCredits, discounts, savingsPlans, reservations)." + }, + "displayName": { + "type": "string", + "description": "Display name for the catalog group." + }, + "shortDescription": { + "type": "string", + "description": "Short description of the catalog group." + }, + "longDescription": { + "type": "string", + "description": "Long description of the catalog group." + }, + "learnMoreLink": { + "type": "string", + "format": "uri", + "description": "Link to learn more about this catalog group. Uses the forward-link format https://go.microsoft.com/fwlink/?linkid=." + }, + "keywords": { + "type": "array", + "description": "Manifest-sourced array of search terms for this catalog group. Omitted when empty.", + "items": { + "type": "string" + } + }, + "icon": { + "type": "string", + "description": "The benefit type's icon as JSON-escaped SVG markup. After parsing, the value is a complete `…` element.", + "example": "" + }, + "capabilities": { + "type": "array", + "description": "Capabilities of the catalog group as key-value pairs. Omitted when a benefit type has no defined capabilities.", + "items": { + "$ref": "#/definitions/CatalogGroupCapability" + }, + "x-ms-identifiers": [] + }, + "disclaimers": { + "type": "array", + "description": "Optional disclaimers (legal or eligibility caveats) for the catalog group. Included only when caveats apply.", + "items": { + "type": "string" + } + } + }, + "required": [ + "benefitResourceType" + ] + }, + "ChangeSponsorRequest": { + "type": "object", + "description": "Request body for the changeSponsor action on a credit.", + "properties": { + "sponsorId": { + "type": "string", + "description": "Financial code identifying the new sponsor. This is an alphanumeric identifier assigned by the billing system, for example P20567384.", + "example": "P30000001" + } + } + }, + "ChargeShortfallRequest": { + "type": "object", + "description": "Charge shortfall request", + "properties": { + "properties": { + "$ref": "#/definitions/Shortfall", + "description": "Charge shortfall request properties", + "x-ms-client-flatten": true + } + } + }, + "Commitment": { + "type": "object", + "description": "Commitment towards the benefit.", + "properties": { + "grain": { + "$ref": "#/definitions/CommitmentGrain", + "description": "The grain of the commitment." + } + }, + "allOf": [ + { + "$ref": "#/definitions/Price" + } + ] + }, + "CommitmentGrain": { + "type": "string", + "description": "Grain.", + "enum": [ + "Hourly", + "FullTerm", + "Unknown" + ], + "x-ms-enum": { + "name": "CommitmentGrain", + "modelAsString": true, + "values": [ + { + "name": "Hourly", + "value": "Hourly" + }, + { + "name": "FullTerm", + "value": "FullTerm" + }, + { + "name": "Unknown", + "value": "Unknown" + } + ] + } + }, + "ConditionalCredit": { + "type": "object", + "description": "Resource definition for Conditional Credits.", + "properties": { + "properties": { + "$ref": "#/definitions/ConditionalCreditProperties", + "description": "Conditional credit properties" + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "ConditionalCreditContributor": { + "type": "object", + "description": "Conditional credit contributor", + "properties": { + "properties": { + "$ref": "#/definitions/ContributorConditionalCreditProperties", + "description": "Conditional credit contributor properties", + "x-ms-client-flatten": true + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "ConditionalCreditContributorList": { + "type": "object", + "description": "Conditional credit contributor list", + "properties": { + "value": { + "type": "array", + "description": "The ConditionalCreditContributor items on this page", + "items": { + "$ref": "#/definitions/ConditionalCreditContributor" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "ConditionalCreditEntityType": { + "type": "string", + "description": "Type of conditional credit entity", + "enum": [ + "Primary", + "Contributor" + ], + "x-ms-enum": { + "name": "ConditionalCreditEntityType", + "modelAsString": true, + "values": [ + { + "name": "Primary", + "value": "Primary" + }, + { + "name": "Contributor", + "value": "Contributor" + } + ] + } + }, + "ConditionalCreditList": { + "type": "object", + "description": "List of applicable conditional credits", + "properties": { + "value": { + "type": "array", + "description": "The ConditionalCredit items on this page", + "items": { + "$ref": "#/definitions/ConditionalCredit" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "ConditionalCreditMilestone": { + "type": "object", + "description": "Milestone definition within a conditional credit", + "properties": { + "award": { + "$ref": "#/definitions/Award", + "description": "Award details for this milestone" + } + }, + "allOf": [ + { + "$ref": "#/definitions/ConditionalCreditMilestoneBase" + } + ] + }, + "ConditionalCreditMilestoneBase": { + "type": "object", + "description": "Base milestone definition for conditional credits", + "properties": { + "milestoneId": { + "type": "string", + "description": "Unique identifier for the milestone" + }, + "name": { + "type": "string", + "description": "Display name for the milestone" + }, + "status": { + "$ref": "#/definitions/MilestoneStatus", + "description": "Current status of the milestone" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date for this milestone" + }, + "spendTarget": { + "$ref": "#/definitions/Price", + "description": "Spend target for this milestone" + }, + "award": { + "$ref": "#/definitions/Award", + "description": "Award details for this milestone (only present for primary conditional credits)" + } + } + }, + "ConditionalCreditPatchRequest": { + "type": "object", + "description": "Conditional credit patch request", + "properties": { + "properties": { + "$ref": "#/definitions/ConditionalCreditPatchRequestProperties", + "description": "Conditional credit patch request properties", + "x-ms-client-flatten": true + }, + "tags": { + "type": "object", + "description": "Resource tags.", + "additionalProperties": { + "type": "string" + } + } + } + }, + "ConditionalCreditPatchRequestProperties": { + "type": "object", + "description": "Conditional credit patch request properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name for the conditional credit" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "allowContributors": { + "$ref": "#/definitions/EnablementMode", + "description": "Whether this conditional credit allows contributor billing accounts" + }, + "milestones": { + "type": "array", + "description": "Updated milestones list (only applicable for primary conditional credits)", + "items": { + "$ref": "#/definitions/ConditionalCreditMilestone" + } + } + } + }, + "ConditionalCreditProperties": { + "type": "object", + "description": "Properties belonging to conditional credits.", + "properties": { + "entityType": { + "$ref": "#/definitions/ConditionalCreditEntityType", + "description": "Type of conditional credit entity" + }, + "displayName": { + "type": "string", + "description": "Display name for the conditional credit" + }, + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "The billing account resource ID", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "The provisioning state of the resource", + "readOnly": true + }, + "status": { + "$ref": "#/definitions/ConditionalCreditStatus", + "description": "The status of the conditional credit" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start date of the conditional credit" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date of the conditional credit (derived from last milestone)" + }, + "productCode": { + "type": "string", + "description": "Product code for the conditional credit" + }, + "benefitResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the benefit under applicable benefit list.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/*" + } + ] + } + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the resource. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/{benefitType}/{benefitName}." + }, + "productDetails": { + "$ref": "#/definitions/ProductDetailsBase", + "description": "Product details including SKU title, product family, and product type.", + "readOnly": true + }, + "appliedScopeType": { + "$ref": "#/definitions/BenefitAppliedScopeType", + "description": "Type of the applied scope for the conditional credit." + }, + "invitationId": { + "type": "string", + "description": "Invitation identifier", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "consumed": { + "$ref": "#/definitions/Price", + "description": "Amount of benefit that has been consumed", + "readOnly": true + } + }, + "discriminator": "entityType", + "required": [ + "entityType" + ] + }, + "ConditionalCreditStatus": { + "type": "string", + "description": "The status of the conditional credit", + "enum": [ + "Unknown", + "Scheduled", + "Active", + "Pending", + "Failed", + "Canceled", + "Completed", + "Stopped", + "PendingSettlement" + ], + "x-ms-enum": { + "name": "ConditionalCreditStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown" + }, + { + "name": "Scheduled", + "value": "Scheduled" + }, + { + "name": "Active", + "value": "Active" + }, + { + "name": "Pending", + "value": "Pending" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Canceled", + "value": "Canceled" + }, + { + "name": "Completed", + "value": "Completed" + }, + { + "name": "Stopped", + "value": "Stopped" + }, + { + "name": "PendingSettlement", + "value": "PendingSettlement" + } + ] + } + }, + "ConditionalCreditTransaction": { + "type": "object", + "description": "Transaction resource definition for ConditionalCredits", + "properties": { + "properties": { + "$ref": "#/definitions/TransactionProperties", + "description": "Transaction properties" + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "ConditionalCreditTransactionsList": { + "type": "object", + "description": "List of conditional credit transactions", + "properties": { + "value": { + "type": "array", + "description": "The ConditionalCreditTransaction items on this page", + "items": { + "$ref": "#/definitions/ConditionalCreditTransaction" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "ConditionalCreditsValidateModel": { + "type": "object", + "description": "Conditional Credits validate model", + "properties": { + "properties": { + "$ref": "#/definitions/ConditionalCreditProperties", + "description": "Conditional Credits validate properties" + } + }, + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "ConditionalCredits" + }, + "ConditionsItem": { + "type": "object", + "description": "Condition for a discount.", + "properties": { + "conditionName": { + "type": "string" + }, + "value": { + "type": "array", + "description": "These items are open-ended strings.", + "items": { + "type": "string" + } + }, + "type": { + "type": "string" + } + } + }, + "Contributor": { + "type": "object", + "description": "MACC contributor", + "properties": { + "properties": { + "$ref": "#/definitions/MaccModelProperties", + "description": "MACC contributor properties", + "x-ms-client-flatten": true + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "ContributorConditionalCreditMilestone": { + "type": "object", + "description": "Milestone definition for contributor conditional credit (excludes award details)", + "allOf": [ + { + "$ref": "#/definitions/ConditionalCreditMilestoneBase" + } + ] + }, + "ContributorConditionalCreditProperties": { + "type": "object", + "description": "Properties for contributor conditional credit.", + "properties": { + "primaryResourceId": { + "type": "string", + "format": "arm-id", + "description": "Resource ID of the primary conditional credit (required for contributors)", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/conditionalCredits" + } + ] + } + }, + "systemId": { + "type": "string", + "description": "System identifier shared between primary and contributor conditional credits representing the same conditional credit program" + }, + "productCode": { + "type": "string", + "description": "Product code for the contributor conditional credit" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start date for the contributor conditional credit" + }, + "milestones": { + "type": "array", + "description": "List of milestones copied from primary conditional credit (excludes award details)", + "items": { + "$ref": "#/definitions/ContributorConditionalCreditMilestone" + }, + "readOnly": true + }, + "primaryBillingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified billing account resource identifier of the primary CACO. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + } + }, + "allOf": [ + { + "$ref": "#/definitions/ConditionalCreditProperties" + } + ], + "x-ms-discriminator-value": "Contributor" + }, + "ContributorList": { + "type": "object", + "description": "Contributor list", + "properties": { + "value": { + "type": "array", + "description": "The Contributor items on this page", + "items": { + "$ref": "#/definitions/Contributor" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "Credit": { + "type": "object", + "description": "Credit resource definition", + "properties": { + "properties": { + "$ref": "#/definitions/CreditProperties", + "description": "Credit properties", + "x-ms-client-flatten": true + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "CreditBreakdownItem": { + "type": "object", + "description": "Credit breakdown item representing a milestone, line-item, or no-charge service", + "properties": { + "allocation": { + "$ref": "#/definitions/Commitment", + "description": "Allocation details including currency and amount for this breakdown item" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start DateTime." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "dimensions": { + "type": "array", + "description": "Key-value pairs for additional parameters and metadata", + "items": { + "$ref": "#/definitions/CreditDimension" + } + } + } + }, + "CreditDimension": { + "type": "object", + "description": "Key-value pair for additional credit parameters and metadata", + "properties": { + "key": { + "type": "string", + "description": "The dimension key (e.g., productFamily, description, creditType)" + }, + "value": { + "type": "string", + "description": "The dimension value" + } + }, + "required": [ + "key", + "value" + ] + }, + "CreditExpirationPolicy": { + "type": "string", + "description": "Expiration policy of the Credit", + "enum": [ + "None", + "SuspendBillingProfile" + ], + "x-ms-enum": { + "name": "CreditExpirationPolicy", + "modelAsString": true, + "values": [ + { + "name": "None", + "value": "None", + "description": "No policy applied to the expiration of this credit" + }, + { + "name": "SuspendBillingProfile", + "value": "SuspendBillingProfile", + "description": "Billing profile is suspended when the credit expires" + } + ] + } + }, + "CreditPatchProperties": { + "type": "object", + "description": "Credit patch properties", + "properties": { + "credit": { + "$ref": "#/definitions/Commitment", + "description": "The entire investment amount for the credit contract, including currency and amount. Only amount can be modified." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "breakdown": { + "type": "array", + "description": "Credit line-items/milestones/no-charge services breakdown. Entire breakdown will be replaced in a PATCH operation.", + "items": { + "$ref": "#/definitions/CreditBreakdownItem" + } + } + } + }, + "CreditPatchRequest": { + "type": "object", + "description": "Credit patch request", + "properties": { + "tags": { + "type": "object", + "description": "Resource tags", + "additionalProperties": { + "type": "string" + } + }, + "properties": { + "$ref": "#/definitions/CreditPatchProperties", + "description": "Credit patch properties", + "x-ms-client-flatten": true + } + } + }, + "CreditPolicies": { + "type": "object", + "description": "Credit breakdown item representing a milestone, line-item, or no-charge service", + "properties": { + "redemption": { + "$ref": "#/definitions/CreditRedemptionPolicy", + "description": "Redemption policy of the Credit" + }, + "expiration": { + "$ref": "#/definitions/CreditExpirationPolicy", + "description": "Expiration policy of the Credit" + } + } + }, + "CreditProductDetails": { + "type": "object", + "description": "Product details for a credit", + "properties": { + "skuTitle": { + "type": "string", + "description": "SKU title of the product" + }, + "productFamily": { + "type": "string", + "description": "The product family, for example \"Azure\" or \"M365\"." + }, + "productType": { + "type": "string", + "description": "The type of the product." + }, + "appliedOn": { + "type": "array", + "description": "Indicates where the credit benefit is applied (e.g., consume, invoice, or external application).", + "items": { + "$ref": "#/definitions/AppliedOn" + } + }, + "appliedPrice": { + "type": "string", + "description": "Specifies which price point is used when applying the credit. Known values include \"MarketPrice\", \"UnitPrice\", and \"BenefitGroupPrice:\" where identifies the benefit group." + } + } + }, + "CreditProperties": { + "type": "object", + "description": "Properties of a credit", + "properties": { + "status": { + "$ref": "#/definitions/CreditStatus", + "description": "Status of the credit" + }, + "productCode": { + "type": "string", + "description": "Product UPN for the credit type" + }, + "displayName": { + "type": "string", + "description": "Display name" + }, + "reason": { + "$ref": "#/definitions/CreditReason", + "description": "The reason for the credit. Not required if not applicable." + }, + "credit": { + "$ref": "#/definitions/Commitment", + "description": "The entire investment amount for the credit contract, including currency and amount" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start DateTime." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "policies": { + "$ref": "#/definitions/CreditPolicies", + "description": "Credit breakdown item representing a milestone, line-item, or no-charge service" + }, + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing account where the benefit is applied. Present only for Enterprise Agreement customers.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "billingProfileResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing profile where the benefit is applied. Present only for Field-led or Customer-led customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/billingProfiles" + } + ] + } + }, + "customerResourceId": { + "type": "string", + "format": "arm-id", + "description": "Customer resource id where the benefit is scoped to.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/customers" + } + ] + } + }, + "breakdown": { + "type": "array", + "description": "Credit line-items/milestones/no-charge services breakdown", + "items": { + "$ref": "#/definitions/CreditBreakdownItem" + } + }, + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "Provisioning state", + "readOnly": true + }, + "systemId": { + "type": "string", + "description": "System identifier" + }, + "orderId": { + "type": "string", + "description": "Identifier of the $0 transaction created during credit acquisition.", + "readOnly": true + }, + "fundingSystemId": { + "type": "string", + "description": "Unique identifier (UUID) of the funding lot assigned by the benefit publisher. Used in credit transfer scenarios to trace the originating credit lot.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the resource. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/{benefitType}/{benefitName}." + }, + "invitationId": { + "type": "string", + "description": "Invitation identifier", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "consumed": { + "$ref": "#/definitions/Price", + "description": "Amount of benefit that has been consumed", + "readOnly": true + }, + "productDetails": { + "$ref": "#/definitions/CreditProductDetails", + "description": "Product details including SKU title, product kind, offer type, and application details", + "readOnly": true + }, + "appliedScopeType": { + "$ref": "#/definitions/BenefitAppliedScopeType", + "description": "Type of the applied scope for the credit." + } + } + }, + "CreditReason": { + "type": "object", + "description": "The reason for the credit. Not required if not applicable.", + "properties": { + "code": { + "type": "string", + "description": "The reason code for credit." + }, + "description": { + "type": "string", + "description": "The free string description of the credit." + } + } + }, + "CreditRedemptionPolicy": { + "type": "string", + "description": "Redemption policy of the Credit", + "enum": [ + "NotApplicable", + "AutoRedeem", + "ManualRedeem" + ], + "x-ms-enum": { + "name": "CreditRedemptionPolicy", + "modelAsString": true, + "values": [ + { + "name": "NotApplicable", + "value": "NotApplicable", + "description": "Redemption policy is not applicable for this credit" + }, + { + "name": "AutoRedeem", + "value": "AutoRedeem", + "description": "Credit is automatically redeemed" + }, + { + "name": "ManualRedeem", + "value": "ManualRedeem", + "description": "Credit is manually redeemed" + } + ] + } + }, + "CreditSource": { + "type": "object", + "description": "Credit source resource definition", + "properties": { + "properties": { + "$ref": "#/definitions/CreditSourceProperties", + "description": "Credit source properties", + "x-ms-client-flatten": true + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "CreditSourcePatchRequest": { + "type": "object", + "description": "Credit patch request", + "properties": { + "tags": { + "type": "object", + "description": "Resource Tags", + "additionalProperties": { + "type": "string" + }, + "x-ms-mutability": [ + "read", + "update", + "create" + ] + } + } + }, + "CreditSourceProperties": { + "type": "object", + "description": "Properties of a credit source", + "properties": { + "status": { + "$ref": "#/definitions/CreditStatus", + "description": "Status of the credit" + }, + "sourceResourceId": { + "type": "string", + "format": "arm-id", + "description": "The uri of the resource impacted which lead to the grant of the credit.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/credits" + } + ] + } + }, + "impactedBillingPeriod": { + "type": "string", + "description": "The billing period of the impact for the resource. Format YYYYMM" + }, + "credit": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + } + } + }, + "CreditSourcesList": { + "type": "object", + "description": "List of credit sources", + "properties": { + "value": { + "type": "array", + "description": "The CreditSource items on this page", + "items": { + "$ref": "#/definitions/CreditSource" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "CreditStatus": { + "type": "string", + "description": "Status of the credit", + "enum": [ + "Unknown", + "Pending", + "Active", + "Succeeded", + "Canceled", + "Failed", + "Expired", + "Exhausted", + "NotStarted" + ], + "x-ms-enum": { + "name": "CreditStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown", + "description": "Credit status is unknown" + }, + { + "name": "Pending", + "value": "Pending", + "description": "Credit is pending activation" + }, + { + "name": "Active", + "value": "Active", + "description": "Credit is active and available for use" + }, + { + "name": "Succeeded", + "value": "Succeeded", + "description": "Credit operation succeeded" + }, + { + "name": "Canceled", + "value": "Canceled", + "description": "Credit has been cancelled" + }, + { + "name": "Failed", + "value": "Failed", + "description": "Credit operation failed" + }, + { + "name": "Expired", + "value": "Expired", + "description": "Credit has expired" + }, + { + "name": "Exhausted", + "value": "Exhausted", + "description": "Credit has been fully consumed" + }, + { + "name": "NotStarted", + "value": "NotStarted", + "description": "Credit application has not started yet" + } + ] + }, + "readOnly": true + }, + "CreditTransaction": { + "type": "object", + "description": "Transaction resource definition for Credits", + "properties": { + "properties": { + "$ref": "#/definitions/TransactionProperties", + "description": "Transaction properties" + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "CreditsList": { + "type": "object", + "description": "List of credits", + "properties": { + "value": { + "type": "array", + "description": "The Credit items on this page", + "items": { + "$ref": "#/definitions/Credit" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "CreditsValidateModel": { + "type": "object", + "description": "Credits validate model", + "properties": { + "properties": { + "$ref": "#/definitions/Credit", + "description": "Credits validate properties", + "x-ms-client-flatten": true + } + }, + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "Credits" + }, + "CustomPriceProperties": { + "type": "object", + "description": "Custom price properties for a given discount.", + "properties": { + "ruleType": { + "$ref": "#/definitions/DiscountRuleType", + "description": "The type of the priceable node pricing rule. Validation: Required. Supported values are fixedPriceLock, fixedListPrice, and priceCeiling." + }, + "catalogId": { + "type": "string", + "description": "The catalog instance where the priceable node lives. Validation: Required. No defined format, will vary per team." + }, + "catalogClaims": { + "type": "array", + "description": "The set of BigCat claims. Validation: Required. Must contain AgreementType, NationalCloud, and PricingAudience claims. Additionally requires AccessPass claim when creating custom price with action == consume on the pricing instructions.", + "items": { + "$ref": "#/definitions/CatalogClaimsItem" + } + }, + "termUnits": { + "type": "string", + "description": "The term units for the priceable node. Validation: Optional, Maximum length 128 characters. Must be present if and only if the availability derived by market, product, sku, and claims has terms." + }, + "billingPeriod": { + "type": "string", + "description": "The billing period of the priceable node. Validation: Optional, Maximum length 128 characters. Only allowed if the availability derived by market, product, sku, and claims has terms and at least one of those terms has a billing period. When specified, termUnits must be specified." + }, + "meterType": { + "type": "string", + "description": "Must be present if the market, product, sku, and claims, and optional term information resolves to multiple availabilities that only differ by meter type. Validation: Maximum length 128 characters." + }, + "marketSetPrices": { + "type": "array", + "description": "The set of market set prices of the priceable node. Validation: Required. Must contain at least one element.", + "items": { + "$ref": "#/definitions/MarketSetPricesItems" + } + } + }, + "required": [ + "ruleType", + "catalogId", + "catalogClaims", + "marketSetPrices" + ] + }, + "Discount": { + "type": "object", + "description": "Resource definition for Discounts.", + "properties": { + "properties": { + "$ref": "#/definitions/DiscountProperties", + "description": "Discount properties" + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "DiscountCombinationRule": { + "type": "string", + "description": "The discount combination rule when there are multiple applicable custom prices. Validation: Required. Supported values are Stackable and BestOf.", + "enum": [ + "BestOf", + "Stackable" + ], + "x-ms-enum": { + "name": "DiscountCombinationRule", + "modelAsString": true, + "values": [ + { + "name": "BestOf", + "value": "BestOf" + }, + { + "name": "Stackable", + "value": "Stackable" + } + ] + } + }, + "DiscountEntityType": { + "type": "string", + "description": "This defines whether the entity being created is primary or affiliate. Supported values: primary, affiliate. Validation: Required, must match one of the 2 values.", + "enum": [ + "Primary", + "Affiliate" + ], + "x-ms-enum": { + "name": "DiscountEntityType", + "modelAsString": true, + "values": [ + { + "name": "Primary", + "value": "Primary" + }, + { + "name": "Affiliate", + "value": "Affiliate" + } + ] + } + }, + "DiscountList": { + "type": "object", + "description": "Discount list", + "properties": { + "value": { + "type": "array", + "description": "The Discount items on this page", + "items": { + "$ref": "#/definitions/Discount" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "DiscountPatchRequest": { + "type": "object", + "description": "Discounts patch request", + "properties": { + "properties": { + "$ref": "#/definitions/DiscountPatchRequestProperties", + "description": "Discounts patch request properties", + "x-ms-client-flatten": true + }, + "tags": { + "type": "object", + "description": "Resource tags.", + "additionalProperties": { + "type": "string" + } + } + } + }, + "DiscountPatchRequestProperties": { + "type": "object", + "description": "Discounts patch request properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate." + } + } + }, + "DiscountProperties": { + "type": "object", + "description": "Properties belonging to discounts.", + "properties": { + "entityType": { + "$ref": "#/definitions/DiscountEntityType", + "description": "This defines whether the entity being created is primary or affiliate. Supported values: primary, affiliate. Validation: Required, must match one of the 2 values." + }, + "productCode": { + "type": "string", + "description": "This is the catalog UPN for the product." + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start date of the discount. Value is the date the discount started or will start in the future." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate." + }, + "systemId": { + "type": "string", + "description": "This is the globally unique identifier of the Discount which will not change for the lifetime of the Discount." + }, + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "The state of the resource. Supported values are Pending, Failed, Succeeded, Canceled.", + "readOnly": true + }, + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing account where the benefit is applied.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "billingProfileResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing profile where the benefit is applied.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/billingProfiles" + } + ] + } + }, + "customerResourceId": { + "type": "string", + "format": "arm-id", + "description": "Customer resource id where the benefit is scoped to.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/customers" + } + ] + } + }, + "invitationId": { + "type": "string", + "description": "Invitation identifier", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "displayName": { + "type": "string", + "description": "This defines a user friendly display name for the discount." + }, + "status": { + "$ref": "#/definitions/DiscountStatus", + "description": "Represents the current status of the discount.", + "readOnly": true + }, + "benefitResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the benefit under applicable benefit list.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/*" + } + ] + } + }, + "appliedScopeType": { + "$ref": "#/definitions/BenefitAppliedScopeType", + "description": "List of applied scopes supported for discounts." + }, + "productDetails": { + "$ref": "#/definitions/ProductDetailsBase", + "description": "Product details including SKU title, product family, and product type.", + "readOnly": true + } + }, + "discriminator": "entityType", + "required": [ + "entityType", + "productCode", + "startAt" + ] + }, + "DiscountRuleType": { + "type": "string", + "description": "The type of the priceable node pricing rule. Validation: Required. Supported values are fixedPriceLock, fixedListPrice, and priceCeiling.", + "enum": [ + "FixedPriceLock", + "FixedListPrice", + "PriceCeiling" + ], + "x-ms-enum": { + "name": "DiscountRuleType", + "modelAsString": true, + "values": [ + { + "name": "FixedPriceLock", + "value": "FixedPriceLock" + }, + { + "name": "FixedListPrice", + "value": "FixedListPrice" + }, + { + "name": "PriceCeiling", + "value": "PriceCeiling" + } + ] + } + }, + "DiscountStatus": { + "type": "string", + "description": "Represents the current status of the discount.", + "enum": [ + "Active", + "Pending", + "Failed", + "Canceled", + "Expired" + ], + "x-ms-enum": { + "name": "DiscountStatus", + "modelAsString": true, + "values": [ + { + "name": "Active", + "value": "Active" + }, + { + "name": "Pending", + "value": "Pending" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Canceled", + "value": "Canceled" + }, + { + "name": "Expired", + "value": "Expired" + } + ] + } + }, + "DiscountType": { + "type": "string", + "description": "Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency.", + "enum": [ + "ProductFamily", + "Product", + "Sku", + "CustomPrice", + "CustomPriceMultiCurrency", + "AzurePromotion" + ], + "x-ms-enum": { + "name": "DiscountType", + "modelAsString": true, + "values": [ + { + "name": "ProductFamily", + "value": "ProductFamily" + }, + { + "name": "Product", + "value": "Product" + }, + { + "name": "Sku", + "value": "Sku" + }, + { + "name": "CustomPrice", + "value": "CustomPrice" + }, + { + "name": "CustomPriceMultiCurrency", + "value": "CustomPriceMultiCurrency" + }, + { + "name": "AzurePromotion", + "value": "AzurePromotion", + "description": "Azure promotion discount type." + } + ] + } + }, + "DiscountTypeAzurePromotion": { + "type": "object", + "description": "Discount type properties for Azure promotion discounts.", + "properties": { + "productFamilyName": { + "type": "string", + "description": "Product family for which the discount is given. Validation: Optional" + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeProperties" + } + ], + "x-ms-discriminator-value": "AzurePromotion" + }, + "DiscountTypeCustomPrice": { + "type": "object", + "description": "Discount type properties including product family name, product id, sku, and custom price properties. Allows a single entry in marketSetPrices.", + "properties": { + "productFamilyName": { + "type": "string", + "description": "Product family for which the discount is given. Validation: Optional" + }, + "productId": { + "type": "string", + "description": "Product ID for which the discount is given. Validation: Optional. No specific format, example: DZH318Z09V6F" + }, + "skuId": { + "type": "string", + "description": "ResourceSku for the given discount. Validation: Optional." + }, + "customPriceProperties": { + "$ref": "#/definitions/CustomPriceProperties", + "description": "Custom price properties for a given discount." + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeProperties" + } + ], + "x-ms-discriminator-value": "CustomPrice" + }, + "DiscountTypeCustomPriceMultiCurrency": { + "type": "object", + "description": "Discount type properties including product family name, product id, sku, and custom price properties. Allows multiple entries in marketSetPrices.", + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeCustomPrice" + } + ], + "x-ms-discriminator-value": "CustomPriceMultiCurrency" + }, + "DiscountTypeProduct": { + "type": "object", + "description": "Discount type properties including product family name and product id.", + "properties": { + "productFamilyName": { + "type": "string", + "description": "Product family for which the discount is given. Validation: Optional" + }, + "productId": { + "type": "string", + "description": "Product ID for which the discount is given. Validation: Optional. No specific format, example: DZH318Z09V6F" + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeProperties" + } + ], + "x-ms-discriminator-value": "Product" + }, + "DiscountTypeProductFamily": { + "type": "object", + "description": "Discount type properties including product family name", + "properties": { + "productFamilyName": { + "type": "string", + "description": "Product family for which the discount is given. Validation: Optional" + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeProperties" + } + ], + "x-ms-discriminator-value": "ProductFamily" + }, + "DiscountTypeProductSku": { + "type": "object", + "description": "Discount type properties including product family name, product id, and sku id.", + "properties": { + "productFamilyName": { + "type": "string", + "description": "Product family for which the discount is given. Validation: Optional" + }, + "productId": { + "type": "string", + "description": "Product ID for which the discount is given. Validation: Optional. No specific format, example: DZH318Z09V6F" + }, + "skuId": { + "type": "string", + "description": "ResourceSku for the given discount. Validation: Optional." + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountTypeProperties" + } + ], + "x-ms-discriminator-value": "Sku" + }, + "DiscountTypeProperties": { + "type": "object", + "description": "This defines the conditions for a given discount type.", + "properties": { + "discountType": { + "$ref": "#/definitions/DiscountType", + "description": "Defines the type of discount. Supported values are ProductFamily, Product, Sku, CustomPrice, and CustomPriceMultiCurrency." + }, + "applyDiscountOn": { + "$ref": "#/definitions/ApplyDiscountOn", + "description": "The customer action on which the discount is applied. Supported values are Purchase, Consume, and Renew. Validation: Required, one of supported values." + }, + "discountPercentage": { + "type": "number", + "format": "double", + "description": "Discount percentage provided for the customer. Validation: Required unless this is a price rule.", + "minimum": 0, + "maximum": 100 + }, + "discountCombinationRule": { + "$ref": "#/definitions/DiscountCombinationRule", + "description": "The discount combination rule when there are multiple applicable custom prices. Validation: Required. Supported values are Stackable and BestOf." + }, + "priceGuaranteeProperties": { + "$ref": "#/definitions/PriceGuaranteeProperties", + "description": "Set only in price guarantee scenario." + }, + "conditions": { + "type": "array", + "description": "Array of conditions for the discount. Validation: Optional. Maximum length is 1000.", + "items": { + "$ref": "#/definitions/ConditionsItem" + } + } + }, + "discriminator": "discountType", + "required": [ + "discountType", + "applyDiscountOn" + ] + }, + "DiscountValidateModel": { + "type": "object", + "description": "Discount validate model", + "properties": { + "properties": { + "$ref": "#/definitions/DiscountProperties", + "description": "Discount validate properties" + } + }, + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "Discounts" + }, + "EnablementMode": { + "type": "string", + "description": "Represents the enablement status of a feature or settings.", + "enum": [ + "Unknown", + "Enabled", + "Disabled" + ], + "x-ms-enum": { + "name": "EnablementMode", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown" + }, + { + "name": "Enabled", + "value": "Enabled" + }, + { + "name": "Disabled", + "value": "Disabled" + } + ] + } + }, + "EntityTypeAffiliateDiscount": { + "type": "object", + "description": "Entity type for affiliate discounts", + "properties": { + "primaryResourceId": { + "type": "string", + "format": "arm-id", + "description": "This will be present in the response if the primary has a resource ID", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/discounts" + } + ] + } + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate.", + "readOnly": true + } + }, + "allOf": [ + { + "$ref": "#/definitions/DiscountProperties" + } + ], + "x-ms-discriminator-value": "Affiliate" + }, + "EntityTypePrimaryDiscount": { + "type": "object", + "description": "Entity type for primary discounts", + "properties": { + "discountTypeProperties": { + "$ref": "#/definitions/DiscountTypeProperties", + "description": "This defines the conditions for a given discount type." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date of the discount. No duration will be supported. Allowed value is any date greater than or equal to startDate." + } + }, + "required": [ + "endAt" + ], + "allOf": [ + { + "$ref": "#/definitions/DiscountProperties" + } + ], + "x-ms-discriminator-value": "Primary" + }, + "ExtendedStatusInfo": { + "type": "object", + "properties": { + "statusCode": { + "type": "string", + "description": "Status code providing additional information." + }, + "message": { + "type": "string", + "description": "The message giving detailed information about the status code." + } + } + }, + "FreeServices": { + "type": "object", + "description": "Free Services resource definition", + "properties": { + "properties": { + "$ref": "#/definitions/FreeServicesProperties", + "description": "Free services properties", + "x-ms-client-flatten": true + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "FreeServicesList": { + "type": "object", + "description": "This operation lists the free services that are available under the specified subscription.", + "properties": { + "value": { + "type": "array", + "description": "The list of free services", + "items": { + "$ref": "#/definitions/FreeServices" + } + }, + "nextLink": { + "type": "string", + "description": "The URL to get the next set of results", + "readOnly": true + } + } + }, + "FreeServicesPatchRequest": { + "type": "object", + "description": "Free services patch request", + "properties": { + "properties": { + "$ref": "#/definitions/FreeServicesPatchRequestProperties", + "description": "Free services patch request properties", + "x-ms-client-flatten": true + }, + "tags": { + "type": "object", + "description": "Resource tags.", + "additionalProperties": { + "type": "string" + } + } + } + }, + "FreeServicesPatchRequestProperties": { + "type": "object", + "description": "Free services patch request properties", + "properties": { + "endAt": { + "type": "string", + "format": "date-time", + "description": "Updated expiration date and time of the free services" + } + } + }, + "FreeServicesProperties": { + "type": "object", + "description": "Properties of free services", + "properties": { + "productCode": { + "type": "string", + "description": "This is the catalog UPN for the product." + }, + "displayName": { + "type": "string", + "description": "Display name" + }, + "status": { + "$ref": "#/definitions/FreeServicesStatus", + "description": "Current status of the free services" + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Date and time when the free services become active" + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "Expiration date and time of the free services" + }, + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "Provisioning state of Free Services as assigned by RPaaS. This indicates the last operation's status. For all practical purposes, this can be ignored. For current status of Free Services resource, refer to FreeServicesStatus.", + "readOnly": true + }, + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing account where the benefit is applied.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "billingProfileResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing profile where the benefit is applied.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/billingProfiles" + } + ] + } + }, + "customerResourceId": { + "type": "string", + "format": "arm-id", + "description": "Customer resource id where the benefit is scoped to.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/customers" + } + ] + } + }, + "invitationId": { + "type": "string", + "description": "Invitation identifier", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "systemId": { + "type": "string", + "description": "This is the globally unique identifier of the free services which will not change for its lifetime. Generated by the benefit publisher." + }, + "productDetails": { + "$ref": "#/definitions/ProductDetailsBase", + "description": "Product details including SKU title, product family, and product type.", + "readOnly": true + } + } + }, + "FreeServicesStatus": { + "type": "string", + "description": "Status of the free services", + "enum": [ + "Unknown", + "Pending", + "Active", + "Canceled", + "Completed" + ], + "x-ms-enum": { + "name": "FreeServicesStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown", + "description": "Free services status is unknown" + }, + { + "name": "Pending", + "value": "Pending", + "description": "Free services are pending activation" + }, + { + "name": "Active", + "value": "Active", + "description": "Free services are active" + }, + { + "name": "Canceled", + "value": "Canceled", + "description": "Free services have been canceled" + }, + { + "name": "Completed", + "value": "Completed", + "description": "Free services have been fully consumed or completed" + } + ] + } + }, + "InstanceFlexibility": { + "type": "string", + "description": "Turning this on will apply the reservation discount to other VMs in the same VM size group.", + "enum": [ + "On", + "Off" + ], + "x-ms-enum": { + "name": "InstanceFlexibility", + "modelAsString": true, + "values": [ + { + "name": "On", + "value": "On" + }, + { + "name": "Off", + "value": "Off" + } + ] + } + }, + "Macc": { + "type": "object", + "description": "Microsoft Azure Consumption Commitment.", + "properties": { + "properties": { + "$ref": "#/definitions/MaccModelProperties", + "description": "MACC properties", + "x-ms-client-flatten": true + }, + "managedBy": { + "type": "string", + "description": "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.", + "x-ms-mutability": [ + "read", + "update", + "create" + ] + }, + "kind": { + "type": "string", + "description": "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.", + "pattern": "^[-\\w\\._,\\(\\)]+$", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "etag": { + "type": "string", + "description": "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.", + "readOnly": true + }, + "identity": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/ManagedServiceIdentity", + "description": "Managed service identity (system assigned and/or user assigned identities)" + }, + "sku": { + "$ref": "#/definitions/Sku", + "description": "The resource model definition representing SKU" + }, + "plan": { + "$ref": "#/definitions/Plan", + "description": "Plan for the resource." + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/TrackedResource" + } + ] + }, + "MaccEntityType": { + "type": "string", + "description": "Represents type of the object being operated on. Possible values are primary or contributor.", + "enum": [ + "Primary", + "Contributor" + ], + "x-ms-enum": { + "name": "MaccEntityType", + "modelAsString": true, + "values": [ + { + "name": "Primary", + "value": "Primary" + }, + { + "name": "Contributor", + "value": "Contributor" + } + ] + } + }, + "MaccList": { + "type": "object", + "description": "MACC list", + "properties": { + "value": { + "type": "array", + "description": "The Macc items on this page", + "items": { + "$ref": "#/definitions/Macc" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "MaccMilestone": { + "type": "object", + "description": "MACC milestone represents interim targets within the period of MACC.", + "properties": { + "milestoneId": { + "type": "string", + "description": "Globally unique identifier for the milestone. Format: {guid}", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "commitment": { + "$ref": "#/definitions/Price", + "description": "Commitment associated with this milestone." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End date time for the milestone. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z." + }, + "automaticShortfall": { + "$ref": "#/definitions/EnablementMode", + "description": "Setting this to 'Enable' enables automatic shortfall invoicing when milestone commitment is not met." + }, + "automaticShortfallSuppressReason": { + "$ref": "#/definitions/AutomaticShortfallSuppressReason", + "description": "Optional field to record suppression reason for automatic shortfall." + }, + "status": { + "$ref": "#/definitions/MaccMilestoneStatus", + "description": "Represents the current status of the Milestone." + }, + "shortfall": { + "$ref": "#/definitions/Shortfall", + "description": "Details of the shortfall associated with this milestone." + } + } + }, + "MaccMilestoneStatus": { + "type": "string", + "description": "Represents the current status of the Milestone.", + "enum": [ + "Unknown", + "Scheduled", + "Active", + "Pending", + "Failed", + "Completed", + "Canceled", + "Removed", + "PendingSettlement", + "ShortfallCharged", + "ShortfallWaived" + ], + "x-ms-enum": { + "name": "MaccMilestoneStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown" + }, + { + "name": "Scheduled", + "value": "Scheduled" + }, + { + "name": "Active", + "value": "Active" + }, + { + "name": "Pending", + "value": "Pending" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Completed", + "value": "Completed" + }, + { + "name": "Canceled", + "value": "Canceled" + }, + { + "name": "Removed", + "value": "Removed" + }, + { + "name": "PendingSettlement", + "value": "PendingSettlement" + }, + { + "name": "ShortfallCharged", + "value": "ShortfallCharged" + }, + { + "name": "ShortfallWaived", + "value": "ShortfallWaived" + } + ] + } + }, + "MaccModelProperties": { + "type": "object", + "description": "MACC properties", + "properties": { + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "Provisioning state of MACC as assigned by RPaaS. This indicates the last operation's status. For all practical purposes, this can be ignored. For current status of MACC resource, refer to MaccStatus.", + "readOnly": true + }, + "status": { + "$ref": "#/definitions/MaccStatus", + "description": "Represents the current status of the MACC." + }, + "entityType": { + "$ref": "#/definitions/MaccEntityType", + "description": "Represents type of the object being operated on. Possible values are primary or contributor.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "displayName": { + "type": "string", + "description": "Display name" + }, + "productCode": { + "type": "string", + "description": "Represents catalog UPN.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "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}", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "commitment": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Must be start of month. Timestamp must be in the ISO date format YYYY-MM-DDT00:00:00Z." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "Must be end of month. Timestamp must be in the ISO date format YYYY-MM-DDT23:59:59Z." + }, + "systemId": { + "type": "string", + "description": "This is the globally unique identifier of the MACC which will not change for the lifetime of the MACC.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "automaticShortfall": { + "$ref": "#/definitions/EnablementMode", + "description": "Setting this to 'Enable' enables automatic shortfall charging when commitment is not met." + }, + "automaticShortfallSuppressReason": { + "$ref": "#/definitions/AutomaticShortfallSuppressReason", + "description": "Optional field to record suppression reason for automatic shortfall." + }, + "shortfall": { + "$ref": "#/definitions/Shortfall", + "description": "MACC shortfall" + }, + "milestones": { + "type": "array", + "description": "List of milestones associated with this MACC.", + "items": { + "$ref": "#/definitions/MaccMilestone" + } + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "This is the resource identifier of either the primary MACC or the contributor. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/maccs" + } + ] + } + }, + "allowContributors": { + "type": "boolean", + "description": "Setting this to true means multi-entity.", + "default": false + }, + "primaryResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the primary MACC. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/maccs" + } + ] + } + }, + "primaryBillingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified billing account resource identifier of the primary MACC. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "productDetails": { + "$ref": "#/definitions/ProductDetailsBase", + "description": "Product details including SKU title, product family, and product type.", + "readOnly": true + }, + "appliedScopeType": { + "$ref": "#/definitions/BenefitAppliedScopeType", + "description": "Type of the applied scope for the MACC." + }, + "invitationId": { + "type": "string", + "description": "Invitation identifier", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "consumed": { + "$ref": "#/definitions/Price", + "description": "Amount of benefit that has been consumed", + "readOnly": true + } + }, + "required": [ + "entityType" + ] + }, + "MaccPatchRequest": { + "type": "object", + "description": "Macc patch request", + "properties": { + "properties": { + "$ref": "#/definitions/MaccPatchRequestProperties", + "description": "Macc patch request properties", + "x-ms-client-flatten": true + }, + "tags": { + "type": "object", + "description": "Resource tags.", + "additionalProperties": { + "type": "string" + } + } + } + }, + "MaccPatchRequestProperties": { + "type": "object", + "description": "Macc patch request properties", + "properties": { + "commitment": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "allowContributors": { + "type": "boolean", + "description": "Setting this to true means multi-entity.", + "default": false + }, + "automaticShortfall": { + "$ref": "#/definitions/EnablementMode", + "description": "Represents the enablement status of a feature or settings." + }, + "automaticShortfallSuppressReason": { + "$ref": "#/definitions/AutomaticShortfallSuppressReason", + "description": "Optional field to record suppression reason for automatic shortfall." + }, + "displayName": { + "type": "string", + "description": "Display name" + }, + "status": { + "$ref": "#/definitions/MaccMilestoneStatus", + "description": "Represents the current status of the Milestone." + }, + "milestones": { + "type": "array", + "description": "List of milestones to update or add.", + "items": { + "$ref": "#/definitions/MaccMilestone" + } + }, + "primaryResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the primary MACC. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/maccs" + } + ] + } + }, + "primaryBillingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified billing account resource identifier of the primary MACC. Format must be Azure Resource ID: /providers/Microsoft.Billing/billingAccounts/{acctId:orgId}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + } + } + }, + "MaccStatus": { + "type": "string", + "description": "Represents the current status of the MACC.", + "enum": [ + "Unknown", + "Scheduled", + "Active", + "Pending", + "Failed", + "Canceled", + "Completed", + "Stopped", + "PendingSettlement", + "ShortfallCharged", + "ShortfallWaived" + ], + "x-ms-enum": { + "name": "MaccStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown" + }, + { + "name": "Scheduled", + "value": "Scheduled" + }, + { + "name": "Active", + "value": "Active" + }, + { + "name": "Pending", + "value": "Pending" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Canceled", + "value": "Canceled" + }, + { + "name": "Completed", + "value": "Completed" + }, + { + "name": "Stopped", + "value": "Stopped" + }, + { + "name": "PendingSettlement", + "value": "PendingSettlement" + }, + { + "name": "ShortfallCharged", + "value": "ShortfallCharged" + }, + { + "name": "ShortfallWaived", + "value": "ShortfallWaived" + } + ] + } + }, + "MaccTransaction": { + "type": "object", + "description": "Transaction resource definition for Maccs", + "properties": { + "properties": { + "$ref": "#/definitions/TransactionProperties", + "description": "Transaction properties" + } + }, + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "MaccTransactionsList": { + "type": "object", + "description": "List of Macc transactions", + "properties": { + "value": { + "type": "array", + "description": "The MaccTransaction items on this page", + "items": { + "$ref": "#/definitions/MaccTransaction" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "MaccValidateModel": { + "type": "object", + "description": "MACC validate model", + "properties": { + "properties": { + "$ref": "#/definitions/MaccModelProperties", + "description": "MACC validate properties", + "x-ms-client-flatten": true + } + }, + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "MACC" + }, + "MaccsValidateModel": { + "type": "object", + "description": "Maccs validate model", + "properties": { + "properties": { + "$ref": "#/definitions/MaccModelProperties", + "description": "MACC validate properties" + } + }, + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "Maccs" + }, + "ManagedServiceIdentity": { + "type": "object", + "description": "Managed service identity (system assigned and/or user assigned identities)", + "properties": { + "principalId": { + "type": "string", + "format": "uuid", + "description": "The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.", + "readOnly": true + }, + "tenantId": { + "type": "string", + "format": "uuid", + "description": "The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.", + "readOnly": true + }, + "type": { + "$ref": "#/definitions/ManagedServiceIdentityType", + "description": "Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed)." + }, + "userAssignedIdentities": { + "type": "object", + "description": "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.", + "additionalProperties": { + "$ref": "../../../../../common-types/resource-management/v6/managedidentity.json#/definitions/UserAssignedIdentity" + } + } + }, + "required": [ + "type" + ] + }, + "ManagedServiceIdentityType": { + "type": "string", + "description": "Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).", + "enum": [ + "None", + "SystemAssigned", + "UserAssigned", + "SystemAssigned,UserAssigned" + ], + "x-ms-enum": { + "name": "ManagedServiceIdentityType", + "modelAsString": true, + "values": [ + { + "name": "None", + "value": "None" + }, + { + "name": "SystemAssigned", + "value": "SystemAssigned" + }, + { + "name": "UserAssigned", + "value": "UserAssigned" + }, + { + "name": "SystemAssigned,UserAssigned", + "value": "SystemAssigned,UserAssigned" + } + ] + } + }, + "MarketSetPricesItems": { + "type": "object", + "description": "Items in the MarketSetPrices array.", + "properties": { + "markets": { + "type": "array", + "items": { + "type": "string" + } + }, + "value": { + "type": "number", + "format": "float", + "description": "The locked price for the priceable node. Validation: Required. Must be greater than or equal to 0. If the case of billing plans. This represents the price for each cycle charge." + }, + "currency": { + "type": "string", + "description": "The currency of the locked price value. Validation: Required. Must be a valid ISO 4217 3-letter currency code." + } + }, + "required": [ + "markets", + "value", + "currency" + ] + }, + "MilestoneStatus": { + "type": "string", + "description": "Current status of the milestone", + "enum": [ + "Unknown", + "Scheduled", + "Active", + "Pending", + "Failed", + "Completed", + "Canceled", + "Removed", + "PendingSettlement", + "Missed" + ], + "x-ms-enum": { + "name": "MilestoneStatus", + "modelAsString": true, + "values": [ + { + "name": "Unknown", + "value": "Unknown" + }, + { + "name": "Scheduled", + "value": "Scheduled" + }, + { + "name": "Active", + "value": "Active" + }, + { + "name": "Pending", + "value": "Pending" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Completed", + "value": "Completed" + }, + { + "name": "Canceled", + "value": "Canceled" + }, + { + "name": "Removed", + "value": "Removed" + }, + { + "name": "PendingSettlement", + "value": "PendingSettlement" + }, + { + "name": "Missed", + "value": "Missed" + } + ] + } + }, + "PaymentDetail": { + "type": "object", + "description": "Information about payment related to a savings plan order.", + "properties": { + "dueDate": { + "type": "string", + "format": "date", + "description": "Date when the payment needs to be done." + }, + "paymentDate": { + "type": "string", + "format": "date", + "description": "Date when the transaction is completed. Is null when it is scheduled." + }, + "pricingCurrencyTotal": { + "$ref": "#/definitions/Price", + "description": "Amount in pricing currency. Tax not included." + }, + "billingCurrencyTotal": { + "$ref": "#/definitions/Price", + "description": "Amount charged in Billing currency. Tax not included. Is null for future payments" + }, + "status": { + "$ref": "#/definitions/PaymentStatus", + "description": "Describes whether the payment is completed, failed, cancelled or scheduled in the future." + }, + "extendedStatusInfo": { + "$ref": "#/definitions/ExtendedStatusInfo", + "readOnly": true + }, + "billingAccount": { + "type": "string", + "description": "Billing account" + } + } + }, + "PaymentStatus": { + "type": "string", + "description": "Describes whether the payment is completed, failed, cancelled or scheduled in the future.", + "enum": [ + "Succeeded", + "Failed", + "Scheduled", + "Cancelled" + ], + "x-ms-enum": { + "name": "PaymentStatus", + "modelAsString": true, + "values": [ + { + "name": "Succeeded", + "value": "Succeeded" + }, + { + "name": "Failed", + "value": "Failed" + }, + { + "name": "Scheduled", + "value": "Scheduled" + }, + { + "name": "Cancelled", + "value": "Cancelled" + } + ] + }, + "readOnly": true + }, + "Plan": { + "type": "object", + "description": "Plan for the resource.", + "properties": { + "name": { + "type": "string", + "description": "A user defined name of the 3rd Party Artifact that is being procured." + }, + "publisher": { + "type": "string", + "description": "The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic" + }, + "product": { + "type": "string", + "description": "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": { + "type": "string", + "description": "A publisher provided promotion code as provisioned in Data Market for the said product/artifact." + }, + "version": { + "type": "string", + "description": "The version of the desired product/artifact." + } + }, + "required": [ + "name", + "publisher", + "product" + ] + }, + "Price": { + "type": "object", + "properties": { + "currencyCode": { + "type": "string", + "description": "The ISO 4217 3-letter currency code for the currency used by this purchase record." + }, + "amount": { + "type": "number", + "format": "double" + } + } + }, + "PriceGuaranteeProperties": { + "type": "object", + "description": "Set only in price guarantee scenario.", + "properties": { + "pricingPolicy": { + "$ref": "#/definitions/PricingPolicy", + "description": "Supported values: Protected, Locked" + }, + "priceGuaranteeDate": { + "type": "string", + "format": "date-time", + "description": "The date on which prices are to be used for guarantee calculation. Validation: expected to be 00 hours, Format: 2024-09-30T00:00:00Z. Must be in UTC." + } + } + }, + "PricingCurrencyDuration": { + "type": "string", + "description": "Represents either billing plan or savings plan term in ISO 8601 format.", + "enum": [ + "P1M", + "P1Y", + "P3Y" + ], + "x-ms-enum": { + "name": "PricingCurrencyDuration", + "modelAsString": true, + "values": [ + { + "name": "P1M", + "value": "P1M" + }, + { + "name": "P1Y", + "value": "P1Y" + }, + { + "name": "P3Y", + "value": "P3Y" + } + ] + } + }, + "PricingCurrencyTotal": { + "type": "object", + "properties": { + "duration": { + "$ref": "#/definitions/PricingCurrencyDuration", + "description": "Represents either billing plan or savings plan term in ISO 8601 format." + } + }, + "allOf": [ + { + "$ref": "#/definitions/Price" + } + ] + }, + "PricingPolicy": { + "type": "string", + "description": "Supported values: Protected, Locked", + "enum": [ + "Protected", + "Locked" + ], + "x-ms-enum": { + "name": "PricingPolicy", + "modelAsString": true, + "values": [ + { + "name": "Protected", + "value": "Protected" + }, + { + "name": "Locked", + "value": "Locked" + } + ] + } + }, + "PrimaryConditionalCreditProperties": { + "type": "object", + "description": "Properties for primary conditional credit.", + "properties": { + "systemId": { + "type": "string", + "description": "System identifier shared between primary and contributor conditional credits representing the same conditional credit program" + }, + "allowContributors": { + "$ref": "#/definitions/EnablementMode", + "description": "Whether this conditional credit allows contributor billing accounts" + }, + "milestones": { + "type": "array", + "description": "List of milestones for this conditional credit (must include awards)", + "items": { + "$ref": "#/definitions/ConditionalCreditMilestone" + } + } + }, + "allOf": [ + { + "$ref": "#/definitions/ConditionalCreditProperties" + } + ], + "x-ms-discriminator-value": "Primary" + }, + "ProductDetailsBase": { + "type": "object", + "description": "Common product detail properties shared across all benefit resources", + "properties": { + "skuTitle": { + "type": "string", + "description": "SKU title of the product" + }, + "productFamily": { + "type": "string", + "description": "The product family, for example \"Azure\" or \"M365\"." + }, + "productType": { + "type": "string", + "description": "The type of the product." + } + } + }, + "ProvisioningState": { + "type": "string", + "description": "Provisioning state", + "enum": [ + "Creating", + "PendingBilling", + "ConfirmedBilling", + "Created", + "Succeeded", + "Cancelled", + "Expired", + "Failed" + ], + "x-ms-enum": { + "name": "ProvisioningState", + "modelAsString": true, + "values": [ + { + "name": "Creating", + "value": "Creating" + }, + { + "name": "PendingBilling", + "value": "PendingBilling" + }, + { + "name": "ConfirmedBilling", + "value": "ConfirmedBilling" + }, + { + "name": "Created", + "value": "Created" + }, + { + "name": "Succeeded", + "value": "Succeeded" + }, + { + "name": "Cancelled", + "value": "Cancelled" + }, + { + "name": "Expired", + "value": "Expired" + }, + { + "name": "Failed", + "value": "Failed" + } + ] + }, + "readOnly": true + }, + "PurchaseRequest": { + "type": "object", + "properties": { + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "The SKU to be applied for this resource" + }, + "properties": { + "$ref": "#/definitions/PurchaseRequestProperties", + "x-ms-client-flatten": true + } + } + }, + "PurchaseRequestProperties": { + "type": "object", + "properties": { + "displayName": { + "type": "string", + "description": "Friendly name of the savings plan" + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "commitment": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + }, + "effectiveDateTime": { + "type": "string", + "format": "date-time", + "description": "DateTime of the savings plan starts providing benefit from.", + "readOnly": true + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + }, + "renewAction": { + "$ref": "#/definitions/RenewAction", + "description": "Represents the renewal action for a reservation to be a new purchase or existing renewal." + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + } + } + }, + "RenewAction": { + "type": "string", + "description": "Represents the renewal action for a reservation to be a new purchase or existing renewal.", + "enum": [ + "CreateNew", + "RenewExisting" + ], + "x-ms-enum": { + "name": "RenewAction", + "modelAsString": true, + "values": [ + { + "name": "CreateNew", + "value": "CreateNew", + "description": "Represents a new purchase renewal action." + }, + { + "name": "RenewExisting", + "value": "RenewExisting", + "description": "Represents renewal of an existing reservation." + } + ] + } + }, + "RenewProperties": { + "type": "object", + "properties": { + "purchaseProperties": { + "$ref": "#/definitions/PurchaseRequest" + } + } + }, + "ReservationOrderAliasRequest": { + "type": "object", + "description": "Reservation order alias", + "properties": { + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Reservation order SKU" + }, + "location": { + "type": "string", + "description": "The Azure Region where the reservation benefits are applied to." + }, + "properties": { + "$ref": "#/definitions/ReservationOrderAliasRequestProperties", + "description": "Reservation order alias request properties", + "x-ms-client-flatten": true + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/Resource" + } + ] + }, + "ReservationOrderAliasRequestProperties": { + "type": "object", + "description": "Reservation properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + }, + "quantity": { + "type": "integer", + "format": "int32", + "description": "Total Quantity of the SKUs purchased in the Reservation.", + "minimum": 1 + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + }, + "renewAction": { + "$ref": "#/definitions/RenewAction", + "description": "Represents the renewal action for a reservation to be a new purchase or existing renewal." + }, + "reservedResourceType": { + "$ref": "#/definitions/ReservedResourceType", + "description": "The type of the resource that is being reserved." + }, + "reviewDateTime": { + "type": "string", + "format": "date-time", + "description": "This is the date-time when the Azure Hybrid Benefit needs to be reviewed." + }, + "benefitStartTime": { + "type": "string", + "format": "date-time", + "description": "This is the DateTime when the reservation benefit started." + }, + "reservedResourceProperties": { + "$ref": "#/definitions/ReservationOrderAliasRequestPropertiesReservedResourceProperties", + "description": "Properties specific to each reserved resource type. Not required if not applicable." + } + } + }, + "ReservationOrderAliasRequestPropertiesReservedResourceProperties": { + "type": "object", + "description": "Properties specific to each reserved resource type. Not required if not applicable.", + "properties": { + "instanceFlexibility": { + "$ref": "#/definitions/InstanceFlexibility", + "description": "Turning this on will apply the reservation discount to other VMs in the same VM size group." + } + } + }, + "ReservationOrderAliasResponse": { + "type": "object", + "description": "Reservation order alias", + "properties": { + "properties": { + "$ref": "#/definitions/ReservationOrderAliasResponseProperties", + "description": "Reservation order alias response properties", + "x-ms-client-flatten": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Reservation order SKU" + }, + "location": { + "type": "string", + "description": "The Azure Region where the reserved resource lives." + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "ReservationOrderAliasResponseProperties": { + "type": "object", + "description": "Reservation properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "reservationOrderId": { + "type": "string", + "description": "Identifier of the reservation order created", + "readOnly": true + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + }, + "quantity": { + "type": "integer", + "format": "int32", + "description": "Total Quantity of the SKUs purchased in the Reservation." + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + }, + "renewAction": { + "$ref": "#/definitions/RenewAction", + "description": "Represents the renewal action for a reservation to be a new purchase or existing renewal." + }, + "renewalPurchaseDateTime": { + "type": "string", + "format": "date-time", + "description": "This is the date-time when the reservation was renewed.", + "readOnly": true + }, + "reservedResourceType": { + "$ref": "#/definitions/ReservedResourceType", + "description": "The type of the resource that is being reserved." + }, + "reviewDateTime": { + "type": "string", + "format": "date-time", + "description": "This is the date-time when the Reservation needs to be reviewed." + }, + "benefitStartTime": { + "type": "string", + "format": "date-time", + "description": "This is the DateTime when the reservation benefit started." + }, + "reservedResourceProperties": { + "$ref": "#/definitions/ReservationOrderAliasResponsePropertiesReservedResourceProperties", + "description": "Properties specific to each reserved resource type. Not required if not applicable." + } + } + }, + "ReservationOrderAliasResponsePropertiesReservedResourceProperties": { + "type": "object", + "description": "Properties specific to each reserved resource type. Not required if not applicable.", + "properties": { + "instanceFlexibility": { + "$ref": "#/definitions/InstanceFlexibility", + "description": "Turning this on will apply the reservation discount to other VMs in the same VM size group." + } + } + }, + "ReservedResourceType": { + "type": "string", + "description": "The type of the resource that is being reserved.", + "enum": [ + "VirtualMachines", + "SqlDatabases", + "SuseLinux", + "CosmosDb", + "RedHat", + "SqlDataWarehouse", + "VMwareCloudSimple", + "RedHatOsa", + "Databricks", + "AppService", + "ManagedDisk", + "BlockBlob", + "RedisCache", + "AzureDataExplorer", + "MySql", + "MariaDb", + "PostgreSql", + "DedicatedHost", + "SapHana", + "SqlAzureHybridBenefit", + "AVS", + "DataFactory", + "NetAppStorage", + "AzureFiles", + "SqlEdge", + "VirtualMachineSoftware" + ], + "x-ms-enum": { + "name": "ReservedResourceType", + "modelAsString": true, + "values": [ + { + "name": "VirtualMachines", + "value": "VirtualMachines" + }, + { + "name": "SqlDatabases", + "value": "SqlDatabases" + }, + { + "name": "SuseLinux", + "value": "SuseLinux" + }, + { + "name": "CosmosDb", + "value": "CosmosDb" + }, + { + "name": "RedHat", + "value": "RedHat" + }, + { + "name": "SqlDataWarehouse", + "value": "SqlDataWarehouse" + }, + { + "name": "VMwareCloudSimple", + "value": "VMwareCloudSimple" + }, + { + "name": "RedHatOsa", + "value": "RedHatOsa" + }, + { + "name": "Databricks", + "value": "Databricks" + }, + { + "name": "AppService", + "value": "AppService" + }, + { + "name": "ManagedDisk", + "value": "ManagedDisk" + }, + { + "name": "BlockBlob", + "value": "BlockBlob" + }, + { + "name": "RedisCache", + "value": "RedisCache" + }, + { + "name": "AzureDataExplorer", + "value": "AzureDataExplorer" + }, + { + "name": "MySql", + "value": "MySql" + }, + { + "name": "MariaDb", + "value": "MariaDb" + }, + { + "name": "PostgreSql", + "value": "PostgreSql" + }, + { + "name": "DedicatedHost", + "value": "DedicatedHost" + }, + { + "name": "SapHana", + "value": "SapHana" + }, + { + "name": "SqlAzureHybridBenefit", + "value": "SqlAzureHybridBenefit" + }, + { + "name": "AVS", + "value": "AVS" + }, + { + "name": "DataFactory", + "value": "DataFactory" + }, + { + "name": "NetAppStorage", + "value": "NetAppStorage" + }, + { + "name": "AzureFiles", + "value": "AzureFiles" + }, + { + "name": "SqlEdge", + "value": "SqlEdge" + }, + { + "name": "VirtualMachineSoftware", + "value": "VirtualMachineSoftware" + } + ] + } + }, + "ResourceSku": { + "type": "object", + "properties": { + "name": { + "type": "string" + } + } + }, + "ResourceType": { + "type": "string", + "description": "The top-level ARM resource type for a billing benefit (e.g., maccs, credits, savingsPlans, reservations).", + "enum": [ + "Maccs", + "Credits", + "ConditionalCredits", + "Discounts", + "FreeServices", + "SavingsPlans", + "Reservations" + ], + "x-ms-enum": { + "name": "ResourceType", + "modelAsString": true, + "values": [ + { + "name": "Maccs", + "value": "Maccs", + "description": "Microsoft Azure Consumption Commitments" + }, + { + "name": "Credits", + "value": "Credits", + "description": "Credits applied to the customer's billing account" + }, + { + "name": "ConditionalCredits", + "value": "ConditionalCredits", + "description": "Conditional Credits" + }, + { + "name": "Discounts", + "value": "Discounts", + "description": "Discounts that reduce charges on eligible services" + }, + { + "name": "FreeServices", + "value": "FreeServices", + "description": "Services provided at no charge under the billing agreement" + }, + { + "name": "SavingsPlans", + "value": "SavingsPlans", + "description": "Savings Plan" + }, + { + "name": "Reservations", + "value": "Reservations", + "description": "Reserved capacity or reserved instances" + } + ] + } + }, + "RoleAssignmentEntity": { + "type": "object", + "description": "Role assignment entity", + "properties": { + "id": { + "type": "string", + "description": "Role assignment entity id" + }, + "name": { + "type": "string", + "description": "Role assignment entity name" + }, + "properties": { + "$ref": "#/definitions/RoleAssignmentEntityProperties", + "description": "Role assignment entity properties", + "x-ms-client-flatten": true + } + } + }, + "RoleAssignmentEntityProperties": { + "type": "object", + "description": "Role assignment entity properties", + "properties": { + "principalId": { + "type": "string", + "description": "Principal Id" + }, + "roleDefinitionId": { + "type": "string", + "description": "Role definition id" + }, + "scope": { + "type": "string", + "description": "Scope of the role assignment entity" + } + } + }, + "SavingsPlanModel": { + "type": "object", + "description": "Savings plan", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanModelProperties", + "description": "Savings plan properties", + "x-ms-client-flatten": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Savings plan SKU" + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "SavingsPlanModelList": { + "type": "object", + "description": "Paged collection of SavingsPlanModel items", + "properties": { + "value": { + "type": "array", + "description": "The SavingsPlanModel items on this page", + "items": { + "$ref": "#/definitions/SavingsPlanModel" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "SavingsPlanModelListResult": { + "type": "object", + "description": "Represents the result of listing savings plan models", + "properties": { + "value": { + "type": "array", + "description": "The list of savings plans.", + "items": { + "$ref": "#/definitions/SavingsPlanModel" + }, + "readOnly": true + }, + "nextLink": { + "type": "string", + "description": "Url to get the next page.", + "readOnly": true + }, + "additionalProperties": { + "type": "array", + "description": "The roll out count summary of the savings plans", + "items": { + "$ref": "#/definitions/SavingsPlanSummary" + }, + "readOnly": true + } + } + }, + "SavingsPlanModelProperties": { + "type": "object", + "description": "Savings plan properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + }, + "displayProvisioningState": { + "type": "string", + "description": "The provisioning state of the savings plan for display, e.g. Succeeded", + "readOnly": true + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "billingProfileId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing profile where the benefit is applied. Present only for Field-led or Customer-led customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/billingProfiles" + } + ] + } + }, + "customerId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the customer where the savings plan is applied. Present only for Partner-led customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/customers" + } + ] + } + }, + "billingAccountId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing account where the benefit is applied. Present only for Enterprise Agreement customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "userFriendlyAppliedScopeType": { + "type": "string", + "description": "The applied scope type of the savings plan for display, e.g. Shared", + "readOnly": true + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + }, + "commitment": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + }, + "effectiveDateTime": { + "type": "string", + "format": "date-time", + "description": "DateTime of the savings plan starts providing benefit from.", + "readOnly": true + }, + "expiryDateTime": { + "type": "string", + "format": "date-time", + "description": "Expiry date time", + "readOnly": true + }, + "purchaseDateTime": { + "type": "string", + "format": "date-time", + "description": "Date time when the savings plan was purchased", + "readOnly": true + }, + "benefitStartTime": { + "type": "string", + "format": "date-time", + "description": "This is the DateTime when the savings plan benefit started." + }, + "extendedStatusInfo": { + "$ref": "#/definitions/ExtendedStatusInfo", + "readOnly": true + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + }, + "utilization": { + "$ref": "#/definitions/Utilization", + "description": "Savings plan utilization", + "readOnly": true + }, + "renewSource": { + "type": "string", + "description": "SavingsPlan Id of the SavingsPlan from which this SavingsPlan is renewed." + }, + "renewDestination": { + "type": "string", + "description": "SavingsPlan Id of the SavingsPlan which is purchased because of renew." + }, + "renewProperties": { + "$ref": "#/definitions/RenewProperties" + } + } + }, + "SavingsPlanOrderAliasModel": { + "type": "object", + "description": "Savings plan order alias", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanOrderAliasProperties", + "description": "Savings plan order alias properties", + "x-ms-client-flatten": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Savings plan SKU" + }, + "kind": { + "type": "string", + "description": "Resource provider kind" + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "SavingsPlanOrderAliasProperties": { + "type": "object", + "description": "Savings plan properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "savingsPlanOrderId": { + "type": "string", + "description": "Identifier of the savings plan created", + "readOnly": true + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + }, + "commitment": { + "$ref": "#/definitions/Commitment", + "description": "Commitment towards the benefit." + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + } + } + }, + "SavingsPlanOrderModel": { + "type": "object", + "description": "Savings plan order", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanOrderModelProperties", + "description": "Savings plan order properties", + "x-ms-client-flatten": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Savings plan SKU" + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/ProxyResource" + } + ] + }, + "SavingsPlanOrderModelList": { + "type": "object", + "description": "Paged collection of SavingsPlanOrderModel items", + "properties": { + "value": { + "type": "array", + "description": "The SavingsPlanOrderModel items on this page", + "items": { + "$ref": "#/definitions/SavingsPlanOrderModel" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "SavingsPlanOrderModelProperties": { + "type": "object", + "description": "Savings plan order properties", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "provisioningState": { + "$ref": "#/definitions/ProvisioningState", + "description": "Provisioning state", + "readOnly": true + }, + "billingScopeId": { + "type": "string", + "description": "Subscription that will be charged for purchasing the benefit" + }, + "billingProfileId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing profile where the benefit is applied. Present only for Field-led or Customer-led customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/billingProfiles" + } + ] + } + }, + "customerId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the customer where the savings plan is applied. Present only for Partner-led customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts/customers" + } + ] + } + }, + "billingAccountId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the billing account where the benefit is applied. Present only for Enterprise Agreement customers.", + "readOnly": true, + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "term": { + "$ref": "#/definitions/Term", + "description": "Represent benefit term in ISO 8601 format." + }, + "billingPlan": { + "$ref": "#/definitions/BillingPlan", + "description": "Represents the billing plan in ISO 8601 format. Required only for monthly billing plans." + }, + "expiryDateTime": { + "type": "string", + "format": "date-time", + "description": "Expiry date time", + "readOnly": true + }, + "benefitStartTime": { + "type": "string", + "format": "date-time", + "description": "This is the DateTime when the savings plan benefit started." + }, + "planInformation": { + "$ref": "#/definitions/BillingPlanInformation", + "description": "Information describing the type of billing plan for this savings plan." + }, + "savingsPlans": { + "type": "array", + "items": { + "type": "string" + } + }, + "extendedStatusInfo": { + "$ref": "#/definitions/ExtendedStatusInfo", + "readOnly": true + } + } + }, + "SavingsPlanSummary": { + "type": "object", + "description": "Savings plans list summary", + "properties": { + "name": { + "type": "string", + "description": "This property has value 'summary'", + "readOnly": true + }, + "value": { + "$ref": "#/definitions/SavingsPlanSummaryCount", + "description": "The roll up count summary of savings plans in each state" + } + } + }, + "SavingsPlanSummaryCount": { + "type": "object", + "description": "The roll up count summary of savings plans in each state", + "properties": { + "succeededCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Succeeded state", + "readOnly": true + }, + "failedCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Failed state", + "readOnly": true + }, + "expiringCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Expiring state", + "readOnly": true + }, + "expiredCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Expired state", + "readOnly": true + }, + "pendingCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Pending state", + "readOnly": true + }, + "cancelledCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Cancelled state", + "readOnly": true + }, + "processingCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Processing state", + "readOnly": true + }, + "noBenefitCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in No Benefit state", + "readOnly": true + }, + "warningCount": { + "type": "number", + "format": "float", + "description": "The number of savings plans in Warning state", + "readOnly": true + } + } + }, + "SavingsPlanUpdateRequest": { + "type": "object", + "description": "Savings plan patch request", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanUpdateRequestProperties", + "description": "Savings plan patch request" + } + } + }, + "SavingsPlanUpdateRequestProperties": { + "type": "object", + "description": "Savings plan patch request", + "properties": { + "displayName": { + "type": "string", + "description": "Display name" + }, + "appliedScopeType": { + "$ref": "#/definitions/AppliedScopeType", + "description": "Type of the Applied Scope." + }, + "appliedScopeProperties": { + "$ref": "#/definitions/AppliedScopeProperties", + "description": "Properties specific to applied scope type. Not required if not applicable." + }, + "renew": { + "type": "boolean", + "description": "Setting this to true will automatically purchase a new benefit on the expiration date time.", + "default": false + }, + "renewProperties": { + "$ref": "#/definitions/RenewProperties" + } + } + }, + "SavingsPlanUpdateValidateRequest": { + "type": "object", + "properties": { + "benefits": { + "type": "array", + "items": { + "$ref": "#/definitions/SavingsPlanUpdateRequestProperties" + }, + "x-ms-identifiers": [] + } + } + }, + "SavingsPlanValidResponseProperty": { + "type": "object", + "description": "Benefit scope response property", + "properties": { + "valid": { + "type": "boolean", + "description": "Indicates if the provided input was valid" + }, + "reasonCode": { + "type": "string", + "description": "Failure reason code if the provided input was invalid" + }, + "reason": { + "type": "string", + "description": "Failure reason if the provided input was invalid" + } + } + }, + "SavingsPlanValidateModel": { + "type": "object", + "description": "Savings plan validate model", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanOrderAliasProperties", + "description": "Savings plan order alias properties", + "x-ms-client-flatten": true + }, + "id": { + "type": "string", + "format": "arm-id", + "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}", + "readOnly": true + }, + "name": { + "type": "string", + "description": "The name of the resource", + "readOnly": true + }, + "type": { + "$ref": "#/definitions/Azure.Core.armResourceType", + "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\"", + "readOnly": true + }, + "systemData": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/systemData", + "description": "Azure Resource Manager metadata containing createdBy and modifiedBy information.", + "readOnly": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Savings plan SKU" + }, + "kind": { + "type": "string", + "description": "Resource provider kind" + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "SavingsPlan" + }, + "SavingsPlanValidateResponse": { + "type": "object", + "properties": { + "benefits": { + "type": "array", + "items": { + "$ref": "#/definitions/SavingsPlanValidResponseProperty" + }, + "x-ms-identifiers": [] + }, + "nextLink": { + "type": "string", + "description": "Url to get the next page." + } + } + }, + "SavingsPlansValidateModel": { + "type": "object", + "description": "Savings Plans validate model", + "properties": { + "properties": { + "$ref": "#/definitions/SavingsPlanOrderAliasProperties", + "description": "Savings plan order alias properties" + }, + "id": { + "type": "string", + "format": "arm-id", + "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}", + "readOnly": true + }, + "name": { + "type": "string", + "description": "The name of the resource", + "readOnly": true + }, + "type": { + "$ref": "#/definitions/Azure.Core.armResourceType", + "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\"", + "readOnly": true + }, + "systemData": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/systemData", + "description": "Azure Resource Manager metadata containing createdBy and modifiedBy information.", + "readOnly": true + }, + "sku": { + "$ref": "#/definitions/ResourceSku", + "description": "Savings plan SKU" + }, + "kind": { + "type": "string", + "description": "Resource provider kind" + } + }, + "required": [ + "sku" + ], + "allOf": [ + { + "$ref": "#/definitions/BenefitValidateModel" + } + ], + "x-ms-discriminator-value": "SavingsPlans" + }, + "SellerResourceListRequest": { + "type": "object", + "description": "List MACCs under a billing account", + "properties": { + "properties": { + "$ref": "#/definitions/SellerResourceListRequestProperties", + "description": "Request properties to list maccs under a billing account", + "x-ms-client-flatten": true + } + } + }, + "SellerResourceListRequestProperties": { + "type": "object", + "description": "Request properties to list maccs under a billing account", + "properties": { + "billingAccountResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified billing account resource identifier where the benefit is applied. Present only for Enterprise Agreement customers.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "$filter": { + "type": "string", + "description": "This is an OData expresssion to filter the list of MACCs based on the properties of MACC passed in the filter." + }, + "contributors": { + "type": "boolean", + "description": "Setting it to true will return the list of contributors associated with the MACC." + }, + "milestones": { + "type": "boolean", + "description": "Setting it to true will return the list of milestones associated with the MACC." + }, + "primaryResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the primary MACC. Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/maccs/{maccName}.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "ResourceGroup" + ], + "type": "Microsoft.BillingBenefits/maccs" + } + ] + } + } + }, + "required": [ + "billingAccountResourceId" + ] + }, + "Shortfall": { + "type": "object", + "description": "MACC shortfall", + "properties": { + "productCode": { + "type": "string", + "description": "Represents catalog UPN.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "charge": { + "$ref": "#/definitions/Commitment", + "description": "Shortfall amount with grain." + }, + "startAt": { + "type": "string", + "format": "date-time", + "description": "Start DateTime." + }, + "endAt": { + "type": "string", + "format": "date-time", + "description": "End DateTime in UTC." + }, + "resourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified resource identifier of the credits associated with the shortfall." + }, + "balanceVersion": { + "type": "number", + "format": "float", + "description": "Points to BalanceVersion document that indicates the remaining commitment balance when the credit was created." + }, + "systemId": { + "type": "string", + "description": "This is an identifier of the shortfall which will not change for its lifetime.", + "x-ms-mutability": [ + "read", + "create" + ] + } + } + }, + "Sku": { + "type": "object", + "description": "The resource model definition representing SKU", + "properties": { + "name": { + "type": "string", + "description": "The name of the SKU. E.g. P3. It is typically a letter+number code" + }, + "tier": { + "$ref": "../../../../../common-types/resource-management/v6/types.json#/definitions/SkuTier", + "description": "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": { + "type": "string", + "description": "The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code." + }, + "family": { + "type": "string", + "description": "If the service has different generations of hardware, for the same SKU, then that can be captured here." + }, + "capacity": { + "type": "integer", + "format": "int32", + "description": "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." + } + }, + "required": [ + "name" + ] + }, + "Term": { + "type": "string", + "description": "Represent benefit term in ISO 8601 format.", + "enum": [ + "P1M", + "P1Y", + "P3Y", + "P5Y" + ], + "x-ms-enum": { + "name": "Term", + "modelAsString": true, + "values": [ + { + "name": "P1M", + "value": "P1M" + }, + { + "name": "P1Y", + "value": "P1Y" + }, + { + "name": "P3Y", + "value": "P3Y" + }, + { + "name": "P5Y", + "value": "P5Y" + } + ] + } + }, + "TransactionBillingStatus": { + "type": "string", + "description": "Billing lifecycle status of a transaction.", + "enum": [ + "Open", + "Closed" + ], + "x-ms-enum": { + "name": "TransactionBillingStatus", + "modelAsString": true, + "values": [ + { + "name": "Open", + "value": "Open", + "description": "Charge may still change." + }, + { + "name": "Closed", + "value": "Closed", + "description": "Charge is finalized." + } + ] + } + }, + "TransactionChargeType": { + "type": "string", + "description": "The type of charge for a transaction.", + "enum": [ + "Usage", + "Purchase", + "Refund" + ], + "x-ms-enum": { + "name": "TransactionChargeType", + "modelAsString": true, + "values": [ + { + "name": "Usage", + "value": "Usage", + "description": "Usage charge. Applicable to all benefits." + }, + { + "name": "Purchase", + "value": "Purchase", + "description": "Purchase charge. Applicable to MACC, CACO, ACO, MC only." + }, + { + "name": "Refund", + "value": "Refund", + "description": "Refund charge. Applicable to all benefits." + } + ] + } + }, + "TransactionProductDetails": { + "type": "object", + "description": "Product details for a transaction", + "properties": { + "skuTitle": { + "type": "string", + "description": "SKU title of the product" + }, + "productFamily": { + "type": "string", + "description": "The product family, for example \"Azure\" or \"M365\"." + }, + "productType": { + "type": "string", + "description": "The type of the product." + }, + "serviceFamily": { + "type": "string", + "description": "Grouping of Azure services by core function (e.g., Compute, Databases)." + }, + "publisherType": { + "type": "string", + "description": "The publisher type of the product, for example \"Microsoft\" for first-party or a third-party publisher name. Additional values may be introduced in the future." + } + } + }, + "TransactionProperties": { + "type": "object", + "description": "Properties of a transaction", + "properties": { + "provisioningState": { + "$ref": "#/definitions/BenefitProvisioningState", + "description": "Provisioning state of the transaction as assigned by RPaaS. This indicates the last operation's status.", + "readOnly": true + }, + "date": { + "type": "string", + "format": "date-time", + "description": "This is the DateTime when the transaction occurred." + }, + "chargeType": { + "$ref": "#/definitions/TransactionChargeType", + "description": "The type of charge for this transaction." + }, + "billingStatus": { + "$ref": "#/definitions/TransactionBillingStatus", + "description": "Billing lifecycle status of this transaction." + }, + "invoiceResourceId": { + "type": "string", + "format": "arm-id", + "description": "Fully-qualified identifier of the invoice.", + "x-ms-arm-id-details": { + "allowedResources": [ + { + "scopes": [ + "Tenant" + ], + "type": "Microsoft.Billing/billingAccounts" + } + ] + } + }, + "amountInBillingCurrency": { + "$ref": "#/definitions/Price", + "description": "Transaction amount in billing currency." + }, + "amountInPricingCurrency": { + "$ref": "#/definitions/Price", + "description": "Transaction amount in pricing currency." + }, + "productCode": { + "type": "string", + "description": "Catalog UPN for the product associated with this transaction." + }, + "productDetails": { + "$ref": "#/definitions/TransactionProductDetails", + "description": "Product details including SKU title, SKU properties, product family, type, and publisher type." + } + } + }, + "TransactionsList": { + "type": "object", + "description": "List of transactions", + "properties": { + "value": { + "type": "array", + "description": "The CreditTransaction items on this page", + "items": { + "$ref": "#/definitions/CreditTransaction" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "Utilization": { + "type": "object", + "description": "Savings plan utilization", + "properties": { + "trend": { + "type": "string", + "description": "The number of days trend for a savings plan", + "readOnly": true + }, + "aggregates": { + "type": "array", + "description": "The array of aggregates of a savings plan's utilization", + "items": { + "$ref": "#/definitions/UtilizationAggregates" + }, + "x-ms-identifiers": [] + } + } + }, + "UtilizationAggregates": { + "type": "object", + "description": "The aggregate values of savings plan utilization", + "properties": { + "grain": { + "type": "number", + "format": "float", + "description": "The grain of the aggregate", + "readOnly": true + }, + "grainUnit": { + "type": "string", + "description": "The grain unit of the aggregate", + "readOnly": true + }, + "value": { + "type": "number", + "format": "float", + "description": "The aggregate value", + "readOnly": true + }, + "valueUnit": { + "type": "string", + "description": "The aggregate value unit", + "readOnly": true + } + } + } + }, + "parameters": { + "CatalogGroupsListParameters": { + "name": "$filter", + "in": "query", + "description": "OData filter expression to narrow the list of catalog groups.", + "required": false, + "type": "string", + "x-ms-parameter-location": "method" + } + } +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableConditionalCreditList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableConditionalCreditList.json new file mode 100644 index 000000000000..5d5d48c9f785 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableConditionalCreditList.json @@ -0,0 +1,145 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "C20251028000000000000", + "type": "Microsoft.BillingBenefits/applicableConditionalCredits", + "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/providers/microsoft.billingbenefits/applicableConditionalCredits/C20251028000000000000", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/conditionalcredits/testprimaryconditionalcredit", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2026-03-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Q1 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-10-01T00:00:00Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Q2 Milestone", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "C20251028000000000000", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/providers/microsoft.billingbenefits/applicableConditionalCredits/C20251028000000000000", + "location": "global", + "properties": { + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/conditionalcredits/testprimaryconditionalcredit2", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250802", + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q3 Milestone", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-07-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2026-04-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000" + }, + "systemData": { + "createdAt": "2025-09-02T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-02T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key3": "value3" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ScopeList", + "title": "ConditionalCreditScopeList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableDiscountsList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableDiscountsList.json new file mode 100644 index 000000000000..12c18755849b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableDiscountsList.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "13810867107109237", + "type": "Microsoft.BillingBenefits/applicableDiscounts", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableDiscounts/13810867107109237", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "63810867107109237", + "type": "Microsoft.BillingBenefits/applicableDiscounts", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableDiscounts/63810867107109237", + "location": "global", + "properties": { + "benefitResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "63810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_ScopeList", + "title": "DiscountScopeList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableMaccsList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableMaccsList.json new file mode 100644 index 000000000000..d1409cb93610 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ApplicableMaccsList.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "13810867107109237", + "type": "Microsoft.BillingBenefits/applicableMaccs", + "id": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/applicableMaccs/13810867107109237", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "ApplicableMaccs_List", + "title": "DiscountScopeList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountGet.json new file mode 100644 index 000000000000..e24ced4f6cec --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountGet.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "BillingAccountCatalogGroupsOps_Get", + "title": "BillingAccountCatalogGroupsGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountList.json new file mode 100644 index 000000000000..2c0cc6facd37 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingAccountList.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "BillingAccountCatalogGroupsOps_List", + "title": "BillingAccountCatalogGroupsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileGet.json new file mode 100644 index 000000000000..4262f95c4b48 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileGet.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "billingProfileName": "xxxx-xxxx-xxx-xxx", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "BillingProfileCatalogGroupsOps_Get", + "title": "BillingProfileCatalogGroupsGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileList.json new file mode 100644 index 000000000000..c36cce0ccfc8 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsBillingProfileList.json @@ -0,0 +1,111 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountName": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", + "billingProfileName": "xxxx-xxxx-xxx-xxx" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "BillingProfileCatalogGroupsOps_List", + "title": "BillingProfileCatalogGroupsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionGet.json new file mode 100644 index 000000000000..4f13abf54ed0 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionGet.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "catalogGroupName": "reservations.VirtualMachines" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "ScheduledChanges", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + } + }, + "operationId": "SubscriptionCatalogGroupsOps_Get", + "title": "SubscriptionCatalogGroupsGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionList.json new file mode 100644 index 000000000000..37b33e161f30 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CatalogGroupsSubscriptionList.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/maccs", + "name": "maccs", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Maccs", + "displayName": "Microsoft Azure Consumption Commitment", + "shortDescription": "Commit to a minimum Azure spend and unlock discounts across eligible services.", + "longDescription": "Microsoft Azure Consumption Commitments (MACCs) let organizations pre-commit to a minimum Azure spend over 1 or 3 years in exchange for discounted rates. Discounts apply automatically as usage accrues against the commitment balance.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301001", + "keywords": [ + "MACC", + "Azure Consumption Commitment", + "commitment" + ], + "icon": null + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/savingsPlans", + "name": "savingsPlans", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "SavingsPlans", + "displayName": "Savings Plans – Compute", + "shortDescription": "Save on consistent compute spend across Azure services with a flexible hourly commitment.", + "longDescription": "Azure Savings Plans for compute provide discounts on dynamic workloads by committing to an hourly spend for 1 or 3 years. Discounts apply automatically across Virtual Machines, Dedicated Host, Container Instances, App Service, and Azure Functions.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301006", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "NotSupported" + }, + { + "name": "SelfServiceRefund", + "value": "NotSupported" + }, + { + "name": "Renewability", + "value": "Supported" + } + ], + "disclaimers": [ + "Savings plan purchases cannot be canceled or refunded.", + "Select compute reservations may be traded in for a savings plan." + ], + "keywords": [ + "Savings Plan", + "compute", + "hourly commitment" + ], + "icon": null + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/catalogGroups/reservations.VirtualMachines", + "name": "reservations.VirtualMachines", + "type": "Microsoft.BillingBenefits/catalogGroups", + "properties": { + "benefitResourceType": "Reservations", + "displayName": "Reservations – Virtual Machines", + "shortDescription": "Lock in discounted VM pricing for 1 or 3 years with instance size flexibility.", + "longDescription": "Reserved VM Instances provide significant savings over pay-as-you-go pricing for stable Virtual Machine workloads. Instance size flexibility automatically covers different VM sizes within the same series and region.", + "learnMoreLink": "https://go.microsoft.com/fwlink/?linkid=2301008", + "capabilities": [ + { + "name": "SelfServiceExchange", + "value": "Supported" + }, + { + "name": "SelfServiceRefund", + "value": "Supported" + }, + { + "name": "Renewability", + "value": "Supported" + }, + { + "name": "InstanceSizeFlexibility", + "value": "Supported" + } + ], + "disclaimers": [ + "Exchanges for different instance series or regions are available until further notice.", + "Refunds are subject to a $50,000 USD cap per 12-month rolling window per billing scope." + ], + "keywords": [ + "VM", + "Virtual Machine", + "compute" + ], + "icon": "" + } + } + ] + } + } + }, + "operationId": "SubscriptionCatalogGroupsOps_List", + "title": "SubscriptionCatalogGroupsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCancel.json new file mode 100644 index 000000000000..1c0bf4812e99 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCancel.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Canceled" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765433" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Canceled" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368189?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Cancel", + "title": "ConditionalCreditCancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorGetFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorGetFromPrimary.json new file mode 100644 index 000000000000..5919911e51d8 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorGetFromPrimary.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "contributorName": "caco_contributor_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801/contributors/{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "caco contributor 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + } + }, + "operationId": "ConditionalCreditContributors_GetFromPrimary", + "title": "ConditionalCreditContributor_GetFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromApplicableConditionalCredit.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromApplicableConditionalCredit.json new file mode 100644 index 000000000000..a860a5dd420d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromApplicableConditionalCredit.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "systemId": "C20251028000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "contributor_caco_20250801", + "type": "Microsoft.BillingBenefits/applicableContributors", + "id": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/providers/Microsoft.BillingBenefits/applicableConditionalCredits/C20251028000000000000/providers/Microsoft.BillingBenefits/applicableContributors/contributor_caco_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "C20251028000000000000", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + ] + } + } + }, + "operationId": "ConditionalCreditContributors_ListFromApplicableConditionalCredit", + "title": "ConditionalCreditContributorsScopeList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromPrimary.json new file mode 100644 index 000000000000..11dbc069fed5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditContributorsListFromPrimary.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801/contributors/{contributorCloudSubId}_{rgName}_caco_contributor_20250801", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Contributor CACO 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Q4 2025 Milestone", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + } + } + ] + } + } + }, + "operationId": "ConditionalCreditContributors_ListFromPrimary", + "title": "ConditionalCreditContributors_ListFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreateContributor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreateContributor.json new file mode 100644 index 000000000000..cd0a5cdf16d7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreateContributor.json @@ -0,0 +1,134 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "displayName": "Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-09-01T00:00:00Z" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + "conditionalCreditName": "conditionalCredit_contributor_20250801", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Milestone 1", + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "name": "Milestone 2", + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-001", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + } + }, + "201": { + "body": { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Pending", + "startAt": "2025-09-01T00:00:00Z", + "status": "Pending", + "systemId": "CACO-SYSTEM-001", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_CreateOrUpdate", + "title": "ConditionalCreditCreateContributor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreatePrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreatePrimary.json new file mode 100644 index 000000000000..bdfea22c0f49 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditCreatePrimary.json @@ -0,0 +1,231 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": "Enabled", + "displayName": "Conditional Credit 20250801", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-09-30T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "name": "Milestone 2", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Pending" + }, + { + "name": "Milestone 2", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765432" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Pending" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Pending", + "startAt": "2025-07-01T00:00:00Z", + "status": "Pending", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_CreateOrUpdate", + "title": "ConditionalCreditCreatePrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditDelete.json new file mode 100644 index 000000000000..f99fb3265e26 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditDelete.json @@ -0,0 +1,22 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/6d3hhhh9-d553-6hde-cd33-d7hc6b580300?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": { + "description": "The resource has been deleted." + } + }, + "operationId": "ConditionalCredits_Delete", + "title": "ConditionalCreditDelete" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditGet.json new file mode 100644 index 000000000000..13dc81388a5f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditGet.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "systemId": "credit98765433" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "ConditionalCredits_Get", + "title": "ConditionalCreditGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionGet.json new file mode 100644 index 000000000000..7dd589cc737a --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "benefits-rg", + "conditionalCreditName": "caco-20250101-001", + "transactionName": "txn-67890", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-67890", + "name": "txn-67890", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-20T10:30:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-X001540275", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 300.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 300.0 + }, + "productCode": "UPN24243", + "productDetails": { + "skuTitle": "Premium Block Blob Storage", + "productFamily": "Azure", + "productType": "Premium Block Blob Storage", + "serviceFamily": "Storage", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "ConditionalCreditTransactions_Get", + "title": "ConditionalCreditTransactionGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionsList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionsList.json new file mode 100644 index 000000000000..c75dfb550740 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditTransactionsList.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "conditionalCreditName": "caco-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-caco-001", + "name": "txn-caco-001", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "productCode": "UPN242547", + "productDetails": { + "skuTitle": "GPT-4 API", + "productFamily": "Azure", + "productType": "Azure OpenAI", + "serviceFamily": "AI + Machine Learning", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/conditionalCredits/caco-20250101-001/transactions/txn-caco-002", + "name": "txn-caco-002", + "type": "Microsoft.BillingBenefits/conditionalCredits/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 250.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 250.0 + }, + "productCode": "UPN242548", + "productDetails": { + "skuTitle": "Multi-region writes", + "productFamily": "Azure", + "productType": "Azure Cosmos DB", + "serviceFamily": "Databases", + "publisherType": "Microsoft" + } + } + } + ], + "nextLink": null + } + } + }, + "operationId": "ConditionalCreditTransactions_ListByParent", + "title": "ConditionalCreditTransactionsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdate.json new file mode 100644 index 000000000000..3de6c46ea124 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdate.json @@ -0,0 +1,180 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated Conditional Credit 20250801", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 3", + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + } + } + ] + }, + "tags": { + "key1": "updated_value1", + "key3": "value3" + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Updated Conditional Credit 20250801", + "endAt": "2026-04-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + }, + { + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "updated_value1", + "key3": "value3" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateContributor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateContributor.json new file mode 100644 index 000000000000..c6687f1fcab9 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateContributor.json @@ -0,0 +1,108 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated Contributor Conditional Credit 20250801" + }, + "tags": { + "environment": "test", + "team": "finance" + } + }, + "conditionalCreditName": "conditionalCreditContributor_20250801", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCreditContributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCreditContributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Updated Contributor Conditional Credit 20250801", + "entityType": "Contributor", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "test", + "team": "finance" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/7e3ffff7-b331-4fcb-ab11-b5fa49368199?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdateContributor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateLastMilestoneEndDate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateLastMilestoneEndDate.json new file mode 100644 index 000000000000..dc69e7b296cd --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditUpdateLastMilestoneEndDate.json @@ -0,0 +1,133 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003" + } + ] + } + }, + "conditionalCreditName": "conditionalCredit_20250801", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2026-04-30T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 6000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M", + "endAt": "2026-02-28T23:59:59Z", + "startAt": "2026-02-01T00:00:00Z", + "systemId": "credit98765431" + }, + "endAt": "2026-01-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "name": "Milestone 1", + "spendTarget": { + "amount": 60000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M", + "endAt": "2026-03-31T23:59:59Z", + "startAt": "2026-03-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2026-02-28T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "name": "Milestone 2", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 15000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "name": "Milestone 3", + "spendTarget": { + "amount": 150000, + "currencyCode": "USD" + }, + "status": "Completed" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-11-01T00:00:00Z", + "status": "Active", + "systemId": "CONDITIONALCREDITS-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationStatus/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationStatus/5f3gggg8-c442-5gdc-bc22-c6gb5a479299?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ConditionalCredits_Update", + "title": "ConditionalCreditUpdateLastMilestoneEndDate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCancel.json new file mode 100644 index 000000000000..36aa9428f5c3 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCancel.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "entityType": "Primary", + "resourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "status": "Canceled", + "systemId": "CACO-SYSTEM-20250801" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreate.json new file mode 100644 index 000000000000..d64941e3334c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreate.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Validation Test CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateContributor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateContributor.json new file mode 100644 index 000000000000..2a95df48b88b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateContributor.json @@ -0,0 +1,32 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "displayName": "Contributor CACO Test", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47/resourceGroups/primaryRG/providers/Microsoft.BillingBenefits/conditionalCredits/primaryCACO", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-09-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateContributor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateError.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateError.json new file mode 100644 index 000000000000..2faba94a5853 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateError.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "Invalid CACO Test", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 100000, + "currencyCode": "USD" + }, + "endAt": "2021-12-31T00:00:00Z", + "startAt": "2022-01-01T00:00:00Z" + }, + "endAt": "2022-12-31T00:00:00Z", + "spendTarget": { + "amount": -1000, + "currencyCode": "INVALID" + } + } + ], + "productCode": "b8473ce57f1d", + "startAt": "2023-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "displayName": "Invalid Contributor CACO", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/nonexistent", + "primaryResourceId": "/subscriptions/invalid/resourceGroups/invalid/providers/Microsoft.BillingBenefits/conditionalCredits/nonexistent", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2023-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "reason": "The billing account resource ID is missing or invalid", + "reasonCode": "InvalidBillingAccountId", + "valid": false + }, + { + "reason": "Start date must be the first day of the current or a future month", + "reasonCode": "InvalidStartAt", + "valid": false + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateError" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateMultiple.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateMultiple.json new file mode 100644 index 000000000000..cafeb04c39c5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateCreateMultiple.json @@ -0,0 +1,109 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "Standard CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "High Value CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "Special Product CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2025-12-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateCreateMultiple" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdate.json new file mode 100644 index 000000000000..8c7c51d1b610 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdate.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Validation Test Update CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdateRemoveMilestone.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdateRemoveMilestone.json new file mode 100644 index 000000000000..84d7498861ba --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditValidateUpdateRemoveMilestone.json @@ -0,0 +1,69 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Validation Test Update CACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Removed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-06-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Removed" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/CACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "ConditionalCreditValidateUpdateRemoveMilestone" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListByResourceGroup.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListByResourceGroup.json new file mode 100644 index 000000000000..0bd498005644 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListByResourceGroup.json @@ -0,0 +1,132 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "nextLink": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits?api-version=2026-06-01&$skiptoken=abcd1234", + "value": [ + { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "conditionalCredit_simple_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_simple_20250801", + "location": "global", + "properties": { + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Simple Conditional Credit", + "entityType": "Primary", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-SIMPLE-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "production" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ListByResourceGroup", + "title": "ConditionalCreditsListByResourceGroup" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListBySubscription.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListBySubscription.json new file mode 100644 index 000000000000..c703382480be --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ConditionalCreditsListBySubscription.json @@ -0,0 +1,235 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "nextLink": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/conditionalCredits?api-version=2026-06-01&$skiptoken=xyz5678", + "value": [ + { + "name": "conditionalCredit_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "location": "global", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-07-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "conditionalCredit_contributor_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_contributor_20250801", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Contributor Conditional Credit 20250801", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "balanceVersion": 13, + "credit": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M", + "endAt": "2025-12-31T23:59:59Z", + "startAt": "2025-10-01T00:00:00Z", + "systemId": "credit98765432" + }, + "endAt": "2025-09-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P3M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_20250801", + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "dev", + "team": "finance" + } + }, + { + "name": "conditionalCredit_simple_20250801", + "type": "Microsoft.BillingBenefits/conditionalCredits", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_03/providers/Microsoft.BillingBenefits/conditionalCredits/conditionalCredit_simple_20250801", + "location": "global", + "properties": { + "allowContributors": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Simple Conditional Credit", + "endAt": "2025-12-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 2500, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "duration": "P1M" + }, + "endAt": "2025-12-31T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440003", + "spendTarget": { + "amount": 25000, + "currencyCode": "USD" + }, + "status": "Active" + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "provisioningState": "Succeeded", + "startAt": "2025-09-01T00:00:00Z", + "status": "Active", + "systemId": "CACO-SYSTEM-SIMPLE-20250801", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-09-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "environment": "production" + } + } + ] + } + } + }, + "operationId": "ConditionalCredits_ListBySubscription", + "title": "ConditionalCreditsListBySubscription" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorCreate.json new file mode 100644 index 000000000000..f7df2b2d2348 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorCreate.json @@ -0,0 +1,104 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/20000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "Contributor_Create" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorEndDateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorEndDateUpdate.json new file mode 100644 index 000000000000..c0e865f91645 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorEndDateUpdate.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2023-07-10T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "contributor_macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/contributor_macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Contributor", + "milestones": [], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "Contributor_UpdateEndDate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGet.json new file mode 100644 index 000000000000..a7af428b0d09 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGet.json @@ -0,0 +1,54 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "Contributor_Get" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGetFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGetFromPrimary.json new file mode 100644 index 000000000000..a643781ed8c7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorGetFromPrimary.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGet.json new file mode 100644 index 000000000000..baba1c46c84c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGet.json @@ -0,0 +1,91 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 9, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall32109876" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "ContributorWithMilestonesAndShortfall_GetFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGetFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGetFromPrimary.json new file mode 100644 index 000000000000..fc93ec5bc791 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesAndShortfallGetFromPrimary.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 10, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "13810867107109238" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary_WithMilestonesAndShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGet.json new file mode 100644 index 000000000000..491411dcb678 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGet.json @@ -0,0 +1,78 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_contributor_20230614", + "resourceGroupName": "resource_group_name_02", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{contributorCloudSubId}/resourceGroups/resource_group_name_02/providers/Microsoft.BillingBenefits/maccs/macc_contributor_20230614", + "location": "global", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "ContributorWithMilestones_GetFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGetFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGetFromPrimary.json new file mode 100644 index 000000000000..23d78c7f128c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorWithMilestonesGetFromPrimary.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "contributorName": "macc_contributor_20230614", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc contributor 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + } + }, + "operationId": "Contributors_GetFromPrimary", + "title": "Contributor_GetFromPrimary_WithMilestones" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromApplicableMacc.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromApplicableMacc.json new file mode 100644 index 000000000000..996e3d1797d2 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromApplicableMacc.json @@ -0,0 +1,45 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "billingAccountId": "20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "systemId": "13810867107109237" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "contributor_20230614", + "type": "Microsoft.BillingBenefits/applicableContributors", + "id": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/providers/Microsoft.BillingBenefits/applicableMaccs/13810867107109237/providers/Microsoft.BillingBenefits/applicableContributors/contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromApplicableMacc", + "title": "ContributorsScopeList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromPrimary.json new file mode 100644 index 000000000000..e1daf4578e3c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsListFromPrimary.json @@ -0,0 +1,46 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "Contributors_ListFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesAndShortfallListFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesAndShortfallListFromPrimary.json new file mode 100644 index 000000000000..99aff7c424aa --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesAndShortfallListFromPrimary.json @@ -0,0 +1,83 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 13, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "13810867107109238" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "ContributorsWithMilestonesAndShortfall_ListFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesListFromPrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesListFromPrimary.json new file mode 100644 index 000000000000..89808f245ad7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ContributorsWithMilestonesListFromPrimary.json @@ -0,0 +1,71 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "type": "Microsoft.BillingBenefits/maccs/contributors", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614/contributors/{contributorCloudSubId}_{rgName}_macc_contributor_20230614", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor Macc 20230614", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + } + } + ] + } + } + }, + "operationId": "Contributors_ListFromPrimary", + "title": "ContributorsWithMilestones_ListFromPrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCancel.json new file mode 100644 index 000000000000..ff805487b3c6 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCancel.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Canceled", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Cancel", + "title": "CreditCancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditChangeSponsor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditChangeSponsor.json new file mode 100644 index 000000000000..0d70dc467eb7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditChangeSponsor.json @@ -0,0 +1,23 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "body": { + "sponsorId": "P30000001" + } + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Credits_ChangeSponsor", + "title": "CreditChangeSponsor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreate.json new file mode 100644 index 000000000000..27ab8fa0f849 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreate.json @@ -0,0 +1,129 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreateWithInvitation.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreateWithInvitation.json new file mode 100644 index 000000000000..412425e5bd04 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditCreateWithInvitation.json @@ -0,0 +1,135 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "invitationId": "sampleInvitationId", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_invitation_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_invitation_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_invitation_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "invitationId": "sampleInvitationId", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_invitation_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_invitation_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "invitationId": "sampleInvitationId", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditCreateWithInvitation" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditDelete.json new file mode 100644 index 000000000000..3f8b83be1559 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Credits_Delete", + "title": "CreditDelete" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditGet.json new file mode 100644 index 000000000000..5e2161866856 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditGet.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Credits_Get", + "title": "CreditGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditListApplicableCredits.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditListApplicableCredits.json new file mode 100644 index 000000000000..ec671d12e6d7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditListApplicableCredits.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "scope": "providers/Microsoft.Billing/billingAccounts/{acctId}" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/applicableCredits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/applicableCredits/{systemId}", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/12345678", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/1185c37e-d180-5aea-03a3-07e2489791a8:3c9f6394-2029-4f58-bf47-76ebbb03136e_2019-05-31/billingProfiles/6EB6-D7AQ-BG7-TGB", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T23:59:59Z", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "reason": { + "description": "Outage credit (SLA)", + "code": "125" + }, + "resourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/credits/testprimarydiscount", + "startAt": "2023-07-01T00:00:00Z", + "status": "Succeeded", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/1185c37e-d180-5aea-03a3-07e2489791a8:3c9f6394-2029-4f58-bf47-76ebbb03136e_2019-05-31/customers/5334c5c9-e4b0-4170-a015-fa8fff5c226a", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListApplicable", + "title": "CreditSourcesListByCredit" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceCreate.json new file mode 100644 index 000000000000..84f3d85e8394 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceCreate.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Sources_Create", + "title": "CreditSourceCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceDelete.json new file mode 100644 index 000000000000..71de8b3c03d9 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceDelete.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": {}, + "204": {} + }, + "operationId": "Sources_Delete", + "title": "CreditSourceDelete" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceGet.json new file mode 100644 index 000000000000..7e9527152409 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceGet.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Sources_Get", + "title": "CreditSourceGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceTagsUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceTagsUpdate.json new file mode 100644 index 000000000000..919ba39688f5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourceTagsUpdate.json @@ -0,0 +1,47 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "sourceName": "source_20231212", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + } + }, + "operationId": "Sources_Update", + "title": "CreditSourceTagsUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourcesListByCredit.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourcesListByCredit.json new file mode 100644 index 000000000000..48872c8d92de --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditSourcesListByCredit.json @@ -0,0 +1,44 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "source_20231212", + "type": "Microsoft.BillingBenefits/credits/sources", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212/sources/source_20231212", + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "impactedBillingPeriod": "202304", + "sourceResourceId": "/subscriptions/{subId}", + "status": "Pending" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Sources_ListByCredit", + "title": "CreditSourcesListByCredit" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTagsUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTagsUpdate.json new file mode 100644 index 000000000000..fd587ca416d1 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTagsUpdate.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileResourceId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/customers/{customerId}", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Update", + "title": "CreditTagsUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionGet.json new file mode 100644 index 000000000000..1f772e7e9df3 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "credit-rg", + "creditName": "credit-20250101-001", + "transactionName": "txn-mc-001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/credit-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-001", + "name": "txn-mc-001", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-12345", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "CreditTransactions_Get", + "title": "CreditTransactionGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionsList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionsList.json new file mode 100644 index 000000000000..6e7787c8eb96 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransactionsList.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "creditName": "credit-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-001", + "name": "txn-mc-001", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 50.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/credits/credit-20250101-001/transactions/txn-mc-002", + "name": "txn-mc-002", + "type": "Microsoft.BillingBenefits/credits/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 125.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 125.0 + }, + "productCode": "UPN242545", + "productDetails": { + "skuTitle": "P30 Disk", + "productFamily": "Azure", + "productType": "Premium SSD Managed Disks", + "serviceFamily": "Storage", + "publisherType": "Microsoft" + } + } + } + ] + } + } + }, + "operationId": "CreditTransactions_ListByParent", + "title": "CreditTransactionsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransferCreditCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransferCreditCreate.json new file mode 100644 index 000000000000..3a136deeda47 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditTransferCreditCreate.json @@ -0,0 +1,113 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "credit": { + "grain": "FullTerm", + "amount": 20000, + "currencyCode": "USD" + }, + "displayName": "Transfer Credit" + } + }, + "creditName": "credit_transfer_20260301", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_transfer_20260301", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_transfer_20260301", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-03-01T00:00:00Z", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Transfer Credit", + "startAt": "2026-03-01T00:00:00Z", + "status": "Succeeded", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + } + }, + "systemData": { + "createdAt": "2026-03-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + } + } + }, + "201": { + "body": { + "name": "credit_transfer_20260301", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_transfer_20260301", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-03-01T00:00:00Z", + "fundingSystemId": "e21611dc-a314-4aa7-b590-1ab159b7b41b", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Transfer Credit", + "startAt": "2026-03-01T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + } + }, + "systemData": { + "createdAt": "2026-03-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "CreditTransferCreditCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListByResourceGroup.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListByResourceGroup.json new file mode 100644 index 000000000000..bc3c98709183 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListByResourceGroup.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListByResourceGroup", + "title": "CreditsListByResourceGroup" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListBySubscription.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListBySubscription.json new file mode 100644 index 000000000000..e8a32cd9657c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsListBySubscription.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{enrollmentId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28/customers/22222222-2222-2222-2222-222222222222", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "appliedScopeType": "BillingProfile", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Credits_ListBySubscription", + "title": "CreditsListBySubscription" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsValidateCreate.json new file mode 100644 index 000000000000..0645750e3751 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/CreditsValidateCreate.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Credits", + "properties": { + "location": "global", + "properties": { + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-12-12T00:00:00Z", + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Credit", + "startAt": "2026-12-12T00:00:00Z" + } + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "CreditsValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountCancel.json new file mode 100644 index 000000000000..9c0c49dfe02b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountCancel.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testdiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Discounts_Cancel", + "title": "DiscountCancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountGet.json new file mode 100644 index 000000000000..b8870f316b7b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountGet.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discount_Get", + "title": "DiscountGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountList.json new file mode 100644 index 000000000000..27f06ed646cc --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountList.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_SubscriptionList", + "title": "DiscountSubscriptionList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountResourceGroupList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountResourceGroupList.json new file mode 100644 index 000000000000..f9d6faf59662 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountResourceGroupList.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Discounts_ResourceGroupList", + "title": "DiscountResourceGroupList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreateAffiliate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreateAffiliate.json new file mode 100644 index 000000000000..2691a5f4c247 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreateAffiliate.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "displayName": "Virtual Machines D Series", + "entityType": "Affiliate", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testaffiliatediscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Affiliate", + "primaryResourceId": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testaffiliatediscount", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreateAffiliate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimary.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimary.json new file mode 100644 index 000000000000..486b4d772c83 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimary.json @@ -0,0 +1,141 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimary" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryBackfill.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryBackfill.json new file mode 100644 index 000000000000..9a44b47de7e6 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryBackfill.json @@ -0,0 +1,136 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "ProductFamily", + "productFamilyName": "Azure" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryBackfill" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithAzurePromotion.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithAzurePromotion.json new file mode 100644 index 000000000000..1655f895c05b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithAzurePromotion.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testazurepromotiondiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testazurepromotiondiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testazurepromotiondiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "systemId": "DISC-20250801-00000001" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testazurepromotiondiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testazurepromotiondiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Consume", + "discountCombinationRule": "BestOf", + "discountPercentage": 10, + "discountType": "AzurePromotion", + "productFamilyName": "Azure" + }, + "displayName": "ConsumptionPromo20percent ", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + }, + "systemId": "DISC-20250801-00000001" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithAzurePromotion" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPrice.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPrice.json new file mode 100644 index 000000000000..2dd8a30a15f1 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPrice.json @@ -0,0 +1,182 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPrice", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPrice", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithCustomPrice" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json new file mode 100644 index 000000000000..a17a1a6f5659 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithCustomPriceMultiCurrency.json @@ -0,0 +1,224 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "account", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "customPriceProperties": { + "catalogClaims": [ + { + "catalogClaimsItemType": "NationalCloud", + "value": "USSec" + } + ], + "catalogId": "4", + "marketSetPrices": [ + { + "currency": "USD", + "markets": [ + "US" + ], + "value": 125.16 + }, + { + "currency": "EUR", + "markets": [ + "FR" + ], + "value": 110.16 + } + ], + "ruleType": "FixedPriceLock", + "termUnits": "ASI1251A" + }, + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "CustomPriceMultiCurrency", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithCustomPriceMultiCurrency" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithPriceGuarantee.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithPriceGuarantee.json new file mode 100644 index 000000000000..41b67e69e133 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsCreatePrimaryWithPriceGuarantee.json @@ -0,0 +1,150 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series Discount", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountType": "Sku", + "priceGuaranteeProperties": { + "priceGuaranteeDate": "2024-11-01T00:00:00", + "pricingPolicy": "Protected" + }, + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Discounts_Create", + "title": "DiscountsCreatePrimaryWithPriceGuarantee" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsDelete.json new file mode 100644 index 000000000000..10a4ef4fce97 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "discountName": "testdiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/providers/Microsoft.BillingBenefits/operationStatuses/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Discounts_Delete", + "title": "ReservationOrderAliasCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdate.json new file mode 100644 index 000000000000..02f65870c972 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdate.json @@ -0,0 +1,76 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Virtual Machines D Series" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2024-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-Asyncoperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": "5" + } + } + }, + "operationId": "Discount_Update", + "title": "DiscountGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdateEndAt.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdateEndAt.json new file mode 100644 index 000000000000..47a4c465b986 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsUpdateEndAt.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2025-07-01T23:59:59Z" + } + }, + "discountName": "testprimarydiscount", + "resourceGroupName": "testrg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "testprimarydiscount", + "type": "Microsoft.BillingBenefits/discounts", + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/discounts/testprimarydiscount", + "location": "global", + "properties": { + "appliedScopeType": "BillingAccount", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series", + "endAt": "2025-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + }, + "202": { + "headers": { + "Azure-Asyncoperation": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": "5" + } + } + }, + "operationId": "Discount_Update", + "title": "DiscountsUpdateEndAt" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsValidateCreate.json new file mode 100644 index 000000000000..d1e042b17dfb --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/DiscountsValidateCreate.json @@ -0,0 +1,51 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Discounts", + "properties": { + "appliedScopeType": "BillingAccount", + "discountTypeProperties": { + "applyDiscountOn": "Purchase", + "conditions": [ + { + "type": "equalAny", + "conditionName": "Cloud", + "value": [ + "US-Sec" + ] + } + ], + "discountCombinationRule": "BestOf", + "discountPercentage": 14, + "discountType": "Sku", + "productFamilyName": "Azure", + "productId": "DZH318Z0BQ35", + "skuId": "0001" + }, + "displayName": "Virtual Machines D Series Discount", + "endAt": "2027-07-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2026-07-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "DiscountsValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/EndCustomerInvestmentFundCreditCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/EndCustomerInvestmentFundCreditCreate.json new file mode 100644 index 000000000000..80f0d0161912 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/EndCustomerInvestmentFundCreditCreate.json @@ -0,0 +1,206 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "startAt": "2025-08-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2025-08-01T00:00:00Z", + "status": "Succeeded", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "breakdown": [ + { + "allocation": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "dimensions": [ + { + "key": "productFamily", + "value": "Azure" + }, + { + "key": "productCode", + "value": "00002b30-0000-0260-d348-f3ffcd565473" + }, + { + "key": "creditType", + "value": "EndCustomerInvestmentCredit" + }, + { + "key": "supplierType", + "value": "External" + } + ], + "endAt": "2025-08-31T23:59:59.999Z", + "startAt": "2025-08-01T00:00:00Z" + } + ], + "credit": { + "amount": 25000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-08-31T23:59:59.999Z", + "productCode": "00002b30-0000-0260-d348-f3ffcd565473", + "displayName": "Investment Fund Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2025-08-01T00:00:00Z", + "status": "Pending", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "EndCustomerInvestmentFundCreditCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesCreate.json new file mode 100644 index 000000000000..0da6ddd16a74 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesCreate.json @@ -0,0 +1,96 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01", + "body": { + "location": "global", + "tags": { + "environment": "production" + }, + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + } + }, + "201": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "FreeServices_Create", + "title": "FreeServicesCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesDelete.json new file mode 100644 index 000000000000..e5c305eba140 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesDelete.json @@ -0,0 +1,24 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001?api-version=2025-12-01-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + }, + "204": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview" + } + } + }, + "operationId": "FreeServices_Delete", + "title": "FreeServicesDelete" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesGet.json new file mode 100644 index 000000000000..91f9e1a6fb31 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesGet.json @@ -0,0 +1,46 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + } + } + }, + "operationId": "FreeServices_Get", + "title": "FreeServicesGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListByResourceGroup.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListByResourceGroup.json new file mode 100644 index 000000000000..cd3f41a5fdec --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListByResourceGroup.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250901", + "name": "freeservice_20250901", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "b2c3d4e5-f6a7-8901-bcde-fa2345678901", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z" + } + } + ] + } + } + }, + "operationId": "FreeServices_ListByResourceGroup", + "title": "FreeServicesListByResourceGroup" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListBySubscription.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListBySubscription.json new file mode 100644 index 000000000000..db423cc58fb1 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesListBySubscription.json @@ -0,0 +1,112 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-10-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250901", + "name": "freeservice_20250901", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "b2c3d4e5-f6a7-8901-bcde-fa2345678901", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "production" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-09-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-09-01T01:01:01.1075056Z" + } + }, + { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/providers/Microsoft.BillingBenefits/freeServices/freeservice_20250801", + "name": "freeservice_20250801", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-10-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "c3d4e5f6-a7b8-9012-cdef-ab3456789012", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "development" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-08-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-08-01T01:01:01.1075056Z" + } + } + ] + } + } + }, + "operationId": "FreeServices_ListBySubscription", + "title": "FreeServicesListBySubscription" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesUpdate.json new file mode 100644 index 000000000000..8479b777973d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/FreeServicesUpdate.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277", + "resourceGroupName": "resource_group_name_01", + "freeServiceName": "freeservice_20251001", + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2026-12-01T00:00:00Z" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001", + "name": "freeservice_20251001", + "type": "Microsoft.BillingBenefits/freeServices", + "properties": { + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Test Free Service", + "status": "Active", + "startAt": "2025-10-01T00:00:00Z", + "endAt": "2026-12-01T00:00:00Z", + "provisioningState": "Succeeded", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "customerResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/customers/40000000-0000-0000-0000-000000000000", + "systemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "productDetails": { + "skuTitle": "Sample SKU Title", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "location": "global", + "tags": { + "environment": "updated" + }, + "systemData": { + "createdByType": "User", + "createdAt": "2025-10-01T01:01:01.1075056Z", + "lastModifiedByType": "User", + "lastModifiedAt": "2025-11-01T01:01:01.1075056Z" + } + } + }, + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/freeServices/freeservice_20251001?api-version=2025-12-01-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/freeservice_20251001?api-version=2025-12-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "FreeServices_Update", + "title": "FreeServicesUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneCommitmentUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneCommitmentUpdate.json new file mode 100644 index 000000000000..3a162ccda676 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneCommitmentUpdate.json @@ -0,0 +1,112 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneCommitment_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneEndDateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneEndDateUpdate.json new file mode 100644 index 000000000000..50afe9073e90 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneEndDateUpdate.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2029-05-01T23:59:59Z", + "milestones": [ + { + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2028-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2029-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2028-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneEndDate_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneMultiPropertyUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneMultiPropertyUpdate.json new file mode 100644 index 000000000000..229c9c3fcbbb --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccAndMilestoneMultiPropertyUpdate.json @@ -0,0 +1,117 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false, + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated with milestones", + "endAt": "2029-10-31T23:59:59Z", + "milestones": [ + { + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-06-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 35000, + "currencyCode": "USD" + }, + "endAt": "2028-06-30T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated with milestones", + "endAt": "2029-10-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 25000, + "currencyCode": "USD" + }, + "endAt": "2027-06-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 35000, + "currencyCode": "USD" + }, + "endAt": "2028-06-30T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccAndMilestoneMultiProperty_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCancel.json new file mode 100644 index 000000000000..62c0a62feb8f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCancel.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Cancel", + "title": "Macc_Cancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccChargeShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccChargeShortfall.json new file mode 100644 index 000000000000..8b7032a59c70 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccChargeShortfall.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Canceled", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/{rgName}/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 3, + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall87654321" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_ChargeShortfall", + "title": "Maccs_ChargeShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccContributorRuleUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccContributorRuleUpdate.json new file mode 100644 index 000000000000..3cfa8f927f6b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccContributorRuleUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccEndContributorRule_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCreate.json new file mode 100644 index 000000000000..9b763523c357 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccCreate.json @@ -0,0 +1,128 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": true, + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2023-07-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "Macc_Create" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDelete.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDelete.json new file mode 100644 index 000000000000..06a198fedfdb --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + }, + "204": {} + }, + "operationId": "Maccs_Delete", + "title": "ServiceSpecificIncentives_Delete" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDisplayNameUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDisplayNameUpdate.json new file mode 100644 index 000000000000..10460b6b594d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccDisplayNameUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "displayName": "Updated MACC Display Name" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Updated MACC Display Name", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccDisplayName_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccGet.json new file mode 100644 index 000000000000..71b074902d2d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccGet.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "Macc_Get" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneSuppressAutomaticShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneSuppressAutomaticShortfall.json new file mode 100644 index 000000000000..8bd4e893c70b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneSuppressAutomaticShortfall.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + }, + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMilestoneSuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneUnsuppressAutomaticShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneUnsuppressAutomaticShortfall.json new file mode 100644 index 000000000000..3b0071695a02 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMilestoneUnsuppressAutomaticShortfall.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "PendingSettlement" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-07-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMilestoneUnsuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMultiPropertyUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMultiPropertyUpdate.json new file mode 100644 index 000000000000..1cbe5db8b442 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccMultiPropertyUpdate.json @@ -0,0 +1,77 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "allowContributors": false, + "commitment": { + "amount": 45000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated", + "endAt": "2024-10-01T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": false, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 45000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614 updated", + "endAt": "2024-10-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccMultiProperty_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesCommitmentUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesCommitmentUpdate.json new file mode 100644 index 000000000000..bf18c242b602 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesCommitmentUpdate.json @@ -0,0 +1,74 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + } + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccCommitment_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesEndDateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesEndDateUpdate.json new file mode 100644 index 000000000000..24186dc8ac49 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccNoMilestonesEndDateUpdate.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "endAt": "2023-07-10T00:00:00Z" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccEndDate_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributors.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributors.json new file mode 100644 index 000000000000..b17e5328d85f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributors.json @@ -0,0 +1,101 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 4, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall56789012" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Contributor 1", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Contributor", + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributors" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestones.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestones.json new file mode 100644 index 000000000000..aebe84df8f41 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestones.json @@ -0,0 +1,136 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "milestones": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc Contributor 1", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributorsWithMilestones" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestonesAndShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestonesAndShortfall.json new file mode 100644 index 000000000000..899e3bd1a86c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewContributorsWithMilestonesAndShortfall.json @@ -0,0 +1,162 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "contributors": true, + "milestones": true, + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 5, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall76543210" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + }, + { + "properties": { + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc Contributor 1", + "endAt": "2028-05-31T23:59:59Z", + "entityType": "Contributor", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "primaryBillingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "primaryResourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/{leadMaccName}/contributor/{maccContributorName}", + "shortfall": { + "balanceVersion": 6, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall65432109" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewContributorsWithMilestonesAndShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewNoContributors.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewNoContributors.json new file mode 100644 index 000000000000..acc84e21b67f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewNoContributors.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}" + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2024-06-30T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/{rgName}/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "shortfall": { + "balanceVersion": 5, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "charge": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-01T00:00:00Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2023-07-01T00:00:00Z", + "systemId": "shortfall67890123" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewNoContributors" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewWithMilestonesNoContributors.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewWithMilestonesNoContributors.json new file mode 100644 index 000000000000..5c6b7458e402 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSellerViewWithMilestonesNoContributors.json @@ -0,0 +1,81 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "$filter": "properties/status ne 'Canceled'", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "milestones": true + } + } + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + } + }, + "systemData": { + "createdAt": "2023-06-12T22:05:09Z", + "createdByType": "User", + "lastModifiedAt": "2023-06-12T22:05:09Z", + "lastModifiedByType": "User" + } + } + ] + } + } + }, + "operationId": "SellerResource_List", + "title": "SellerViewWithMilestonesNoContributors" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSuppressAutomaticShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSuppressAutomaticShortfall.json new file mode 100644 index 000000000000..a66ec0ad2ff2 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccSuppressAutomaticShortfall.json @@ -0,0 +1,78 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall charging" + } + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequestedSuppression", + "message": "Customer explicitly requested to disable automatic shortfall." + }, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccSuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTagsUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTagsUpdate.json new file mode 100644 index 000000000000..b3650b204d69 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTagsUpdate.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": {}, + "tags": { + "key1": "value4", + "key2": "value5" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 40000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-10T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value4", + "key2": "value5" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccTags_Update" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionGet.json new file mode 100644 index 000000000000..aad2f367e0fd --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionGet.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "subscriptionId": "30000000-0000-0000-0000-000000000000", + "resourceGroupName": "macc-rg", + "maccName": "macc-20250101-001", + "transactionName": "txn-macc-001", + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/macc-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-001", + "name": "txn-macc-001", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-20T10:30:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/DDFF-TTNN-BG7-GGG/invoices/INV-X001540275", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 100.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D2s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series Windows", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + } + } + }, + "operationId": "MaccTransactions_Get", + "title": "MaccTransactionGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionsList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionsList.json new file mode 100644 index 000000000000..335dcd17c1b5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccTransactionsList.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc-20250101-001", + "resourceGroupName": "benefits-rg", + "subscriptionId": "30000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-001", + "name": "txn-macc-001", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-15T14:22:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 150.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 150.0 + }, + "productCode": "UPN242544", + "productDetails": { + "skuTitle": "Standard D4s v3", + "productFamily": "Azure", + "productType": "Virtual Machines Dv2 Series", + "serviceFamily": "Compute", + "publisherType": "Microsoft" + } + } + }, + { + "id": "/subscriptions/30000000-0000-0000-0000-000000000000/resourceGroups/benefits-rg/providers/Microsoft.BillingBenefits/maccs/macc-20250101-001/transactions/txn-macc-002", + "name": "txn-macc-002", + "type": "Microsoft.BillingBenefits/maccs/transactions", + "properties": { + "date": "2025-07-16T10:15:00Z", + "chargeType": "Usage", + "billingStatus": "Closed", + "invoiceResourceId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000/billingProfiles/ABCD-1234-5678-9012/invoices/INV20250001", + "amountInBillingCurrency": { + "currencyCode": "USD", + "amount": 225.0 + }, + "amountInPricingCurrency": { + "currencyCode": "USD", + "amount": 225.0 + }, + "productCode": "UPN242546", + "productDetails": { + "skuTitle": "Standard Firewall", + "productFamily": "Azure", + "productType": "Azure Firewall", + "serviceFamily": "Networking", + "publisherType": "Microsoft" + } + } + } + ] + } + } + }, + "operationId": "MaccTransactions_ListByParent", + "title": "MaccTransactionsList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccUnsuppressAutomaticShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccUnsuppressAutomaticShortfall.json new file mode 100644 index 000000000000..bfb942b09d57 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccUnsuppressAutomaticShortfall.json @@ -0,0 +1,72 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "automaticShortfallSuppressReason": null, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "PendingSettlement", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccUnsuppressAutomaticShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancel.json new file mode 100644 index 000000000000..8961b51bc992 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancel.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "Canceled", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancelWithMilestones.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancelWithMilestones.json new file mode 100644 index 000000000000..c904ccc6de57 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCancelWithMilestones.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "Canceled", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCancelWithMilestones" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreate.json new file mode 100644 index 000000000000..e38e85ec79e5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreate.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateBackfilledMacc.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateBackfilledMacc.json new file mode 100644 index 000000000000..49a9fea65840 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateBackfilledMacc.json @@ -0,0 +1,32 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateBackfilledMacc" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateContributor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateContributor.json new file mode 100644 index 000000000000..059dca6605e0 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateContributor.json @@ -0,0 +1,35 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateContributor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMilestonesOnExistingMacc.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMilestonesOnExistingMacc.json new file mode 100644 index 000000000000..87614c1dee0d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMilestonesOnExistingMacc.json @@ -0,0 +1,54 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 7000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z" + }, + { + "commitment": { + "amount": 13000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateMilestonesOnExistingMacc" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMultiEntity.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMultiEntity.json new file mode 100644 index 000000000000..fd83b8d5093d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateMultiEntity.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + }, + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Contributor", + "primaryResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + }, + { + "reason": "Error message", + "reasonCode": "ErrorCode", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": false + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateMultiEntity" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateNewMaccWithMilestone.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateNewMaccWithMilestone.json new file mode 100644 index 000000000000..48d3d732199b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateCreateNewMaccWithMilestone.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2026-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 5000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-07-31T23:59:59Z" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "startAt": "2023-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateCreateNewMaccWithMilestone" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdate.json new file mode 100644 index 000000000000..6b62c9f75df1 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdate.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Test MACC Benefit", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-07-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-07-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitment.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitment.json new file mode 100644 index 000000000000..97146fa060f6 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitment.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateCommitment" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitmentEndAtContributorRule.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitmentEndAtContributorRule.json new file mode 100644 index 000000000000..37fbcd400e1c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateCommitmentEndAtContributorRule.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateCommitmentEndAtContributorRule" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributor.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributor.json new file mode 100644 index 000000000000..c5420b5af100 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributor.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Test MACC Benefit", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Contributor", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateContributor" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributorRule.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributorRule.json new file mode 100644 index 000000000000..cf82f97bb96e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateContributorRule.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateContributorRule" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateDisplayName.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateDisplayName.json new file mode 100644 index 000000000000..beddfea93942 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateDisplayName.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "displayName": "Updated Macc Name", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateDisplayName" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateEndAt.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateEndAt.json new file mode 100644 index 000000000000..341fd228d8ab --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateEndAt.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateEndAt" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneCommitment.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneCommitment.json new file mode 100644 index 000000000000..6ed24e3daf3d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneCommitment.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 40000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMaccAndMilestoneCommitment" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneEndDate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneEndDate.json new file mode 100644 index 000000000000..f63db5b2ba9e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMaccAndMilestoneEndDate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "endAt": "2027-11-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2029-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMaccAndMilestoneEndDate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneCommitment.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneCommitment.json new file mode 100644 index 000000000000..bb0e8522a042 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneCommitment.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 50000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 20000, + "currencyCode": "USD" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "commitment": { + "amount": 40000, + "currencyCode": "USD" + }, + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMilestoneCommitment" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneEndDate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneEndDate.json new file mode 100644 index 000000000000..3a159e98e684 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateMilestoneEndDate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "endAt": "2030-07-31T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "endAt": "2027-11-30T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111" + }, + { + "endAt": "2029-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222" + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateMilestoneEndDate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateRemoveMilestones.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateRemoveMilestones.json new file mode 100644 index 000000000000..239ceda38c18 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateRemoveMilestones.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Removed" + }, + { + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Removed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateRemoveMilestones" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfall.json new file mode 100644 index 000000000000..229a9363cd8a --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfall.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequest", + "message": "Customer requested to suppress automatic shortfall" + }, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateSuppressShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfallOnMilestone.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfallOnMilestone.json new file mode 100644 index 000000000000..c9153508537f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateSuppressShortfallOnMilestone.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "automaticShortfallSuppressReason": { + "code": "CustomerRequest", + "message": "Customer requested to suppress automatic shortfall" + }, + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateSuppressShortfallOnMilestone" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfall.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfall.json new file mode 100644 index 000000000000..359f2f19a373 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfall.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/benefits/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateUnsuppressShortfall" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfallOnMilestone.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfallOnMilestone.json new file mode 100644 index 000000000000..2512c808d729 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateUpdateUnsuppressShortfallOnMilestone.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "milestoneId": "11111111-1111-1111-1111-111111111111" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateUpdateUnsuppressShortfallOnMilestone" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateWriteOffWithMilestones.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateWriteOffWithMilestones.json new file mode 100644 index 000000000000..15b6436a392e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccValidateWriteOffWithMilestones.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "MACC", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "entityType": "Primary", + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "status": "PendingSettlement", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/maccs/myBenefit", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccValidateWriteOffWithMilestones" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesAndShortfallGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesAndShortfallGet.json new file mode 100644 index 000000000000..1988a1388462 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesAndShortfallGet.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": { + "balanceVersion": 1, + "charge": { + "amount": 2000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2027-07-01T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2026-07-01T00:00:00Z", + "systemId": "lotId" + }, + "status": "ShortfallCharged" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": { + "balanceVersion": 3, + "charge": { + "amount": 5000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2029-07-31T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2028-07-01T00:00:00Z", + "systemId": "shortfall98765432" + }, + "startAt": "2025-05-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithMilestonesAndShortfall_Get" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCancel.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCancel.json new file mode 100644 index 000000000000..e933cada1968 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCancel.json @@ -0,0 +1,87 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Canceled" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Canceled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Canceled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Cancel", + "title": "MaccWithMilestones_Cancel" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCreate.json new file mode 100644 index 000000000000..b6f711d6c531 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesCreate.json @@ -0,0 +1,190 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "allowContributors": true, + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2025-05-01T00:00:00Z", + "systemId": "13810867107109237" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Scheduled" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Scheduled", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Active" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Pending", + "startAt": "2025-05-01T00:00:00Z", + "status": "Pending", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Create", + "title": "MaccWithMilestones_Create" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesGet.json new file mode 100644 index 000000000000..652182e39b09 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesGet.json @@ -0,0 +1,82 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithMilestones_Get" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesUpdateLastMilestoneEndDate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesUpdateLastMilestoneEndDate.json new file mode 100644 index 000000000000..4f8bd44158b6 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesUpdateLastMilestoneEndDate.json @@ -0,0 +1,107 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "33333333-3333-3333-3333-333333333333" + } + ] + } + }, + "maccName": "macc_20250614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20250614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20250614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 30000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20250614", + "endAt": "2026-04-30T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-01-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Completed" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-02-28T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Completed" + }, + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-03-31T23:59:59Z", + "milestoneId": "33333333-3333-3333-3333-333333333333", + "status": "Completed" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-11-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109238", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2025-06-14T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2026-03-01T02:15:30.2080047Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MaccWithMilestonesUpdateLastMilestoneEndDate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesWriteOff.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesWriteOff.json new file mode 100644 index 000000000000..b7881df957b5 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithMilestonesWriteOff.json @@ -0,0 +1,90 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2026-07-01T00:00:00Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2024-10-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Completed" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2025-01-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "PendingSettlement" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": null, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallWaived", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_WriteOff", + "title": "MaccWithMilestones_WriteOff" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithShortfallGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithShortfallGet.json new file mode 100644 index 000000000000..6e09c4c885ab --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWithShortfallGet.json @@ -0,0 +1,70 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc_20230614", + "endAt": "2024-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Canceled", + "shortfall": { + "balanceVersion": 2, + "charge": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2025-09-30T23:59:59Z", + "productCode": "000278da-0000-0160-330f-a0b98cdbbdc4", + "resourceId": "/subscriptions/27507203-b094-420a-a716-b6fda046e1c2/resourceGroups/testcredit/providers/Microsoft.BillingBenefits/credits/taco0647052025", + "startAt": "2024-09-01T00:00:00Z", + "systemId": "shortfall12345678" + }, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallCharged", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + } + }, + "operationId": "Maccs_Get", + "title": "MaccWithShortfall_Get" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWriteOff.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWriteOff.json new file mode 100644 index 000000000000..7a049cf029c8 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccWriteOff.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Disabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "shortfall": null, + "startAt": "2023-07-01T00:00:00Z", + "status": "ShortfallWaived", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_WriteOff", + "title": "Macc_WriteOff" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListByResourceGroup.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListByResourceGroup.json new file mode 100644 index 000000000000..1926d9a9853e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListByResourceGroup.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListByResourceGroup", + "title": "Maccs_ListByResourceGroup" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListBySubscription.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListBySubscription.json new file mode 100644 index 000000000000..19e9f4705436 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsListBySubscription.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2024-07-01T00:00:00Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2023-07-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListBySubscription", + "title": "Maccs_ListBySubscription" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsValidateCreate.json new file mode 100644 index 000000000000..81656cc49c64 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsValidateCreate.json @@ -0,0 +1,40 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "Maccs", + "properties": { + "allowContributors": true, + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 10000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "Test MACC Benefit", + "endAt": "2028-07-31T23:59:59Z", + "entityType": "Primary", + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "startAt": "2026-07-01T00:00:00Z", + "systemId": null + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "MaccsValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListByResourceGroup.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListByResourceGroup.json new file mode 100644 index 000000000000..6056f8ea14eb --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListByResourceGroup.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListByResourceGroup", + "title": "MaccsWithMilestones_ListByResourceGroup" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListBySubscription.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListBySubscription.json new file mode 100644 index 000000000000..e5a69359de09 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MaccsWithMilestonesListBySubscription.json @@ -0,0 +1,84 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "shortfall": null, + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "shortfall": null, + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237", + "consumed": { + "currencyCode": "USD", + "amount": 1250.5 + }, + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "appliedScopeType": "BillingAccount" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + ] + } + } + }, + "operationId": "Maccs_ListBySubscription", + "title": "MaccsWithMilestones_ListBySubscription" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesCreateOnExistingMacc.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesCreateOnExistingMacc.json new file mode 100644 index 000000000000..984ead80ceee --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesCreateOnExistingMacc.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z" + }, + { + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [ + { + "automaticShortfall": "Enabled", + "commitment": { + "amount": 10000, + "currencyCode": "USD" + }, + "endAt": "2026-05-31T23:59:59Z", + "milestoneId": "11111111-1111-1111-1111-111111111111", + "status": "Active" + }, + { + "automaticShortfall": "Disabled", + "commitment": { + "amount": 15000, + "currencyCode": "USD" + }, + "endAt": "2027-05-31T23:59:59Z", + "milestoneId": "22222222-2222-2222-2222-222222222222", + "status": "Scheduled" + } + ], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MilestonesCreate_OnExistingMacc" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesRemoveFromMacc.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesRemoveFromMacc.json new file mode 100644 index 000000000000..d936b4d8913b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/MilestonesRemoveFromMacc.json @@ -0,0 +1,75 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "milestones": [ + { + "milestoneId": "12000000-0000-0000-0000-000000000000", + "status": "Removed" + }, + { + "milestoneId": "13000000-0000-0000-0000-000000000001", + "status": "Removed" + } + ] + } + }, + "maccName": "macc_20230614", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "10000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "macc_20230614", + "type": "Microsoft.BillingBenefits/maccs", + "id": "/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/maccs/macc_20230614", + "location": "global", + "properties": { + "allowContributors": true, + "automaticShortfall": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "commitment": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "displayName": "macc 20230614", + "endAt": "2028-05-01T23:59:59Z", + "entityType": "Primary", + "milestones": [], + "productCode": "0001d726-0000-0160-330f-a0b98cdbbdc4", + "productDetails": { + "skuTitle": "Azure Benefit Product", + "productFamily": "Azure", + "productType": "Benefit" + }, + "provisioningState": "Succeeded", + "startAt": "2025-05-01T00:00:00Z", + "status": "Active", + "systemId": "13810867107109237" + }, + "systemData": { + "createdAt": "2023-02-01T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-02-01T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Location": "https://management.azure.com/subscriptions/{primaryCloudSubId}/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "Maccs_Update", + "title": "MilestonesRemove_FromMacc" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/OperationsGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/OperationsGet.json new file mode 100644 index 000000000000..2fdf9b6b4e06 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/OperationsGet.json @@ -0,0 +1,114 @@ +{ + "parameters": { + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "Microsoft.BillingBenefits/savingsPlanOrderAliases/read", + "display": { + "description": "Read all savings plan order aliases", + "operation": "Get Savings plan order alias", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrderAliases" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrderAliases/write", + "display": { + "description": "Create a Savings plan order alias", + "operation": "Create SavingsPlanOrderAliases", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrderAliases" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/read", + "display": { + "description": "Read all savings plan orders", + "operation": "Get Savings plan orders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/write", + "display": { + "description": "Patch a Savings plan order", + "operation": "Patch SavingsPlanOrders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/action", + "display": { + "description": "Update a Savings plan order", + "operation": "Update SavingsPlanOrders", + "provider": "Microsoft Benefits", + "resource": "SavingsPlanOrders" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans/read", + "display": { + "description": "Read All SavingsPlans", + "operation": "Get SavingsPlans", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans/write", + "display": { + "description": "Patch an existing Savings plan", + "operation": "Patch SavingsPlans", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/register/action", + "display": { + "description": "Registers the Benefits resource provider and enables the creation of Benefits resources.", + "operation": "Registers the Benefits Resource Provider.", + "provider": "Microsoft Benefits", + "resource": "SavingsPlans" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/read", + "display": { + "description": "Get a conditional credit", + "operation": "Get Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/write", + "display": { + "description": "Create or update a conditional credit", + "operation": "Create or Update Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + }, + { + "name": "Microsoft.BillingBenefits/conditionalCredits/delete", + "display": { + "description": "Delete a conditional credit", + "operation": "Delete Conditional Credit", + "provider": "Microsoft.BillingBenefits", + "resource": "Conditional Credits" + } + } + ] + } + } + }, + "operationId": "Operations_List", + "title": "OperationsGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/PromotionalCreditCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/PromotionalCreditCreate.json new file mode 100644 index 000000000000..0a9fa9fd2a53 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/PromotionalCreditCreate.json @@ -0,0 +1,124 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "global", + "properties": { + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "0002d726-0000-0160-330f-a0b98cdbbdc4", + "displayName": "Promotional Credit" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "creditName": "credit_20231212", + "resourceGroupName": "resource_group_name_01", + "subscriptionId": "97ee05f2-07d5-494d-908c-081a197f4277" + }, + "responses": { + "200": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "18eb6fdd-37c1-479b-b9be-550dbc461842", + "displayName": "Promotional Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2023-12-12T00:00:00Z", + "status": "Succeeded", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + } + }, + "201": { + "body": { + "name": "credit_20231212", + "type": "Microsoft.BillingBenefits/credits", + "id": "/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/credits/credit_20231212", + "location": "global", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}", + "billingProfileResourceId": "/providers/Microsoft.Billing/billingAccounts/{acctId:orgId}/billingProfiles/{billingProfileId}", + "credit": { + "amount": 20000, + "currencyCode": "USD", + "grain": "FullTerm" + }, + "endAt": "2024-01-12T00:00:00Z", + "policies": { + "expiration": "SuspendBillingProfile", + "redemption": "AutoRedeem" + }, + "productCode": "18eb6fdd-37c1-479b-b9be-550dbc461842", + "displayName": "Promotional Credit", + "productDetails": { + "skuTitle": "Azure Credit - Standard", + "productFamily": "Azure", + "productType": "Benefit", + "appliedOn": [ + "Consumption" + ], + "appliedPrice": "marketPrice" + }, + "startAt": "2023-12-12T00:00:00Z", + "status": "Pending", + "systemId": "CR-20250901-00000001" + }, + "systemData": { + "createdAt": "2023-12-12T01:01:01.1075056Z", + "createdByType": "User", + "lastModifiedAt": "2023-12-12T01:01:01.1075056Z", + "lastModifiedByType": "User" + }, + "tags": { + "key1": "value1", + "key2": "value2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Location": "https://management.azure.com/subscriptions/97ee05f2-07d5-494d-908c-081a197f4277/resourceGroups/resource_group_name_01/providers/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2024-03-01-preview", + "Retry-After": 5 + } + } + }, + "operationId": "Credits_Create", + "title": "PromotionalCreditCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreate.json new file mode 100644 index 000000000000..a7293cfbacfa --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreate.json @@ -0,0 +1,99 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "quantity": 5, + "renew": true, + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + }, + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + }, + "201": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-06-02-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "ReservationOrderAlias_Create", + "title": "ReservationOrderAliasCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreateWithRenewProperties.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreateWithRenewProperties.json new file mode 100644 index 000000000000..76100b94d1a6 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasCreateWithRenewProperties.json @@ -0,0 +1,102 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + }, + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + } + }, + "201": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1M", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_B2ats_v2" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2026-06-01", + "Retry-After": 5 + } + } + }, + "operationId": "ReservationOrderAlias_Create", + "title": "ReservationOrderAliasCreateWithRenewProperties" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGet.json new file mode 100644 index 000000000000..343b140b3f6b --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGet.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Created", + "quantity": 5, + "renew": true, + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + } + }, + "operationId": "ReservationOrderAlias_Get", + "title": "ReservationOrderAliasGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGetWithRenewProperties.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGetWithRenewProperties.json new file mode 100644 index 000000000000..508eb94d8d2e --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/ReservationOrderAliasGetWithRenewProperties.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "reservationOrderAliasName": "reservationOrderAlias123" + }, + "responses": { + "200": { + "body": { + "name": "reservationOrderAlias123", + "type": "Microsoft.BillingBenefits/reservationOrderAliases", + "id": "/providers/microsoft.billingbenefits/reservationOrderAliases/reservationOrderAlias123", + "location": "eastus", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "displayName": "ReservationOrder_2022-06-02", + "provisioningState": "Succeeded", + "quantity": 5, + "renew": true, + "renewAction": "RenewExisting", + "renewalPurchaseDateTime": "2025-06-15T10:30:00Z", + "reservationOrderId": "/providers/Microsoft.Capacity/reservationOrders/30000000-0000-0000-0000-000000000000", + "reservedResourceProperties": { + "instanceFlexibility": "On" + }, + "reservedResourceType": "VirtualMachines", + "term": "P1Y", + "benefitStartTime": "2023-01-15T00:00:00Z" + }, + "sku": { + "name": "Standard_M64s_v2" + } + } + } + }, + "operationId": "ReservationOrderAlias_Get", + "title": "ReservationOrderAliasGetWithRenewProperties" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreate.json new file mode 100644 index 000000000000..c844785b9059 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreate.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-28", + "displayName": "Validation Test SSCACO", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T23:59:59Z", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json new file mode 100644 index 000000000000..9259db612476 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleInvalidOverlap.json @@ -0,0 +1,115 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 1", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "SS CACO 2", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 3", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + }, + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + }, + { + "valid": false, + "reason": "One or more SSCACO overlap with the same product code.", + "reasonCode": "OverlappingSSCACO" + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreateMultipleInvalidOverlap" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleValidOverlap.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleValidOverlap.json new file mode 100644 index 000000000000..84722adf4ac7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateCreateMultipleValidOverlap.json @@ -0,0 +1,109 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 1", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + } + ], + "productCode": "000187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Enabled", + "displayName": "SS CACO 2", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 500000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 2000000, + "currencyCode": "USD" + } + } + ], + "productCode": "100187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + }, + { + "benefitType": "ConditionalCredits", + "properties": { + "allowContributors": "Disabled", + "displayName": "SS CACO 3", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 7500, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-03-31T00:00:00Z", + "spendTarget": { + "amount": 75000, + "currencyCode": "USD" + } + } + ], + "productCode": "200187f7-0000-0260-ab43-b8473ce57f1d", + "startAt": "2026-01-01T00:00:00Z" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateCreateMultipleValidOverlap" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateUpdate.json new file mode 100644 index 000000000000..6bdbe196b783 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SSCacoFlexibleValidateUpdate.json @@ -0,0 +1,67 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "ConditionalCredits", + "properties": { + "billingAccountResourceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:11111111-1111-1111-1111-111111111111_2025-10-2", + "displayName": "Validation Test Update SSCACO - update endAt", + "entityType": "Primary", + "milestones": [ + { + "name": "Milestone 1", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-04-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440001", + "spendTarget": { + "amount": 50000, + "currencyCode": "USD" + } + }, + { + "name": "Milestone 2", + "award": { + "credit": { + "amount": 5000, + "currencyCode": "USD" + }, + "duration": "P3M" + }, + "endAt": "2026-04-30T23:59:59Z", + "milestoneId": "550e8400-e29b-41d4-a716-446655440002", + "spendTarget": { + "amount": 100000, + "currencyCode": "USD" + } + } + ], + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/SSCACO1", + "systemId": "13810867107109237" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.BillingBenefits/conditionalCredits/SSCACO1", + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SSCacoFlexibleValidateUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemExpandedGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemExpandedGet.json new file mode 100644 index 000000000000..4e6b278855ab --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemExpandedGet.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "$expand": "renewProperties", + "api-version": "2026-06-01", + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeType": "Shared", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-21T18:15:42.4098626Z", + "expiryDateTime": "2025-10-18T21:16:13.1854959Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-18T21:14:26.8279361Z", + "renew": true, + "renewProperties": { + "purchaseProperties": { + "properties": { + "appliedScopeType": "Shared", + "billingPlan": "Upfront", + "billingScopeId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2_renewed", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Shared", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 84, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 83.87, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlan_Get", + "title": "SavingsPlanItemWithExpandedRenewPropertiesGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemGet.json new file mode 100644 index 000000000000..638f42a0bd14 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanItemGet.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeType": "Shared", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_patch_rename2", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-21T18:15:42.4098626Z", + "expiryDateTime": "2025-10-18T21:16:13.1854959Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-18T21:14:26.8279361Z", + "renew": true, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Shared", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 84, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 83.87, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlan_Get", + "title": "SavingsPlanItemGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreate.json new file mode 100644 index 000000000000..6226eeb42194 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreate.json @@ -0,0 +1,84 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "201": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": null, + "appliedScopeType": "Shared", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "SavingsPlanOrderAlias_Create", + "title": "SavingsPlanOrderAliasCreate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreateSingleScope.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreateSingleScope.json new file mode 100644 index 000000000000..c9ac0a2650de --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasCreateSingleScope.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "201": { + "body": { + "name": "SavingsPlan_1667000324595", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595", + "kind": null, + "properties": { + "appliedScopeProperties": { + "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023", + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview", + "Retry-After": 5 + } + } + }, + "operationId": "SavingsPlanOrderAlias_Create", + "title": "SavingsPlanOrderAliasCreateSingleScope" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasGet.json new file mode 100644 index 000000000000..d6605615c5c7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderAliasGet.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderAliasName": "spAlias123" + }, + "responses": { + "200": { + "body": { + "name": "spAlias123", + "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/spAlias123", + "kind": null, + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "provisioningState": "Created", + "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000000", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrderAlias_Get", + "title": "SavingsPlanOrderAliasGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderElevate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderElevate.json new file mode 100644 index 000000000000..3a9374b15afa --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderElevate.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "70000000-0000-0000-0000-000000000005", + "id": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009/providers/Microsoft.Authorization/roleAssignments/70000000-0000-0000-0000-000000000005", + "properties": { + "principalId": "50000000-0000-0000-0000-000000000000", + "roleDefinitionId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009/providers/Microsoft.Authorization/roleDefinitions/30000000-0000-0000-0000-000000000008", + "scope": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000009" + } + } + } + }, + "operationId": "SavingsPlanOrder_Elevate", + "title": "SavingsPlanOrderElevate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderExpandedGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderExpandedGet.json new file mode 100644 index 000000000000..f3c0c474530d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderExpandedGet.json @@ -0,0 +1,337 @@ +{ + "parameters": { + "$expand": "schedule", + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000003", + "displayName": "Compute_SavingsPlan_10-19-2022_11-01", + "expiryDateTime": "2025-10-19T18:03:55.2519794Z", + "planInformation": { + "nextPaymentDueDate": "2022-11-19", + "pricingCurrencyTotal": { + "amount": 26.28, + "currencyCode": "USD" + }, + "startDate": "2022-10-19", + "transactions": [ + { + "billingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "dueDate": "2022-10-19", + "paymentDate": "2022-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Completed" + }, + { + "dueDate": "2022-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2022-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2023-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-10-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-11-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2024-12-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-01-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-02-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-03-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-04-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-05-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-06-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-07-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-08-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + }, + { + "dueDate": "2025-09-19", + "pricingCurrencyTotal": { + "amount": 0.73, + "currencyCode": "USD" + }, + "status": "Scheduled" + } + ] + }, + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrder_Get", + "title": "SavingsPlanOrderWithExpandedPaymentsGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderGet.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderGet.json new file mode 100644 index 000000000000..0ace1e745da7 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderGet.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "20000000-0000-0000-0000-000000000005", + "displayName": "Compute_SavingsPlan_10-19-2022_11-01", + "expiryDateTime": "2025-10-19T18:03:55.2519794Z", + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + }, + "operationId": "SavingsPlanOrder_Get", + "title": "SavingsPlanOrderGet" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderList.json new file mode 100644 index 000000000000..cdf91f005ba0 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanOrderList.json @@ -0,0 +1,36 @@ +{ + "parameters": { + "api-version": "2026-06-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders", + "id": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000", + "properties": { + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000004:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000004:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "20000000-0000-0000-0000-000000000005", + "displayName": "Compute_SavingsPlan_10-28-2022_16-38", + "expiryDateTime": "2025-10-28T23:40:30.6028303Z", + "provisioningState": "Succeeded", + "savingsPlans": [ + "/providers/Microsoft.BillingBenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/20000000-0000-0000-0000-000000000001" + ], + "term": "P3Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlanOrder_List", + "title": "SavingsPlanOrderList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanUpdate.json new file mode 100644 index 000000000000..651bb6e9359c --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanUpdate.json @@ -0,0 +1,113 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "displayName": "TestDisplayName", + "renew": true, + "renewProperties": { + "purchaseProperties": { + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingPlan": "P1M", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "TestDisplayName_renewed", + "renew": false, + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + } + } + }, + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "name": "30000000-0000-0000-0000-000000000000", + "type": "microsoft.billingbenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "displayName": "Azure subscription 1", + "subscriptionId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "benefitStartTime": "2022-10-27T00:34:33.6697600Z", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingPlan": "P1M", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "riName", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-11-10T00:12:54.549373Z", + "expiryDateTime": "2025-10-27T00:34:33.6697600Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-27T00:32:45.5823486Z", + "renew": true, + "term": "P3Y", + "userFriendlyAppliedScopeType": "Single", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 37, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 53.85, + "valueUnit": "percentage" + } + ], + "trend": "DOWN" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + }, + "202": { + "description": "The request is completed.", + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/locations/eastus/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-07-01" + } + }, + "404": {} + }, + "operationId": "SavingsPlan_Update", + "title": "SavingsPlanUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidatePurchase.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidatePurchase.json new file mode 100644 index 000000000000..5bfd8038021d --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidatePurchase.json @@ -0,0 +1,69 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "SavingsPlan", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + }, + { + "benefitType": "SavingsPlan", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/RG", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 20, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2021-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "reason": "Your provider has not enabled Savings Plan purchase on this subscription.", + "reasonCode": "CustomerCannotPurchaseSavingsPlan", + "valid": false + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SavingsPlanValidatePurchase" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidateUpdate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidateUpdate.json new file mode 100644 index 000000000000..15ecfa239a7f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlanValidateUpdate.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "appliedScopeProperties": { + "managementGroupId": "/providers/Microsoft.Management/managementGroups/30000000-0000-0000-0000-000000000100", + "tenantId": "30000000-0000-0000-0000-000000000100", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "ManagementGroup" + }, + { + "appliedScopeProperties": { + "managementGroupId": "/providers/Microsoft.Management/managementGroups/MockMG", + "tenantId": "30000000-0000-0000-0000-000000000100", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "ManagementGroup" + } + ] + }, + "savingsPlanId": "30000000-0000-0000-0000-000000000000", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + }, + { + "valid": true + } + ] + } + } + }, + "operationId": "SavingsPlan_ValidateUpdate", + "title": "SavingsPlanValidateUpdate" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansInOrderList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansInOrderList.json new file mode 100644 index 000000000000..ee2428047144 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansInOrderList.json @@ -0,0 +1,71 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "savingsPlanOrderId": "20000000-0000-0000-0000-000000000000" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/eef82110-c91b-4395-9420-fcfcbefc5a47/resourcegroups/3ppRG", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.002, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-24-2022_15-44", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-24T22:47:04.8539493Z", + "expiryDateTime": "2023-10-24T22:47:04.6196635Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-24T22:45:13.6202486Z", + "renew": false, + "term": "P1Y", + "userFriendlyAppliedScopeType": "ResourceGroup", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 0, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlan_List", + "title": "SavingsPlansInOrderList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansList.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansList.json new file mode 100644 index 000000000000..b43dac758169 --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansList.json @@ -0,0 +1,92 @@ +{ + "parameters": { + "$filter": "(properties%2farchived+eq+false)", + "$orderby": "properties/displayName asc", + "$skiptoken": "50", + "api-version": "2026-06-01", + "refreshsummary": "true", + "take": "1" + }, + "responses": { + "200": { + "body": { + "additionalProperties": [ + { + "name": "summary", + "value": { + "cancelledCount": 0, + "expiredCount": 0, + "expiringCount": 0, + "failedCount": 0, + "noBenefitCount": 0, + "pendingCount": 0, + "processingCount": 0, + "succeededCount": 1, + "warningCount": 0 + } + } + ], + "value": [ + { + "name": "20000000-0000-0000-0000-000000000000/30000000-0000-0000-0000-000000000000", + "type": "Microsoft.BillingBenefits/savingsPlanOrders/savingsPlans", + "id": "/providers/microsoft.billingbenefits/savingsPlanOrders/20000000-0000-0000-0000-000000000000/savingsPlans/30000000-0000-0000-0000-000000000000", + "properties": { + "appliedScopeProperties": { + "displayName": "Azure subscription 1", + "subscriptionId": "/subscriptions/20000000-0000-0000-0000-000000000005", + "benefitFilter": "clusterId/2025 H2CPU" + }, + "appliedScopeType": "Single", + "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31", + "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000000:20000000-0000-3000-0000-000000000000_2019-05-31/billingProfiles/KPSV-DWNE-BG7-TGB", + "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/20000000-1000-0000-0000-000000000009", + "commitment": { + "amount": 0.001, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "Compute_SavingsPlan_10-19-2022_11-03", + "displayProvisioningState": "Succeeded", + "effectiveDateTime": "2022-10-19T18:05:37.1034288Z", + "expiryDateTime": "2023-10-19T18:05:36.5252231Z", + "provisioningState": "Succeeded", + "purchaseDateTime": "2022-10-19T18:03:56.4032132Z", + "renew": false, + "term": "P1Y", + "userFriendlyAppliedScopeType": "Single", + "utilization": { + "aggregates": [ + { + "grain": 1, + "grainUnit": "days", + "value": 100, + "valueUnit": "percentage" + }, + { + "grain": 7, + "grainUnit": "days", + "value": 78, + "valueUnit": "percentage" + }, + { + "grain": 30, + "grainUnit": "days", + "value": 78.12, + "valueUnit": "percentage" + } + ], + "trend": "" + } + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + } + }, + "operationId": "SavingsPlan_ListAll", + "title": "SavingsPlansList" +} diff --git a/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansValidateCreate.json b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansValidateCreate.json new file mode 100644 index 000000000000..5cd28fef223f --- /dev/null +++ b/specification/billingbenefits/resource-manager/Microsoft.BillingBenefits/stable/2026-06-01/examples/SavingsPlansValidateCreate.json @@ -0,0 +1,42 @@ +{ + "parameters": { + "api-version": "2026-06-01", + "body": { + "benefits": [ + { + "benefitType": "SavingsPlans", + "properties": { + "appliedScopeProperties": { + "resourceGroupId": "/subscriptions/10000000-0000-0000-0000-000000000000/resourceGroups/testrg" + }, + "appliedScopeType": "Single", + "billingScopeId": "/subscriptions/10000000-0000-0000-0000-000000000000", + "commitment": { + "amount": 15.23, + "currencyCode": "USD", + "grain": "Hourly" + }, + "displayName": "ComputeSavingsPlan_2026-07-01", + "term": "P1Y" + }, + "sku": { + "name": "Compute_Savings_Plan" + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "benefits": [ + { + "valid": true + } + ] + } + } + }, + "operationId": "Benefit_Validate", + "title": "SavingsPlansValidateCreate" +} diff --git a/specification/billingbenefits/resource-manager/readme.md b/specification/billingbenefits/resource-manager/readme.md index 74ee2c61902d..e5041bf6e3ea 100644 --- a/specification/billingbenefits/resource-manager/readme.md +++ b/specification/billingbenefits/resource-manager/readme.md @@ -27,7 +27,7 @@ These are the global settings for the billingbenefits. ```yaml openapi-type: arm openapi-subtype: providerHub -tag: package-preview-2025-12-01-preview +tag: package-2026-06-01 ``` ### Suppression @@ -107,6 +107,15 @@ directive: where: $.paths["/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/conditionalCredits/{conditionalCreditName}"].patch.parameters[4]["schema"] ``` +### Tag: package-2026-06-01 + +These settings apply only when `--tag=package-2026-06-01` is specified on the command line. + +```yaml $(tag) == 'package-2026-06-01' +input-file: + - Microsoft.BillingBenefits/stable/2026-06-01/billingbenefits.json +``` + ### Tag: package-preview-2025-12-01-preview These settings apply only when `--tag=package-preview-2025-12-01-preview` is specified on the command line. From 80236ac07af641d2449c37a24b090535cd666560 Mon Sep 17 00:00:00 2001 From: rishchou Date: Wed, 1 Jul 2026 11:44:45 -0700 Subject: [PATCH 2/4] Restore C#/Python client customizations in client.tsp to avoid SDK breaking changes Reverts the accidental removal of csharp @@clientName/@@alternateType/@@usage decorators and python client-name/enum mitigations, and restores the !csharp scope in back-compatible.tsp. Keeps the shipped SDK surface stable for Azure.ResourceManager.BillingBenefits (C#) and azure-mgmt-billingbenefits (Python). Addresses review feedback from @msyyc. --- .../back-compatible.tsp | 2 +- .../BillingBenefits.Management/client.tsp | 313 ++++++++++++++++-- 2 files changed, 293 insertions(+), 22 deletions(-) diff --git a/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp b/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp index 10cc65a544a0..0af15f58b700 100644 --- a/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/back-compatible.tsp @@ -5,7 +5,7 @@ using Microsoft.BillingBenefits; // @@clientLocation and @@clientName decorators for operations that originally had @operationId // All @operationId decorators have been removed and replaced with these client customizations -@@clientLocation(SavingsPlanOperationGroup.listAll, "SavingsPlan"); +@@clientLocation(SavingsPlanOperationGroup.listAll, "SavingsPlan", "!csharp"); @@clientLocation(DiscountsOperationGroup.scopeList, Discounts); @@clientLocation(ReservationOrderAliasResponses.get, "ReservationOrderAlias"); diff --git a/specification/billingbenefits/BillingBenefits.Management/client.tsp b/specification/billingbenefits/BillingBenefits.Management/client.tsp index 30b3c972ffa9..d375fd05663e 100644 --- a/specification/billingbenefits/BillingBenefits.Management/client.tsp +++ b/specification/billingbenefits/BillingBenefits.Management/client.tsp @@ -4,46 +4,317 @@ import "@azure-tools/typespec-client-generator-core"; using Azure.ClientGenerator.Core; using Microsoft.BillingBenefits; -// go -@@clientLocation(BenefitOperationGroup.validate, "RP", "go"); -@@clientName(Microsoft.BillingBenefits.ResourceSku, "SKU", "go"); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentity, "ServiceManagedIdentity", - "go" + "go,java,python,javascript" ); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentityType, "ServiceManagedIdentityType", - "go" + "go,java,python,javascript" ); +// go +@@clientLocation(BenefitOperationGroup.validate, "RP", "go"); + // java @@clientLocation(BenefitOperationGroup.validate, "ResourceProviders", "java"); + +// csharp @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentity, - "ServiceManagedIdentity", - "java" + "BillingBenefitsManagedServiceIdentity", + "csharp" ); @@clientName( Microsoft.BillingBenefits.ManagedServiceIdentityType, - "ServiceManagedIdentityType", - "java" + "BillingBenefitsManagedServiceIdentityType", + "csharp" +); +@@clientName( + ReservationOrderAliasResponse, + "BillingBenefitsReservationOrderAlias", + "csharp" +); +@@clientName( + AppliedScopeProperties, + "BillingBenefitsAppliedScopeProperties", + "csharp" +); +@@clientName(AppliedScopeType, "BillingBenefitsAppliedScopeType", "csharp"); +@@clientName(BillingPlan, "BillingBenefitsBillingPlan", "csharp"); +@@clientName(ProvisioningState, "BillingBenefitsProvisioningState", "csharp"); +@@clientName( + InstanceFlexibility, + "BillingBenefitsInstanceFlexibility", + "csharp" +); +@@clientName( + ReservedResourceType, + "BillingBenefitsReservedResourceType", + "csharp" +); +@@clientName(Term, "BillingBenefitsTerm", "csharp"); +@@clientName(SavingsPlanModel, "BillingBenefitsSavingsPlan", "csharp"); +@@clientName(Commitment, "BillingBenefitsCommitment", "csharp"); +@@clientName(CommitmentGrain, "BillingBenefitsCommitmentGrain", "csharp"); +@@clientName(ExtendedStatusInfo, "BillingBenefitsExtendedStatusInfo", "csharp"); +@@clientName(Utilization, "BillingBenefitsSavingsPlanUtilization", "csharp"); +@@clientName( + UtilizationAggregates, + "BillingBenefitsSavingsPlanUtilizationAggregate", + "csharp" +); +@@clientName(PurchaseRequest, "BillingBenefitsPurchaseContent", "csharp"); +@@clientName( + SavingsPlanValidResponseProperty, + "SavingsPlanValidateResult", + "csharp" +); +@@clientName( + SavingsPlanOrderAliasModel, + "BillingBenefitsSavingsPlanOrderAlias", + "csharp" +); +@@clientName( + SavingsPlanOrderModel, + "BillingBenefitsSavingsPlanOrder", + "csharp" +); +@@clientName( + RoleAssignmentEntity, + "BillingBenefitsRoleAssignmentEntity", + "csharp" +); +@@clientName(Price, "BillingBenefitsPrice", "csharp"); +@@clientName(PaymentDetail, "SavingsPlanOrderPaymentDetail", "csharp"); +@@clientName(PaymentStatus, "BillingBenefitsPaymentStatus", "csharp"); +@@clientName( + SavingsPlanUpdateValidateRequest, + "SavingsPlanUpdateValidateContent", + "csharp" +); +@@clientName( + SavingsPlanPurchaseValidateRequest, + "SavingsPlanPurchaseValidateContent", + "csharp" +); +@@clientName( + ReservationOrderAliasRequest, + "ReservationOrderAliasContent", + "csharp" +); +@@clientName( + SavingsPlanUpdateRequestProperties, + "BillingBenefitsSavingsPlanPatchProperties", + "csharp" +); +@@clientName( + ReservationOrderAliasResponseProperties.renew, + "IsRenewed", + "csharp" +); +@@clientName( + ReservationOrderAliasRequestProperties.renew, + "IsRenewed", + "csharp" +); +@@clientName( + SavingsPlanModelProperties.effectiveDateTime, + "EffectOn", + "csharp" +); +@@clientName(SavingsPlanModelProperties.expiryDateTime, "ExpireOn", "csharp"); +@@clientName(SavingsPlanModelProperties.renew, "IsRenewed", "csharp"); +@@clientName(PurchaseRequestProperties.effectiveDateTime, "EffectOn", "csharp"); +@@clientName(PurchaseRequestProperties.renew, "IsRenewed", "csharp"); +@@clientName(SavingsPlanValidResponseProperty.valid, "IsValid", "csharp"); +@@clientName( + SavingsPlanOrderModelProperties.expiryDateTime, + "ExpireOn", + "csharp" +); +@@clientName(PaymentDetail.paymentDate, "PayOn", "csharp"); +@@clientName(SavingsPlanUpdateRequestProperties.renew, "IsRenewed", "csharp"); +@@clientName(SavingsPlanOrderAliasProperties.renew, "IsRenewed", "csharp"); +@@clientName(BenefitValidateResponseProperty.valid, "IsValid", "csharp"); +@@clientName( + SellerResourceListRequestProperties.contributors, + "IncludeContributors", + "csharp" +); +@@clientName( + SellerResourceListRequestProperties.milestones, + "IncludeMilestones", + "csharp" +); +@@clientName( + MaccModelProperties.allowContributors, + "IsAllowContributors", + "csharp" +); +@@clientName( + MaccPatchRequestProperties.allowContributors, + "IsAllowContributors", + "csharp" +); +@@clientName(DiscountProperties, "BillingBenefitsDiscountProperties", "csharp"); +@@clientName( + ConditionalCreditProperties, + "BillingBenefitsConditionalCreditProperties", + "csharp" +); +@@alternateType( + ReservationOrderAliasResponseProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + ReservationOrderAliasResponseProperties.reservationOrderId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + ReservationOrderAliasRequestProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + AppliedScopeProperties.managementGroupId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + AppliedScopeProperties.subscriptionId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + AppliedScopeProperties.resourceGroupId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanModelProperties.billingAccountId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanModelProperties.billingProfileId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanModelProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + PurchaseRequestProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanOrderModelProperties.billingAccountId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanOrderModelProperties.billingProfileId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + RoleAssignmentEntity.id, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + RoleAssignmentEntityProperties.roleDefinitionId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + RoleAssignmentEntityProperties.scope, + Azure.Core.armResourceIdentifier, + "csharp" ); -// python +@@clientName(ReservedResourceType.CosmosDb, "CosmosDB", "csharp"); +@@clientName(ReservedResourceType.MariaDb, "MariaDB", "csharp"); +@@clientName(ReservedResourceType.AVS, "Avs", "csharp"); @@clientName( - Microsoft.BillingBenefits.ManagedServiceIdentity, - "ServiceManagedIdentity", - "python" + ReservationOrderAliasRequest, + "BillingBenefitsReservationOrderAliasCreateOrUpdateContent", + "csharp" ); @@clientName( - Microsoft.BillingBenefits.ManagedServiceIdentityType, - "ServiceManagedIdentityType", - "python" + SavingsPlanOperationGroup.listAll, + "GetBillingBenefitsSavingsPlans", + "csharp" +); +@@alternateType( + ReservationOrderAliasResponse.location, + Azure.Core.azureLocation, + "csharp" +); +@@alternateType( + SavingsPlanOrderAliasProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanOrderAliasProperties.savingsPlanOrderId, + Azure.Core.armResourceIdentifier, + "csharp" +); +@@alternateType( + SavingsPlanOrderModelProperties.billingScopeId, + Azure.Core.armResourceIdentifier, + "csharp" +); + +@@usage(SavingsPlanModelProperties, Usage.input | Usage.output, "csharp"); +@@usage(SavingsPlanModel, Usage.input | Usage.output, "csharp"); +@@usage(ReservationOrderAliasRequest, Usage.input | Usage.output, "csharp"); +@@usage( + ReservationOrderAliasRequestProperties, + Usage.input | Usage.output, + "csharp" ); -@@clientName(Microsoft.BillingBenefits, "BillingBenefitsRP", "python"); -@@clientName(Microsoft.BillingBenefits.Term.P1Y, "P1_Y", "python"); -@@clientName(Microsoft.BillingBenefits.Term.P3Y, "P3_Y", "python"); -@@clientName(Microsoft.BillingBenefits.Term.P5Y, "P5_Y", "python"); -@@clientName(Microsoft.BillingBenefits.BillingPlan.P1M, "P1_M", "python"); +@@usage(PaymentDetail, Usage.input | Usage.output, "csharp"); +@@usage(BillingPlanInformation, Usage.input | Usage.output, "csharp"); +@@usage(ReservationOrderAliasResponse, Usage.input | Usage.output, "csharp"); +@@usage(SavingsPlanOrderModel, Usage.input | Usage.output, "csharp"); + +@@alternateType(AppliedScopeProperties.tenantId, Azure.Core.uuid, "csharp"); +@@alternateType( + ReservationOrderAliasRequest.location, + Azure.Core.azureLocation, + "csharp" +); + +// python: client name mitigation +@@clientName(Microsoft.BillingBenefits, "BillingBenefitsMgmtClient", "python"); + +// python: enum value naming mitigations +@@clientName(BillingPlan.P1M, "P1_M", "python"); +@@clientName(Term.P1Y, "P1_Y", "python"); +@@clientName(Term.P3Y, "P3_Y", "python"); +@@clientName(Term.P5Y, "P5_Y", "python"); + +@@clientName( + DiscountsOperationGroup.scopeList, + "listDiscountByScope", + "csharp" +); +@@clientName( + ConditionalCreditsOperationGroup.scopeList, + "listConditionalCreditByScope", + "csharp" +); + +// csharp: preserve original public property name after flatten/lift-to-nullable generator fix +@@clientName(MaccModelProperties.entityType, "MaccEntityType", "csharp"); +@@clientName(DiscountType, "DiscountTypeEnum", "go"); From eba6bdd9e1c663e2224f262f58e83eb077eb86a4 Mon Sep 17 00:00:00 2001 From: Ryan Maley Date: Thu, 2 Jul 2026 10:36:58 -0700 Subject: [PATCH 3/4] restoring tspconfig.yaml --- .../BillingBenefits.Management/tspconfig.yaml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml index 87fcd8299683..2820d8cad7f7 100644 --- a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml +++ b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml @@ -6,7 +6,6 @@ emit: options: "@azure-tools/typespec-autorest": omit-unreachable-types: true - use-read-only-status-schema: true emitter-output-dir: "{project-root}/.." azure-resource-provider-folder: "resource-manager" output-file: "{azure-resource-provider-folder}/{service-name}/{version-status}/{version}/billingbenefits.json" @@ -23,11 +22,14 @@ options: namespace: "com.azure.resourcemanager.billingbenefits" service-name: "BillingBenefits" # human-readable service name, whitespace allowed flavor: azure + "@azure-typespec/http-client-csharp-mgmt": + emitter-output-dir: "{output-dir}/{service-dir}/{namespace}" + namespace: "Azure.ResourceManager.BillingBenefits" "@azure-tools/typespec-ts": emitter-output-dir: "{output-dir}/{service-dir}/arm-billingbenefits" typespec-title-map: BillingBenefitsClient: BillingBenefitsRP - is-modular-library: true + compatibility-lro: true flavor: "azure" experimental-extensible-enums: true package-details: @@ -35,7 +37,7 @@ options: "@azure-tools/typespec-go": service-dir: "sdk/resourcemanager/billingbenefits" emitter-output-dir: "{output-dir}/{service-dir}/armbillingbenefits" - module: "github.com/Azure/azure-sdk-for-go/{service-dir}/armbillingbenefits" + module: "github.com/Azure/azure-sdk-for-go/{service-dir}/armbillingbenefits/v2" fix-const-stuttering: true flavor: "azure" generate-samples: true From 29a0a3f27ce4701eb15ac53d079f231fcba41cde Mon Sep 17 00:00:00 2001 From: Ryan Maley Date: Thu, 2 Jul 2026 11:34:51 -0700 Subject: [PATCH 4/4] re-adding use-read-only-status-schema: true --- .../billingbenefits/BillingBenefits.Management/tspconfig.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml index 2820d8cad7f7..313af754fc19 100644 --- a/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml +++ b/specification/billingbenefits/BillingBenefits.Management/tspconfig.yaml @@ -6,6 +6,7 @@ emit: options: "@azure-tools/typespec-autorest": omit-unreachable-types: true + use-read-only-status-schema: true emitter-output-dir: "{project-root}/.." azure-resource-provider-folder: "resource-manager" output-file: "{azure-resource-provider-folder}/{service-name}/{version-status}/{version}/billingbenefits.json"