Migrace z rozhraní API podrobností o využití rezervovaných instancí EA

Zákazníci EA, kteří dříve používali rozhraní API consumption.azure.com služby Enterprise Reporting k získání podrobností o využití rezervovaných instancí, musí migrovat na paritu rozhraní API Azure Resource Manageru. Následující pokyny vám pomůžou migrovat a probrat všechny rozdíly mezi starým rozhraním API a novým rozhraním API.

Přiřazení oprávnění instančnímu objektu pro volání rozhraní API

Před voláním rozhraní API je potřeba nakonfigurovat instanční objekt se správným oprávněním. Instanční objekt použijete k volání rozhraní API. Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby Cost Management.

Volání rozhraní API podrobností o využití rezervovaných instancí

Microsoft neaktualizuje starší synchronní rozhraní API podrobnosti rezervace. V rámci migrace doporučujeme přejít na novější vzor asynchronního volání rozhraní API s podporou pro hlavní název služby (SPN). Asynchronní požadavky lépe zpracovávají velké objemy dat a zkracují chyby časového limitu.

Podporované požadavky

Při volání nového asynchronního rozhraní API Podrobnosti rezervace použijte následující identifikátory URI požadavků. Jako billingAccountId by se mělo použít vaše registrační číslo. Rozhraní API můžete volat s následujícím oborem:

Registrace: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Generování sestavy podle ID fakturačního účtu

Ukázkový požadavek pro generování sestav podrobností rezervace

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

Požadavek POST vrátí umístění pro dotazování stavu generování sestavy, jak je uvedeno v následující odpovědi:

Ukázková odpověď

Stavový kód 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Stavový kód 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Ukázkový požadavek pro dotaz na stav generování sestav

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01 

Ukázková odpověď dotazu

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Změny textu odpovědi

Následující informace jsou příkladem odpovědi staršího synchronního rozhraní API podrobnosti rezervace.

Původní odpověď:

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nová odpověď:

Nové rozhraní API vytvoří soubor CSV. Projděte si následující pole v souboru.

Související obsah

• Přečtěte si článek s přehledem migrace z generování sestav EA na rozhraní API ARM.