Billing Subscriptions - Validate Transfer

Service:

Billing

API Version:

2019-10-01-preview

구독 요금을 새 청구서 섹션으로 이동할 수 있는지 유효성을 검사합니다. 이 작업은 반복 요금으로 구매한 제품 및 계약 유형이 Microsoft 고객 계약 청구 계정에 대해서만 지원됩니다.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/validateTransferEligibility

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountName	path	True	string	청구 계정을 고유하게 식별하는 ID입니다.
billingProfileName	path	True	string	청구 프로필을 고유하게 식별하는 ID입니다.
billingSubscriptionName	path	True	string	구독을 고유하게 식별하는 ID입니다.
invoiceSectionName	path	True	string	청구서 섹션을 고유하게 식별하는 ID입니다.

요청 본문

Name	형식	Description
destinationBillingProfileId	string	대상 청구 프로필 ID입니다.
destinationInvoiceSectionId	string	대상 청구서 섹션 ID입니다.

응답

Name	형식	Description
200 OK	ValidateSubscriptionTransferEligibilityResult	OK. 요청이 성공했습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

SubscriptionTransferValidateFailure

SubscriptionTransferValidateSuccess

SubscriptionTransferValidateFailure

Sample Request

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/validateTransferEligibility

{
  "destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
  "destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}

Sample Response

Status code:

200

{
  "isTransferEligible": false,
  "errorDetails": {
    "code": "SubscriptionNotActive",
    "message": "Invoice Sections can only be changed for active subscriptions."
  }
}

SubscriptionTransferValidateSuccess

Sample Request

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/validateTransferEligibility

{
  "destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
  "destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}

Sample Response

Status code:

200

{
  "isTransferEligible": true
}

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 이유는 오류 메시지에 제공됩니다.
ErrorSubDetails
subscriptionTransferValidationErrorCode	제품 전송 유효성 검사에 대한 오류 코드입니다.
TransferBillingSubscriptionRequestProperties	청구 구독을 전송하기 위한 요청 매개 변수입니다.
ValidateSubscriptionTransferEligibilityError	이전 자격 유효성 검사의 오류 세부 정보
ValidateSubscriptionTransferEligibilityResult	이전 자격 유효성 검사의 결과입니다.

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
details	ErrorSubDetails[]	오류의 하위 세부 정보입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ErrorResponse

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 이유는 오류 메시지에 제공됩니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

ErrorSubDetails

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.
target	string	특정 오류의 대상입니다.

subscriptionTransferValidationErrorCode

제품 전송 유효성 검사에 대한 오류 코드입니다.

Name	형식	Description
BillingAccountInactive	string
CrossBillingAccountNotAllowed	string
DestinationBillingProfileInactive	string
DestinationBillingProfileNotFound	string
DestinationBillingProfilePastDue	string
DestinationInvoiceSectionInactive	string
DestinationInvoiceSectionNotFound	string
InsufficientPermissionOnDestination	string
InsufficientPermissionOnSource	string
InvalidDestination	string
InvalidSource	string
MarketplaceNotEnabledOnDestination	string
NotAvailableForDestinationMarket	string
ProductInactive	string
ProductNotFound	string
ProductTypeNotSupported	string
SourceBillingProfilePastDue	string
SourceInvoiceSectionInactive	string
SubscriptionNotActive	string
SubscriptionTypeNotSupported	string

TransferBillingSubscriptionRequestProperties

청구 구독을 전송하기 위한 요청 매개 변수입니다.

Name	형식	Description
destinationBillingProfileId	string	대상 청구 프로필 ID입니다.
destinationInvoiceSectionId	string	대상 청구서 섹션 ID입니다.

ValidateSubscriptionTransferEligibilityError

이전 자격 유효성 검사의 오류 세부 정보

Name	형식	Description
code	subscriptionTransferValidationErrorCode	제품 전송 유효성 검사에 대한 오류 코드입니다.
details	string	오류를 설명하는 자세한 오류 메시지입니다.
message	string	오류 메시지입니다.

ValidateSubscriptionTransferEligibilityResult

이전 자격 유효성 검사의 결과입니다.

Name	형식	Description
errorDetails	ValidateSubscriptionTransferEligibilityError	유효성 검사 오류 세부 정보입니다.
isTransferEligible	boolean	구독을 이전할 수 있는지 여부를 지정합니다.