{ "swagger": "2.0", "info": { "version": "2019-10-01-preview", "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.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "name": "$expand", "description": "May be used to expand the address, 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" } } } } }, "/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.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the address, 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.", "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/billingAccounts/{billingAccountName}/paymentMethods": { "get": { "tags": [ "PaymentMethods" ], "operationId": "PaymentMethods_ListByBillingAccount", "description": "Lists the payment Methods for a billing account. 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/2019-10-01-preview/paymentmethods" }, "x-ms-examples": { "PaymentMethodsListByBillingAccount": { "$ref": "./examples/PaymentMethodsListByBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/PaymentMethodsListResult" } }, "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 a billing account or a billing profile address.", "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_GetByBillingProfile", "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.", "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.", "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/{billingProfileName}/paymentMethods": { "get": { "tags": [ "PaymentMethods" ], "operationId": "PaymentMethods_ListByBillingProfile", "description": "Lists the payment Methods for a billing profile. 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": { "PaymentMethodsListByBillingProfile": { "$ref": "./examples/PaymentMethodsListByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/PaymentMethodsListResult" } }, "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}/validateDetachPaymentMethodEligibility": { "get": { "tags": [ "BillingProfiles" ], "x-ms-examples": { "ValidateDetachPaymentMethodEligibilitySuccess": { "$ref": "./examples/ValidateDetachPaymentMethodEligibilitySuccess.json" }, "ValidateDetachPaymentMethodEligibilityFailure": { "$ref": "./examples/ValidateDetachPaymentMethodEligibilityFailure.json" } }, "operationId": "BillingProfiles_GetEligibilityToDetachPaymentMethod", "description": "Validates if the default payment method can be detached from the billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/DetachPaymentMethodEligibilityResult" } }, "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.", "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" } } } } }, "/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.", "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_Create", "x-ms-long-running-operation": true, "description": "Creates 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/CreateBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingProfileCreationRequest" }, "description": "Request parameters that are provided to the create billing profile operation." } ], "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" } } } }, "patch": { "tags": [ "BillingProfiles" ], "operationId": "BillingProfiles_Update", "x-ms-long-running-operation": true, "description": "Updates the properties of a billing profile. Currently, displayName, poNumber, bill-to address and invoiceEmailOptIn can be updated. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.", "x-ms-examples": { "UpdateBillingProfile": { "$ref": "./examples/UpdateBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingProfile" }, "description": "Request parameters supplied to the update billing profile operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/BillingProfile" } }, "202": { "description": "Accepted. Billing profile update is in progress.", "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" } } }, "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.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "$filter", "description": "May be used to filter the list of customers.", "in": "query", "required": false, "type": "string" }, { "name": "$skiptoken", "description": "Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skiptoken parameter that specifies a starting point to use for subsequent calls.", "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.", "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" } } } } }, "/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.", "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_Create", "x-ms-long-running-operation": true, "description": "Creates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "CreateInvoiceSection": { "$ref": "./examples/CreateInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/InvoiceSectionCreationRequest" }, "description": "Request parameters that are provided to the create invoice section operation." } ], "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" } } } }, "patch": { "tags": [ "InvoiceSections" ], "operationId": "InvoiceSections_Update", "x-ms-long-running-operation": true, "description": "Updates an invoice section. Currently, only displayName can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "UpdateInvoiceSection": { "$ref": "./examples/UpdateInvoiceSection.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": "Request parameters that are provided to the update invoice section operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/InvoiceSection" } }, "202": { "description": "Accepted. InvoiceSection update is in progress.", "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" } } }, "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.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$filter", "description": "May be used to filter the list of customers.", "in": "query", "required": false, "type": "string" }, { "name": "$skiptoken", "description": "Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skiptoken parameter that specifies a starting point to use for subsequent calls.", "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.", "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.", "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" } } } } }, "/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}/billingSubscriptions/{billingSubscriptionName}": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_GetByCustomer", "description": "Gets a subscription 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/" }, "x-ms-examples": { "BillingSubscriptionByCustomer": { "$ref": "./examples/BillingSubscriptionByCustomer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "$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" } } } } }, "/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" }, { "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/products/{productName}": { "get": { "tags": [ "Products" ], "operationId": "Products_GetByCustomer", "description": "Gets a product by 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/" }, "x-ms-examples": { "Product": { "$ref": "./examples/ProductByCustomer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/transactions": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_ListByCustomer", "description": "Lists the billed and unbilled transactions by customer id for given start date and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice Id and do not include tax. Tax is added to the amount once an invoice is generated.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "TransactionsListByCustomer": { "$ref": "./examples/TransactionsListByCustomer.json" }, "ReservationTransactionsListByCustomer": { "$ref": "./examples/ReservationTransactionsListByCustomer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "periodStartDate", "in": "query", "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "periodEndDate", "in": "query", "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "$filter", "description": "May be used to filter by transaction 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/TransactionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments": { "get": { "tags": [ "Departments" ], "x-ms-examples": { "DepartmentsListByBillingAccount": { "$ref": "./examples/DepartmentsListByBillingAccount.json" }, "DepartmentsListByBillingAccountWithExpand": { "$ref": "./examples/DepartmentsListByBillingAccountWithExpand.json" } }, "operationId": "Departments_ListByBillingAccountName", "description": "Lists the departments that a user has access to. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the enrollment accounts.", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter by department name. 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/DepartmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}": { "get": { "tags": [ "Departments" ], "x-ms-examples": { "Department": { "$ref": "./examples/Department.json" }, "DepartmentWithExpand": { "$ref": "./examples/DepartmentWithExpand.json" } }, "operationId": "Departments_Get", "description": "Gets a department by ID. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" }, { "name": "$expand", "description": "May be used to expand the enrollment accounts.", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter by department name. 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/Department" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts": { "get": { "tags": [ "EnrollmentAccounts" ], "x-ms-examples": { "EnrollmentAccountsListByBillingAccount": { "$ref": "./examples/EnrollmentAccountsListByBillingAccount.json" }, "EnrollmentAccountsListByBillingAccountWithExpand": { "$ref": "./examples/EnrollmentAccountsListByBillingAccountWithExpand.json" } }, "operationId": "EnrollmentAccounts_ListByBillingAccountName", "description": "Lists the enrollment accounts for a billing account. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the department.", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter by account name. 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/EnrollmentAccountListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}": { "get": { "tags": [ "EnrollmentAccounts" ], "x-ms-examples": { "EnrollmentAccount": { "$ref": "./examples/EnrollmentAccount.json" }, "EnrollmentAccountWithExpand": { "$ref": "./examples/EnrollmentAccountWithExpand.json" } }, "operationId": "EnrollmentAccounts_GetByEnrollmentAccountId", "description": "Gets an enrollment account by ID. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" }, { "name": "$expand", "description": "May be used to expand the department.", "in": "query", "required": false, "type": "string" }, { "name": "$filter", "description": "May be used to filter by account name. 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/EnrollmentAccount" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "BillingAccountInvoicesList": { "$ref": "./examples/BillingAccountInvoicesList.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, Microsoft Customer Agreement or Enterprise Agreement.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/downloadDocuments": { "post": { "tags": [ "Invoices" ], "x-ms-examples": { "EAInvoiceDownload": { "$ref": "./examples/MultipleInvoiceDownload.json" } }, "operationId": "Invoices_DownloadMultipleEAInvoices", "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/billingAccountNameParameter" }, { "name": "downloadUrls", "in": "body", "required": true, "description": "An array of download urls for individual documents. The download url paths in the request body should match the path of the original request.", "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}/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "EnterpriseAgreementInvoice": { "$ref": "./examples/BillingAccountInvoice.json" } }, "operationId": "Invoices_GetBillingAccountInvoice", "description": "Gets an invoice by billing account name and ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement, Microsoft Customer Agreement or Enterprise Agreement.", "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/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. The download url paths in the request body should match the path of the original request.", "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}/invoices/{invoiceName}/pricesheet/default/download": { "post": { "tags": [ "PriceSheet" ], "x-ms-examples": { "PricesheetDownload": { "$ref": "./examples/PricesheetDownload.json" } }, "operationId": "PriceSheet_Download", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download the pricesheet for an invoice. 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/invoiceNameParameter" } ], "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" }, "OData-EntityId": { "description": "The operation entity Id GUID.", "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}/pricesheet/default/download": { "post": { "tags": [ "PriceSheet" ], "x-ms-examples": { "PricesheetDownloadByBillingProfile": { "$ref": "./examples/PricesheetDownloadByBillingProfile.json" } }, "operationId": "PriceSheet_DownloadByBillingProfile", "x-ms-long-running-operation": true, "x-ms-long-running-operation-options": { "final-state-via": "location" }, "description": "Gets a URL to download the current month's pricesheet for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.This API is hereby deprecated in favor of https://docs.microsoft.com/en-us/rest/api/cost-management/2022-02-01-preview/price-sheet/download-by-billing-profile. We highly recommend you move to the new preview version, as the csv file in the current preview version will have 500k max size that cannot scale with Azure product growth.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" } ], "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" }, "OData-EntityId": { "description": "The operation entity Id GUID.", "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}/invoices": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "InvoicesListByBillingProfile": { "$ref": "./examples/InvoicesListByBillingProfile.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.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/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.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "downloadUrls", "in": "body", "required": true, "description": "An array of download urls for individual documents. The download url paths in the request body should match the path of the original request.", "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}/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "x-ms-examples": { "Invoice": { "$ref": "./examples/Invoice.json" } }, "operationId": "Invoices_Get", "description": "Gets an invoice by ID. 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/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}/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/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}/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/billingAccountNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "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/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}/invoices/{invoiceName}": { "get": { "tags": [ "Invoices" ], "operationId": "Invoices_GetById", "description": "Gets an invoice by ID.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "BillingSubscriptionsListByBillingAccount": { "$ref": "./examples/BillingSubscriptionInvoice.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "$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/{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" } } } } }, "/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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}": { "get": { "tags": [ "BillingSubscriptions" ], "operationId": "BillingSubscriptions_Get", "description": "Gets a subscription 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/" }, "x-ms-examples": { "BillingSubscription": { "$ref": "./examples/BillingSubscription.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "$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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/transfer": { "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 only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "BillingSubscriptions_Transfer", "x-ms-long-running-operation": true, "x-ms-examples": { "TransferBillingSubscription": { "$ref": "./examples/TransferBillingSubscription.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties" }, "description": "Request parameters that are provided to the transfer product operation." } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/TransferBillingSubscriptionResult" } }, "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}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/validateTransferEligibility": { "post": { "x-ms-examples": { "SubscriptionTransferValidateSuccess": { "$ref": "./examples/ValidateSubscriptionTransferSuccess.json" }, "SubscriptionTransferValidateFailure": { "$ref": "./examples/ValidateSubscriptionTransferFailure.json" } }, "operationId": "BillingSubscriptions_ValidateTransfer", "description": "Validates if a subscription'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.", "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/billingSubscriptionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties" }, "description": "Request parameters that are provided to the validate transfer 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}/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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/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/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/transfer": { "post": { "tags": [ "Products" ], "operationId": "Products_Transfer", "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.", "x-ms-examples": { "TransferProduct": { "$ref": "./examples/TransferProduct.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferProductRequestProperties" }, "description": "Request parameters that are provided to the transfer 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}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/validateTransferEligibility": { "post": { "x-ms-examples": { "SubscriptionTransferValidateSuccess": { "$ref": "./examples/ValidateProductTransferSuccess.json" }, "SubscriptionTransferValidateFailure": { "$ref": "./examples/ValidateProductTransferFailure.json" } }, "operationId": "Products_ValidateTransfer", "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.", "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TransferProductRequestProperties" }, "description": "Request parameters that are provided to the validate transfer 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}/transactions": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_ListByBillingAccount", "description": "Lists the billed and unbilled transactions by billing account name for given start and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice ID and do not include tax. Tax is added to the amount once an invoice is generated.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "TransactionsListByBillingAccount": { "$ref": "./examples/TransactionsListByBillingAccount.json" }, "ReservationTransactionsListByBillingAccount": { "$ref": "./examples/ReservationTransactionsListByBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "periodStartDate", "in": "query", "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "periodEndDate", "in": "query", "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "$filter", "description": "May be used to filter by transaction 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/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}/transactions": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_ListByBillingProfile", "description": "Lists the billed and unbilled transactions by billing profile name for given start date and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice Id and do not include tax. Tax is added to the amount once an invoice is generated.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "TransactionsListByBillingProfile": { "$ref": "./examples/TransactionsListByBillingProfile.json" }, "ReservationTransactionsListByBillingProfile": { "$ref": "./examples/ReservationTransactionsListByBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "periodStartDate", "in": "query", "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "periodEndDate", "in": "query", "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "$filter", "description": "May be used to filter by transaction 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/TransactionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transactions": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_ListByInvoiceSection", "description": "Lists the billed and unbilled transactions by invoice section name for given start date and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice Id and do not include tax. Tax is added to the amount once an invoice is generated.", "externalDocs": { "url": "https://docs.microsoft.com/en-us/rest/api/billing/" }, "x-ms-examples": { "TransactionsListByInvoiceSection": { "$ref": "./examples/TransactionsListByInvoiceSection.json" }, "ReservationTransactionsListByInvoiceSection": { "$ref": "./examples/ReservationTransactionsListByInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "name": "periodStartDate", "in": "query", "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "periodEndDate", "in": "query", "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "$filter", "description": "May be used to filter by transaction 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/TransactionListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/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/billingProfileNameParameter" }, { "$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}/transactions/{transactionName}": { "get": { "tags": [ "Transactions" ], "operationId": "Transactions_Get", "description": "Gets a transaction by 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/" }, "x-ms-examples": { "Transaction": { "$ref": "./examples/Transaction.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/transactionNameParameter" }, { "name": "periodStartDate", "in": "query", "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "name": "periodEndDate", "in": "query", "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.", "required": true, "type": "string" }, { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/Transaction" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/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": { "UpdateBillingProfile": { "$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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/updateAutoRenew": { "post": { "tags": [ "Products" ], "operationId": "Products_UpdateAutoRenewByInvoiceSection", "description": "Cancel auto renew for product by product id and invoice section name", "x-ms-examples": { "CancelProductForInvoiceSection": { "$ref": "./examples/ProductCancelForInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/productNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/updateAutoRenewRequestParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/UpdateAutoRenewOperation" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/elevate": { "post": { "tags": [ "InvoiceSections" ], "description": "Gives the caller permissions on an invoice section based on their billing profile access. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "InvoiceSections_ElevateToBillingProfile", "x-ms-examples": { "Elevate": { "$ref": "./examples/ElevateInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "204": { "description": "Elevated the caller's access to the invoice section." }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/initiateTransfer": { "post": { "tags": [ "Transfers" ], "description": "Sends a request to a user in another billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "Transfers_Initiate", "x-ms-examples": { "InitiateTransfer": { "$ref": "./examples/InitiateTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/InitiateTransferRequest" }, "description": "Request parameters that are provided to the initiate transfer operation." } ], "responses": { "200": { "description": "Initiated transfer details.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transfers/{transferName}": { "get": { "tags": [ "Transfers" ], "description": "Gets a transfer request by ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "Transfers_Get", "x-ms-examples": { "TransferGet": { "$ref": "./examples/GetTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of transfer.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "Transfers" ], "description": "Cancels a transfer request. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "Transfers_Cancel", "x-ms-examples": { "TransferCancel": { "$ref": "./examples/CancelTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of canceled transfer.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transfers": { "get": { "tags": [ "Transfers" ], "description": "Lists the transfer requests for an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.", "operationId": "Transfers_List", "x-ms-examples": { "TransfersList": { "$ref": "./examples/ListTransfers.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" } ], "responses": { "200": { "description": "List of transfers initiated from this invoice section.", "schema": { "$ref": "#/definitions/TransferDetailsListResult" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/initiateTransfer": { "post": { "tags": [ "Transfers" ], "description": "Sends a request to a user in a customer's billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "operationId": "PartnerTransfers_Initiate", "x-ms-examples": { "InitiatePartnerTransfer": { "$ref": "./examples/PartnerInitiateTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/InitiateTransferRequest" }, "description": "Request parameters that are provided to the initiate transfer operation." } ], "responses": { "200": { "description": "Initiated transfer details.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/transfers/{transferName}": { "get": { "tags": [ "Transfers" ], "description": "Gets a transfer request by ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "operationId": "PartnerTransfers_Get", "x-ms-examples": { "TransferGet": { "$ref": "./examples/PartnerGetTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of transfer.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } }, "delete": { "tags": [ "Transfers" ], "description": "Cancels a transfer request. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "operationId": "PartnerTransfers_Cancel", "x-ms-examples": { "TransferCancel": { "$ref": "./examples/PartnerCancelTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/customerNameParameter" }, { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of canceled transfer.", "schema": { "$ref": "#/definitions/TransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/transfers": { "get": { "tags": [ "Transfers" ], "description": "Lists the transfer requests sent to a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.", "operationId": "PartnerTransfers_List", "x-ms-examples": { "TransfersList": { "$ref": "./examples/PartnerListTransfers.json" } }, "parameters": [ { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/customerNameParameter" } ], "responses": { "200": { "description": "List of transfers initiated from this invoice section.", "schema": { "$ref": "#/definitions/TransferDetailsListResult" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/transfers/{transferName}/acceptTransfer": { "post": { "tags": [ "RecipientTransfers" ], "summary": "Accepts a transfer request.", "operationId": "RecipientTransfers_Accept", "x-ms-examples": { "AcceptTransfer": { "$ref": "./examples/AcceptTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/transferNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/AcceptTransferRequest" }, "description": "Request parameters that are provided to the accept transfer operation." } ], "responses": { "200": { "description": "Details of the accepted transfer.", "schema": { "$ref": "#/definitions/RecipientTransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/transfers/{transferName}/validateTransfer": { "post": { "tags": [ "RecipientTransfers" ], "summary": "Validates if a subscription or a reservation can be transferred. Use this operation to validate your subscriptions or reservation before using the accept transfer operation.", "operationId": "RecipientTransfers_Validate", "x-ms-examples": { "ValidateTransfer": { "$ref": "./examples/ValidateTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/transferNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/AcceptTransferRequest" }, "description": "Request parameters that are provided to the validate transfer operation." } ], "responses": { "200": { "description": "Results of the transfer validation.", "schema": { "$ref": "#/definitions/ValidateTransferListResponse" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/transfers/{transferName}/declineTransfer": { "post": { "tags": [ "RecipientTransfers" ], "summary": "Declines a transfer request.", "operationId": "RecipientTransfers_Decline", "x-ms-examples": { "DeclineTransfer": { "$ref": "./examples/DeclineTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of the declined transfer.", "schema": { "$ref": "#/definitions/RecipientTransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/transfers/{transferName}": { "get": { "tags": [ "RecipientTransfers" ], "summary": "Gets a transfer request by ID. The caller must be the recipient of the transfer request.", "operationId": "RecipientTransfers_Get", "x-ms-examples": { "RecipientTransferGet": { "$ref": "./examples/GetRecipientTransfer.json" } }, "parameters": [ { "$ref": "#/parameters/transferNameParameter" } ], "responses": { "200": { "description": "Details of the transfers with given Id.", "schema": { "$ref": "#/definitions/RecipientTransferDetails" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/transfers": { "get": { "tags": [ "RecipientTransfers" ], "summary": "Lists the transfer requests received by the caller.", "operationId": "RecipientTransfers_List", "x-ms-examples": { "RecipientTransfersList": { "$ref": "./examples/ListRecipientTransfers.json" } }, "responses": { "200": { "description": "List of transfers received by caller.", "schema": { "$ref": "#/definitions/RecipientTransferDetailsListResult" } }, "default": { "description": "Unexpected error.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/operations": { "get": { "tags": [ "Operations" ], "operationId": "Operations_List", "description": "Lists the available billing REST API operations.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" } ], "responses": { "200": { "description": "OK. The request has succeeded.", "schema": { "$ref": "#/definitions/OperationListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "BillingAccountPermissionsList": { "$ref": "./examples/BillingAccountPermissionsList.json" }, "BillingAccountEaPermissionsList": { "$ref": "./examples/BillingAccountEaPermissionsList.json" } }, "operationId": "BillingPermissions_ListByBillingAccount", "description": "Lists the billing permissions the caller has on a billing account.", "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.", "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" } } } } }, "/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.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "DepartmentPermissionsList": { "$ref": "./examples/DepartmentPermissionsList.json" } }, "operationId": "BillingPermissions_ListByDepartment", "description": "Lists the billing permissions the caller has on a department.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" } ], "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}/enrollmentAccounts/{enrollmentAccountName}/billingPermissions": { "get": { "tags": [ "BillingPermissions" ], "x-ms-examples": { "EnrollmentAccountPermissionsList": { "$ref": "./examples/EnrollmentAccountPermissionsList.json" } }, "operationId": "BillingPermissions_ListByEnrollmentAccount", "description": "Lists the billing permissions the caller has on an enrollment account.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" } ], "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" }, "BillingAccountEaRoleDefinition": { "$ref": "./examples/BillingAccountEaRoleDefinition.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.", "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.", "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.", "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}/departments/{departmentName}/billingRoleDefinitions/{billingRoleDefinitionName}": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "DepartmentRoleDefinition": { "$ref": "./examples/DepartmentRoleDefinition.json" } }, "operationId": "BillingRoleDefinitions_GetByDepartment", "description": "Gets the definition for a role on a department. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" }, { "$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}/enrollmentAccounts/{enrollmentAccountName}/billingRoleDefinitions/{billingRoleDefinitionName}": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "EnrollmentAccountRoleDefinition": { "$ref": "./examples/EnrollmentAccountRoleDefinition.json" } }, "operationId": "BillingRoleDefinitions_GetByEnrollmentAccount", "description": "Gets the definition for a role on an enrollment account. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" }, { "$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" }, "BillingAccountEaRoleDefinitionsList": { "$ref": "./examples/BillingAccountEaRoleDefinitionsList.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, Microsoft Customer Agreement or Enterprise Agreement.", "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.", "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" } } } } }, "/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.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingRoleDefinitions": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "DepartmentRoleDefinitionsList": { "$ref": "./examples/DepartmentRoleDefinitionsList.json" } }, "operationId": "BillingRoleDefinitions_ListByDepartment", "description": "Lists the role definitions for a department. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" } ], "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}/enrollmentAccounts/{enrollmentAccountName}/billingRoleDefinitions": { "get": { "tags": [ "BillingRoleDefinitions" ], "x-ms-examples": { "EnrollmentAccountRoleDefinitionsList": { "$ref": "./examples/EnrollmentAccountRoleDefinitionsList.json" } }, "operationId": "BillingRoleDefinitions_ListByEnrollmentAccount", "description": "Lists the role definitions for a enrollmentAccount. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" } ], "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" }, "BillingAccountEaRoleAssignment": { "$ref": "./examples/BillingAccountEaRoleAssignment.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, Microsoft Customer Agreement or Enterprise 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" } } } }, "delete": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "BillingAccountRoleAssignmentDelete": { "$ref": "./examples/BillingAccountRoleAssignmentDelete.json" }, "BillingAccountEaRoleAssignmentDelete": { "$ref": "./examples/BillingAccountEaRoleAssignmentDelete.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" } } } }, "put": { "tags": [ "BillingRoleAssignments" ], "operationId": "RoleAssignments_Put", "description": "Create or update a billing role assignment.", "x-ms-examples": { "PutEnrollmentAdministratorRoleAssignment": { "$ref": "./examples/PutAdministratorRoleAssignment.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignment" }, "description": "The new or updated billing role assignment." } ], "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.", "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.", "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}/departments/{departmentName}/billingRoleAssignments/{billingRoleAssignmentName}": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "DepartmentRoleAssignment": { "$ref": "./examples/DepartmentRoleAssignment.json" } }, "operationId": "BillingRoleAssignments_GetByDepartment", "description": "Gets a role assignment for the caller on a department. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" }, { "$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": { "DepartmentRoleAssignmentDelete": { "$ref": "./examples/DepartmentRoleAssignmentDelete.json" } }, "operationId": "BillingRoleAssignments_DeleteByDepartment", "description": "Deletes a role assignment for the caller on a department. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" }, { "$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" } } } }, "put": { "tags": [ "BillingRoleAssignments" ], "operationId": "EnrollmentDepartmentRoleAssignments_Put", "description": "Create or update a billing role assignment.", "x-ms-examples": { "PutEnrollmentDepartmentAdministratorRoleAssignment": { "$ref": "./examples/PutEnrollmentDepartmentAdministratorRoleAssignment.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignment" }, "description": "The new or updated billing role assignment." } ], "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}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments/{billingRoleAssignmentName}": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "EnrollmentAccountRoleAssignment": { "$ref": "./examples/EnrollmentAccountRoleAssignment.json" } }, "operationId": "BillingRoleAssignments_GetByEnrollmentAccount", "description": "Gets a role assignment for the caller on a enrollment Account. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" }, { "$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": { "EnrollmentAccountRoleAssignmentDelete": { "$ref": "./examples/EnrollmentAccountRoleAssignmentDelete.json" } }, "operationId": "BillingRoleAssignments_DeleteByEnrollmentAccount", "description": "Deletes a role assignment for the caller on a enrollment Account. The operation is supported only for billing accounts with agreement type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" }, { "$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" } } } }, "put": { "tags": [ "BillingRoleAssignments" ], "operationId": "EnrollmentAccountRoleAssignments_Put", "description": "Create or update a billing role assignment.", "x-ms-examples": { "PutEnrollmentAccountSubscriptionCreatorRoleAssignment": { "$ref": "./examples/PutEnrollmentAccountSubscriptionCreatorRoleAssignment.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" }, { "$ref": "#/parameters/billingRoleAssignmentNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignment" }, "description": "The new or updated billing role assignment." } ], "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" }, "BillingAccountEaRoleAssignmentList": { "$ref": "./examples/BillingAccountEaRoleAssignmentList.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, Microsoft Customer Agreement or Enterprise Agreement.", "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}/createBillingRoleAssignment": { "post": { "tags": [ "BillingRoleAssignments" ], "operationId": "BillingRoleAssignments_AddByBillingAccount", "description": "Adds a role assignment on a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "AddRoleAssignmentToBillingAccount": { "$ref": "./examples/AddRoleAssignmentToBillingAccount.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignmentPayload" }, "description": "Request parameters that are provided to the create billing role assignment operation." } ], "responses": { "201": { "description": "Role assignment is successfully created", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/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.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/createBillingRoleAssignment": { "post": { "tags": [ "BillingRoleAssignments" ], "operationId": "BillingRoleAssignments_AddByInvoiceSection", "description": "Adds a role assignment on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "AddRoleAssignmentToInvoiceSection": { "$ref": "./examples/AddRoleAssignmentToInvoiceSection.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "$ref": "#/parameters/invoiceSectionNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignmentPayload" }, "description": "Request parameters that are provided to the create billing role assignment operation." } ], "responses": { "201": { "description": "Role assignment is successfully created", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/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.", "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" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/createBillingRoleAssignment": { "post": { "tags": [ "BillingRoleAssignments" ], "operationId": "BillingRoleAssignments_AddByBillingProfile", "description": "Adds a role assignment on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.", "x-ms-examples": { "AddRoleAssignmentToBillingProfile": { "$ref": "./examples/AddRoleAssignmentToBillingProfile.json" } }, "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/billingProfileNameParameter" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/BillingRoleAssignmentPayload" }, "description": "Request parameters that are provided to the create billing role assignment operation." } ], "responses": { "201": { "description": "Role assignment is successfully created", "schema": { "$ref": "#/definitions/BillingRoleAssignmentListResult" } }, "default": { "description": "Error response describing why the operation failed.", "schema": { "$ref": "#/definitions/ErrorResponse" } } } } }, "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingRoleAssignments": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "DepartmentRoleAssignmentList": { "$ref": "./examples/DepartmentRoleAssignmentList.json" } }, "operationId": "BillingRoleAssignments_ListByDepartment", "description": "Lists the role assignments for the caller on a billing profile. The operation is supported for billing accounts of type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/departmentNameParameter" } ], "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}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments": { "get": { "tags": [ "BillingRoleAssignments" ], "x-ms-examples": { "EnrollmentAccountRoleAssignmentList": { "$ref": "./examples/EnrollmentAccountRoleAssignmentList.json" } }, "operationId": "BillingRoleAssignments_ListByEnrollmentAccount", "description": "Lists the role assignments for the caller on a billing profile. The operation is supported for billing accounts of type Enterprise Agreement.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/billingAccountNameParameter" }, { "$ref": "#/parameters/enrollmentAccountNameParameter" } ], "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.", "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" } } } } }, "/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.", "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" } } } } } }, "definitions": { "CustomerListResult": { "description": "The list of customers.", "properties": { "value": { "description": "The list of customers.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Customer" } }, "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": { "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" } } } }, "InitiateTransferRequest": { "type": "object", "description": "Request parameters to initiate transfer.", "properties": { "properties": { "description": "Request parameters to initiate transfer.", "x-ms-client-flatten": true, "$ref": "#/definitions/InitiateTransferProperties" } } }, "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 } }, "InitiateTransferProperties": { "type": "object", "description": "Request parameters to initiate transfer.", "properties": { "recipientEmailId": { "type": "string", "description": "The email ID of the recipient to whom the transfer request is sent." }, "resellerId": { "type": "string", "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account." } } }, "AcceptTransferRequest": { "type": "object", "description": "Request parameters to accept transfer.", "properties": { "properties": { "description": "Request parameters to accept transfer.", "x-ms-client-flatten": true, "$ref": "#/definitions/AcceptTransferProperties" } } }, "AcceptTransferProperties": { "type": "object", "description": "Request parameters to accept transfer.", "properties": { "productDetails": { "description": "Request parameters to accept transfer.", "type": "array", "items": { "$ref": "#/definitions/ProductDetails" } } } }, "ProductDetails": { "type": "object", "description": "Details of the product that is transferred.", "properties": { "productType": { "description": "Type of the product that is transferred.", "$ref": "#/definitions/ProductType" }, "productId": { "type": "string", "description": "The ID of the product that is transferred." } } }, "ProductType": { "type": "string", "description": "The type of product that is transferred.", "enum": [ "AzureSubscription", "AzureReservation" ], "x-ms-enum": { "name": "productType", "modelAsString": true } }, "TransferDetails": { "type": "object", "description": "Details of the transfer.", "properties": { "properties": { "description": "Details of the transfer.", "x-ms-client-flatten": true, "$ref": "#/definitions/TransferProperties" } } }, "RecipientTransferDetails": { "type": "object", "description": "Details of the transfer.", "properties": { "properties": { "description": "Details of the transfer.", "x-ms-client-flatten": true, "$ref": "#/definitions/RecipientTransferProperties" } } }, "DetailedTransferStatus": { "type": "object", "description": "Detailed transfer status.", "properties": { "productType": { "type": "string", "$ref": "#/definitions/ProductType", "readOnly": true, "description": "Type of product that is transferred." }, "productId": { "type": "string", "readOnly": true, "description": "The ID of the product that is transferred." }, "transferStatus": { "type": "string", "$ref": "#/definitions/ProductTransferStatus", "readOnly": true, "description": "Transfer status." }, "errorDetails": { "description": "Error details for transfer execution.", "$ref": "#/definitions/Error" } } }, "Error": { "description": "Error details for transfer execution.", "properties": { "errorCode": { "type": "string", "readOnly": true, "description": "Error code." }, "errorMessage": { "type": "string", "readOnly": true, "description": "Error message." } } }, "EligibleProductType": { "type": "string", "description": "Type of the products that can be transferred.", "enum": [ "DevTestAzureSubscription", "StandardAzureSubscription", "AzureReservation" ], "x-ms-enum": { "name": "eligibleProductType", "modelAsString": true } }, "TransferProperties": { "description": "Transfer details", "type": "object", "properties": { "creationTime": { "type": "string", "format": "date-time", "description": "The time at which the transfer request was created.", "readOnly": true }, "expirationTime": { "type": "string", "format": "date-time", "readOnly": true, "description": "The time at which the transfer request expires." }, "invoiceSectionId": { "type": "string", "description": "The ID of the invoice section to which the product is billed after the transfer request is completed.", "readOnly": true }, "billingAccountId": { "type": "string", "description": "The ID of the billing account to which the product is billed after the transfer request is completed.", "readOnly": true }, "resellerId": { "type": "string", "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.", "readOnly": true }, "resellerName": { "type": "string", "description": "Optional name of the reseller for transfer requests that are sent from Microsoft Partner Agreement billing account.", "readOnly": true }, "initiatorCustomerType": { "type": "string", "description": "The type of customer who sent the transfer request.", "readOnly": true }, "billingProfileId": { "type": "string", "description": "The ID of the billing profile to which the product will be billed after the transfer.", "readOnly": true }, "transferStatus": { "type": "string", "$ref": "#/definitions/TransferStatus", "description": "Overall transfer status.", "readOnly": true }, "recipientEmailId": { "type": "string", "readOnly": true, "description": "The email ID of the user to whom the transfer request was sent." }, "initiatorEmailId": { "type": "string", "readOnly": true, "description": "The email ID of the user who sent the transfer request." }, "canceledBy": { "type": "string", "readOnly": true, "description": "The email ID of the user who canceled the transfer request." }, "lastModifiedTime": { "type": "string", "format": "date-time", "readOnly": true, "description": "The time at which the transfer request was last modified." }, "detailedTransferStatus": { "type": "array", "readOnly": true, "description": "Detailed transfer status.", "items": { "$ref": "#/definitions/DetailedTransferStatus" } } } }, "RecipientTransferProperties": { "description": "Transfer Details.", "type": "object", "properties": { "creationTime": { "type": "string", "format": "date-time", "description": "The time at which the transfer request was created.", "readOnly": true }, "expirationTime": { "type": "string", "format": "date-time", "readOnly": true, "description": "The time at which the transfer request expires." }, "allowedProductType": { "type": "array", "readOnly": true, "description": "Type of subscriptions that can be transferred.", "items": { "$ref": "#/definitions/EligibleProductType" } }, "transferStatus": { "type": "string", "$ref": "#/definitions/TransferStatus", "description": "Overall transfer status.", "readOnly": true }, "recipientEmailId": { "type": "string", "readOnly": true, "description": "The email ID of the user to whom the transfer request was sent." }, "initiatorEmailId": { "type": "string", "readOnly": true, "description": "The email ID of the user who sent the transfer request." }, "resellerId": { "type": "string", "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.", "readOnly": true }, "resellerName": { "type": "string", "description": "Optional name of the reseller for transfer requests that are sent from Microsoft Partner Agreement billing account.", "readOnly": true }, "initiatorCustomerType": { "type": "string", "description": "The type of customer who sent the transfer request.", "readOnly": true }, "canceledBy": { "type": "string", "readOnly": true, "description": "The email ID of the user who canceled the transfer request." }, "lastModifiedTime": { "type": "string", "format": "date-time", "readOnly": true, "description": "The time at which the transfer request was last modified." }, "detailedTransferStatus": { "type": "array", "readOnly": true, "description": "Detailed transfer status.", "items": { "$ref": "#/definitions/DetailedTransferStatus" } } } }, "TransferStatus": { "type": "string", "description": "The status of a transfer.", "enum": [ "Pending", "InProgress", "Completed", "CompletedWithErrors", "Failed", "Canceled", "Declined" ], "x-ms-enum": { "name": "transferStatus", "modelAsString": true } }, "ProductTransferStatus": { "type": "string", "description": "The status of a transfer.", "enum": [ "NotStarted", "InProgress", "Completed", "Failed" ], "x-ms-enum": { "name": "productTransferStatus", "modelAsString": true } }, "RecipientTransferDetailsListResult": { "description": "The list of transfers received by caller.", "properties": { "value": { "description": "The list of transfers received by caller.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/RecipientTransferDetails" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "TransferDetailsListResult": { "description": "The list of transfers initiated by caller.", "properties": { "value": { "description": "The list of transfers initiated by caller.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/TransferDetails" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "TransferProductRequestProperties": { "description": "The properties of the product to initiate a transfer.", "properties": { "destinationInvoiceSectionId": { "type": "string", "description": "The destination invoice section id." }, "destinationBillingProfileId": { "type": "string", "description": "The destination billing profile id." } } }, "TransferBillingSubscriptionResult": { "type": "object", "description": "Result of the transfer billing subscription operation.", "properties": { "properties": { "description": "Properties of the transfer billing subscription operation result.", "x-ms-client-flatten": true, "$ref": "#/definitions/TransferBillingSubscriptionResultProperties" } } }, "TransferBillingSubscriptionResultProperties": { "type": "object", "description": "Properties of the transfer billing subscription operation result.", "properties": { "billingSubscriptionName": { "type": "string", "description": "The destination billing subscription id." } } }, "TransferBillingSubscriptionRequest": { "type": "object", "description": "Request parameters to transfer billing subscription.", "properties": { "properties": { "description": "Request parameters to transfer billing subscription.", "x-ms-client-flatten": true, "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties" } } }, "TransferBillingSubscriptionRequestProperties": { "type": "object", "description": "Request parameters to transfer billing subscription.", "properties": { "destinationInvoiceSectionId": { "type": "string", "description": "The destination invoice section id." }, "destinationBillingProfileId": { "type": "string", "description": "The destination billing profile id." } } }, "DetachPaymentMethodEligibilityResult": { "type": "object", "description": "Result of the detach payment method eligibility validation.", "properties": { "isEligible": { "description": "Specifies whether the payment method is eligible to be detached from the billing profile.", "type": "boolean", "readOnly": true }, "errorDetails": { "description": "The list of detach payment method eligibility errors.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/DetachPaymentMethodErrorDetails" } } } }, "DetachPaymentMethodErrorDetails": { "type": "object", "description": "Error details of the detach payment method eligibility validation.", "properties": { "code": { "description": "Error code for the detach payment method eligibility validation.", "$ref": "#/definitions/DetachPaymentMethodEligibilityErrorCode" }, "message": { "description": "Error message for the detach payment method eligibility validation.", "type": "string" } } }, "DetachPaymentMethodEligibilityErrorCode": { "type": "string", "description": "Error code of the detach payment method eligibility validation response.", "enum": [ "AzureSubscriptions", "RecurringCharges", "ReservedInstances", "OutstandingCharges", "PendingCharges" ], "x-ms-enum": { "name": "detachPaymentMethodEligibilityErrorCode", "modelAsString": true } }, "ValidateSubscriptionTransferEligibilityResult": { "type": "object", "description": "Result of the transfer eligibility validation.", "properties": { "isTransferEligible": { "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 } }, "UpdateAutoRenewOperation": { "type": "object", "description": "Result of the update auto renew operation", "properties": { "properties": { "description": "Summary of update auto renew operation properties", "x-ms-client-flatten": true, "$ref": "#/definitions/UpdateAutoRenewOperationProperties" } } }, "UpdateAutoRenewOperationProperties": { "type": "object", "description": "Summary of update auto renew operation properties", "properties": { "endDate": { "type": "string", "format": "date-time", "description": "The date at which the product will be canceled." } } }, "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", "readOnly": true }, "address": { "description": "The address associated with 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 } }, "customerType": { "description": "The type of customer.", "type": "string", "enum": [ "Enterprise", "Individual", "Partner" ], "readOnly": true, "x-ms-enum": { "name": "CustomerType", "modelAsString": true } }, "accountType": { "description": "The type of customer.", "type": "string", "enum": [ "Enterprise", "Individual", "Partner" ], "readOnly": true, "x-ms-enum": { "name": "AccountType", "modelAsString": true } }, "billingProfiles": { "description": "The billing profiles associated with the billing account. By default this is not populated, unless it's specified in $expand.", "type": "array", "items": { "$ref": "#/definitions/BillingProfile" } }, "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" } }, "organizationId": { "description": "Organization id.", "type": "string", "readOnly": true } } }, "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": { "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" ], "readOnly": true, "x-ms-enum": { "name": "BillingProfileStatusReasonCode", "modelAsString": true } }, "billingProfileSpendingLimit": { "description": "The billing profile spending limit.", "enum": [ "Off", "On" ], "readOnly": true, "x-ms-enum": { "name": "BillingProfileSpendingLimit", "modelAsString": true } }, "costCenter": { "description": "The cost center applied to the subscription.", "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 }, "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 }, "marketplacesEnabled": { "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 } } }, "DepartmentListResult": { "description": "The list of departments.", "properties": { "value": { "description": "The list of departments.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Department" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "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" } } } }, "EnrollmentAccountListResult": { "description": "The list of enrollment accounts.", "properties": { "value": { "description": "The list of enrollment accounts.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/EnrollmentAccount" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "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" }, "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" } }, "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" }, "address": { "description": "Billing address.", "$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" }, "address": { "description": "Billing address.", "$ref": "#/definitions/AddressDetails" }, "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 } }, "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" } }, "indirectRelationshipInfo": { "description": "Identifies the billing profile that is linked to another billing profile in indirect purchase motion.", "readOnly": true, "$ref": "#/definitions/IndirectRelationshipInfo" }, "invoiceSections": { "description": "The invoice sections associated to the billing profile.", "type": "array", "items": { "$ref": "#/definitions/InvoiceSection" } }, "status": { "description": "The status of the billing profile.", "enum": [ "Active", "Disabled", "Warned" ], "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" } } } }, "AddressDetails": { "description": "Address details.", "properties": { "firstName": { "description": "First 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" }, "region": { "description": "Address region.", "type": "string" }, "country": { "description": "Country code uses ISO2, 2-digit format.", "type": "string" }, "postalCode": { "description": "Postal code.", "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" } }, "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" }, "state": { "description": "Identifies the state of an invoice section.", "type": "string", "enum": [ "Active", "Restricted" ], "readOnly": true, "x-ms-enum": { "name": "InvoiceSectionState", "modelAsString": true } }, "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 }, "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" ], "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" ], "readOnly": true, "type": "string", "x-ms-enum": { "name": "BillingProfileSpendingLimit", "modelAsString": 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": { "description": "The amount of Azure prepayment applied to the charges. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.", "readOnly": true, "$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" } }, "subscriptionId": { "description": "The ID of the subscription for which the invoice is generated.", "type": "string", "readOnly": true }, "rebillDetails": { "description": "Rebill details of an Enterprise Agreement invoice.", "x-ms-client-flatten": true, "$ref": "#/definitions/InvoiceRebillDetails" } } }, "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 } } }, "InvoiceRebillDetails": { "description": "The rebill details of an invoice.", "properties": { "rebillDocumentType": { "description": "The type of the document generated when an Enterprise Agreement invoice is rebilled.", "type": "string", "enum": [ "Credit", "Rebill", "Original" ], "x-ms-enum": { "name": "rebillDocumentType", "modelAsString": true } }, "rebilledInvoiceId": { "description": "The ID of the invoice generated when an Enterprise Agreement invoice is rebilled.", "type": "string", "readOnly": true }, "latestInvoiceId": { "description": "The ID of the latest invoice generated when an Enterprise Agreement invoice is rebilled.", "type": "string", "readOnly": true } } }, "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 }, "documentNumbers": { "description": "Document numbers for an Enterprise Agreement invoice.", "type": "array", "readOnly": true, "items": { "type": "string" } } } }, "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" } }, "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": { "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 }, "parentProductId": { "description": "Parent product Id.", "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": { "isTransferEligible": { "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" } }, "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 }, "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 } } }, "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" } }, "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 }, "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 }, "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" } } }, "PaymentMethodsListResult": { "description": "The list of payment methods.", "properties": { "value": { "description": "The list of payment methods.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/PaymentMethod" } }, "nextLink": { "description": "The link (url) to the next page of results.", "type": "string", "readOnly": true } } }, "PaymentMethod": { "description": "A payment method.", "type": "object", "allOf": [ { "$ref": "#/definitions/Resource" } ], "properties": { "properties": { "x-ms-client-flatten": true, "$ref": "#/definitions/PaymentMethodProperties", "title": "Payment method properties" } } }, "PaymentMethodProperties": { "description": "The properties of a payment method.", "properties": { "paymentMethodType": { "description": "The type of payment method.", "type": "string", "enum": [ "Credits", "ChequeWire" ], "x-ms-enum": { "name": "PaymentMethodType", "modelAsString": true } }, "details": { "description": "Details about the payment method.", "type": "string", "readOnly": true }, "expiration": { "description": "Expiration month and year.", "type": "string", "readOnly": true }, "currency": { "description": "The currency associated with the payment method.", "type": "string", "readOnly": true } } }, "UpdateAutoRenewRequest": { "type": "object", "description": "Request parameters to update auto renew settings for a product.", "properties": { "autoRenew": { "description": "The flag that determines the auto-renew settings for a product.", "type": "string", "enum": [ "true", "false" ], "x-ms-enum": { "name": "UpdateAutoRenew", "modelAsString": true } } } }, "Operation": { "description": "A Billing REST API operation.", "type": "object", "properties": { "name": { "description": "Operation name: {provider}/{resource}/{operation}.", "type": "string", "readOnly": true }, "display": { "description": "The object that represents the operation.", "properties": { "provider": { "description": "Service provider: Microsoft.Billing.", "type": "string", "readOnly": true }, "resource": { "description": "Resource on which the operation is performed such as invoice and billing subscription.", "type": "string", "readOnly": true }, "operation": { "description": "Operation type such as read, write and delete.", "type": "string", "readOnly": true } } } } }, "OperationListResult": { "description": "The list of billing operations and a URL link to get the next set of results.", "properties": { "value": { "description": "The list of billing operations supported by the Microsoft.Billing resource provider.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/Operation" } }, "nextLink": { "description": "URL to get the next set of operation list results if there are any.", "type": "string", "readOnly": true } } }, "BillingRoleAssignmentPayload": { "description": "The payload use to update role assignment on a scope", "properties": { "principalId": { "description": "The user's principal id that the role gets assigned to", "type": "string" }, "billingRoleDefinitionId": { "description": "The role definition id", "type": "string" } } }, "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. This is supported only for billing accounts with agreement type Enterprise Agreement.", "type": "string", "readOnly": true }, "name": { "description": "The name of 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 }, "userEmailAddress": { "description": "The email address of the user to whom the role was assigned. This is supported only for billing accounts with agreement type Enterprise Agreement.", "type": "string" }, "userAuthenticationType": { "description": "The authentication type of the user, whether Organization or MSA, of the user to whom the role was assigned. This is supported only for billing accounts with agreement type Enterprise Agreement.", "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": [ "ClickToAccept", "ESignEmbedded", "ESignOffline" ], "x-ms-enum": { "name": "acceptanceMode", "modelAsString": true } }, "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 } } }, "ValidateTransferListResponse": { "description": "Result of transfer validation.", "properties": { "value": { "description": "The list of transfer validation results.", "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/ValidateTransferResponse" } } } }, "ValidateTransferResponse": { "type": "object", "description": "Transfer validation response.", "properties": { "properties": { "description": "The properties of transfer validation response.", "x-ms-client-flatten": true, "$ref": "#/definitions/ValidateTransferResponseProperties" } } }, "ValidateTransferResponseProperties": { "type": "object", "description": "The properties of transfer validation response.", "properties": { "status": { "description": "The status of validation", "type": "string", "readOnly": true }, "productId": { "description": "The product id for which this result applies.", "type": "string", "readOnly": true }, "results": { "description": "The array of validation results.", "type": "array", "items": { "$ref": "#/definitions/ValidationResultProperties" } } } }, "ValidationResultProperties": { "description": "The properties of the validation result.", "properties": { "level": { "description": "Result Level.", "type": "string", "readOnly": true }, "code": { "description": "Result Code.", "type": "string", "readOnly": true }, "message": { "description": "The validation message.", "type": "string", "readOnly": true } } }, "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 } }, "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 2019-10-01-preview." }, "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" }, "billingSubscriptionNameParameter": { "name": "billingSubscriptionName", "in": "path", "description": "The ID that uniquely identifies a subscription.", "required": true, "type": "string", "x-ms-parameter-location": "method" }, "transferNameParameter": { "name": "transferName", "x-ms-parameter-location": "method", "in": "path", "required": true, "type": "string", "description": "The ID that uniquely identifies a transfer request." }, "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" }, "updateAutoRenewRequestParameter": { "name": "body", "x-ms-parameter-location": "method", "in": "body", "required": true, "description": "Request parameters that are provided to the update auto renew operation.", "schema": { "$ref": "#/definitions/UpdateAutoRenewRequest" } }, "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" } } } }