Transfers - List

Služba:: Billing

Verze rozhraní API:: 2024-04-01

Zobrazí seznam žádostí o převod pro oddíl faktury. Operace se podporuje jenom u fakturačních účtů s typem Smlouvy se zákazníkem Microsoftu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	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, které jednoznačně identifikuje fakturační účet.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID, které jednoznačně identifikuje fakturační profil.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID, které jednoznačně identifikuje oddíl faktury.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	TransferDetailsListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

TransfersList

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
      }
    }
  ]
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DetailedTransferStatus	Podrobný stav přenosu
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ProductTransferStatus	Stav přestupu.
ProductType	Typ produktu, který se přenáší.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TransferDetails	Podrobnosti o převodu.
TransferDetailsListResult	Stránkovaná sbírka položek TransferDetails
TransferError	Podrobnosti o chybě při provádění přenosu
TransferStatus	Stav přestupu.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DetailedTransferStatus

Objekt

Podrobný stav přenosu

Name	Typ	Description
errorDetails	TransferError	Podrobnosti o chybě při provádění přenosu
productId	string	ID převedeného produktu.
productName	string	Název produktu, který je převeden.
productType	ProductType	Typ produktu, který je převeden.
skuDescription	string	Skladová položka produktu, který je převeden.
transferStatus	ProductTransferStatus	Stav přenosu

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ProductTransferStatus

Výčet

Stav přestupu.

Hodnota	Description
NotStarted	Nezahájeno
InProgress	V průběhu
Completed	Dokončeno
Failed	Nezdařilo se

ProductType

Výčet

Typ produktu, který se přenáší.

Hodnota	Description
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	Oddělení
SavingsPlan	Spořicí plán
SAAS	SAAS

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TransferDetails

Objekt

Podrobnosti o převodu.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties.canceledBy	string	ID e-mailu uživatele, který žádost o převod zrušil.
properties.detailedTransferStatus	DetailedTransferStatus[]	Podrobný stav přenosu
properties.expirationTime	string (date-time)	Čas vypršení platnosti žádosti o převod.
properties.initiatorEmailId	string	ID e-mailu uživatele, který odeslal žádost o převod.
properties.recipientEmailId	string	ID e-mailu uživatele, kterému byla odeslána žádost o převod.
properties.transferStatus	TransferStatus	Celkový stav převodu
systemData	systemData	Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy
tags	object	Slovník metadat přidružených k prostředku Nemusí být vyplněna pro všechny typy prostředků. Maximální podporovaná délka klíče a hodnoty 256 znaků. Klíče nebo hodnota by neměly být prázdné ani null. Klíče nemohou obsahovat <> % & \ ? /
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

TransferDetailsListResult

Objekt

Stránkovaná sbírka položek TransferDetails

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	TransferDetails[]	Položky TransferDetails na této stránce

TransferError

Objekt

Podrobnosti o chybě při provádění přenosu

Name	Typ	Description
code	string	Kód chyby
message	string	Zpráva o chybě.

TransferStatus

Výčet

Stav přestupu.

Hodnota	Description
Expired	Platnost vypršela
Pending	Čeká na vyřízení
InProgress	V průběhu
Completed	Dokončeno
CompletedWithErrors	CompletedWithErrors
Failed	Nezdařilo se
Canceled	Zrušeno
Declined	Odmítnuto

Sdílet prostřednictvím

Transfers - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

TransfersList

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

DetailedTransferStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProductTransferStatus

ProductType

systemData

TransferDetails

TransferDetailsListResult

TransferError

TransferStatus