Partner Transfers - List

Служба:: Billing

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

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

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/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}$	Идентификатор, который однозначно идентифицирует профиль выставления счетов.
customerName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Идентификатор, который однозначно идентифицирует клиента.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

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

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

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

PartnerTransfersList

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

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/customers/11111111-1111-1111-1111-111111111111/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/customers/11111111-1111-1111-1111-111111111111/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",
        "initiatorCustomerType": "Partner",
        "initiatorEmailId": "xyz@contoso.com",
        "recipientEmailId": "user@contoso.com",
        "transferStatus": "InProgress"
      }
    }
  ]
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
DetailedTransferStatus	Подробный статус передачи.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
InitiatorCustomerType	Тип клиента инициатора передачи.
PartnerTransferDetails	Сведения о передаче.
PartnerTransferDetailsListResult	Страница сборника материалов PartnerTransferDetails
ProductTransferStatus	Статус перевода.
ProductType	Тип продукта, который передаётся.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
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	Объект ошибки.

InitiatorCustomerType

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

Тип клиента инициатора передачи.

Значение	Описание
Partner	Партнер
EA	EA

PartnerTransferDetails

Объект

Сведения о передаче.

Имя	Тип	Описание
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.initiatorCustomerType	InitiatorCustomerType	Тип клиента, отправившего запрос на передачу.
properties.initiatorEmailId	string	Идентификатор электронной почты пользователя, отправившего запрос на передачу.
properties.recipientEmailId	string	Идентификатор электронной почты пользователя, которому был отправлен запрос на передачу.
properties.resellerId	string	Необязательный идентификатор MPN торгового посредника для запросов на передачу, отправленных из учетной записи выставления счетов соглашения с партнером Майкрософт.
properties.resellerName	string	Необязательное имя торгового посредника для запросов на передачу, отправленных из учетной записи выставления счетов соглашения о партнерах Майкрософт.
properties.transferStatus	TransferStatus	Общее состояние передачи.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Словарь метаданных, связанных с ресурсом. Он не может быть заполнен для всех типов ресурсов. Максимальная длина ключа и значения, поддерживаемая 256 символами. Ключи или значение не должны пустыми значениями и значениями NULL. Ключи не могут содержать <> % & \ ? /
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

PartnerTransferDetailsListResult

Объект

Страница сборника материалов PartnerTransferDetails

Имя	Тип	Описание
nextLink	string (uri)	Ссылка на следующую страницу элементов
value	PartnerTransferDetails[]	Пункты PartnerTransferDetails на этой странице

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	Тип удостоверения, который последний раз изменил ресурс.

TransferError

Объект

Сведения об ошибке для выполнения передачи.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.

TransferStatus

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

Статус перевода.

Значение	Описание
Expired	Срок действия истек
Pending	В ожидании
InProgress	InProgress
Completed	Завершено
CompletedWithErrors	CompletedWithErrors
Failed	Неудача
Canceled	Отменено
Declined	Declined

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

Partner Transfers - List

Параметры URI

Ответы

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

azure_auth

Области

Примеры

PartnerTransfersList

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

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

Определения

createdByType

DetailedTransferStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InitiatorCustomerType

PartnerTransferDetails

PartnerTransferDetailsListResult

ProductTransferStatus

ProductType

systemData

TransferError

TransferStatus