Products - Update

Aggiorna le proprietà di un prodotto. Attualmente è possibile aggiornare il rinnovo automatico. L'operazione è supportata solo per gli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

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

Parametri dell'URI

Name In Required Type Description
billingAccountName
path True
  • string

ID che identifica in modo univoco un account di fatturazione.

productName
path True
  • string

ID che identifica in modo univoco un prodotto.

api-version
query True
  • string

Versione dell'API da usare con la richiesta client. La versione corrente è 2020-05-01.

Corpo della richiesta

Name Type Description
properties.autoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

properties.billingFrequency

Frequenza con cui verrà fatturato il prodotto.

properties.status

Stato corrente del prodotto.

Risposte

Name Type Description
200 OK

OK. La richiesta ha avuto esito positivo.

Other Status Codes

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2.

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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"
  }
}

Definizioni

Amount

Importo.

AutoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

BillingFrequency

Frequenza con cui verrà fatturato il prodotto.

ErrorDetails

Dettagli dell'errore.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

ErrorSubDetails
Product

Un prodotto.

ProductStatusType

Stato corrente del prodotto.

Reseller

Dettagli del rivenditore.

Amount

Importo.

Name Type Description
currency
  • string

Valuta per il valore dell'importo.

value
  • number

Valore di importo.

AutoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

Name Type Description
Off
  • string
On
  • string

BillingFrequency

Frequenza con cui verrà fatturato il prodotto.

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

ErrorDetails

Dettagli dell'errore.

Name Type Description
code
  • string

Codice di errore.

details

Dettagli secondari dell'errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Name Type Description
error

Dettagli dell'errore.

ErrorSubDetails

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

Product

Un prodotto.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.autoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

properties.availabilityId
  • string

Disponibilità del prodotto.

properties.billingFrequency

Frequenza con cui verrà fatturato il prodotto.

properties.billingProfileDisplayName
  • string

Nome del profilo di fatturazione a cui viene fatturato il prodotto.

properties.billingProfileId
  • string

ID del profilo di fatturazione a cui viene fatturato il prodotto.

properties.customerDisplayName
  • string

Nome del cliente per il quale è stato acquistato il prodotto. Il campo è applicabile solo per Contratto Microsoft Partner account di fatturazione.

properties.customerId
  • string

ID del cliente per il quale è stato acquistato il prodotto. Il campo è applicabile solo per Contratto Microsoft Partner account di fatturazione.

properties.displayName
  • string

Nome visualizzato del prodotto.

properties.endDate
  • string

Data in cui il prodotto verrà rinnovato o annullato.

properties.invoiceSectionDisplayName
  • string

Nome della sezione della fattura a cui viene fatturato il prodotto.

properties.invoiceSectionId
  • string

ID della sezione della fattura a cui viene fatturato il prodotto.

properties.lastCharge

Addebiti per l'ultimo mese.

properties.lastChargeDate
  • string

Data dell'ultimo addebito.

properties.productType
  • string

Descrizione del tipo di prodotto.

properties.productTypeId
  • string

ID del tipo di prodotto.

properties.purchaseDate
  • string

Data di acquisto del prodotto.

properties.quantity
  • number

Quantità acquistata per il prodotto.

properties.reseller

Rivenditore per questo prodotto.

properties.skuDescription
  • string

Descrizione sku del prodotto.

properties.skuId
  • string

ID SKU del prodotto.

properties.status

Stato corrente del prodotto.

properties.tenantId
  • string

ID del tenant in cui viene usato il prodotto.

type
  • string

Tipo di risorsa.

ProductStatusType

Stato corrente del prodotto.

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

Reseller

Dettagli del rivenditore.

Name Type Description
description
  • string

Nome del rivenditore.

resellerId
  • string

ID MPN del rivenditore.