Partilhar via

Manage orders - Create a transfer

Serviço:
Partner Center Rest
Versão da API:
v1

Cria uma nova entidade de transferência.

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfers

Parâmetros do URI

Name Em Necessário Tipo Description
customer_id
 path True

string

O identificador do cliente.
version
 path True

string

Cabeçalho do Pedido

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Necessário Tipo Description
Authorization True

string

Token de portador de autorização
ms-correlationid

string

Usado para rastrear solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação
ms-cv

string

Usado para rastrear solicitações internamente. Se um ms-cv não for fornecido, o servidor gerará um novo para cada solicitação
ms-requestid

string

Usado para idempotência de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação

Corpo do Pedido

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Tipo Description
alternateId

string

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

completedTime

string (date-time)

createdTime

string (date-time)

customerEmailId

string

customerName

string

customerTenantId

string

expirationTime

string (date-time)

id

string

ignoreEligibilityCheck

boolean

lastModifiedTime

string (date-time)

lastModifiedUser

string

lineItems

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem[]

links

Microsoft.Partner.Core.Collections.ResourceLinks

participants

System.Collections.Generic.KeyValuePair[System.String,System.String][]

partnerOnRecord

string

partnertenantid

string

sourcePartnerEmailId

string

sourcePartnerName

string

sourcePartnerTenantId

string

status

string

targetPartnerEmailId

string

targetPartnerName

string

targetPartnerTenantId

string

targetProductTypes

string[]

transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
transferType enum:
  • Unknown (int32)
  • EaToCsp (int32)
  • DirectToIndirect (int32)
  • ModernAzure (int32)
  • PartnerToPartner (int32)
  • NewCommerce (int32)

Respostas

Name Tipo Description
201 Created

Microsoft.Partner.Services.Transfers.V2.Models.TransferEntity

O pedido foi bem-sucedido. O corpo da resposta contém as informações de transferência.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

O pedido não foi autenticado. O cliente precisa se autenticar com o serviço de API do parceiro primeiro.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

O pedido foi autenticado, mas foi recusado, uma vez que o autor da chamada não tem o direito de o invocar.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem tentar novamente.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definições

Name Description
Microsoft.Partner.Core.Collections.Link
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Core.Collections.ResourceLinks
Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingDetails
Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingPeriod
Microsoft.Partner.Services.Transfers.V2.Models.TransferEntity
Microsoft.Partner.Services.Transfers.V2.Models.TransferItemType
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemError
Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemPrice
System.Collections.Generic.KeyValuePair[System.String,System.String]
Object
Name Tipo Description
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

Object
Name Tipo Description
etag

string

objectType

string

Object
Name Tipo Description
next

Microsoft.Partner.Core.Collections.Link

previous

Microsoft.Partner.Core.Collections.Link

self

Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingDetails

Object
Name Tipo Description
billingAmount

number (double)

billingCycle enum:
  • annual (int32)
  • monthly (int32)
  • none (int32)
  • one_time (int32)
  • unknown (int32)
billingPeriod

Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingPeriod

billingType enum:
  • license (int32)
  • none (int32)
  • usage (int32)
currency

string

Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingPeriod

Object
Name Tipo Description
endDate

string (date-time)

startDate

string (date-time)

Microsoft.Partner.Services.Transfers.V2.Models.TransferEntity

Object
Name Tipo Description
alternateId

string

attributes

Microsoft.Partner.Core.Collections.ResourceAttributes

completedTime

string (date-time)

createdTime

string (date-time)

customerEmailId

string

customerName

string

customerTenantId

string

expirationTime

string (date-time)

id

string

ignoreEligibilityCheck

boolean

lastModifiedTime

string (date-time)

lastModifiedUser

string

lineItems

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem[]

links

Microsoft.Partner.Core.Collections.ResourceLinks

participants

System.Collections.Generic.KeyValuePair[System.String,System.String][]

partnerOnRecord

string

partnertenantid

string

sourcePartnerEmailId

string

sourcePartnerName

string

sourcePartnerTenantId

string

status

string

targetPartnerEmailId

string

targetPartnerName

string

targetPartnerTenantId

string

targetProductTypes

string[]

transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
transferType enum:
  • DirectToIndirect (int32)
  • EaToCsp (int32)
  • ModernAzure (int32)
  • NewCommerce (int32)
  • PartnerToPartner (int32)
  • Unknown (int32)

Microsoft.Partner.Services.Transfers.V2.Models.TransferItemType

Enumeração
Valor Description
AzureSubscription
AzureReservation
LegacyAzureSubscription
AzureSavingsPlan
OnlineServicesNCE

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem

Object
Name Tipo Description
addonItems

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItem[]

billingCycle enum:
  • annual (int32)
  • monthly (int32)
  • none (int32)
  • one_time (int32)
  • unknown (int32)
billingDetails

Microsoft.Partner.Services.Transfers.V2.Models.LastKnownBillingDetails

currencyCode

string

errors

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemError[]

friendlyName

string

id

integer (int32)

offerId

string

orderId

string

partnerIdOnRecord

string

price

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemPrice

productType

Microsoft.Partner.Services.Transfers.V2.Models.TransferItemType (int32)

quantity

integer (int32)

status

string

subscriptionId

string

transferError

string

transferGroupId

string

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemError

Object
Name Tipo Description
code

string

description

string

Microsoft.Partner.Services.Transfers.V2.Models.TransferLineItemPrice

Object
Name Tipo Description
currencyCode

string

discountedPrice

number (double)

extendedPrice

number (double)

listPrice

number (double)

price

number (double)

proratedPrice

number (double)

System.Collections.Generic.KeyValuePair[System.String,System.String]

Object
Name Tipo Description
key

string

value

string