Products - Update

제품의 속성을 업데이트합니다. 현재 자동 갱신을 업데이트할 수 있습니다. 이 작업은 계약 유형이 Microsoft 고객 계약 청구 계정에 대해서만 지원됩니다.

PATCH https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products/{productName}?api-version=2020-05-01

URI 매개 변수

Name In Required Type Description
billingAccountName
path True
  • string

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

productName
path True
  • string

제품을 고유하게 식별하는 ID입니다.

api-version
query True
  • string

클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2020-05-01입니다.

요청 본문

Name Type Description
properties.autoRenew

제품에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.

properties.billingFrequency

제품이 청구되는 빈도입니다.

properties.status

제품의 현재 상태입니다.

응답

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 사용자 계정 가장

예제

UpdateBillingProperty

Sample Request

PATCH https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/products/{productName}?api-version=2020-05-01

{
  "properties": {
    "autoRenew": "Off"
  }
}

Sample Response

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/products/{productName}",
  "name": "{productName}",
  "type": "Microsoft.Billing/billingAccounts/products",
  "properties": {
    "autoRenew": "Off",
    "productTypeId": "A12345",
    "productType": "Subscription",
    "displayName": "AIP Dev",
    "status": "Active",
    "purchaseDate": "2018-05-01T17:32:28Z",
    "lastCharge": {
      "currency": "USD",
      "value": 5000
    },
    "lastChargeDate": "2018-06-15T17:32:28Z",
    "billingFrequency": "Monthly",
    "quantity": 4,
    "skuId": "0001",
    "skuDescription": "Enterprise Agreement Development",
    "tenantId": "515a6d36-aaf8-4ca2-a5e8-c45deb0c5cce",
    "availabilityId": "AvailabilityId1",
    "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}",
    "invoiceSectionDisplayName": "Contoso operations invoiceSection",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
    "billingProfileDisplayName": "Contoso operations billing"
  }
}

정의

Amount

금액입니다.

AutoRenew

제품에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.

BillingFrequency

제품이 청구되는 빈도입니다.

ErrorDetails

오류의 세부 정보입니다.

ErrorResponse

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

ErrorSubDetails
Product

제품입니다.

ProductStatusType

제품의 현재 상태입니다.

Reseller

재판매인의 세부 정보입니다.

Amount

금액입니다.

Name Type Description
currency
  • string

금액 값의 통화입니다.

value
  • number

금액 값입니다.

AutoRenew

제품에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.

Name Type Description
Off
  • string
On
  • string

BillingFrequency

제품이 청구되는 빈도입니다.

Name Type Description
Monthly
  • string
OneTime
  • string
UsageBased
  • string

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

특정 오류의 대상입니다.

Product

제품입니다.

Name Type Description
id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.autoRenew

제품에 대해 자동 갱신이 설정되어 있는지 여부를 나타냅니다.

properties.availabilityId
  • string

제품의 가용성입니다.

properties.billingFrequency

제품이 청구되는 빈도입니다.

properties.billingProfileDisplayName
  • string

제품이 청구되는 청구 프로필의 이름입니다.

properties.billingProfileId
  • string

제품이 청구되는 청구 프로필의 ID입니다.

properties.customerDisplayName
  • string

제품을 구매한 고객의 이름입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.

properties.customerId
  • string

제품을 구매한 고객의 ID입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.

properties.displayName
  • string

제품의 표시 이름입니다.

properties.endDate
  • string

제품을 갱신하거나 취소할 날짜입니다.

properties.invoiceSectionDisplayName
  • string

제품 요금이 청구되는 청구서 섹션의 이름입니다.

properties.invoiceSectionId
  • string

제품 요금이 청구되는 청구서 섹션의 ID입니다.

properties.lastCharge

지난 달 요금이 청구됩니다.

properties.lastChargeDate
  • string

마지막 청구 날짜입니다.

properties.productType
  • string

제품 유형에 대한 설명입니다.

properties.productTypeId
  • string

제품 유형의 ID입니다.

properties.purchaseDate
  • string

제품을 구입한 날짜입니다.

properties.quantity
  • number

제품에 대해 구매한 수량입니다.

properties.reseller

이 제품의 재판매인입니다.

properties.skuDescription
  • string

제품에 대한 sku 설명입니다.

properties.skuId
  • string

제품의 sku ID입니다.

properties.status

제품의 현재 상태입니다.

properties.tenantId
  • string

제품이 사용되는 테넌트 ID입니다.

type
  • string

리소스 종류.

ProductStatusType

제품의 현재 상태입니다.

Name Type Description
Active
  • string
AutoRenew
  • string
Cancelled
  • string
Disabled
  • string
Expired
  • string
Expiring
  • string
Inactive
  • string
PastDue
  • string

Reseller

재판매인의 세부 정보입니다.

Name Type Description
description
  • string

재판매인의 이름입니다.

resellerId
  • string

재판매인의 MPN ID입니다.