你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Transfers - Get

参考

Service:: Billing

API Version:: 2019-10-01-preview

按 ID 获取转移请求。只有协议类型为 Microsoft 客户协议的计费帐户支持该操作。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transfers/{transferName}

URI 参数

名称	在	必需	类型	说明
billingAccountName	path	True	string	唯一标识计费帐户的 ID。
billingProfileName	path	True	string	唯一标识计费对象信息的 ID。
invoiceSectionName	path	True	string	唯一标识发票科目的 ID。
transferName	path	True	string	唯一标识传输请求的 ID。

响应

名称	类型	说明
200 OK	TransferDetails	转移的详细信息。
Other Status Codes	ErrorResponse	意外错误。

安全性

azure_auth

Azure Active Directory OAuth2 流。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

TransferGet

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transfers/transferName

Sample Response

Status code:: 200

{
  "properties": {
    "creationTime": "2018-10-10T17:32:28Z",
    "expirationTime": "2018-11-05T17:32:28Z",
    "billingAccountId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}",
    "billingProfileId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}",
    "invoiceSectionId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}",
    "transferStatus": "InProgress",
    "recipientEmailId": "user@contoso.com",
    "initiatorEmailId": "xyz@contoso.com",
    "lastModifiedTime": "2018-10-10T17:32:28Z",
    "detailedTransferStatus": [
      {
        "productType": "AzureSubscription",
        "productId": "subscriptionId",
        "transferStatus": "InProgress"
      },
      {
        "productType": "AzureReservation",
        "productId": "reservedInstanceId",
        "transferStatus": "InProgress"
      }
    ]
  }
}

定义

名称	说明
DetailedTransferStatus	详细的传输状态。
Error	传输执行的错误详细信息。
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。错误消息中提供了原因。
ErrorSubDetails
productTransferStatus	传输状态。
productType	要转移的产品的类型。
TransferDetails	转移的详细信息。
transferStatus	总体传输状态。

DetailedTransferStatus

详细的传输状态。

名称	类型	说明
errorDetails	Error	传输执行的错误详细信息。
productId	string	要转移的产品的 ID。
productType	productType	要转移的产品的类型。
transferStatus	productTransferStatus	传输状态。

Error

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

名称	类型	说明
errorCode	string	错误代码。
errorMessage	string	错误消息。

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
details	ErrorSubDetails[]	错误的子详细信息。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

ErrorResponse

错误响应指示服务无法处理传入请求。错误消息中提供了原因。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

ErrorSubDetails

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

productTransferStatus

传输状态。

名称	类型	说明
Completed	string
Failed	string
InProgress	string
NotStarted	string

productType

要转移的产品的类型。

名称	类型	说明
AzureReservation	string
AzureSubscription	string

TransferDetails

转移的详细信息。

名称	类型	说明
properties.billingAccountId	string	转移请求完成后，产品要向其计费的计费帐户的 ID。
properties.billingProfileId	string	产品在转移后要对其计费的计费对象信息的 ID。
properties.canceledBy	string	取消转移请求的用户的电子邮件 ID。
properties.creationTime	string	创建传输请求的时间。
properties.detailedTransferStatus	DetailedTransferStatus[]	详细的传输状态。
properties.expirationTime	string	转移请求过期的时间。
properties.initiatorCustomerType	string	发送转移请求的客户类型。
properties.initiatorEmailId	string	发送转移请求的用户的电子邮件 ID。
properties.invoiceSectionId	string	转移请求完成后，产品要对其计费的发票科目的 ID。
properties.lastModifiedTime	string	上次修改传输请求的时间。
properties.recipientEmailId	string	向其发送转移请求的用户的电子邮件 ID。
properties.resellerId	string	经销商的可选 MPN ID，用于从Microsoft 合作伙伴协议计费帐户发送的转移请求。
properties.resellerName	string	从Microsoft 合作伙伴协议计费帐户发送的转移请求的经销商的可选名称。
properties.transferStatus	transferStatus	总体传输状态。

transferStatus

总体传输状态。

名称	类型	说明
Canceled	string
Completed	string
CompletedWithErrors	string
Declined	string
Failed	string
InProgress	string
Pending	string