Kostenanalyse

Die API für Nutzung unterstützt die Granularität MONTHLY, DAILY und HOURLY. Alle startTime-Werte werden einbezogen und endTime-Werte werden ausgeschlossen, genau wie bei einer Java-Teilzeichenfolge.

• Für HOURLY wird nur ein Zeitraum von maximal 36 Stunden mit einer Genauigkeit von höchstens einer Stunde unterstützt. Das heißt, es werden keine Minuten oder Sekunden in der Eingabezeit unterstützt.

• Für MONTHLY werden nur Zeiträume von einem Monatsersten bis zu einem anderen Monatsersten unterstützt. Beispiel: 2020-06-01T00:00:00Z, ein maximaler 12-Monats-Zeitraum.

• Für DAILY wird eine maximale Genauigkeit von einem Tag über einen Zeitraum von maximal 90 Tagen unterstützt. Sie müssen dies als 00:00:00 eingeben. Beispiel: 2020-06-01T00:00:00Z.

In einer API-Antwort wird die Dimension nur in Bezug auf groupBy angezeigt. Beispiel: Wenn "service" nicht in groupBy enthalten ist, ist das Feld "service" in der Antwort leer.

Die API kann USAGE oder COST abfragen. computedQuantity stellt die Nutzung dar und computedAmount die Kosten. Um die erwartete Nutzung abzurufen, müssen Sie queryType auf USAGE setzen oder "unit" zu groupByKey hinzufügen. Dies liegt daran, dass die Nutzung bei der Gruppierung nach Einheit korrekt aggregiert/gruppiert wird.

Verschachtelte Filterung in API-Anforderungen wird unterstützt. Die Liste der Filter wird vom Operator ausgewertet. In jedem Filter werden alle Dimensionen und Tags vom Operator ausgewertet. Die gleichzeitige Auswertung der Filterliste und der Dimension/Tags wird nicht unterstützt. Das heißt, dass Dimensionen bzw. Tags und die Filterliste nicht gleichzeitig Werte aufweisen dürfen.

Unterstützte Operatoren sind AND, OR. Die beiden nachfolgenden Filter sind identisch:

"filter": {
  "operator": "AND",
  "dimensions": [
    {
      "key": "service",
      "value": "compute"
    },
    {
      "key": "compartmentPath",
      "value": "abc/cde"
    }
  ],
  "tags": [
    {
      "namespace": "compute",
      "key": "created",
      "value": "string"
    }
  ],
  "filters": null
}
  
or 
 
"filter": {
    "operator": "AND",
    "dimensions": [],
    "tags": [],
    "filters": [{
            "operator": "AND",
            "dimensions": [{
                "key": "service",
                "value": "compute"
            }],
            "tags": null,
            "filters": null
        }, {
            "operator": "AND",
            "dimensions": [{
                "key": "compartmentPath",
                "value": "abc/cde"
            }],
            "tags": null,
            "filters": null
        },
        {
            "operator": "AND",
            "dimensions": null,
            "tags": [{
                "namespace": "compute",
                "key": "created",
                "value": "string"
            }],
            "filters": null
        }
    ]
}

"filter": {
    "operator": "AND",
    "dimensions": [{
                "key": "compartmentPath",
                "value": "abc/cde"
            }],
    "tags": [],
    "filters": [{
            "operator": "AND",
            "dimensions": [{
                "key": "service",
                "value": "compute"
            }],
            "tags": null,
            "filters": null
        },
        {
            "operator": "AND",
            "dimensions": null,
            "tags": [{
                "namespace": "compute",
                "key": "created",
                "value": "string"
            }],
            "filters": null
        }
    ]
}

Wie bereits erwähnt, wird das Feld nur in groupBy angezeigt. Sie müssen also tagbezogene Felder in groupBy hinzufügen. Beispiel:

"tagNamespace", "tagKey", "tagValue"

Wenn Sie per tagKey einen Tagschlüssel hinzufügen, enthalten alle Elemente in der Antwort einen tagKey. tagKey kann auch leer sein, obwohl Sie einen tagKey hinzufügen. Dies liegt daran, dass einige Ihrer Ressourcen keinen tagKey enthalten. Oben wurde empfohlen, alle drei in groupBy hinzuzufügen, damit in der Antwort ein vollständiges Tag angezeigt wird:

"tagNamespace", "tagKey", "tagValue" 

Wenn Sie nach Tag filtern möchten, müssen Sie das Tag im Filterobjekt hinzufügen. Dies kann nach einer beliebigen Kombination aus tagKey/tagNamespace/tagValue für beliebige tagKey/tagNamespace/tagValue-Werte gefiltert werden.

"tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit",
"compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd",
"resourceId", "tenantId", "tenantName"

"tenantId" und "tenantName" werden derzeit nicht unterstützt.

Compartment-bezogene groupBy-Schlüssel ("compartmentName", "compartmentPath", "compartmentId") unterscheiden sich von den anderen groupBy-Schlüsseln.

Um ein erwartetes Ergebnis zu erhalten, müssen Sie compartmentDepth in die Anforderung aufnehmen. compartmentDepth ist >=1 und <=6.

Wenn Sie mit groupBy nach Compartment gruppieren, bedeutet dies, dass Compartment-Nutzung oder -Kosten mit einer höheren Tiefe vollständig in das Compartment mit der angegebenen Tiefe aggregiert werden. Beispiel:

           Root             1

        B          C        2

    D    E                  3

 F                          4

Eine Tiefe von 1 bedeutet, dass Nutzung oder Kosten vollständig in das Root Compartment gruppiert werden.

Eine Tiefe von 2 bedeutet, dass alle Compartments mit Tiefe 2 die Nutzung oder Kosten aller untergeordneten Compartments enthalten. In der Antwort enthält die Root ihre eigene Nutzung, B aggregiert (B, D, E, F) und C enthält C.

Die Felder werden nur angezeigt, wenn sich die Felder in groupBy befinden. Es sind derzeit nicht alle Felder in der Antwort verfügbar. Es werden nur die Felder unterstützt, die unter Gültiges groupBy-Beispiel aufgeführt sind.

Dies kann als Nullwert festgelegt werden. Wird derzeit nicht unterstützt.

Die beste Methode, um die Funktionsweise der API zu verstehen, besteht darin zu prüfen, wie die Konsole die API verwendet. Sie finden den Anforderungsbody im Debug-Modus des Webbrowsers.

{
  "tenantId": "ocid1.tenancy.oc1..<unique_ID>",
  "timeUsageStarted": "2020-04-01T00:00:00.000Z",
  "timeUsageEnded": "2020-07-01T00:00:00.000Z",
  "granularity": "MONTHLY",
  "queryType": "COST",
  "groupBy": [
    "tagNamespace",
    "tagKey",
    "tagValue",
    "service",
    "compartmentPath"
  ],
  "compartmentDepth": 2,
  "filter": null
}

Nachdem Sie eine Anforderung ohne Filter gestellt haben, können Sie sehen, wie der Wert der Dimension/Tags aussieht. Anschließend können Sie eine Anforderung mit einem Filter und einem korrekten Dimensionswert stellen.

{
  "tenantId": "ocid1.tenancy.oc1..<unique_ID>",
  "timeUsageStarted": "2020-04-01T00:00:00.000Z",
  "timeUsageEnded": "2020-07-01T00:00:00.000Z",
  "granularity": "MONTHLY",
  "groupBy": ["tagNamespace","tagKey","tagValue", "service", "compartmentPath"],
  "compartmentDepth": 2,
  "filter": {
    "operator": "AND",
    "dimensions": [],
    "tags": [],
    "filters": [{
      "operator": "AND",
      "dimensions": [{
        "key": "service",
        "value": "compute"
      }],
      "tags": null,
      "filters": null
    }, {
      "operator": "AND",
      "dimensions": [{
        "key": "compartmentPath",
        "value": "abc/cde"
      }],
      "tags": null,
      "filters": null
    },
      {
        "operator": "AND",
        "dimensions": null,
        "tags": [{
          "namespace": "compute",
          "key": "created",
          "value": "string"
        }],
        "filters": null
      }
    ]
  }
}

Wenn Sie ein benutzerdefiniertes Skript schreiben, bietet Ihnen Oracle keinerlei Unterstützung oder Hilfe für das Debugging Ihres Skripts. Nur CLI, SDK und Terraform werden unterstützt. Weitere Informationen finden Sie unter Befehlszeilenschnittstelle (CLI). Beispiel:

oci raw-request --http-method POST --target-uri https://usageapi.us-ashburn-1.oci.oraclecloud.com/20200107/usage 
--request-body file:///<system_path>SimpleRequestSummarizedUsagesDetails.json 
--config-file ~/Downloads/clitest.conf

{
  "tenantId": "ocid1.tenancy.oc1..<unique_ID>",
  "timeUsageStarted": "2020-03-19T17:00:00.000000-07:00",
  "timeUsageEnded": "2020-03-21T00:00:00Z",
  "granularity": "DAILY",
  "groupBy": [],
  "compartmentDepth": null,
  "filter": null,
  "nextPageToken": "string"
}

[DEFAULT]
user=ocid1.user.oc1..<unique_ID>
fingerprint=<MAC_ID>
key_file=<system_path>/oci_api_key.pem
#tenancy=ocid1.tenancy.oc1..<unique_ID>
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-ashburn-1