Analyse des coûts

L'API d'utilisation prend en charge les degrés de finesse suivants : MONTHLY, DAILY et HOURLY. Tous les éléments startTime sont inclusifs et endTime sont exclusifs, comme une sous-chaîne Java.

• Pour HOURLY, la période maximale prise en charge est de 36 heures, avec une précision maximale d'une heure. Ainsi, il n'y a pas de minutes ni de secondes dans l'heure saisie.

• Pour MONTHLY, seule la période comprise entre la première date du mois et une autre première date du mois est prise en charge. Par exemple, 2020-06-01T00:00:00Z, période maximale de 12 mois.

• Pour DAILY, la précision maximale prise en charge est d'une journée, avec une période maximale de 90 jours. Vous devez saisir cette valeur au format 00:00:00. Par exemple, 2020-06-01T00:00:00Z.

Dans une réponse d'API, seules les valeurs de la dimension figurant dans groupBy sont affichées. Par exemple, si "service" n'est pas dans groupBy, le champ "service" de la réponse sera vide.

L'API peut interroger USAGE ou COST. computedQuantity représente l'utilisation et computedAmount représente les coûts. Pour obtenir l'utilisation attendue, vous devez définir queryType sur USAGE ou ajouter "unit" dans groupByKey. En effet, l'utilisation est agrégée/regroupée correctement lorsque vous effectuez un regroupement par unité.

Le filtrage imbriqué dans les demandes d'API est pris en charge. La liste des filtres est évaluée par l'opérateur. Dans chaque filtre, toutes les dimensions et balises sont évaluées par l'opérateur. L'évaluation simultanée de la liste des filtres et des dimensions/balises n'est pas prise en charge, ce qui signifie que les dimensions ou les balises, et la liste des filtres ne peuvent pas être vides simultanément.

Les opérateurs pris en charge sont AND et OR. Ces deux filtres sont égaux :

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

Comme mentionné précédemment, nous n'affichons que le champ dans groupBy. Vous devez donc ajouter des champs liés aux balises dans groupBy. Par exemple :

"tagNamespace", "tagKey", "tagValue"

Si vous ajoutez tagKey, tous les éléments de la réponse auront une balise tagKey. Cette balise peut également être vide même si vous ajoutez une balise tagKey. Cela est dû au fait que certaines de vos ressources n'ont pas de balise tagKey. Nous avons suggéré d'ajouter ces trois éléments dans groupBy afin que vous puissiez voir une balise complète dans la réponse :

"tagNamespace", "tagKey", "tagValue" 

Pour filtrer par balise, vous devez ajouter la balise dans l'objet de filtre. Vous pouvez filtrer par n'importe quelle combinaison tagKey/Namespace/value de n'importe quelle tagKey/Namespace/value.

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

"tenantId" et "tenantName" ne sont actuellement pas pris en charge.

Les clés relatives au compartiment groupBy ("compartmentName", "compartmentPath", "compartmentId") sont différentes des autres clés groupBy.

Pour obtenir un résultat attendu, vous devez faire la demande avec compartmentDepth. compartmentDepth est >=1 et <=6.

Un compartiment groupBy désigne un compartiment avec la profondeur indiquée, où seront agrégés l'utilisation ou les coûts de tous les compartiments ayant une profondeur supérieure. Par exemple :

           Root             1

        B          C        2

    D    E                  3

 F                          4

Si la profondeur est de 1, toutes les utilisations ou tous les coûts sont regroupés dans le compartiment racine.

Si la profondeur est de 2, tous les compartiments de profondeur 2 contiendront l'utilisation ou les coûts avec tous les enfants. Dans la réponse, la racine contiendra sa propre utilisation, B effectuera une agrégation (B, D, E, F) et C contiendra C.

Les champs s'affichent uniquement lorsqu'ils sont dans groupBy. Certains champs de réponse ne sont actuellement pas disponibles. Seuls les champs mentionnés dans Exemple de groupBy valide sont pris en charge.

Cette valeur peut être définie comme NULL. Non pris en charge actuellement.

La meilleure façon de comprendre le fonctionnement de l'API est de vérifier comment la console l'utilise. Vous pouvez trouver le corps de demande dans le mode débogage du navigateur 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
}

Une fois que vous avez fait une demande sans filtre, vous pouvez voir la valeur de la dimension/balise. Par la suite, vous pouvez effectuer une demande avec un filtre et une valeur de dimension correcte.

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

Si vous écrivez un script personnalisé, Oracle ne le prend pas en charge ou ne vous aide pas à le déboguer. Seuls l'interface de ligne de commande, le kit SDK et Terraform sont pris en charge. Pour plus d'informations, reportez-vous à Interface de ligne de commande (CLI). Par exemple :

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