Condividi tramite


Partner Transfers - Cancel

Annulla una richiesta di trasferimento. L'operazione è supportata solo per gli account di fatturazione con tipo di contratto Contratto Microsoft Partner.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/transfers/{transferName}/cancel?api-version=2024-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
billingAccountName
path True

string

ID che identifica in modo univoco un account di fatturazione.

Criterio di espressione regolare: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

billingProfileName
path True

string

ID che identifica in modo univoco un profilo di fatturazione.

Criterio di espressione regolare: ^[a-zA-Z\d-_]{1,128}$

customerName
path True

string

ID che identifica in modo univoco un cliente.

Criterio di espressione regolare: ^[a-zA-Z\d-_]{1,128}$

transferName
path True

string

ID che identifica in modo univoco una richiesta di trasferimento.

Criterio di espressione regolare: ^[a-z0-9]*$

api-version
query True

string

Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.

Risposte

Nome Tipo Descrizione
200 OK

PartnerTransferDetails

Dettagli del trasferimento annullato.

Other Status Codes

ErrorResponse

Errore imprevisto.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

PartnerTransferCancel

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/customers/11111111-1111-1111-1111-111111111111/transfers/aabb123/cancel?api-version=2024-04-01

Risposta di esempio

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/BillingProfiles/xxxx-xxxx-xxx-xxx/customers/11111111-1111-1111-1111-111111111111/transfers/aabb123",
  "name": "aabb123",
  "type": "Microsoft.Billing/transfers",
  "properties": {
    "expirationTime": "2018-11-05T17:32:28Z",
    "transferStatus": "Pending",
    "recipientEmailId": "user@contoso.com",
    "initiatorEmailId": "xyz@contoso.com",
    "initiatorCustomerType": "Partner",
    "canceledBy": "user@contoso.com"
  }
}

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.

DetailedTransferStatus

Stato di trasferimento dettagliato.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

initiatorCustomerType

Tipo di cliente che ha inviato la richiesta di trasferimento.

PartnerTransferDetails

Dettagli del trasferimento.

productTransferStatus

Stato trasferimento.

productType

Tipo del prodotto trasferito.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

TransferError

Dettagli dell'errore per l'esecuzione del trasferimento.

transferStatus

Stato complessivo del trasferimento.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DetailedTransferStatus

Stato di trasferimento dettagliato.

Nome Tipo Descrizione
errorDetails

TransferError

Dettagli dell'errore per l'esecuzione del trasferimento.

productId

string

ID del prodotto trasferito.

productName

string

Nome del prodotto trasferito.

productType

productType

Tipo di prodotto trasferito.

skuDescription

string

SKU del prodotto trasferito.

transferStatus

productTransferStatus

Stato trasferimento.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

initiatorCustomerType

Tipo di cliente che ha inviato la richiesta di trasferimento.

Nome Tipo Descrizione
EA

string

Partner

string

PartnerTransferDetails

Dettagli del trasferimento.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties.canceledBy

string

ID di posta elettronica dell'utente che ha annullato la richiesta di trasferimento.

properties.detailedTransferStatus

DetailedTransferStatus[]

Stato di trasferimento dettagliato.

properties.expirationTime

string

Ora di scadenza della richiesta di trasferimento.

properties.initiatorCustomerType

initiatorCustomerType

Tipo di cliente che ha inviato la richiesta di trasferimento.

properties.initiatorEmailId

string

ID di posta elettronica dell'utente che ha inviato la richiesta di trasferimento.

properties.recipientEmailId

string

ID di posta elettronica dell'utente a cui è stata inviata la richiesta di trasferimento.

properties.resellerId

string

ID MPN facoltativo del rivenditore per le richieste di trasferimento inviate da un account di fatturazione del Contratto Microsoft Partner.

properties.resellerName

string

Nome facoltativo del rivenditore per le richieste di trasferimento inviate dall'account di fatturazione del Contratto Microsoft Partner.

properties.transferStatus

transferStatus

Stato complessivo del trasferimento.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

tags

object

Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /

type

string

Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

productTransferStatus

Stato trasferimento.

Nome Tipo Descrizione
Completed

string

Failed

string

InProgress

string

NotStarted

string

productType

Tipo del prodotto trasferito.

Nome Tipo Descrizione
AzureReservation

string

AzureSubscription

string

Department

string

SAAS

string

SavingsPlan

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

TransferError

Dettagli dell'errore per l'esecuzione del trasferimento.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

transferStatus

Stato complessivo del trasferimento.

Nome Tipo Descrizione
Canceled

string

Completed

string

CompletedWithErrors

string

Declined

string

Expired

string

Failed

string

InProgress

string

Pending

string