Análise de Custos

A API de Uso suporta granularidade MONTHLY, DAILY e HOURLY. Todos os startTime são inclusivos e endTime são exclusivos, o mesmo que uma substring do Java.

• Para HOURLY, só há suporte para um período máximo de 36 horas, com não mais precisão do que uma hora. Isso significa que não há minutos ou segundos no tempo de entrada.

• Para MONTHLY, só há suporte à primeira data do mês para outra primeira data do mês. Por exemplo, 2020-06-01T00:00:00Z, um período máximo de 12 meses.

• Para DAILY, não há suporte para mais precisão do que um dia, com um período máximo de 90 dias. Você deve inserir isso como 00:00:00. Por exemplo, 2020-06-01T00:00:00Z.

Em uma resposta de API, a dimensão só é mostrada em termos de groupBy. Por exemplo, se "service" não estiver em groupBy, o campo "service" na resposta ficará vazio.

A API pode consultar USAGE ou COST. computedQuantity representa o uso e computedAmount representa o custo. Para obter o uso esperado, defina queryType como USAGE ou adicione "unit" em groupByKey. Isso se deve ao fato de que o uso é agregado/agrupado corretamente ao agrupar por unidade.

Existe suporte para a filtragem aninhada em solicitações de API. A lista de filtros é avaliada pelo operador. Em cada filtro, todas as dimensões e tags são avaliadas pelo operador. Não há suporte para a avaliação simultânea da lista de filtros e dimensão/tags, que significa que dimensões ou tags e a lista de filtros não podem ficar não-vazias ao mesmo tempo.

Os operadores suportados são AND e OR. Esses dois filtros a seguir são iguais:

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

Conforme mencionado anteriormente, só mostramos o campo em groupBy. Portanto, você precisa adicionar campos relacionados à tag em groupBy. Por exemplo:

"tagNamespace", "tagKey", "tagValue"

Se você adicionar tagKey, todos os itens da resposta terão um tagKey. tagKey também pode ficar vazio mesmo que você adicione um tagKey. Isso ocorre porque alguns de seus recursos não têm um tagKey. Sugerimos adicionar todos os três em groupBy, para que você possa ver uma tag completa na resposta:

"tagNamespace", "tagKey", "tagValue" 

Se quiser filtrar por tag, será necessário adicionar a tag ao objeto de filtro. Isso pode ser filtrado por qualquer combinação tagKey/Namespace/value de qualquer tagKey/Namespace/value.

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

No momento não há suporte para "tenantId" e "tenantName".

As chaves relacionadas ao compartimento groupBy ("compartmentName", "compartmentPath", "compartmentId") são diferentes das outras chaves groupBy.

Para obter um resultado esperado, você deve solicitar com compartmentDepth. compartmentDepth é >=1 e <=6.

Compartimento groupBy significa que todo o uso de compartimentos ou custos com maior profundidade serão agregados ao compartimento com a profundidade especificada. Por exemplo:

           Root             1

        B          C        2

    D    E                  3

 F                          4

Se a profundidade for 1, significa que todo o uso ou custos serão agrupados no compartimento raiz.

Se a profundidade for 2, significa que todos os compartimentos com profundidade 2 conterão o uso ou os custos com todos os seus filhos. Na resposta, a raiz conterá seu próprio uso, B agregará (B, D, E, F) e C conterá C.

Os campos aparecerão somente quando os campos estiverem em groupBy. Nem todos os campos da resposta estão disponíveis no momento. Só há suporte para os campos mencionados no Exemplo válido de groupBy.

Isso pode ser definido como nulo. No momento, não há suporte para ele.

A melhor maneira de entender como a API funciona é verificar como a Console usa a API. Você pode localizar o corpo da solicitação no modo de depuração do Web browser.

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

Depois de fazer uma solicitação sem qualquer filtro, você poderá ver qual pode ser o valor da dimensão/tags. Posteriormente, você pode fazer uma solicitação com um filtro e um valor de dimensão correto.

{
  "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 você gravar um script personalizado, a Oracle não dará suporte nem ajudará na depuração do script. Só há suporte para CLI, SDK e Terraform. Consulte Interface de Linha de Comando (CLI) para obter mais informações. Por exemplo:

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