{ "swagger": "2.0", "info": { "version": "2020-05-01", "title": "BillingManagementClient", "description": "Billing client provides access to billing resources for Azure subscriptions." }, "host": "management.azure.com", "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "paths": { "/providers/Microsoft.Billing/billingAccounts": { "get": { "tags": [ "BillingAccounts" ], "x-ms-examples": { "BillingAccountsList": { "$ref": "./examples/BillingAccountsList.json" }, "BillingAccountsListWithExpand": { "$ref": "./examples/BillingAccountsListWithExpand.json" }, "BillingAccountsListWithExpandForEnrollmentDetails": { "$ref": "./examples/BillingAccountsListWithExpandForEnrollmentDetails.json" } }, "operationId": "BillingAccounts_List", "description": "Lists the billing accounts that a user has access to.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "name": "$expand", "description": "May be used to expand the soldTo, invoice sections and billing profiles.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingAccountListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}": { "get": { "tags": [ "BillingAccounts" ], "x-ms-examples": { "BillingAccounts": { "$ref": "./examples/BillingAccount.json" }, "BillingAccountWithExpand": { "$ref": "./examples/BillingAccountWithExpand.json" } }, "operationId": "BillingAccounts_Get", "description": "Gets a billing account by its ID.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the soldTo, invoice sections and billing profiles.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingAccount" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "BillingAccounts" ], "operationId": "BillingAccounts_Update", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "azure-async-operation" }, "description": "Updates the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdateBillingAccount": { "$ref": "./examples/UpdateBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingAccountUpdateRequest" }, "description": "Request parameters that are provided to the update billing account operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingAccount" } }, "202": { "description": "Accepted. Billing account update is in progress." }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/listInvoiceSectionsWithCreateSubscriptionPermission": { "post": { "tags": [ "BillingAccounts" ], "x-ms-examples": { "InvoiceSectionsListWithCreateSubPermission": { "$ref": "./examples/InvoiceSectionsListWithCreateSubPermission.json" } }, "operationId": "BillingAccounts_ListInvoiceSectionsByCreateSubscriptionPermission", "description": "Lists the invoice sections for which the user has permission to create Azure subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceSectionListWithCreateSubPermissionResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/validateAddress": { "post": { "tags": [ "Address" ], "x-ms-examples": { "AddressValid": { "$ref": "./examples/AddressValid.json" }, "AddressInvalid": { "$ref": "./examples/AddressInvalid.json" } }, "operationId": "Address_Validate", "description": "Validates an address. Use the operation to validate an address before using it as soldTo or a billTo address.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "name": "address", "in": "body", "required": true, "schema": { "$ref": "#/definitions/AddressDetails" } } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ValidateAddressResponse" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/availableBalance/default": { "get": { "tags": [ "AvailableBalances" ], "operationId": "AvailableBalances_Get", "description": "The available credit balance for a billing profile. This is the balance that can be used for pay now to settle due or past due invoices. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "AvailableBalanceByBillingProfile": { "$ref": "./examples/AvailableBalanceByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/AvailableBalance" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/instructions": { "get": { "tags": [ "Instructions" ], "operationId": "Instructions_ListByBillingProfile", "description": "Lists the instructions by billing profile id.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "InstructionsListByBillingProfile": { "$ref": "./examples/InstructionsListByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InstructionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/instructions/{instructionName}": { "get": { "tags": [ "Instructions" ], "x-ms-examples": { "Instruction": { "$ref": "./examples/Instruction.json" } }, "operationId": "Instructions_Get", "description": "Get the instruction by name. These are custom billing instructions and are only applicable for certain customers.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/instructionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Instruction" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "Instructions" ], "operationId": "Instructions_Put", "description": "Creates or updates an instruction. These are custom billing instructions and are only applicable for certain customers.", "x-ms-examples": { "PutInstruction": { "$ref": "./examples/PutInstruction.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/instructionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/Instruction" }, "description": "The new instruction." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Instruction" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles": { "get": { "tags": [ "BillingProfiles" ], "x-ms-examples": { "BillingProfilesListByBillingAccount": { "$ref": "./examples/BillingProfilesListByBillingAccount.json" }, "BillingProfilesListWithExpand": { "$ref": "./examples/BillingProfilesListWithExpand.json" } }, "operationId": "BillingProfiles_ListByBillingAccount", "description": "Lists the billing profiles that a user has access to. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the invoice sections.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProfileListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}": { "get": { "tags": [ "BillingProfiles" ], "x-ms-examples": { "BillingProfile": { "$ref": "./examples/BillingProfile.json" }, "BillingProfileWithExpand": { "$ref": "./examples/BillingProfileWithExpand.json" } }, "operationId": "BillingProfiles_Get", "description": "Gets a billing profile by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "$expand", "description": "May be used to expand the invoice sections.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProfile" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "BillingProfiles" ], "operationId": "BillingProfiles_CreateOrUpdate", "x-ms-long-running-operation": true, "description": "Creates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "x-ms-examples": { "CreateBillingProfile": { "$ref": "./examples/PutBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingProfile" }, "description": "The new or updated billing profile." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProfile" } }, "202": { "description": "Accepted", "headers": { "Location": { "description": "Location URI to poll for result", "type": "string" }, "Retry-After": { "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.", "type": "integer", "format": "int32" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers": { "get": { "tags": [ "Customers" ], "x-ms-examples": { "CustomersListByBillingProfile": { "$ref": "./examples/CustomersListByBillingProfile.json" } }, "operationId": "Customers_ListByBillingProfile", "description": "Lists the customers that are billed to a billing profile. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "$search", "description": "Used for searching customers by their name. Any customer with name containing the search text will be included in the response", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter the list of customers.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/CustomerListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections": { "get": { "tags": [ "InvoiceSections" ], "x-ms-examples": { "InvoiceSectionsListByBillingProfile": { "$ref": "./examples/InvoiceSectionsListByBillingProfile.json" } }, "operationId": "InvoiceSections_ListByBillingProfile", "description": "Lists the invoice sections that a user has access to. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceSectionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}": { "get": { "tags": [ "InvoiceSections" ], "x-ms-examples": { "InvoiceSection": { "$ref": "./examples/InvoiceSection.json" } }, "operationId": "InvoiceSections_Get", "description": "Gets an invoice section by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceSection" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "InvoiceSections" ], "operationId": "InvoiceSections_CreateOrUpdate", "x-ms-long-running-operation": true, "description": "Creates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "PutInvoiceSection": { "$ref": "./examples/PutInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/InvoiceSection" }, "description": "The new or updated invoice section." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceSection" } }, "202": { "description": "Accepted", "headers": { "Location": { "description": "Location URI to poll for result", "type": "string" }, "Retry-After": { "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.", "type": "integer", "format": "int32" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers": { "get": { "tags": [ "Customers" ], "x-ms-examples": { "CustomersListByBillingAccount": { "$ref": "./examples/CustomersListByBillingAccount.json" } }, "operationId": "Customers_ListByBillingAccount", "description": "Lists the customers that are billed to a billing account. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$search", "description": "Used for searching customers by their name. Any customer with name containing the search text will be included in the response", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter the list of customers.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/CustomerListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}": { "get": { "tags": [ "Customers" ], "x-ms-examples": { "Customer": { "$ref": "./examples/Customer.json" }, "CustomerWithExpand": { "$ref": "./examples/CustomerWithExpand.json" } }, "operationId": "Customers_Get", "description": "Gets a customer by its ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "name": "$expand", "description": "May be used to expand enabledAzurePlans and resellers", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Customer" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "BillingProfilePermissionsList": { "$ref": "./examples/CustomerPermissionsList.json" } }, "operationId": "BillingPermissions_ListByCustomer", "description": "Lists the billing permissions the caller has for a customer.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingPermissionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_ListByCustomer", "description": "Lists the subscriptions for a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByCustomer": { "$ref": "./examples/BillingSubscriptionsListByCustomer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscriptionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/products": { "get": { "tags": [ "Products" ], "operationId": "Products_ListByCustomer", "description": "Lists the products for a customer. These don't include products billed based on usage.The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "ProductsListByInvoiceSection": { "$ref": "./examples/ProductsListByCustomer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ProductsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "BillingAccountInvoicesList": { "$ref": "./examples/BillingAccountInvoicesList.json" }, "BillingAccountInvoicesListWithRebillDetails": { "$ref": "./examples/BillingAccountInvoicesListWithRebillDetails.json" } }, "operationId": "Invoices_ListByBillingAccount", "description": "Lists the invoices for a billing account for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "periodStartDate", "description": "The start date to fetch the invoices. The date should be specified in MM-DD-YYYY format.", "in": "query", "required": true, "type": "string" }, { "name": "periodEndDate", "description": "The end date to fetch the invoices. The date should be specified in MM-DD-YYYY format.", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "InvoicesListByBillingProfile": { "$ref": "./examples/InvoicesListByBillingProfile.json" }, "InvoicesListByBillingProfileWithRebillDetails": { "$ref": "./examples/InvoicesListByBillingProfileWithRebillDetails.json" } }, "operationId": "Invoices_ListByBillingProfile", "description": "Lists the invoices for a billing profile for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "periodStartDate", "description": "The start date to fetch the invoices. The date should be specified in MM-DD-YYYY format.", "in": "query", "required": true, "type": "string" }, { "name": "periodEndDate", "description": "The end date to fetch the invoices. The date should be specified in MM-DD-YYYY format.", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "Invoice": { "$ref": "./examples/Invoice.json" }, "InvoiceWithRebillDetails": { "$ref": "./examples/InvoiceWithRebillDetails.json" }, "VoidInvoice": { "$ref": "./examples/VoidInvoice.json" }, "CreditNote": { "$ref": "./examples/CreditNote.json" } }, "operationId": "Invoices_Get", "description": "Gets an invoice by billing account name and ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/invoiceNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Invoice" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/default/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "Invoice": { "$ref": "./examples/InvoiceById.json" } }, "operationId": "Invoices_GetById", "description": "Gets an invoice by ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/invoiceNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Invoice" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/download": { "post": { "tags": [ "Invoices" ], "x-ms-examples": { "InvoiceDownload": { "$ref": "./examples/ModernInvoiceDownload.json" } }, "operationId": "Invoices_DownloadInvoice", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download an invoice. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/invoiceNameParameter" }, { "name": "downloadToken", "description": "Download token with document source and document ID.", "in": "query", "required": true, "type": "string" } ], "responses": { "202": { "description": "Accepted.", "headers": { "Location": { "description": "GET this URL to retrieve the status of the asynchronous operation.", "type": "string" }, "Retry-After": { "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.", "type": "string" } } }, "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/DownloadUrl" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/downloadDocuments": { "post": { "tags": [ "Invoices" ], "x-ms-examples": { "BillingProfileInvoiceDownload": { "$ref": "./examples/MultipleModernInvoiceDownload.json" } }, "operationId": "Invoices_DownloadMultipleBillingProfileInvoices", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download multiple invoice documents (invoice pdf, tax receipts, credit notes) as a zip file. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "downloadUrls", "in": "body", "required": true, "description": "An array of download urls for individual documents", "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "202": { "description": "Accepted.", "headers": { "Location": { "description": "GET this URL to retrieve the status of the asynchronous operation.", "type": "string" }, "Retry-After": { "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.", "type": "string" } } }, "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/DownloadUrl" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_ListByBillingAccount", "description": "Lists the subscriptions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByBillingAccount": { "$ref": "./examples/BillingSubscriptionsListByBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscriptionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices": { "get": { "tags": [ "Invoices" ], "operationId": "Invoices_ListByBillingSubscription", "description": "Lists the invoices for a subscription.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByBillingAccount": { "$ref": "./examples/BillingSubscriptionInvoicesList.json" } }, "parameters": [ { "$ref": "#/parameters/subscriptionIdParameter" }, { "name": "periodStartDate", "description": "Invoice period start date.", "in": "query", "required": true, "type": "string" }, { "name": "periodEndDate", "description": "Invoice period end date.", "in": "query", "required": true, "type": "string" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "operationId": "Invoices_GetBySubscriptionAndInvoiceId", "description": "Gets an invoice by subscription ID and invoice ID.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByBillingAccount": { "$ref": "./examples/BillingSubscriptionInvoice.json" } }, "parameters": [ { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/invoiceNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Invoice" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices/{invoiceName}/download": { "post": { "tags": [ "Invoices" ], "x-ms-examples": { "BillingSubscriptionInvoiceDownload": { "$ref": "./examples/BillingSubscriptionInvoiceDownload.json" } }, "operationId": "Invoices_DownloadBillingSubscriptionInvoice", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download an invoice.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/invoiceNameParameter" }, { "name": "downloadToken", "description": "Download token with document source and document ID.", "in": "query", "required": true, "type": "string" } ], "responses": { "202": { "description": "Accepted.", "headers": { "Location": { "description": "GET this URL to retrieve the status of the asynchronous operation.", "type": "string" }, "Retry-After": { "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.", "type": "string" } } }, "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/DownloadUrl" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/downloadDocuments": { "post": { "tags": [ "Invoices" ], "x-ms-examples": { "BillingSubscriptionInvoiceDownload": { "$ref": "./examples/MultipleBillingSubscriptionInvoiceDownload.json" } }, "operationId": "Invoices_DownloadMultipleBillingSubscriptionInvoices", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download multiple invoice documents (invoice pdf, tax receipts, credit notes) as a zip file.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "name": "downloadUrls", "in": "body", "required": true, "description": "An array of download urls for individual documents", "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "202": { "description": "Accepted.", "headers": { "Location": { "description": "GET this URL to retrieve the status of the asynchronous operation.", "type": "string" }, "Retry-After": { "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.", "type": "string" } } }, "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/DownloadUrl" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingSubscriptions": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_ListByBillingProfile", "description": "Lists the subscriptions that are billed to a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByBillingProfile": { "$ref": "./examples/BillingSubscriptionsListByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscriptionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_ListByInvoiceSection", "description": "Lists the subscriptions that are billed to an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByInvoiceSection": { "$ref": "./examples/BillingSubscriptionsListByInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscriptionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{subscriptionId}": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_Get", "description": "Gets a subscription by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement and Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscription": { "$ref": "./examples/BillingSubscription.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscription" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_Update", "description": "Updates the properties of a billing subscription. Currently, cost center can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdateBillingProperty": { "$ref": "./examples/UpdateBillingSubscription.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingSubscription" }, "description": "Request parameters that are provided to the update billing subscription operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscription" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{subscriptionId}/move": { "post": { "description": "Moves a subscription's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "operationId": "BillingSubscriptions_Move", "x-ms-long-running-operation": true, "x-ms-examples": { "MoveBillingSubscription": { "$ref": "./examples/MoveBillingSubscription.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties" }, "description": "Request parameters that are provided to the move subscription operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingSubscription" } }, "202": { "description": "Accepted. Billing Subscription transfer is in progress.", "headers": { "Location": { "description": "Location URI to poll for result.", "type": "string" }, "Retry-After": { "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.", "type": "integer", "format": "int32" } } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{subscriptionId}/validateMoveEligibility": { "post": { "x-ms-examples": { "SubscriptionMoveValidateSuccess": { "$ref": "./examples/ValidateSubscriptionMoveSuccess.json" }, "SubscriptionMoveValidateFailure": { "$ref": "./examples/ValidateSubscriptionMoveFailure.json" } }, "operationId": "BillingSubscriptions_ValidateMove", "description": "Validates if a subscription's charges can be moved to a new invoice section. This operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties" }, "description": "Request parameters that are provided to the validate move eligibility operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ValidateSubscriptionTransferEligibilityResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products": { "get": { "tags": [ "Products" ], "operationId": "Products_ListByBillingAccount", "description": "Lists the products for a billing account. These don't include products billed based on usage. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "ProductsListByBillingAccount": { "$ref": "./examples/ProductsListByBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "$filter", "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ProductsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/products": { "get": { "tags": [ "Products" ], "operationId": "Products_ListByBillingProfile", "description": "Lists the products for a billing profile. These don't include products billed based on usage. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "ProductsListByBillingProfile": { "$ref": "./examples/ProductsListByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "$filter", "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ProductsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products": { "get": { "tags": [ "Products" ], "operationId": "Products_ListByInvoiceSection", "description": "Lists the products for an invoice section. These don't include products billed based on usage. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "ProductsListByInvoiceSection": { "$ref": "./examples/ProductsListByInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "$filter", "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ProductsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products/{productName}": { "get": { "tags": [ "Products" ], "operationId": "Products_Get", "description": "Gets a product by ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "Product": { "$ref": "./examples/Product.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Product" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "Products" ], "operationId": "Products_Update", "description": "Updates the properties of a Product. Currently, auto renew can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdateBillingProperty": { "$ref": "./examples/UpdateProduct.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/Product" }, "description": "Request parameters that are provided to the update product operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Product" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products/{productName}/move": { "post": { "tags": [ "Products" ], "operationId": "Products_Move", "description": "Moves a product's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "MoveProduct": { "$ref": "./examples/MoveProduct.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferProductRequestProperties" }, "description": "Request parameters that are provided to the move product operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Product" } }, "202": { "description": "Accepted", "headers": { "Location": { "description": "Location URI to poll for result", "type": "string" }, "Retry-After": { "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.", "type": "integer", "format": "int32" } } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products/{productName}/validateMoveEligibility": { "post": { "x-ms-examples": { "SubscriptionMoveValidateSuccess": { "$ref": "./examples/ValidateProductMoveSuccess.json" }, "SubscriptionMoveValidateFailure": { "$ref": "./examples/ValidateProductMoveFailure.json" } }, "operationId": "Products_ValidateMove", "description": "Validates if a product's charges can be moved to a new invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferProductRequestProperties" }, "description": "Request parameters that are provided to the validate move eligibility operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ValidateProductTransferEligibilityResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_ListByInvoice", "description": "Lists the transactions for an invoice. Transactions include purchases, refunds and Azure usage charges.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "TransactionsListByInvoice": { "$ref": "./examples/TransactionsListByInvoice.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/invoiceNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/TransactionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/policies/default": { "get": { "tags": [ "Policies" ], "operationId": "Policies_GetByBillingProfile", "description": "Lists the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "PolicyByBillingProfile": { "$ref": "./examples/Policy.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Policy" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "Policies" ], "operationId": "Policies_Update", "description": "Updates the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdatePolicy": { "$ref": "./examples/UpdatePolicy.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/Policy" }, "description": "Request parameters that are provided to the update policies operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Policy" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/policies/default": { "get": { "tags": [ "Policies" ], "operationId": "Policies_GetByCustomer", "description": "Lists the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "PolicyByCustomer": { "$ref": "./examples/CustomerPolicy.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/CustomerPolicy" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "put": { "tags": [ "Policies" ], "operationId": "Policies_UpdateCustomer", "description": "Updates the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "x-ms-examples": { "UpdateCustomer": { "$ref": "./examples/UpdateCustomerPolicy.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CustomerPolicy" }, "description": "Request parameters that are provided to the update policies operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/CustomerPolicy" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingProperty/default": { "get": { "tags": [ "BillingProperties" ], "operationId": "BillingProperty_Get", "description": "Get the billing properties for a subscription. This operation is not supported for billing accounts with agreement type Enterprise Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingProperty": { "$ref": "./examples/BillingProperty.json" } }, "parameters": [ { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProperty" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "patch": { "tags": [ "BillingProperties" ], "operationId": "BillingProperty_Update", "description": "Updates the billing property of a subscription. Currently, cost center can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdateBillingProperty": { "$ref": "./examples/UpdateBillingProperty.json" } }, "parameters": [ { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingProperty" }, "description": "Request parameters that are provided to the update billing property operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProperty" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "BillingAccountPermissionsList": { "$ref": "./examples/BillingAccountPermissionsList.json" } }, "operationId": "BillingPermissions_ListByBillingAccount", "description": "Lists the billing permissions the caller has on a billing account.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingPermissionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "InvoiceSectionPermissionsList": { "$ref": "./examples/InvoiceSectionPermissionsList.json" } }, "operationId": "BillingPermissions_ListByInvoiceSections", "description": "Lists the billing permissions the caller has on an invoice section.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingPermissionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "BillingProfilePermissionsList": { "$ref": "./examples/BillingProfilePermissionsList.json" } }, "operationId": "BillingPermissions_ListByBillingProfile", "description": "Lists the billing permissions the caller has on a billing profile.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingPermissionsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleDefinitions/{billingRoleDefinitionName}": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "BillingAccountRoleDefinition": { "$ref": "./examples/BillingAccountRoleDefinition.json" } }, "operationId": "BillingRoleDefinitions_GetByBillingAccount", "description": "Gets the definition for a role on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingRoleDefinitionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinition" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleDefinitions/{billingRoleDefinitionName}": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "InvoiceSectionRoleDefinition": { "$ref": "./examples/InvoiceSectionRoleDefinition.json" } }, "operationId": "BillingRoleDefinitions_GetByInvoiceSection", "description": "Gets the definition for a role on an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingRoleDefinitionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinition" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingRoleDefinitions/{billingRoleDefinitionName}": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "BillingProfileRoleDefinition": { "$ref": "./examples/BillingProfileRoleDefinition.json" } }, "operationId": "BillingRoleDefinitions_GetByBillingProfile", "description": "Gets the definition for a role on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/billingRoleDefinitionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinition" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleDefinitions": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "BillingAccountRoleDefinitionsList": { "$ref": "./examples/BillingAccountRoleDefinitionsList.json" } }, "operationId": "BillingRoleDefinitions_ListByBillingAccount", "description": "Lists the role definitions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinitionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleDefinitions": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "InvoiceSectionRoleDefinitionsList": { "$ref": "./examples/InvoiceSectionRoleDefinitionsList.json" } }, "operationId": "BillingRoleDefinitions_ListByInvoiceSection", "description": "Lists the role definitions for an invoice section. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinitionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingRoleDefinitions": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "BillingProfileRoleDefinitionsList": { "$ref": "./examples/BillingProfileRoleDefinitionsList.json" } }, "operationId": "BillingRoleDefinitions_ListByBillingProfile", "description": "Lists the role definitions for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleDefinitionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments/{billingRoleAssignmentName}": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingAccountRoleAssignment": { "$ref": "./examples/BillingAccountRoleAssignment.json" } }, "operationId": "BillingRoleAssignments_GetByBillingAccount", "description": "Gets a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingAccountRoleAssignmentDelete": { "$ref": "./examples/BillingAccountRoleAssignmentDelete.json" } }, "operationId": "BillingRoleAssignments_DeleteByBillingAccount", "description": "Deletes a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments/{billingRoleAssignmentName}": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "InvoiceSectionRoleAssignment": { "$ref": "./examples/InvoiceSectionRoleAssignment.json" } }, "operationId": "BillingRoleAssignments_GetByInvoiceSection", "description": "Gets a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "InvoiceSectionRoleAssignmentDelete": { "$ref": "./examples/InvoiceSectionRoleAssignmentDelete.json" } }, "operationId": "BillingRoleAssignments_DeleteByInvoiceSection", "description": "Deletes a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingRoleAssignments/{billingRoleAssignmentName}": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingProfileRoleAssignment": { "$ref": "./examples/BillingProfileRoleAssignment.json" } }, "operationId": "BillingRoleAssignments_GetByBillingProfile", "description": "Gets a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingProfileRoleAssignmentDelete": { "$ref": "./examples/BillingProfileRoleAssignmentDelete.json" } }, "operationId": "BillingRoleAssignments_DeleteByBillingProfile", "description": "Deletes a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignment" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingAccountRoleAssignmentList": { "$ref": "./examples/BillingAccountRoleAssignmentList.json" } }, "operationId": "BillingRoleAssignments_ListByBillingAccount", "description": "Lists the role assignments for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "InvoiceSectionRoleAssignmentList": { "$ref": "./examples/InvoiceSectionRoleAssignmentList.json" } }, "operationId": "BillingRoleAssignments_ListByInvoiceSection", "description": "Lists the role assignments for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/billingRoleAssignments": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingProfileRoleAssignmentList": { "$ref": "./examples/BillingProfileRoleAssignmentList.json" } }, "operationId": "BillingRoleAssignments_ListByBillingProfile", "description": "Lists the role assignments for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/agreements": { "get": { "tags": [ "Agreements" ], "x-ms-examples": { "AgreementsListByBillingAccount": { "$ref": "./examples/AgreementsListByBillingAccount.json" } }, "operationId": "Agreements_ListByBillingAccount", "description": "Lists the agreements for a billing account.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the participants.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/AgreementListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/agreements/{agreementName}": { "get": { "tags": [ "Agreements" ], "x-ms-examples": { "AgreementByName": { "$ref": "./examples/AgreementByName.json" } }, "operationId": "Agreements_Get", "description": "Gets an agreement by ID.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/agreementNameParameter" }, { "name": "$expand", "description": "May be used to expand the participants.", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Agreement" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/reservations": { "get": { "tags": [ "Reservations" ], "x-ms-examples": { "ReservationsListByBillingAccount": { "$ref": "./examples/ReservationsListByBillingAccount.json" } }, "operationId": "Reservations_ListByBillingAccount", "description": "Lists the reservations for a billing account and the roll up counts of reservations group by provisioning states.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$filter", "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'.", "in": "query", "required": false, "type": "string" }, { "name": "$orderby", "description": "May be used to sort order by reservation properties.", "in": "query", "required": false, "type": "string" }, { "name": "refreshSummary", "description": "To indicate whether to refresh the roll up counts of the reservations group by provisioning states", "in": "query", "required": false, "type": "string" }, { "name": "selectedState", "description": "The selected provisioning state", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ReservationsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/reservations": { "get": { "tags": [ "Reservations" ], "x-ms-examples": { "ReservationsListByBillingProfile": { "$ref": "./examples/ReservationsListByBillingProfile.json" } }, "operationId": "Reservations_ListByBillingProfile", "description": "Lists the reservations for a billing profile and the roll up counts of reservations group by provisioning state.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "$filter", "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'.", "in": "query", "required": false, "type": "string" }, { "name": "$orderby", "description": "May be used to sort order by reservation properties.", "in": "query", "required": false, "type": "string" }, { "name": "refreshSummary", "description": "To indicate whether to refresh the roll up counts of the reservations group by provisioning state", "in": "query", "required": false, "type": "string" }, { "name": "selectedState", "description": "The selected provisioning state", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/ReservationsListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } } }, "definitions": { "CustomerListResult": { "description": "The list of customers.", "properties": { "value": { "description": "The list of customers.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Customer" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "Customer": { "description": "A partner's customer.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The customer.", "x-ms-client-flatten": true, "$ref": "#/definitions/CustomerProperties" } } }, "CustomerProperties": { "description": "The properties of a customer.", "properties": { "billingProfileId": { "description": "The ID of the billing profile for the invoice section.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile for the invoice section.", "type": "string", "readOnly": true }, "displayName": { "description": "The name of the customer.", "type": "string" }, "enabledAzurePlans": { "description": "Azure plans enabled for the customer.", "type": "array", "items": { "$ref": "#/definitions/AzurePlan" } }, "resellers": { "description": "The list of resellers for which an Azure plan is enabled for the customer.", "type": "array", "items": { "$ref": "#/definitions/Reseller" } } } }, "ValidateAddressResponse": { "type": "object", "description": "Result of the address validation", "properties": { "status": { "description": "status of the address validation.", "$ref": "#/definitions/AddressValidationStatus" }, "suggestedAddresses": { "description": "The list of suggested addresses.", "type": "array", "items": { "$ref": "#/definitions/AddressDetails" } }, "validationMessage": { "description": "Validation error message.", "type": "string" } } }, "AddressValidationStatus": { "type": "string", "description": "Status of the address validation.", "enum": [ "Valid", "Invalid" ], "x-ms-enum": { "name": "addressValidationStatus", "modelAsString": true } }, "TransferProductRequestProperties": { "description": "The properties of the product to initiate a transfer.", "properties": { "destinationInvoiceSectionId": { "type": "string", "description": "The destination invoice section id." } } }, "TransferBillingSubscriptionRequestProperties": { "type": "object", "description": "Request parameters to transfer billing subscription.", "required": [ "destinationInvoiceSectionId" ], "properties": { "destinationInvoiceSectionId": { "type": "string", "description": "The destination invoice section id." } } }, "ValidateSubscriptionTransferEligibilityResult": { "type": "object", "description": "Result of the transfer eligibility validation.", "properties": { "isMoveEligible": { "description": "Specifies whether the subscription is eligible to be transferred.", "type": "boolean", "readOnly": true }, "errorDetails": { "description": "Validation error details.", "$ref": "#/definitions/ValidateSubscriptionTransferEligibilityError" } } }, "ValidateSubscriptionTransferEligibilityError": { "type": "object", "description": "Error details of the transfer eligibility validation", "properties": { "code": { "description": "Error code for the product transfer validation.", "$ref": "#/definitions/SubscriptionTransferValidationErrorCode" }, "message": { "description": "The error message.", "type": "string" }, "details": { "description": "Detailed error message explaining the error.", "type": "string" } } }, "SubscriptionTransferValidationErrorCode": { "type": "string", "description": "Error code of the transfer validation response.", "enum": [ "BillingAccountInactive", "CrossBillingAccountNotAllowed", "DestinationBillingProfileInactive", "DestinationBillingProfileNotFound", "DestinationBillingProfilePastDue", "DestinationInvoiceSectionInactive", "DestinationInvoiceSectionNotFound", "InsufficientPermissionOnDestination", "InsufficientPermissionOnSource", "InvalidDestination", "InvalidSource", "MarketplaceNotEnabledOnDestination", "NotAvailableForDestinationMarket", "ProductInactive", "ProductNotFound", "ProductTypeNotSupported", "SourceBillingProfilePastDue", "SourceInvoiceSectionInactive", "SubscriptionNotActive", "SubscriptionTypeNotSupported" ], "x-ms-enum": { "name": "subscriptionTransferValidationErrorCode", "modelAsString": true } }, "BillingAccountListResult": { "description": "The list of billing accounts.", "properties": { "value": { "description": "The list of billing accounts.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingAccount" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingAccount": { "description": "A billing account.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of the billing account.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingAccountProperties" } } }, "BillingAccountProperties": { "description": "The properties of the billing account.", "properties": { "displayName": { "description": "The billing account name.", "type": "string" }, "soldTo": { "description": "The address of the individual or organization that is responsible for the billing account.", "$ref": "#/definitions/AddressDetails" }, "agreementType": { "description": "The type of agreement.", "type": "string", "enum": [ "MicrosoftCustomerAgreement", "EnterpriseAgreement", "MicrosoftOnlineServicesProgram", "MicrosoftPartnerAgreement" ], "readOnly": true, "x-ms-enum": { "name": "AgreementType", "modelAsString": true } }, "accountType": { "description": "The type of customer.", "type": "string", "enum": [ "Enterprise", "Individual", "Partner" ], "readOnly": true, "x-ms-enum": { "name": "AccountType", "modelAsString": true } }, "accountStatus": { "description": "The current status of the billing account.", "type": "string", "enum": [ "Active", "Deleted", "Disabled", "Expired", "Transferred", "Extended", "Terminated" ], "readOnly": true, "x-ms-enum": { "name": "AccountStatus", "modelAsString": true } }, "billingProfiles": { "description": "The billing profiles associated with the billing account. By default this is not populated, unless it's specified in $expand.", "$ref": "#/definitions/BillingProfilesOnExpand" }, "enrollmentDetails": { "description": "The details about the associated legacy enrollment. By default this is not populated, unless it's specified in $expand.", "$ref": "#/definitions/Enrollment", "readOnly": true }, "departments": { "description": "The departments associated to the enrollment.", "type": "array", "items": { "$ref": "#/definitions/Department" } }, "enrollmentAccounts": { "description": "The accounts associated to the enrollment.", "type": "array", "items": { "$ref": "#/definitions/EnrollmentAccount" } }, "hasReadAccess": { "description": "Indicates whether user has read access to the billing account.", "type": "boolean", "readOnly": true }, "notificationEmailAddress": { "description": "Notification email address, only for legacy accounts", "type": "string" } } }, "BillingProfilesOnExpand": { "description": "The billing profiles associated with the billing account. By default this is not populated, unless it's specified in $expand.", "properties": { "hasMoreResults": { "description": "Indicates whether there are more billing profiles than the ones listed in this collection. The collection lists a maximum of 50 billing profiles. To get all billing profiles, use the list billing profiles API.", "type": "boolean", "readOnly": true }, "value": { "description": "The billing profiles associated with the billing account.", "type": "array", "items": { "$ref": "#/definitions/BillingProfile" } } } }, "BillingAccountUpdateRequest": { "description": "The request properties of the billing account that can be updated.", "properties": { "properties": { "description": "A billing property.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingAccountProperties" } } }, "BillingProperty": { "description": "A billing property.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "A billing property.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingPropertyProperties" } } }, "BillingPropertyProperties": { "description": "The billing property.", "properties": { "accountAdminNotificationEmailAddress": { "description": "The email address on which the account admin gets all Azure notifications.", "type": "string", "readOnly": true }, "billingTenantId": { "description": "The Azure AD tenant ID of the billing account for the subscription.", "type": "string", "readOnly": true }, "billingAccountId": { "description": "The ID of the billing account to which the subscription is billed.", "type": "string", "readOnly": true }, "billingAccountDisplayName": { "description": "The name of the billing account to which the subscription is billed.", "type": "string", "readOnly": true }, "billingProfileId": { "description": "The ID of the billing profile to which the subscription is billed.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile to which the subscription is billed.", "type": "string", "readOnly": true }, "billingProfileStatus": { "description": "The status of the billing profile.", "enum": [ "Active", "Disabled", "Warned" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "BillingProfileStatus", "modelAsString": true } }, "billingProfileStatusReasonCode": { "description": "Reason for the specified billing profile status.", "enum": [ "PastDue", "SpendingLimitReached", "SpendingLimitExpired" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "BillingProfileStatusReasonCode", "modelAsString": true } }, "billingProfileSpendingLimit": { "description": "The billing profile spending limit.", "enum": [ "Off", "On" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "BillingProfileSpendingLimit", "modelAsString": true } }, "costCenter": { "description": "The cost center applied to the subscription.", "type": "string" }, "invoiceSectionId": { "description": "The ID of the invoice section to which the subscription is billed.", "type": "string", "readOnly": true }, "invoiceSectionDisplayName": { "description": "The name of the invoice section to which the subscription is billed.", "type": "string", "readOnly": true }, "isAccountAdmin": { "description": "Indicates whether user is the account admin.", "type": "boolean", "readOnly": true }, "productId": { "description": "The product ID of the Azure plan.", "type": "string", "readOnly": true }, "productName": { "description": "The product name of the Azure plan.", "type": "string", "readOnly": true }, "skuId": { "description": "The sku ID of the Azure plan for the subscription.", "type": "string", "readOnly": true }, "skuDescription": { "description": "The sku description of the Azure plan for the subscription.", "type": "string", "readOnly": true } } }, "Enrollment": { "description": "The properties of an enrollment.", "properties": { "startDate": { "description": "The start date of the enrollment.", "type": "string", "format": "date-time" }, "endDate": { "description": "The end date of the enrollment.", "type": "string", "format": "date-time" }, "currency": { "description": "The billing currency for the enrollment.", "type": "string", "readOnly": true }, "channel": { "description": "The channel type of the enrollment.", "type": "string", "readOnly": true }, "policies": { "description": "The policies for Enterprise Agreement enrollments.", "$ref": "#/definitions/EnrollmentPolicies", "readOnly": true }, "language": { "description": "The language for the enrollment.", "type": "string", "readOnly": true }, "countryCode": { "description": "The country code of the enrollment.", "type": "string", "readOnly": true }, "status": { "description": "The current status of the enrollment.", "type": "string", "readOnly": true }, "billingCycle": { "description": "The billing cycle for the enrollment.", "type": "string", "readOnly": true } } }, "EnrollmentPolicies": { "description": "The policies for Enterprise Agreement enrollments.", "properties": { "accountOwnerViewCharges": { "description": "The policy that controls whether Account Owners can view charges.", "type": "boolean", "readOnly": true }, "departmentAdminViewCharges": { "description": "The policy that controls whether Department Administrators can view charges.", "type": "boolean", "readOnly": true }, "marketplaceEnabled": { "description": "The policy that controls whether Azure marketplace purchases are allowed in the enrollment.", "type": "boolean", "readOnly": true }, "reservedInstancesEnabled": { "description": "The policy that controls whether Azure reservation purchases are allowed in the enrollment.", "type": "boolean", "readOnly": true } } }, "Department": { "description": "A department.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "A department.", "x-ms-client-flatten": true, "$ref": "#/definitions/DepartmentProperties" } } }, "DepartmentProperties": { "description": "The properties of a department.", "properties": { "departmentName": { "description": "The name of the department.", "type": "string" }, "costCenter": { "description": "The cost center associated with the department.", "type": "string" }, "status": { "description": "The status of the department.", "type": "string" }, "enrollmentAccounts": { "description": "Associated enrollment accounts. By default this is not populated, unless it's specified in $expand.", "type": "array", "items": { "$ref": "#/definitions/EnrollmentAccount" } } } }, "EnrollmentAccount": { "description": "An enrollment account.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of an enrollment account.", "x-ms-client-flatten": true, "$ref": "#/definitions/EnrollmentAccountProperties" } } }, "EnrollmentAccountProperties": { "description": "The properties of an enrollment account.", "properties": { "accountName": { "description": "The name of the enrollment account.", "type": "string" }, "costCenter": { "description": "The cost center associated with the enrollment account.", "type": "string" }, "accountOwner": { "description": "The owner of the enrollment account.", "type": "string" }, "accountOwnerEmail": { "description": "The enrollment account owner email address.", "type": "string" }, "status": { "description": "The status of the enrollment account.", "type": "string" }, "startDate": { "description": "The start date of the enrollment account.", "type": "string", "format": "date-time" }, "endDate": { "description": "The end date of the enrollment account.", "type": "string", "format": "date-time" }, "department": { "description": "Associated department. By default this is not populated, unless it's specified in $expand.", "$ref": "#/definitions/Department" } } }, "InstructionListResult": { "description": "The list of billing instructions used during invoice generation.", "properties": { "value": { "description": "The list of billing instructions used during invoice generation.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Instruction" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingProfileListResult": { "description": "The list of billing profiles.", "properties": { "value": { "description": "The list of billing profiles.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingProfile" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingProfile": { "description": "A billing profile.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of the billing profile.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingProfileProperties" } } }, "Instruction": { "description": "An instruction.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "A billing instruction used during invoice generation.", "x-ms-client-flatten": true, "$ref": "#/definitions/InstructionProperties" } } }, "InstructionProperties": { "description": "A billing instruction used during invoice generation.", "required": [ "amount", "startDate", "endDate" ], "properties": { "amount": { "description": "The amount budgeted for this billing instruction.", "type": "number" }, "startDate": { "description": "The date this billing instruction goes into effect.", "type": "string", "format": "date-time" }, "endDate": { "description": "The date this billing instruction is no longer in effect.", "type": "string", "format": "date-time" }, "creationDate": { "description": "The date this billing instruction was created.", "type": "string", "format": "date-time" } } }, "BillingProfileCreationRequest": { "description": "The request parameters for creating a new billing profile.", "properties": { "displayName": { "description": "The name of the billing profile.", "type": "string" }, "poNumber": { "description": "The purchase order name that will appear on the invoices generated for the billing profile.", "type": "string" }, "billTo": { "description": "The address of the individual or organization that is responsible for the billing profile.", "$ref": "#/definitions/AddressDetails" }, "invoiceEmailOptIn": { "description": "Flag controlling whether the invoices for the billing profile are sent through email.", "type": "boolean" }, "enabledAzurePlans": { "description": "Enabled azure plans for the billing profile.", "type": "array", "items": { "$ref": "#/definitions/AzurePlan" } } } }, "BillingProfileProperties": { "description": "The properties of the billing profile.", "properties": { "displayName": { "description": "The name of the billing profile.", "type": "string" }, "poNumber": { "description": "The purchase order name that will appear on the invoices generated for the billing profile.", "type": "string" }, "billingRelationshipType": { "description": "Identifies which services and purchases are paid by a billing profile.", "type": "string", "enum": [ "Direct", "IndirectCustomer", "IndirectPartner", "CSPPartner" ], "readOnly": true, "x-ms-enum": { "name": "BillingRelationshipType", "modelAsString": true } }, "billTo": { "description": "Billing address.", "$ref": "#/definitions/AddressDetails" }, "indirectRelationshipInfo": { "description": "Identifies the billing profile that is linked to another billing profile in indirect purchase motion.", "readOnly": true, "$ref": "#/definitions/IndirectRelationshipInfo" }, "invoiceEmailOptIn": { "description": "Flag controlling whether the invoices for the billing profile are sent through email.", "type": "boolean" }, "invoiceDay": { "description": "The day of the month when the invoice for the billing profile is generated.", "type": "integer", "format": "int32", "readOnly": true }, "currency": { "description": "The currency in which the charges for the billing profile are billed.", "type": "string", "readOnly": true }, "enabledAzurePlans": { "description": "Information about the enabled azure plans.", "type": "array", "items": { "$ref": "#/definitions/AzurePlan" } }, "invoiceSections": { "description": "The invoice sections associated to the billing profile. By default this is not populated, unless it's specified in $expand.", "$ref": "#/definitions/InvoiceSectionsOnExpand" }, "hasReadAccess": { "description": "Indicates whether user has read access to the billing profile.", "type": "boolean", "readOnly": true }, "systemId": { "description": "The system generated unique identifier for a billing profile.", "type": "string", "readOnly": true }, "status": { "description": "The status of the billing profile.", "enum": [ "Active", "Disabled", "Warned" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "BillingProfileStatus", "modelAsString": true } }, "statusReasonCode": { "description": "Reason for the specified billing profile status.", "enum": [ "PastDue", "SpendingLimitReached", "SpendingLimitExpired" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "StatusReasonCode", "modelAsString": true } }, "spendingLimit": { "description": "The billing profile spending limit.", "enum": [ "Off", "On" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "SpendingLimit", "modelAsString": true } }, "targetClouds": { "description": "Identifies the cloud environments that are associated with a billing profile. This is a system managed optional field and gets updated as the billing profile gets associated with accounts in various clouds.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/TargetCloud" } }, "tags": { "description": "Tags of billing profiles.", "type": "object", "additionalProperties": { "type": "string" }, "maxItems": 1000 } } }, "InvoiceSectionsOnExpand": { "description": "The invoice sections associated to the billing profile. By default this is not populated, unless it's specified in $expand.", "properties": { "hasMoreResults": { "description": "Indicates whether there are more invoice sections than the ones listed in this collection. The collection lists a maximum of 50 invoice sections. To get all invoice sections, use the list invoice sections API.", "type": "boolean", "readOnly": true }, "value": { "description": "The invoice sections associated to the billing profile.", "type": "array", "items": { "$ref": "#/definitions/InvoiceSection" } } } }, "AddressDetails": { "description": "Address details.", "required": [ "addressLine1", "country" ], "properties": { "firstName": { "description": "First name.", "type": "string" }, "middleName": { "description": "Middle name.", "type": "string" }, "lastName": { "description": "Last name.", "type": "string" }, "companyName": { "description": "Company name.", "type": "string" }, "addressLine1": { "description": "Address line 1.", "type": "string" }, "addressLine2": { "description": "Address line 2.", "type": "string" }, "addressLine3": { "description": "Address line 3.", "type": "string" }, "city": { "description": "Address city.", "type": "string" }, "district": { "description": "Address district.", "type": "string" }, "region": { "description": "Address region.", "type": "string" }, "country": { "description": "Country code uses ISO2, 2-digit format.", "type": "string" }, "postalCode": { "description": "Postal code.", "type": "string" }, "email": { "description": "Email address.", "type": "string" }, "phoneNumber": { "description": "Phone number.", "type": "string" } } }, "IndirectRelationshipInfo": { "description": "The billing profile details of the partner of the customer for an indirect motion.", "properties": { "billingAccountName": { "description": "The billing account name of the partner or the customer for an indirect motion.", "type": "string" }, "billingProfileName": { "description": "The billing profile name of the partner or the customer for an indirect motion.", "type": "string" }, "displayName": { "description": "The display name of the partner or customer for an indirect motion.", "type": "string" } } }, "InvoiceSectionCreationRequest": { "description": "The properties of the invoice section.", "properties": { "displayName": { "description": "The name of the invoice section.", "type": "string" } } }, "InvoiceSectionListResult": { "description": "The list of invoice sections.", "properties": { "value": { "description": "The list of invoice sections.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/InvoiceSection" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "InvoiceSection": { "description": "An invoice section.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of an invoice section.", "x-ms-client-flatten": true, "$ref": "#/definitions/InvoiceSectionProperties" } } }, "InvoiceSectionProperties": { "description": "The properties of an invoice section.", "properties": { "displayName": { "description": "The name of the invoice section.", "type": "string" }, "labels": { "type": "object", "description": "Dictionary of metadata associated with the invoice section.", "additionalProperties": { "type": "string" }, "maxItems": 50 }, "state": { "description": "Identifies the state of an invoice section.", "type": "string", "enum": [ "Active", "Restricted" ], "readOnly": true, "x-ms-enum": { "name": "InvoiceSectionState", "modelAsString": true } }, "systemId": { "description": "The system generated unique identifier for an invoice section.", "type": "string", "readOnly": true }, "tags": { "type": "object", "description": "Dictionary of metadata associated with the invoice section. Maximum key/value length supported of 256 characters. Keys/value should not empty value nor null. Keys can not contain < > % & \\ ? /", "additionalProperties": { "type": "string" }, "maxItems": 50 }, "targetCloud": { "description": "Identifies the cloud environments that are associated with an invoice section. This is a system managed optional field and gets updated as the invoice section gets associated with accounts in various clouds.", "$ref": "#/definitions/TargetCloud", "readOnly": true } } }, "InvoiceSectionListWithCreateSubPermissionResult": { "type": "object", "description": "The list of invoice section properties with create subscription permission.", "properties": { "value": { "description": "The list of invoice section properties with create subscription permission.", "type": "array", "items": { "$ref": "#/definitions/InvoiceSectionWithCreateSubPermission" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "InvoiceSectionWithCreateSubPermission": { "description": "Invoice section properties with create subscription permission.", "properties": { "invoiceSectionId": { "description": "The ID of the invoice section.", "type": "string", "readOnly": true }, "invoiceSectionDisplayName": { "description": "The name of the invoice section.", "type": "string", "readOnly": true }, "invoiceSectionSystemId": { "description": "The system generated unique identifier for an invoice section.", "type": "string", "readOnly": true }, "billingProfileId": { "description": "The ID of the billing profile for the invoice section.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile for the invoice section.", "type": "string", "readOnly": true }, "billingProfileStatus": { "description": "The status of the billing profile.", "enum": [ "Active", "Disabled", "Warned" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "BillingProfileStatus", "modelAsString": true } }, "billingProfileStatusReasonCode": { "description": "Reason for the specified billing profile status.", "enum": [ "PastDue", "SpendingLimitReached", "SpendingLimitExpired" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "StatusReasonCodeForBillingProfile", "modelAsString": true } }, "billingProfileSpendingLimit": { "description": "The billing profile spending limit.", "enum": [ "Off", "On" ], "readOnly": true, "type": "string", "x-ms-enum": { "name": "SpendingLimitForBillingProfile", "modelAsString": true } }, "billingProfileSystemId": { "description": "The system generated unique identifier for a billing profile.", "type": "string", "readOnly": true }, "enabledAzurePlans": { "description": "Enabled azure plans for the associated billing profile.", "type": "array", "items": { "$ref": "#/definitions/AzurePlan" } } } }, "AzurePlan": { "description": "Details of the Azure plan.", "properties": { "skuId": { "description": "The sku id.", "type": "string" }, "skuDescription": { "description": "The sku description.", "type": "string", "readOnly": true } } }, "DownloadUrl": { "description": "A secure URL that can be used to download a an entity until the URL expires.", "properties": { "expiryTime": { "description": "The time in UTC when the download URL will expire.", "type": "string", "format": "date-time", "readOnly": true }, "url": { "description": "The URL to the PDF file.", "type": "string", "readOnly": true } } }, "ErrorDetails": { "description": "The details of the error.", "properties": { "code": { "description": "Error code.", "type": "string", "readOnly": true }, "message": { "description": "Error message indicating why the operation failed.", "type": "string", "readOnly": true }, "target": { "description": "The target of the particular error.", "type": "string", "readOnly": true }, "details": { "description": "The sub details of the error.", "readOnly": true, "$ref": "#/definitions/ErrorSubDetails" } } }, "ErrorResponse": { "description": "Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.", "type": "object", "properties": { "error": { "description": "The details of the error.", "$ref": "#/definitions/ErrorDetails" } } }, "ErrorSubDetails": { "type": "array", "items": { "type": "object", "properties": { "code": { "description": "Error code.", "type": "string", "readOnly": true }, "message": { "description": "Error message indicating why the operation failed.", "type": "string", "readOnly": true }, "target": { "description": "The target of the particular error.", "type": "string", "readOnly": true } } } }, "Reseller": { "description": "Details of the reseller.", "properties": { "resellerId": { "description": "The MPN ID of the reseller.", "type": "string", "readOnly": true }, "description": { "description": "The name of the reseller.", "type": "string", "readOnly": true } } }, "Resource": { "description": "The Resource model definition.", "properties": { "id": { "readOnly": true, "type": "string", "description": "Resource Id." }, "name": { "readOnly": true, "type": "string", "description": "Resource name." }, "type": { "readOnly": true, "type": "string", "description": "Resource type." } }, "x-ms-azure-resource": true }, "InvoiceListResult": { "description": "The list of invoices.", "properties": { "value": { "description": "The list of invoices.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Invoice" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true } } }, "Invoice": { "description": "An invoice.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "An invoice.", "x-ms-client-flatten": true, "$ref": "#/definitions/InvoiceProperties" } } }, "InvoiceProperties": { "description": "The properties of the invoice.", "properties": { "dueDate": { "description": "The due date for the invoice.", "type": "string", "format": "date-time", "readOnly": true }, "invoiceDate": { "description": "The date when the invoice was generated.", "type": "string", "format": "date-time", "readOnly": true }, "status": { "description": "The current status of the invoice.", "type": "string", "enum": [ "Due", "OverDue", "Paid", "Void" ], "readOnly": true, "x-ms-enum": { "name": "InvoiceStatus", "modelAsString": true } }, "amountDue": { "description": "The amount due as of now.", "readOnly": true, "$ref": "#/definitions/Amount" }, "azurePrepaymentApplied": { "readOnly": true, "description": "The amount of Azure prepayment applied to the charges. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "$ref": "#/definitions/Amount" }, "billedAmount": { "description": "The total charges for the invoice billing period.", "readOnly": true, "$ref": "#/definitions/Amount" }, "creditAmount": { "description": "The total refund for returns and cancellations during the invoice billing period. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$ref": "#/definitions/Amount" }, "freeAzureCreditApplied": { "description": "The amount of free Azure credits applied to the charges. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$ref": "#/definitions/Amount" }, "subTotal": { "description": "The pre-tax amount due. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$ref": "#/definitions/Amount" }, "taxAmount": { "description": "The amount of tax charged for the billing period. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$ref": "#/definitions/Amount" }, "totalAmount": { "description": "The amount due when the invoice was generated. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$ref": "#/definitions/Amount" }, "invoicePeriodStartDate": { "description": "The start date of the billing period for which the invoice is generated.", "type": "string", "format": "date-time", "readOnly": true }, "invoicePeriodEndDate": { "description": "The end date of the billing period for which the invoice is generated.", "type": "string", "format": "date-time", "readOnly": true }, "invoiceType": { "description": "Invoice type.", "enum": [ "AzureService", "AzureMarketplace", "AzureSupport" ], "type": "string", "readOnly": true, "x-ms-enum": { "name": "InvoiceType", "modelAsString": true } }, "isMonthlyInvoice": { "description": "Specifies if the invoice is generated as part of monthly invoicing cycle or not. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "type": "boolean", "readOnly": true }, "billingProfileId": { "description": "The ID of the billing profile for which the invoice is generated.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile for which the invoice is generated.", "type": "string", "readOnly": true }, "purchaseOrderNumber": { "description": "An optional purchase order number for the invoice.", "type": "string", "readOnly": true }, "documents": { "description": "List of documents available to download such as invoice and tax receipt.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Document" } }, "payments": { "description": "List of payments.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/PaymentProperties" } }, "rebillDetails": { "description": "Rebill details for an invoice.", "type": "object", "readOnly": true, "additionalProperties": { "type": "object", "$ref": "#/definitions/RebillDetails" } }, "documentType": { "description": "The type of the document.", "type": "string", "enum": [ "Invoice", "CreditNote" ], "readOnly": true, "x-ms-enum": { "name": "InvoiceDocumentType", "modelAsString": true } }, "billedDocumentId": { "description": "The Id of the active invoice which is originally billed after this invoice was voided. This field is applicable to the void invoices only.", "type": "string", "readOnly": true }, "creditForDocumentId": { "description": "The Id of the invoice which got voided and this credit note was issued as a result. This field is applicable to the credit notes only.", "type": "string", "readOnly": true }, "subscriptionId": { "description": "The ID of the subscription for which the invoice is generated.", "type": "string", "readOnly": true } } }, "PaymentProperties": { "description": "The properties of a payment.", "properties": { "paymentType": { "description": "The type of payment.", "type": "string", "readOnly": true }, "amount": { "description": "The paid amount.", "readOnly": true, "$ref": "#/definitions/Amount" }, "date": { "description": "The date when the payment was made.", "type": "string", "format": "date-time", "readOnly": true }, "paymentMethodFamily": { "description": "The family of payment method.", "type": "string", "enum": [ "Credits", "CheckWire", "CreditCard", "None" ], "x-ms-enum": { "name": "PaymentMethodFamily", "modelAsString": true } }, "paymentMethodType": { "description": "The type of payment method.", "type": "string", "readOnly": true } } }, "RebillDetails": { "description": "The rebill details of an invoice.", "properties": { "creditNoteDocumentId": { "description": "The ID of credit note.", "type": "string", "readOnly": true }, "invoiceDocumentId": { "description": "The ID of invoice.", "type": "string", "readOnly": true }, "rebillDetails": { "description": "Rebill details for an invoice.", "type": "object", "readOnly": true, "additionalProperties": { "type": "object", "$ref": "#/definitions/RebillDetails" } } } }, "Document": { "description": "The properties of a document.", "properties": { "kind": { "description": "The type of the document.", "type": "string", "enum": [ "Invoice", "VoidNote", "TaxReceipt", "CreditNote" ], "readOnly": true, "x-ms-enum": { "name": "DocumentType", "modelAsString": true } }, "url": { "description": "Document URL.", "type": "string", "readOnly": true }, "source": { "description": "The source of the document. ENF for Brazil and DRS for rest of the world.", "type": "string", "enum": [ "DRS", "ENF" ], "readOnly": true, "x-ms-enum": { "name": "DocumentSource", "modelAsString": true } } } }, "ProductsListResult": { "description": "The list of products. It contains a list of available product summaries in reverse chronological order by purchase date.", "properties": { "value": { "description": "The list of products.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Product" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "Product": { "description": "A product.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/ProductProperties", "title": "Product properties" } } }, "ProductProperties": { "description": "The properties of a product.", "properties": { "autoRenew": { "description": "Indicates whether auto renewal is turned on or off for a product.", "type": "string", "enum": [ "Off", "On" ], "x-ms-enum": { "name": "AutoRenew", "modelAsString": true } }, "displayName": { "description": "The display name of the product.", "type": "string", "readOnly": true }, "purchaseDate": { "description": "The date when the product was purchased.", "type": "string", "format": "date-time", "readOnly": true }, "productTypeId": { "description": "The ID of the type of product.", "type": "string", "readOnly": true }, "productType": { "description": "The description of the type of product.", "type": "string", "readOnly": true }, "status": { "description": "The current status of the product.", "type": "string", "enum": [ "Active", "Inactive", "PastDue", "Expiring", "Expired", "Disabled", "Cancelled", "AutoRenew" ], "x-ms-enum": { "name": "ProductStatusType", "modelAsString": true } }, "endDate": { "description": "The date when the product will be renewed or canceled.", "type": "string", "format": "date-time", "readOnly": true }, "billingFrequency": { "description": "The frequency at which the product will be billed.", "type": "string", "enum": [ "OneTime", "Monthly", "UsageBased" ], "x-ms-enum": { "name": "BillingFrequency", "modelAsString": true } }, "lastCharge": { "description": "The last month charges.", "readOnly": true, "$ref": "#/definitions/Amount" }, "lastChargeDate": { "description": "The date of the last charge.", "type": "string", "format": "date-time", "readOnly": true }, "quantity": { "description": "The quantity purchased for the product.", "type": "number", "readOnly": true }, "skuId": { "description": "The sku ID of the product.", "type": "string", "readOnly": true }, "skuDescription": { "description": "The sku description of the product.", "type": "string", "readOnly": true }, "tenantId": { "description": "The id of the tenant in which the product is used.", "type": "string", "readOnly": true }, "availabilityId": { "description": "The availability of the product.", "type": "string", "readOnly": true }, "invoiceSectionId": { "description": "The ID of the invoice section to which the product is billed.", "type": "string", "readOnly": true }, "invoiceSectionDisplayName": { "description": "The name of the invoice section to which the product is billed.", "type": "string", "readOnly": true }, "billingProfileId": { "description": "The ID of the billing profile to which the product is billed.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile to which the product is billed.", "type": "string", "readOnly": true }, "customerId": { "description": "The ID of the customer for whom the product was purchased. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "customerDisplayName": { "description": "The name of the customer for whom the product was purchased. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "reseller": { "description": "Reseller for this product.", "readOnly": true, "$ref": "#/definitions/Reseller" } } }, "ValidateProductTransferEligibilityResult": { "type": "object", "description": "Result of the product transfer eligibility validation.", "properties": { "isMoveEligible": { "description": "Specifies whether the transfer is eligible or not.", "type": "boolean", "readOnly": true }, "errorDetails": { "description": "Validation error details.", "$ref": "#/definitions/ValidateProductTransferEligibilityError" } } }, "ValidateProductTransferEligibilityError": { "type": "object", "description": "Error details of the product transfer eligibility validation.", "properties": { "code": { "description": "Error code for the product transfer validation.", "$ref": "#/definitions/ProductTransferValidationErrorCode" }, "message": { "description": "The error message.", "type": "string" }, "details": { "description": "Detailed error message explaining the error.", "type": "string" } } }, "ProductTransferValidationErrorCode": { "type": "string", "description": "Error code of the transfer validation response.", "enum": [ "InvalidSource", "ProductNotActive", "InsufficientPermissionOnSource", "InsufficientPermissionOnDestination", "DestinationBillingProfilePastDue", "ProductTypeNotSupported", "CrossBillingAccountNotAllowed", "NotAvailableForDestinationMarket", "OneTimePurchaseProductTransferNotAllowed" ], "x-ms-enum": { "name": "ProductTransferValidationErrorCode", "modelAsString": true } }, "BillingSubscriptionsListResult": { "description": "The list of billing subscriptions.", "properties": { "value": { "description": "The list of billing subscriptions.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingSubscription" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingSubscription": { "description": "A billing subscription.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/BillingSubscriptionProperties", "title": "Billing subscription properties" } } }, "BillingSubscriptionProperties": { "description": "The billing properties of a subscription.", "properties": { "displayName": { "description": "The name of the subscription.", "type": "string", "readOnly": true }, "subscriptionId": { "description": "The ID of the subscription.", "type": "string", "format": "uuid", "readOnly": true }, "subscriptionBillingStatus": { "description": "The current billing status of the subscription.", "type": "string", "enum": [ "Active", "Inactive", "Abandoned", "Deleted", "Warning" ], "x-ms-enum": { "name": "BillingSubscriptionStatusType", "modelAsString": true } }, "lastMonthCharges": { "description": "The last month charges.", "readOnly": true, "$ref": "#/definitions/Amount" }, "monthToDateCharges": { "description": "The current month to date charges.", "readOnly": true, "$ref": "#/definitions/Amount" }, "billingProfileId": { "description": "The ID of the billing profile to which the subscription is billed.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile to which the subscription is billed.", "type": "string", "readOnly": true }, "costCenter": { "description": "The cost center applied to the subscription.", "type": "string" }, "customerId": { "description": "The ID of the customer for whom the subscription was created. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "customerDisplayName": { "description": "The name of the customer for whom the subscription was created. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "invoiceSectionId": { "description": "The ID of the invoice section to which the subscription is billed.", "type": "string", "readOnly": true }, "invoiceSectionDisplayName": { "description": "The name of the invoice section to which the subscription is billed.", "type": "string", "readOnly": true }, "reseller": { "description": "Reseller for this subscription.", "readOnly": true, "$ref": "#/definitions/Reseller" }, "skuId": { "description": "The sku ID of the Azure plan for the subscription.", "type": "string" }, "skuDescription": { "description": "The sku description of the Azure plan for the subscription.", "type": "string", "readOnly": true }, "suspensionReasons": { "description": "The suspension reason for a subscription. Applies only to subscriptions in Microsoft Online Services Program billing accounts.", "type": "array", "readOnly": true, "items": { "type": "string" } } } }, "EnrollmentAccountContext": { "description": "The enrollment account context", "properties": { "costCenter": { "description": "The cost center associated with the enrollment account.", "type": "string" }, "startDate": { "description": "The start date of the enrollment account.", "type": "string", "format": "date-time" }, "endDate": { "description": "The end date of the enrollment account.", "type": "string", "format": "date-time" }, "enrollmentAccountName": { "description": "The ID of the enrollment account.", "type": "string" } } }, "TargetCloud": { "type": "string", "description": "Possible cloud environments.", "enum": [ "USGov", "USNat", "USSec" ], "x-ms-enum": { "name": "targetCloud", "modelAsString": true } }, "TransactionListResult": { "description": "The list of transactions.", "properties": { "value": { "description": "The list of transactions.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Transaction" } }, "totalCount": { "description": "Total number of records.", "type": "number", "format": "int32", "readOnly": true }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "Transaction": { "description": "A transaction.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/TransactionProperties", "title": "Transaction properties" } } }, "TransactionProperties": { "description": "The properties of a transaction.", "properties": { "kind": { "type": "string", "description": "The kind of transaction. Options are all or reservation.", "enum": [ "all", "reservation" ], "x-ms-enum": { "name": "TransactionTypeKind", "modelAsString": true } }, "date": { "description": "The date of transaction.", "type": "string", "format": "date-time", "readOnly": true }, "invoice": { "description": "Invoice on which the transaction was billed or 'pending' if the transaction is not billed.", "type": "string", "readOnly": true }, "invoiceId": { "description": "The ID of the invoice on which the transaction was billed. This field is only applicable for transactions which are billed.", "type": "string", "readOnly": true }, "orderId": { "description": "The order ID of the reservation. The field is only applicable for transaction of kind reservation.", "type": "string", "readOnly": true }, "orderName": { "description": "The name of the reservation order. The field is only applicable for transactions of kind reservation.", "type": "string", "readOnly": true }, "productFamily": { "description": "The family of the product for which the transaction took place.", "type": "string", "readOnly": true }, "productTypeId": { "description": "The ID of the product type for which the transaction took place.", "type": "string", "readOnly": true }, "productType": { "description": "The type of the product for which the transaction took place.", "type": "string", "readOnly": true }, "productDescription": { "description": "The description of the product for which the transaction took place.", "type": "string", "readOnly": true }, "transactionType": { "description": "The type of transaction.", "type": "string", "enum": [ "Purchase", "Usage Charge" ], "x-ms-enum": { "name": "ReservationType", "modelAsString": true } }, "transactionAmount": { "description": "The charge associated with the transaction.", "readOnly": true, "$ref": "#/definitions/Amount" }, "quantity": { "description": "The quantity purchased in the transaction.", "type": "integer", "format": "int32", "readOnly": true }, "invoiceSectionId": { "description": "The ID of the invoice section which will be billed for the transaction.", "type": "string", "readOnly": true }, "invoiceSectionDisplayName": { "description": "The name of the invoice section which will be billed for the transaction.", "type": "string", "readOnly": true }, "billingProfileId": { "description": "The ID of the billing profile which will be billed for the transaction.", "type": "string", "readOnly": true }, "billingProfileDisplayName": { "description": "The name of the billing profile which will be billed for the transaction.", "type": "string", "readOnly": true }, "customerId": { "description": "The ID of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "customerDisplayName": { "description": "The name of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.", "type": "string", "readOnly": true }, "subscriptionId": { "description": "The ID of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.", "type": "string", "readOnly": true }, "subscriptionName": { "description": "The name of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.", "type": "string", "readOnly": true }, "azurePlan": { "description": "The type of azure plan of the subscription that was used for the transaction.", "type": "string", "readOnly": true }, "azureCreditApplied": { "description": "The amount of any Azure credits automatically applied to this transaction.", "readOnly": true, "$ref": "#/definitions/Amount" }, "billingCurrency": { "description": "The ISO 4217 code for the currency in which this transaction is billed.", "type": "string", "readOnly": true }, "discount": { "description": "The percentage discount, if any, applied to this transaction.", "type": "number", "readOnly": true }, "effectivePrice": { "description": "The price of the product after applying any discounts.", "readOnly": true, "$ref": "#/definitions/Amount" }, "exchangeRate": { "description": "The exchange rate used to convert charged amount to billing currency, if applicable.", "type": "number", "readOnly": true }, "marketPrice": { "description": "The retail price of the product.", "readOnly": true, "$ref": "#/definitions/Amount" }, "pricingCurrency": { "description": "The ISO 4217 code for the currency in which the product is priced.", "type": "string", "readOnly": true }, "servicePeriodStartDate": { "description": "The date of the purchase of the product, or the start date of the month in which usage started.", "type": "string", "format": "date-time", "readOnly": true }, "servicePeriodEndDate": { "description": "The end date of the product term, or the end date of the month in which usage ended.", "type": "string", "format": "date-time", "readOnly": true }, "subTotal": { "description": "The pre-tax charged amount for the transaction.", "readOnly": true, "$ref": "#/definitions/Amount" }, "tax": { "description": "The tax amount applied to the transaction.", "readOnly": true, "$ref": "#/definitions/Amount" }, "unitOfMeasure": { "description": "The unit of measure used to bill for the product. For example, compute services are billed per hour.", "type": "string", "readOnly": true }, "units": { "description": "The number of units used for a given product.", "type": "number", "readOnly": true }, "unitType": { "description": "The description for the unit of measure for a given product.", "type": "string", "readOnly": true } } }, "Policy": { "description": "A policy.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/PolicyProperties", "title": "Policy properties" } } }, "PolicyProperties": { "description": "The properties of a policy.", "properties": { "marketplacePurchases": { "description": "The policy that controls whether Azure marketplace purchases are allowed for a billing profile.", "type": "string", "enum": [ "AllAllowed", "OnlyFreeAllowed", "NotAllowed" ], "x-ms-enum": { "name": "MarketplacePurchasesPolicy", "modelAsString": true } }, "reservationPurchases": { "description": "The policy that controls whether Azure reservation purchases are allowed for a billing profile.", "type": "string", "enum": [ "Allowed", "NotAllowed" ], "x-ms-enum": { "name": "ReservationPurchasesPolicy", "modelAsString": true } }, "viewCharges": { "description": "The policy that controls whether users with Azure RBAC access to a subscription can view its charges.", "type": "string", "enum": [ "Allowed", "NotAllowed" ], "x-ms-enum": { "name": "ViewChargesPolicy", "modelAsString": true } } } }, "CustomerPolicy": { "description": "The customer's Policy.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/CustomerPolicyProperties", "title": "Customer Policy properties" } } }, "CustomerPolicyProperties": { "description": "The properties of a customer's policy.", "properties": { "viewCharges": { "description": "The policy that controls whether the users in customer's organization can view charges at pay-as-you-go prices.", "type": "string", "enum": [ "Allowed", "NotAllowed" ], "x-ms-enum": { "name": "ViewCharges", "modelAsString": true } } } }, "AvailableBalance": { "description": "The latest Azure credit balance. This is the balance available for pay now.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/AvailableBalanceProperties", "title": "Available balance properties" } } }, "AvailableBalanceProperties": { "description": "The properties of available balance.", "properties": { "amount": { "description": "Balance amount.", "readOnly": true, "$ref": "#/definitions/Amount" } } }, "Amount": { "description": "The amount.", "properties": { "currency": { "description": "The currency for the amount value.", "type": "string", "readOnly": true }, "value": { "description": "Amount value.", "type": "number" } } }, "BillingRoleAssignmentListResult": { "description": "The list of role assignments.", "properties": { "value": { "description": "The list of role assignments.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingRoleAssignment" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingRoleAssignment": { "description": "The role assignment", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of the role assignment.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingRoleAssignmentProperties" } } }, "BillingRoleAssignmentProperties": { "description": "The properties of the role assignment.", "properties": { "createdOn": { "description": "The date the role assignment was created.", "type": "string", "readOnly": true }, "createdByPrincipalTenantId": { "description": "The tenant Id of the user who created the role assignment.", "type": "string", "readOnly": true }, "createdByPrincipalId": { "description": "The principal Id of the user who created the role assignment.", "type": "string", "readOnly": true }, "createdByUserEmailAddress": { "description": "The email address of the user who created the role assignment.", "type": "string", "readOnly": true }, "principalId": { "description": "The principal id of the user to whom the role was assigned.", "type": "string" }, "principalTenantId": { "description": "The principal tenant id of the user to whom the role was assigned.", "type": "string" }, "roleDefinitionId": { "description": "The ID of the role definition.", "type": "string" }, "scope": { "description": "The scope at which the role was assigned.", "type": "string", "readOnly": true }, "userAuthenticationType": { "description": "The authentication type.", "type": "string" }, "userEmailAddress": { "description": "The email address of the user.", "type": "string" } } }, "BillingRoleDefinitionListResult": { "description": "The list of role definitions.", "properties": { "value": { "description": "The role definitions.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingRoleDefinition" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingRoleDefinition": { "description": "The properties of a role definition.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of the a role definition.", "x-ms-client-flatten": true, "$ref": "#/definitions/BillingRoleDefinitionProperties" } } }, "BillingRoleDefinitionProperties": { "description": "The properties of the a role definition.", "properties": { "description": { "description": "The role description", "type": "string", "readOnly": true }, "permissions": { "description": "The billingPermissions the role has", "type": "array", "items": { "$ref": "#/definitions/BillingPermissionsProperties" } }, "roleName": { "description": "The name of the role", "type": "string", "readOnly": true } } }, "BillingPermissionsListResult": { "description": "Result of list billingPermissions a caller has on a billing account.", "properties": { "value": { "description": "The list of billingPermissions a caller has on a billing account.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BillingPermissionsProperties" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "BillingPermissionsProperties": { "description": "The set of allowed action and not allowed actions a caller has on a billing account", "type": "object", "properties": { "actions": { "description": "The set of actions that the caller is allowed to perform.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Action" } }, "notActions": { "description": "The set of actions that the caller is not allowed to perform.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/NotAction" } } } }, "AgreementListResult": { "description": "Result of listing agreements.", "properties": { "value": { "description": "The list of agreements.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Agreement" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "Agreement": { "description": "An agreement.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "description": "The properties of an agreement.", "x-ms-client-flatten": true, "$ref": "#/definitions/AgreementProperties" } } }, "AgreementProperties": { "description": "The properties of an agreement.", "properties": { "agreementLink": { "description": "The URL to download the agreement.", "type": "string", "readOnly": true }, "category": { "type": "string", "description": "The category of the agreement signed by a customer.", "readOnly": true, "enum": [ "MicrosoftCustomerAgreement", "AffiliatePurchaseTerms", "Other" ], "x-ms-enum": { "name": "category", "modelAsString": true } }, "acceptanceMode": { "type": "string", "description": "The mode of acceptance for an agreement.", "readOnly": true, "enum": [ "Other", "ClickToAccept", "ESignEmbedded", "ESignOffline", "PhysicalSign", "Offline", "Implicit" ], "x-ms-enum": { "name": "acceptanceMode", "modelAsString": true } }, "billingProfileInfo": { "description": "The list of billing profiles associated with agreement and present only for specific agreements.", "readOnly": true, "$ref": "#/definitions/BillingProfileInfo" }, "effectiveDate": { "description": "The date from which the agreement is effective.", "type": "string", "format": "date-time", "readOnly": true }, "expirationDate": { "description": "The date when the agreement expires.", "type": "string", "format": "date-time", "readOnly": true }, "participants": { "description": "The list of participants that participates in acceptance of an agreement.", "type": "array", "items": { "$ref": "#/definitions/Participants" } }, "status": { "description": "The current status of the agreement.", "type": "string", "readOnly": true } } }, "BillingProfileInfo": { "description": "Details about billing profile associated with agreement and available only for specific agreements.", "type": "object", "properties": { "billingProfileId": { "description": "The unique identifier for the billing profile.", "type": "string" }, "billingProfileDisplayName": { "description": "The name of the billing profile", "type": "string" }, "indirectRelationshipOrganizationName": { "description": "Billing account name. This property is available for a specific type of agreement.", "type": "string" } } }, "Participants": { "description": "The details about a participant.", "properties": { "status": { "description": "The acceptance status of the participant.", "type": "string", "readOnly": true }, "statusDate": { "description": "The date when the status got changed.", "type": "string", "format": "date-time", "readOnly": true }, "email": { "description": "The email address of the participant.", "type": "string", "readOnly": true } } }, "Action": { "description": "The action the caller is allowed to perform.", "type": "string", "readOnly": true }, "NotAction": { "description": "The set of actions that the caller is not allowed to perform.", "type": "string", "readOnly": true }, "ReservationsListResult": { "description": "The list of reservations and summary of roll out count of reservations in each state.", "properties": { "value": { "description": "The list of reservations.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Reservation" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true }, "summary": { "description": "The roll out count summary of the reservations", "type": "object", "$ref": "#/definitions/ReservationSummary" } } }, "Reservation": { "description": "The definition of the reservation.", "properties": { "id": { "description": "The id of the reservation.", "type": "string", "readOnly": true }, "name": { "description": "The name of the reservation.", "type": "string", "readOnly": true }, "type": { "description": "The type of the reservation.", "type": "string", "readOnly": true }, "location": { "description": "The location of the reservation.", "type": "string", "readOnly": true }, "sku": { "description": "The sku information associated to this reservation ", "type": "object", "$ref": "#/definitions/ReservationSkuProperty" }, "properties": { "description": "The properties associated to this reservation ", "type": "object", "x-ms-client-flatten": true, "$ref": "#/definitions/ReservationProperty" } } }, "ReservationSkuProperty": { "description": "The property of reservation sku object.", "properties": { "name": { "description": "The name of the reservation sku.", "type": "string", "readOnly": true } } }, "ReservationProperty": { "description": "The property of reservation object.", "properties": { "appliedScopes": { "description": "The array of applied scopes of a reservation. Will be null if the reservation is in Shared scope", "type": "array", "items": { "$ref": "#/definitions/ReservationAppliedScope" } }, "appliedScopeType": { "description": "The applied scope type of the reservation.", "type": "string", "readOnly": true }, "reservedResourceType": { "description": "The reserved source type of the reservation, e.g. virtual machine.", "type": "string", "readOnly": true }, "quantity": { "description": "The number of the reservation.", "type": "number", "readOnly": true }, "provisioningState": { "description": "The provisioning state of the reservation, e.g. Succeeded", "type": "string", "readOnly": true }, "expiryDate": { "description": "The expiry date of the reservation", "type": "string", "readOnly": true }, "provisioningSubState": { "description": "The provisioning state of the reservation, e.g. Succeeded", "type": "string", "readOnly": true }, "displayName": { "description": "The display name of the reservation", "type": "string", "readOnly": true }, "displayProvisioningState": { "description": "The provisioning state of the reservation for display, e.g. Succeeded", "type": "string", "readOnly": true }, "userFriendlyRenewState": { "description": "The renew state of the reservation for display, e.g. On", "type": "string", "readOnly": true }, "userFriendlyAppliedScopeType": { "description": "The applied scope type of the reservation for display, e.g. Shared", "type": "string", "readOnly": true }, "effectiveDateTime": { "description": "The effective date time of the reservation", "type": "string", "readOnly": true }, "skuDescription": { "description": "The sku description of the reservation", "type": "string", "readOnly": true }, "term": { "description": "The term of the reservation, e.g. P1Y", "type": "string", "readOnly": true }, "renew": { "description": "The renew state of the reservation", "type": "boolean", "readOnly": true }, "renewSource": { "description": "The renew source of the reservation", "type": "string", "readOnly": true }, "utilization": { "readOnly": true, "type": "object", "description": "Reservation utilization", "properties": { "trend": { "description": "The number of days trend for a reservation", "readOnly": true, "type": "string" }, "aggregates": { "description": "The array of aggregates of a reservation's utilization", "type": "array", "items": { "$ref": "#/definitions/ReservationUtilizationAggregates" } } } } } }, "ReservationAppliedScope": { "readOnly": true, "type": "string", "description": "Reservation applied scope" }, "ReservationUtilizationAggregates": { "description": "The aggregate values of reservation utilization", "type": "object", "properties": { "grain": { "description": "The grain of the aggregate", "readOnly": true, "type": "number" }, "grainUnit": { "description": "The grain unit of the aggregate", "readOnly": true, "type": "string" }, "value": { "description": "The aggregate value", "readOnly": true, "type": "number" }, "valueUnit": { "description": "The aggregate value unit", "readOnly": true, "type": "string" } } }, "ReservationSummary": { "description": "The roll up count summary of reservations in each state", "type": "object", "properties": { "succeededCount": { "description": "The number of reservation in Succeeded state", "readOnly": true, "type": "number" }, "failedCount": { "description": "The number of reservation in Failed state", "readOnly": true, "type": "number" }, "expiringCount": { "description": "The number of reservation in Expiring state", "readOnly": true, "type": "number" }, "expiredCount": { "description": "The number of reservation in Expired state", "readOnly": true, "type": "number" }, "pendingCount": { "description": "The number of reservation in Pending state", "readOnly": true, "type": "number" }, "cancelledCount": { "description": "The number of reservation in Cancelled state", "readOnly": true, "type": "number" } } } }, "parameters": { "apiVersionParameter": { "name": "api-version", "in": "query", "required": true, "type": "string", "description": "The version of the API to be used with the client request. The current version is 2020-05-01." }, "subscriptionIdParameter": { "name": "subscriptionId", "in": "path", "description": "The ID that uniquely identifies an Azure subscription.", "required": true, "type": "string" }, "billingAccountNameParameter": { "name": "billingAccountName", "in": "path", "description": "The ID that uniquely identifies a billing account.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "invoiceSectionNameParameter": { "name": "invoiceSectionName", "in": "path", "description": "The ID that uniquely identifies an invoice section.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "enrollmentAccountNameParameter": { "name": "enrollmentAccountName", "in": "path", "description": "The ID that uniquely identifies an enrollment account.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "departmentNameParameter": { "name": "departmentName", "in": "path", "description": "The ID that uniquely identifies a department.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "instructionNameParameter": { "name": "instructionName", "in": "path", "description": "Instruction Name.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "billingProfileNameParameter": { "name": "billingProfileName", "in": "path", "description": "The ID that uniquely identifies a billing profile.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "operationIdParameter": { "name": "operationId", "in": "path", "description": "Operation Id.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "billingRoleDefinitionNameParameter": { "name": "billingRoleDefinitionName", "in": "path", "description": "The ID that uniquely identifies a role definition.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "billingRoleAssignmentNameParameter": { "name": "billingRoleAssignmentName", "in": "path", "description": "The ID that uniquely identifies a role assignment.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "invoiceNameParameter": { "name": "invoiceName", "in": "path", "description": "The ID that uniquely identifies an invoice.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "productNameParameter": { "name": "productName", "in": "path", "description": "The ID that uniquely identifies a product.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "agreementNameParameter": { "name": "agreementName", "in": "path", "description": "The ID that uniquely identifies an agreement.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "transactionNameParameter": { "name": "transactionName", "in": "path", "description": "The ID that uniquely identifies a transaction.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "customerNameParameter": { "name": "customerName", "in": "path", "description": "The ID that uniquely identifies a customer.", "required": true, "type": "string", "x-ms-parameter-location": "method" } }, "security": [ { "azure_auth": [ "user_impersonation" ] } ], "securityDefinitions": { "azure_auth": { "type": "oauth2", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "flow": "implicit", "description": "Azure Active Directory OAuth2 Flow.", "scopes": { "user_impersonation": "impersonate your user account" } } } }