Partner Transfers - List

Service:: Billing

Version d'API:: 2024-04-01

Répertorie les demandes de transfert envoyées à un client. L’opération est prise en charge uniquement pour les comptes de facturation avec le type contrat Partenaire Microsoft.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
billingAccountName	path	True	string pattern: ^([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})?)$	ID qui identifie de façon unique un compte de facturation.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID qui identifie de façon unique un profil de facturation.
customerName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID qui identifie de façon unique un client.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	PartnerTransferDetailsListResult	Opération Azure terminée avec succès.
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

PartnerTransfersList

Exemple de requête

HTTP

GET 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?api-version=2024-04-01

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "name": "aabb123",
      "type": "Microsoft.Billing/transfers",
      "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",
      "properties": {
        "detailedTransferStatus": [
          {
            "productId": "subscriptionId",
            "productName": "Azure subscription 1",
            "productType": "AzureSubscription",
            "skuDescription": "MS-AZR-0017G",
            "transferStatus": "InProgress"
          },
          {
            "productId": "reservedInstanceId",
            "productName": "Reservation name",
            "productType": "AzureReservation",
            "skuDescription": "Standard_D2s_v3;VirtualMachines;P1Y",
            "transferStatus": "InProgress"
          }
        ],
        "expirationTime": "2018-11-05T17:32:28Z",
        "initiatorCustomerType": "Partner",
        "initiatorEmailId": "xyz@contoso.com",
        "recipientEmailId": "user@contoso.com",
        "transferStatus": "InProgress"
      }
    }
  ]
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
DetailedTransferStatus	État détaillé du transfert.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
InitiatorCustomerType	Le type de client de l’initiateur de transfert.
PartnerTransferDetails	Détails du transfert.
PartnerTransferDetailsListResult	Collection paginate des éléments PartnerTransferDetails
ProductTransferStatus	Le statut d’un transfert.
ProductType	Le type de produit qui est transféré.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TransferError	Détails de l’erreur pour l’exécution du transfert.
TransferStatus	Le statut d’un transfert.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DetailedTransferStatus

Objet

État détaillé du transfert.

Nom	Type	Description
errorDetails	TransferError	Détails de l’erreur pour l’exécution du transfert.
productId	string	ID du produit transféré.
productName	string	Nom du produit transféré.
productType	ProductType	Type de produit transféré.
skuDescription	string	Référence SKU du produit transféré.
transferStatus	ProductTransferStatus	État du transfert.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

InitiatorCustomerType

Énumération

Le type de client de l’initiateur de transfert.

Valeur	Description
Partner	Partenaire
EA	EA

PartnerTransferDetails

Objet

Détails du transfert.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties.canceledBy	string	ID d’e-mail de l’utilisateur qui a annulé la demande de transfert.
properties.detailedTransferStatus	DetailedTransferStatus[]	État détaillé du transfert.
properties.expirationTime	string (date-time)	Heure à laquelle la demande de transfert expire.
properties.initiatorCustomerType	InitiatorCustomerType	Type de client qui a envoyé la demande de transfert.
properties.initiatorEmailId	string	ID de messagerie de l’utilisateur qui a envoyé la demande de transfert.
properties.recipientEmailId	string	ID d’e-mail de l’utilisateur auquel la demande de transfert a été envoyée.
properties.resellerId	string	ID MPN facultatif du revendeur pour les demandes de transfert envoyées à partir d’un compte de facturation contrat partenaire Microsoft.
properties.resellerName	string	Nom facultatif du revendeur pour les demandes de transfert envoyées à partir du compte de facturation du Contrat partenaire Microsoft.
properties.transferStatus	TransferStatus	État global du transfert.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Dictionnaire de métadonnées associées à la ressource. Il peut ne pas être rempli pour tous les types de ressources. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? /
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

PartnerTransferDetailsListResult

Objet

Collection paginate des éléments PartnerTransferDetails

Nom	Type	Description
nextLink	string (uri)	Lien vers la page suivante des éléments
value	PartnerTransferDetails[]	Les éléments PartnerTransferDetails sur cette page

ProductTransferStatus

Énumération

Le statut d’un transfert.

Valeur	Description
NotStarted	NotStarted
InProgress	En cours
Completed	Terminé
Failed	Échec

ProductType

Énumération

Le type de produit qui est transféré.

Valeur	Description
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	Département
SavingsPlan	Plan d’épargne
SAAS	SAAS

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TransferError

Objet

Détails de l’erreur pour l’exécution du transfert.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d'erreur.

TransferStatus

Énumération

Le statut d’un transfert.

Valeur	Description
Expired	Expiré
Pending	En attente
InProgress	En cours
Completed	Terminé
CompletedWithErrors	CompletedWithErrors
Failed	Échec
Canceled	Opération annulée
Declined	Declined

Partager via

Partner Transfers - List

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

PartnerTransfersList

Exemple de requête

Exemple de réponse

Définitions

createdByType

DetailedTransferStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InitiatorCustomerType

PartnerTransferDetails

PartnerTransferDetailsListResult

ProductTransferStatus

ProductType

systemData

TransferError

TransferStatus