Products - Transfer

Referência

Service:: Billing

API Version:: 2019-10-01-preview

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
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

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	Product	OK. A solicitação foi bem-sucedida.
202 Accepted		Aceito Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Nome

Tipo

Description

200 OK

Product

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

202 Accepted

Aceito

Headers

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

HTTP

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

Status code:: 200

{
  "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"
  }
}

Status code:: 202

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

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	ErrorSubDetails[]	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	ErrorDetails	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	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	Amount	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	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	ProductStatusType	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.

Products - Transfer

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Scopes

Exemplos

TransferProduct

Sample Request

Sample Response

Definições

Amount

BillingFrequency

ErrorDetails

ErrorResponse

ErrorSubDetails

Product

ProductStatusType

Reseller

TransferProductRequestProperties

Recursos adicionais