Transfers - List

Служба:: Billing

Версия API:: 2024-04-01

Перечисляет запросы на передачу для раздела счета. Эта операция поддерживается только для учетных записей выставления счетов с типом клиентского соглашения Майкрософт.

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})?)$	Идентификатор, который однозначно идентифицирует учетную запись выставления счетов.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Идентификатор, который однозначно идентифицирует профиль выставления счетов.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Идентификатор, который однозначно идентифицирует раздел счета.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	TransferDetailsListResult	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: 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	Идентификатор переданного продукта.
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	InProgress
Completed	Завершено
Failed	Неудача

ProductType

Перечисление

Тип продукта, который передаётся.

Значение	Описание
AzureSubscription	AzureSubscription
AzureReservation	AzureReservation
Department	Отдел
SavingsPlan	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)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.canceledBy	string	Идентификатор электронной почты пользователя, который отменил запрос на передачу.
properties.detailedTransferStatus	DetailedTransferStatus[]	Подробный статус передачи.
properties.expirationTime	string (date-time)	Время истечения срока действия запроса на передачу.
properties.initiatorEmailId	string	Идентификатор электронной почты пользователя, отправившего запрос на передачу.
properties.recipientEmailId	string	Идентификатор электронной почты пользователя, которому был отправлен запрос на передачу.
properties.transferStatus	TransferStatus	Общее состояние передачи.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
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	InProgress
Completed	Завершено
CompletedWithErrors	CompletedWithErrors
Failed	Неудача
Canceled	Отменено
Declined	Declined

Поделиться через

Transfers - List

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

TransfersList

Образец запроса

Пример ответа

Определения

createdByType

DetailedTransferStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProductTransferStatus

ProductType

systemData

TransferDetails

TransferDetailsListResult

TransferError

TransferStatus