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 de fatura existente. Essa operação tem suporte apenas para produtos que são comprados com um encargo 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

Name In Required Type Description
billingAccountName
path True
  • string

A ID que identifica exclusivamente uma conta de cobrança.

billingProfileName
path True
  • string

A ID que identifica exclusivamente um perfil de cobrança.

invoiceSectionName
path True
  • string

A ID que identifica exclusivamente uma seção de fatura.

productName
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

Name Type Description
destinationBillingProfileId
  • string

A ID do perfil de cobrança de destino.

destinationInvoiceSectionId
  • string

A ID da seção da fatura de destino.

Respostas

Name Type Description
200 OK

OK. A solicitação foi bem-sucedida.

202 Accepted

Aceito

Headers

  • Location: string
  • Retry-After: integer
Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name 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

Amount

O valor.

BillingFrequency

A frequência em que o produto será cobrado.

ErrorDetails

Os detalhes do erro.

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.

ErrorSubDetails
Product

Um produto.

ProductStatusType

O status atual do produto.

Reseller

Detalhes do revendedor.

TransferProductRequestProperties

As propriedades do produto para iniciar uma transferência.

Amount

O valor.

Name Type Description
currency
  • string

A moeda do valor do valor.

value
  • number

Valor da quantidade.

BillingFrequency

A frequência em que o produto será cobrado.

Name Type Description
Monthly
  • string
OneTime
  • string
UsageBased
  • string

ErrorDetails

Os detalhes do erro.

Name Type 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.

Name Type Description
error

Os detalhes do erro.

ErrorSubDetails

Name Type 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.

Name Type 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 o qual 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 o qual 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 comprada 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.

Name Type Description
Active
  • string
AutoRenew
  • string
Cancelled
  • string
Disabled
  • string
Expired
  • string
Expiring
  • string
Inactive
  • string
PastDue
  • string

Reseller

Detalhes do revendedor.

Name Type 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.

Name Type Description
destinationBillingProfileId
  • string

A ID do perfil de cobrança de destino.

destinationInvoiceSectionId
  • string

A ID da seção da fatura de destino.