Udostępnij przez

Manage orders - Update an existing transfer

Usługa:
Partner Center Rest
Wersja interfejsu API:
v1

Aktualizuje istniejący transfer.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
customer_id
 path True

string

Identyfikator klienta.
transfer_id
 path True

string

Identyfikator transferu.
version
 path True

string

Nagłówek żądania

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

Nazwa Wymagane Typ Opis
Authorization True

string

Token elementu nośnego autoryzacji
ms-correlationid

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania
ms-cv

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania
ms-requestid

string

Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania

Treść żądania

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

Nazwa Typ Opis
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)

Odpowiedzi

Nazwa Typ Opis
200 OK

object

OK

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

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

Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera informacje o transferze.

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

Brak danych wejściowych lub nieprawidłowy. Treść odpowiedzi udostępni szczegóły błędu.

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

Żądanie nie zostało uwierzytelnione. Klient musi najpierw uwierzytelnić się za pomocą usługi interfejsu API partnera.

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

Żądanie zostało uwierzytelnione, ale zostało odrzucone, ponieważ obiekt wywołujący nie ma praw do jego wywołania.

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

Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi.

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

Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Osoby wywołujące mogą ponowić próbę.

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

Definicje

Nazwa Opis
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]
Objekt
Nazwa Typ Opis
body

string

headers

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

method

string

uri

string

Microsoft.Partner.Core.Collections.ResourceAttributes

Objekt
Nazwa Typ Opis
etag

string

objectType

string

Objekt
Nazwa Typ Opis
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

Objekt
Nazwa Typ Opis
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

Objekt
Nazwa Typ Opis
endDate

string (date-time)

startDate

string (date-time)

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

Objekt
Nazwa Typ Opis
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

Wyliczenie
Wartość Opis
AzureSubscription
AzureReservation
LegacyAzureSubscription
AzureSavingsPlan
OnlineServicesNCE

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

Objekt
Nazwa Typ Opis
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

Objekt
Nazwa Typ Opis
code

string

description

string

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

Objekt
Nazwa Typ Opis
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]

Objekt
Nazwa Typ Opis
key

string

value

string