Transfers - List

服务:

Billing

API 版本:

2024-04-01

列出发票科目的转移请求。 该操作仅支持协议类型为Microsoft客户协议的计费帐户。

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

URI 参数

名称	在	必需	类型	说明
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。
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	唯一标识计费配置文件的 ID。
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	唯一标识发票科目的 ID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

响应

名称	类型	说明
200 OK	TransferDetailsListResult	Azure 运营顺利完成。
Other Status Codes	ErrorResponse	意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

TransfersList

示例请求

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

示例响应

状态代码:

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

定义

名称	说明
createdByType	创建资源的标识的类型。
DetailedTransferStatus	详细的传输状态。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ProductTransferStatus	调动状态。
ProductType	传递的产品类型。
systemData	与创建和上次修改资源相关的元数据。
TransferDetails	传输的详细信息。
TransferDetailsListResult	TransferDetails项目的分页集合
TransferError	传输执行的错误详细信息。
TransferStatus	调动状态。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

DetailedTransferStatus

对象

详细的传输状态。

名称	类型	说明
errorDetails	TransferError	传输执行的错误详细信息。
productId	string	已转移的产品的 ID。
productName	string	转移的产品的名称。
productType	ProductType	已转移的产品的类型。
skuDescription	string	转移的产品的 SKU。
transferStatus	ProductTransferStatus	传输状态。

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

对象

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

对象

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ProductTransferStatus

枚举

调动状态。

值	说明
NotStarted	未开始
InProgress	进行中
Completed	已完成
Failed	Failed

ProductType

枚举

传递的产品类型。

值	说明
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	部门
SavingsPlan	储蓄计划
SAAS	SAAS

systemData

对象

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

TransferDetails

对象

传输的详细信息。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties.canceledBy	string	取消转移请求的用户的电子邮件 ID。
properties.detailedTransferStatus	DetailedTransferStatus[]	详细的传输状态。
properties.expirationTime	string (date-time)	传输请求过期的时间。
properties.initiatorEmailId	string	发送传输请求的用户的电子邮件 ID。
properties.recipientEmailId	string	向其发送转移请求的用户的电子邮件 ID。
properties.transferStatus	TransferStatus	总体传输状态。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	与资源关联的元数据字典。 它可能不会针对所有资源类型进行填充。 支持的最大键/值长度为 256 个字符。 键/值不应为空值，也不应为 null。 键不能包含 <> % & \ ？ /
type	string	资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

TransferDetailsListResult

对象

TransferDetails项目的分页集合

名称	类型	说明
nextLink	string (uri)	指向下一页项的链接
value	TransferDetails[]	本页的TransferDetails项目

TransferError

对象

传输执行的错误详细信息。

名称	类型	说明
code	string	错误代码。
message	string	错误信息。

TransferStatus

枚举

调动状态。

值	说明
Expired	已过期
Pending	待处理
InProgress	进行中
Completed	已完成
CompletedWithErrors	CompletedWithErrors
Failed	Failed
Canceled	已取消
Declined	已拒绝