Products - Update

Aktualisiert die Eigenschaften eines Produkts. Derzeit kann die automatische Verlängerung aktualisiert werden. Der Vorgang wird nur für Abrechnungskonten mit vertragstyp Microsoft-Kundenvereinbarung unterstützt.

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

URI-Parameter

Name In Required Type Description
billingAccountName
path True
  • string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

productName
path True
  • string

Die ID, die ein Produkt eindeutig identifiziert.

api-version
query True
  • string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2020-05-01.

Anforderungstext

Name Type Description
properties.autoRenew

Gibt an, ob die automatische Verlängerung für ein Produkt aktiviert oder deaktiviert ist.

properties.billingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

properties.status

Der aktuelle Status des Produkts.

Antworten

Name Type Description
200 OK

OK. Die Anforderung ist erfolgreich.

Other Status Codes

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

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 Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

Amount

Der Betrag.

AutoRenew

Gibt an, ob die automatische Verlängerung für ein Produkt aktiviert oder deaktiviert ist.

BillingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

ErrorSubDetails
Product

Ein Produkt.

ProductStatusType

Der aktuelle Status des Produkts.

Reseller

Details des Händlers.

Amount

Der Betrag.

Name Type Description
currency
  • string

Die Währung für den Betragswert.

value
  • number

Betragswert.

AutoRenew

Gibt an, ob die automatische Verlängerung für ein Produkt aktiviert oder deaktiviert ist.

Name Type Description
Off
  • string
On
  • string

BillingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

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

ErrorDetails

Die Details des Fehlers.

Name Type Description
code
  • string

Fehlercode

details

Die Unterdetails des Fehlers.

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name Type Description
error

Die Details des Fehlers.

ErrorSubDetails

Name Type Description
code
  • string

Fehlercode

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

Product

Ein Produkt.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.autoRenew

Gibt an, ob die automatische Verlängerung für ein Produkt aktiviert oder deaktiviert ist.

properties.availabilityId
  • string

Die Verfügbarkeit des Produkts.

properties.billingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

properties.billingProfileDisplayName
  • string

Der Name des Abrechnungsprofils, dem das Produkt in Rechnung gestellt wird.

properties.billingProfileId
  • string

Die ID des Abrechnungsprofils, dem das Produkt in Rechnung gestellt wird.

properties.customerDisplayName
  • string

Der Name des Kunden, für den das Produkt gekauft wurde. Das Feld gilt nur für Microsoft Partner-Vereinbarung Abrechnungskonto.

properties.customerId
  • string

Die ID des Kunden, für den das Produkt gekauft wurde. Das Feld gilt nur für Microsoft Partner-Vereinbarung Abrechnungskonto.

properties.displayName
  • string

Der Anzeigename des Produkts.

properties.endDate
  • string

Das Datum, an dem das Produkt verlängert oder abgebrochen wird.

properties.invoiceSectionDisplayName
  • string

Der Name des Rechnungsabschnitts, dem das Produkt in Rechnung gestellt wird.

properties.invoiceSectionId
  • string

Die ID des Rechnungsabschnitts, dem das Produkt in Rechnung gestellt wird.

properties.lastCharge

Die Gebühren für den letzten Monat.

properties.lastChargeDate
  • string

Das Datum der letzten Gebühr.

properties.productType
  • string

Die Beschreibung des Produkttyps.

properties.productTypeId
  • string

Die ID des Produkttyps.

properties.purchaseDate
  • string

Das Datum, an dem das Produkt gekauft wurde.

properties.quantity
  • number

Die Menge, die für das Produkt erworben wurde.

properties.reseller

Händler für dieses Produkt.

properties.skuDescription
  • string

Die Sku-Beschreibung des Produkts.

properties.skuId
  • string

Die Sku-ID des Produkts.

properties.status

Der aktuelle Status des Produkts.

properties.tenantId
  • string

Die ID des Mandanten, in dem das Produkt verwendet wird.

type
  • string

Der Ressourcentyp.

ProductStatusType

Der aktuelle Status des Produkts.

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

Reseller

Details des Händlers.

Name Type Description
description
  • string

Der Name des Händlers.

resellerId
  • string

Die MPN-ID des Händlers.