Analyse des coûts

L'API d'utilisation prend en charge les granularités MENSUELLE, QUOTIDIENNE et HORAIRE. Tous les paramètres startTime sont inclusifs et endTime exclusifs, comme une sous-chaîne Java.

• Pour la granularité HORAIRE, seule une période maximale de 36 heures est prise en charge, avec une précision d'une heure. Cela signifie de ne pas indiquer de minutes ou de secondes dans le temps entré.

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

• Pour la granularité QUOTIDIENNE, la précision est le jour et la période maximale est de 90 jours. Vous devez entrer cette valeur comme suit : 00:00:00. Par exemple, 2020-06-01T00:00:00Z.

Dans une réponse de l'API, la dimension est affichée uniquement en fonction du paramètre groupBy. Par exemple, si "service" n'est pas indiqué dans groupBy, le champ "service" de la réponse sera vide.

L'API peut effectuer une interrogation de type USAGE ou COST. computedQuantity représente l'utilisation et computedAmount représente le coût. Pour obtenir l'utilisation attendue, vous devez définir la valeur de queryType à USAGE ou ajouter "unit" dans groupByKey. Cela est dû au fait que l'utilisation est agrégée/regroupée correctement lors du regroupement par unité.

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

Les opérateurs pris en charge sont AND et OR. Les deux filtres ci-dessous sont équivalents :

"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 il est mentionné plus haut, nous affichons uniquement le champ dans groupBy. Vous devez donc ajouter les champs liés aux marqueurs dans groupBy. Par exemple :

"tagNamespace", "tagKey", "tagValue"

Si vous ajoutez tagKey, tous les éléments de la réponse auront une clé tagKey. tagKey peut également être vide même si vous ajoutez une clé tagKey. En effet, certaines de vos ressources n'ont pas de clé tagKey. Nous suggérons d'ajouter ces trois éléments dans groupBy, afin que vous puissiez voir le marqueur complet dans la réponse :

"tagNamespace", "tagKey", "tagValue" 

Si vous souhaitez filtrer par marqueur, vous devez ajouter le marqueur dans l'objet de filtre. Pour ce filtrage, vous pouvez utiliser n'importe quelle combinaison tagKey/espace de nom/valeur des éléments tagKey, espace de nom et valeur.

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

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

Les clés groupBy associées au regroupement par compartiment ("compartimentName", "compartimentPath", "compartimentId") sont différentes des autres clés groupBy.

Pour obtenir un résultat attendu, vous devez soumettre une demande où compartimentDepth. compartmentDepth est >=1 et <=6.

Le regroupement groupBy par compartiment signifie que l'utilisation ou les coûts de tous les compartiments ayant une profondeur supérieure seront regroupés avec ceux du compartiment ayant la profondeur donnée. Par exemple :

           Root             1

        B          C        2

    D    E                  3

 F                          4

Si la profondeur est 1, cela signifie que tous les coûts ou utilisations sont regroupés avec ceux du compartiment racine.

Si la profondeur est 2, cela signifie que tous les compartiments ayant une profondeur 2 regroupent l'utilisation ou les coûts de tous leurs enfants. Dans la réponse, la racine contiendra sa propre utilisation, B regroupera B, D, E, F et C contiendra C.

Les champs ne s'affichent que lorsqu'ils figurent dans groupBy. Tous les champs ne sont pas disponibles actuellement dans la réponse. Seuls les champs mentionnés dans l'exemple groupBy valide sont pris en charge.

Cet élément peut être réglé à la valeur null. Actuellement non pris en charge.

La meilleure façon de comprendre comment l'API fonctionne est de vérifier comment la console l'utilise. Vous pouvez voir le corps de la demande en 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
}

Après avoir soumis une demande sans filtre, vous pouvez voir quelle peut être la valeur des dimensions et des marqueurs. Ensuite, vous pouvez soumettre 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 n'offre aucun soutien ni assistance pour déboguer votre script. Seuls l'interface CLI, la trousse SDK et Terraform sont pris en charge. Pour plus d'informations, voir Interface de ligne de commande. 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