Products - Transfer
Move os encargos de um produto para uma nova seção de fatura. A nova seção da fatura deve pertencer ao mesmo perfil de cobrança que a seção da fatura existente. Essa operação tem suporte apenas para produtos comprados com uma cobrança recorrente e para contas de cobrança com o tipo de contrato Contrato de Cliente da Microsoft.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/transfer?api-version=2019-10-01-preview
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
billing
|
path | True |
string |
A ID que identifica exclusivamente uma conta de cobrança. |
billing
|
path | True |
string |
A ID que identifica exclusivamente um perfil de cobrança. |
invoice
|
path | True |
string |
A ID que identifica exclusivamente uma seção de fatura. |
product
|
path | True |
string |
A ID que identifica exclusivamente um produto. |
api-version
|
query | True |
string |
A versão da API a ser usada com a solicitação do cliente. A versão atual é 2019-10-01-preview. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
destinationBillingProfileId |
string |
A ID do perfil de cobrança de destino. |
destinationInvoiceSectionId |
string |
A ID da seção da fatura de destino. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK. A solicitação foi bem-sucedida. |
|
202 Accepted |
Aceito Headers
|
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
TransferProduct
Sample Request
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/transfer?api-version=2019-10-01-preview
{
"destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
"destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}
Sample Response
{
"id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}/products/{productName}",
"name": "{productName}",
"type": "Microsoft.Billing/products",
"properties": {
"productTypeId": "A12345",
"productType": "Subscription",
"displayName": "Test Product",
"status": "Active",
"purchaseDate": "2018-05-01T17:32:28Z",
"lastCharge": {
"currency": "USD",
"value": 5000
},
"lastChargeDate": "2018-06-15T17:32:28Z",
"billingFrequency": "Monthly",
"quantity": 4,
"skuId": "0001",
"skuDescription": "Enterprise Agreement Development",
"tenantId": "515a6d36-aaf8-4ca2-a5e8-c45deb0c5cce",
"availabilityId": "AvailabilityId1",
"parentProductId": "45000000-0000-0000-0000-0000000001242",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
"invoiceSectionDisplayName": "Contoso operations invoiceSection",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
"billingProfileDisplayName": "Contoso operations billing"
}
}
Location: https://management.azure.com/providers/Microsoft.Billing/operationResults/44000000-0000-0000-0000-000000000000?api-version=2019-10-01-preview
Retry-After: 60
OData-EntityId: 44000000-0000-0000-0000-000000000000
Definições
Nome | Description |
---|---|
Amount |
O valor. |
Billing |
A frequência em que o produto será cobrado. |
Error |
Os detalhes do erro. |
Error |
A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. |
Error |
|
Product |
Um produto. |
Product |
O status atual do produto. |
Reseller |
Detalhes do revendedor. |
Transfer |
As propriedades do produto para iniciar uma transferência. |
Amount
O valor.
Nome | Tipo | Description |
---|---|---|
currency |
string |
A moeda do valor do valor. |
value |
number |
Valor da quantidade. |
BillingFrequency
A frequência em que o produto será cobrado.
Nome | Tipo | Description |
---|---|---|
Monthly |
string |
|
OneTime |
string |
|
UsageBased |
string |
ErrorDetails
Os detalhes do erro.
Nome | Tipo | Description |
---|---|---|
code |
string |
Código do erro. |
details |
Os sub-detalhes do erro. |
|
message |
string |
Mensagem de erro indicando por que a operação falhou. |
target |
string |
O destino do erro específico. |
ErrorResponse
A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
Nome | Tipo | Description |
---|---|---|
error |
Os detalhes do erro. |
ErrorSubDetails
Nome | Tipo | Description |
---|---|---|
code |
string |
Código do erro. |
message |
string |
Mensagem de erro indicando por que a operação falhou. |
target |
string |
O destino do erro específico. |
Product
Um produto.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso. |
name |
string |
Nome do recurso. |
properties.availabilityId |
string |
A disponibilidade do produto. |
properties.billingFrequency |
A frequência em que o produto será cobrado. |
|
properties.billingProfileDisplayName |
string |
O nome do perfil de cobrança ao qual o produto é cobrado. |
properties.billingProfileId |
string |
A ID do perfil de cobrança ao qual o produto é cobrado. |
properties.customerDisplayName |
string |
O nome do cliente para quem o produto foi comprado. O campo é aplicável somente para Contrato de Parceiro da Microsoft conta de cobrança. |
properties.customerId |
string |
A ID do cliente para quem o produto foi comprado. O campo é aplicável somente para Contrato de Parceiro da Microsoft conta de cobrança. |
properties.displayName |
string |
O nome de exibição do produto. |
properties.endDate |
string |
A data em que o produto será renovado ou cancelado. |
properties.invoiceSectionDisplayName |
string |
O nome da seção da fatura à qual o produto é cobrado. |
properties.invoiceSectionId |
string |
A ID da seção da fatura à qual o produto é cobrado. |
properties.lastCharge |
O último mês cobra. |
|
properties.lastChargeDate |
string |
A data da última cobrança. |
properties.parentProductId |
string |
ID do produto pai. |
properties.productType |
string |
A descrição do tipo de produto. |
properties.productTypeId |
string |
A ID do tipo de produto. |
properties.purchaseDate |
string |
A data em que o produto foi comprado. |
properties.quantity |
number |
A quantidade adquirida para o produto. |
properties.reseller |
Revendedor para este produto. |
|
properties.skuDescription |
string |
A descrição do sku do produto. |
properties.skuId |
string |
A ID de sku do produto. |
properties.status |
O status atual do produto. |
|
properties.tenantId |
string |
A ID do locatário no qual o produto é usado. |
type |
string |
Tipo de recurso. |
ProductStatusType
O status atual do produto.
Nome | Tipo | Description |
---|---|---|
Active |
string |
|
AutoRenew |
string |
|
Cancelled |
string |
|
Disabled |
string |
|
Expired |
string |
|
Expiring |
string |
|
Inactive |
string |
|
PastDue |
string |
Reseller
Detalhes do revendedor.
Nome | Tipo | Description |
---|---|---|
description |
string |
O nome do revendedor. |
resellerId |
string |
A ID do MPN do revendedor. |
TransferProductRequestProperties
As propriedades do produto para iniciar uma transferência.
Nome | Tipo | Description |
---|---|---|
destinationBillingProfileId |
string |
A ID do perfil de cobrança de destino. |
destinationInvoiceSectionId |
string |
A ID da seção da fatura de destino. |