Analisi costi

L'API di utilizzo supporta la granularità MONTLY, DAILY e HOURLY. Tutti i valori startTime sono inclusi e endTime sono esclusivi, come una sottostringa Java.

• Per HOURLY è supportato solo un periodo di tempo massimo di 36 ore, con una precisione non superiore a un'ora. Ciò significa che non ci sono minuti o secondi nel tempo di input.

• Per MENSILE è supportata solo la prima data del mese fino a un'altra prima data del mese. Ad esempio, 2020-06-01T00:00:00Z, un periodo massimo di 12 mesi.

• Per DAILY è supportata una precisione massima di un giorno, con un periodo massimo di 90 giorni. Inserire questo valore come 00:00:00. Ad esempio, 2020-06-01T00:00:00Z.

In una risposta API, la dimensione viene visualizzata solo in termini di groupBy. Ad esempio, se "service" non si trova in groupBy, il campo "service" nella risposta sarà vuoto.

L'API può eseguire una query su USAGE o COST. computedQuantity rappresenta l'uso e computedAmount rappresenta il costo. Per ottenere l'uso previsto, è necessario impostare queryType su USAGE o aggiungere "unit" in groupByKey. Ciò è dovuto al fatto che l'uso viene aggregato/raggruppato correttamente durante il raggruppamento per unità.

Il filtro nidificato nelle richieste API è supportato. L'elenco dei filtri viene valutato dall'operatore. In ogni filtro, tutte le dimensioni e i tag vengono valutati dall'operatore. La valutazione simultanea dell'elenco di filtri e delle dimensioni/tag non è supportata. Ciò significa che le dimensioni o i tag e l'elenco di filtri non possono essere contemporaneamente non vuoti.

Gli operatori supportati sono AND, OR. Questi due filtri qui sotto sono uguali:

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

Come accennato in precedenza, mostriamo il campo solo in groupBy. È pertanto necessario aggiungere campi correlati ai tag in groupBy. Ad esempio:

"tagNamespace", "tagKey", "tagValue"

Se si aggiunge tagKey, tutti gli elementi nella risposta avranno un tagKey. Anche tagKey può essere vuoto anche se si aggiunge un tagKey. Questo perché alcune risorse non dispongono di un tagKey. Abbiamo suggerito di aggiungere tutti e tre questi in groupBy, in modo da poter vedere un tag completo nella risposta:

"tagNamespace", "tagKey", "tagValue" 

Se si desidera filtrare per tag, è necessario aggiungere la tag nell'oggetto filtro. Questo può essere filtrato da qualsiasi combinazione tagKey/Namespace/value di qualsiasi tagKey/Namespace/value.

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

"tenantId" e "tenantName" non sono attualmente supportati.

Le chiavi correlate al compartimento groupBy ("compartmentName", "compartmentPath", "compartmentId") sono diverse dalle altre chiavi groupBy.

Per ottenere un risultato previsto, è necessario effettuare una richiesta con compartmentDepth. compartmentDepth è >=1 e <=6.

Il compartimento groupBy indica che tutti gli usi o i costi dei compartimenti con una profondità maggiore verranno aggregati al compartimento con la profondità specificata. Ad esempio:

           Root             1

        B          C        2

    D    E                  3

 F                          4

Se la profondità è 1, significa che tutti gli usi o i costi vengono raggruppati nel compartimento radice.

Se la profondità è 2, significa che tutti i compartimenti con profondità 2 conterranno l'utilizzo o i costi con tutti i suoi figli. Nella risposta, la radice conterrà il proprio utilizzo, B aggregerà (B, D, E, F) e C conterrà C.

I campi verranno visualizzati solo quando si trovano in groupBy. Non tutti i campi della risposta sono attualmente disponibili. Sono supportati solo i campi menzionati nell'esempio groupBy valido.

Può essere impostato come nullo. Attualmente non supportato.

Il modo migliore per capire come funziona l'API è controllare come la console utilizza l'API. È possibile trovare il corpo della richiesta nella modalità di debug del browser Web.

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

Dopo aver effettuato una richiesta senza alcun filtro, è possibile visualizzare il valore della dimensione o dei tag. In modo secondario, è possibile effettuare una richiesta con un filtro e un valore di dimensione corretto.

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

Se si scrive uno script personalizzato, Oracle non supporta o supporta il debug dello script. Sono supportati solo l'interfaccia CLI, l'SDK e Terraform. Per ulteriori informazioni, vedere interfaccia CLI (Command Line Interface). Ad esempio:

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