Billing Subscriptions - Validate Transfer

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

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

URI 매개 변수

Name In Required Type Description
billingAccountName
path True
  • string

청구 계정을 고유하게 식별하는 ID입니다.

billingProfileName
path True
  • string

청구 프로필을 고유하게 식별하는 ID입니다.

billingSubscriptionName
path True
  • string

구독을 고유하게 식별하는 ID입니다.

invoiceSectionName
path True
  • string

청구서 섹션을 고유하게 식별하는 ID입니다.

요청 본문

Name Type Description
destinationBillingProfileId
  • string

대상 청구 프로필 ID입니다.

destinationInvoiceSectionId
  • string

대상 청구서 섹션 ID입니다.

응답

Name Type Description
200 OK

OK. 요청이 성공했습니다.

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

SubscriptionTransferValidateFailure
SubscriptionTransferValidateSuccess

SubscriptionTransferValidateFailure

Sample Request

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

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

SubscriptionTransferValidateSuccess

Sample Request

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

{
  "isTransferEligible": true
}

정의

ErrorDetails

오류의 세부 정보입니다.

ErrorResponse

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

ErrorSubDetails
subscriptionTransferValidationErrorCode

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

TransferBillingSubscriptionRequestProperties

청구 구독을 전송하는 매개 변수를 요청합니다.

ValidateSubscriptionTransferEligibilityError

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

ValidateSubscriptionTransferEligibilityResult

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

ErrorDetails

오류의 세부 정보입니다.

Name Type Description
code
  • string

오류 코드

details

오류의 하위 세부 정보입니다.

message
  • string

작업이 실패한 이유를 나타내는 오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

ErrorResponse

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

Name Type Description
error

오류의 세부 정보입니다.

ErrorSubDetails

Name Type Description
code
  • string

오류 코드

message
  • string

작업이 실패한 이유를 나타내는 오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

subscriptionTransferValidationErrorCode

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

Name Type 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 Type Description
destinationBillingProfileId
  • string

대상 청구 프로필 ID입니다.

destinationInvoiceSectionId
  • string

대상 청구서 섹션 ID입니다.

ValidateSubscriptionTransferEligibilityError

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

Name Type Description
code

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

details
  • string

오류를 설명하는 자세한 오류 메시지입니다.

message
  • string

오류 메시지입니다.

ValidateSubscriptionTransferEligibilityResult

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

Name Type Description
errorDetails

유효성 검사 오류 세부 정보입니다.

isTransferEligible
  • boolean

구독을 양도할 수 있는지 여부를 지정합니다.