Transfers - List

Usługa:

Billing

Wersja interfejsu API:

2024-04-01

Wyświetla listę żądań przeniesienia dla sekcji faktury. Ta operacja jest obsługiwana tylko w przypadku kont rozliczeniowych z typem umowy z Umową z Klientem Microsoft.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
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})?)$	Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Identyfikator, który jednoznacznie identyfikuje sekcję faktury.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TransferDetailsListResult	Operacja Azure zakończyła się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

TransfersList

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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"
      }
    }
  ]
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
DetailedTransferStatus	Szczegółowy stan transferu.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ProductTransferStatus	Status transferu.
ProductType	Rodzaj produktu, który jest przenoszony.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TransferDetails	Szczegóły przeniesienia.
TransferDetailsListResult	Kolekcja przedmiotów TransferDetails z listami
TransferError	Szczegóły błędu dotyczące wykonywania transferu.
TransferStatus	Status transferu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DetailedTransferStatus

Objekt

Szczegółowy stan transferu.

Nazwa	Typ	Opis
errorDetails	TransferError	Szczegóły błędu dotyczące wykonywania transferu.
productId	string	Identyfikator przenoszonego produktu.
productName	string	Nazwa przenoszonego produktu.
productType	ProductType	Typ przenoszonego produktu.
skuDescription	string	Jednostka SKU produktu, który jest przenoszony.
transferStatus	ProductTransferStatus	Stan transferu.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ProductTransferStatus

Wyliczenie

Status transferu.

Wartość	Opis
NotStarted	Nierozpoczęte
InProgress	W toku
Completed	Zakończono
Failed	Nie powiodło się

ProductType

Wyliczenie

Rodzaj produktu, który jest przenoszony.

Wartość	Opis
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	Dział
SavingsPlan	Plan oszczędnościowy
SAAS	SAAS

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TransferDetails

Objekt

Szczegóły przeniesienia.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.canceledBy	string	Identyfikator e-mail użytkownika, który anulował żądanie przeniesienia.
properties.detailedTransferStatus	DetailedTransferStatus[]	Szczegółowy stan transferu.
properties.expirationTime	string (date-time)	Czas wygaśnięcia żądania przeniesienia.
properties.initiatorEmailId	string	Identyfikator e-mail użytkownika, który wysłał żądanie przeniesienia.
properties.recipientEmailId	string	Identyfikator e-mail użytkownika, do którego wysłano żądanie przeniesienia.
properties.transferStatus	TransferStatus	Ogólny stan transferu.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Słownik metadanych skojarzonych z zasobem. Nie można go wypełnić dla wszystkich typów zasobów. Maksymalna długość klucza/wartości obsługiwana przez 256 znaków. Klucze/wartość nie powinny być puste ani mieć wartości null. Klucze nie mogą zawierać <> % & \ ? /
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

TransferDetailsListResult

Objekt

Kolekcja przedmiotów TransferDetails z listami

Nazwa	Typ	Opis
nextLink	string (uri)	Link do następnej strony elementów
value	TransferDetails[]	Elementy TransferDetails na tej stronie

TransferError

Objekt

Szczegóły błędu dotyczące wykonywania transferu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie.

TransferStatus

Wyliczenie

Status transferu.

Wartość	Opis
Expired	Wygasła
Pending	W oczekiwaniu
InProgress	W toku
Completed	Zakończono
CompletedWithErrors	CompletedWithErrors
Failed	Nie powiodło się
Canceled	Anulowane
Declined	Odrzucone