Transfers - List

Servicio:: Billing

Versión de la API:: 2024-04-01

Enumera las solicitudes de transferencia de una sección de factura. La operación solo se admite para las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	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})?)$	Identificador que identifica de forma única una cuenta de facturación.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Identificador que identifica de forma única un perfil de facturación.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Identificador que identifica de forma única una sección de factura.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	TransferDetailsListResult	Operación de Azure completada con éxito.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

TransfersList

Solicitud de ejemplo

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/invoiceSections/yyyy-yyyy-yyy-yyy/transfers?api-version=2024-04-01

Respuesta de muestra

status code:: 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/invoiceSections/yyyy-yyyy-yyy-yyy/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",
        "initiatorEmailId": "xyz@contoso.com",
        "recipientEmailId": "user@contoso.com",
        "transferStatus": "InProgress"
      }
    }
  ]
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
DetailedTransferStatus	Estado detallado de la transferencia.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ProductTransferStatus	El estado de una transferencia.
ProductType	El tipo de producto que se transfiere.
systemData	Metadatos relativos a la creación y última modificación del recurso.
TransferDetails	Detalles de la transferencia.
TransferDetailsListResult	Colección paginada de elementos de TransferDetails
TransferError	Detalles del error para la ejecución de la transferencia.
TransferStatus	El estado de una transferencia.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DetailedTransferStatus

Objeto

Estado detallado de la transferencia.

Nombre	Tipo	Description
errorDetails	TransferError	Detalles del error para la ejecución de la transferencia.
productId	string	Identificador del producto que se transfiere.
productName	string	Nombre del producto que se transfiere.
productType	ProductType	Tipo de producto que se transfiere.
skuDescription	string	SKU del producto que se transfiere.
transferStatus	ProductTransferStatus	Estado de transferencia.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ProductTransferStatus

Enumeración

El estado de una transferencia.

Valor	Description
NotStarted	NotStarted
InProgress	En Progreso
Completed	Completado
Failed	Fallido

ProductType

Enumeración

El tipo de producto que se transfiere.

Valor	Description
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	Departamento
SavingsPlan	Plan de Ahorro
SAAS	SaaS

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

TransferDetails

Objeto

Detalles de la transferencia.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties.canceledBy	string	Identificador de correo electrónico del usuario que canceló la solicitud de transferencia.
properties.detailedTransferStatus	DetailedTransferStatus[]	Estado detallado de la transferencia.
properties.expirationTime	string (date-time)	Hora a la que expira la solicitud de transferencia.
properties.initiatorEmailId	string	Identificador de correo electrónico del usuario que envió la solicitud de transferencia.
properties.recipientEmailId	string	Identificador de correo electrónico del usuario al que se envió la solicitud de transferencia.
properties.transferStatus	TransferStatus	Estado general de la transferencia.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? /
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TransferDetailsListResult

Objeto

Colección paginada de elementos de TransferDetails

Nombre	Tipo	Description
nextLink	string (uri)	Vínculo a la página siguiente de elementos
value	TransferDetails[]	Los elementos de TransferDetails en esta página

TransferError

Objeto

Detalles del error para la ejecución de la transferencia.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error.

TransferStatus

Enumeración

El estado de una transferencia.

Valor	Description
Expired	Caducado
Pending	Pendiente
InProgress	En Progreso
Completed	Completado
CompletedWithErrors	CompletedWithErrors
Failed	Fallido
Canceled	Cancelado
Declined	Rechazado

Compartir a través de

Transfers - List

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

TransfersList

Solicitud de ejemplo

Respuesta de muestra

Definiciones

createdByType

DetailedTransferStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProductTransferStatus

ProductType

systemData

TransferDetails

TransferDetailsListResult

TransferError

TransferStatus