Visión general del análisis de costos

La API de uso soporta: granularidad mensual, diaria y por horas (MONTHLY, DAILY y HOURLY, respectivamente). Todos los tiempos de inicio (startTime) son inclusivos y los tiempos de finalización (endTime) son excluyentes, al igual que con una subcadena de Java.

• Para HOURLY, solo se soporta un período máximo de 36 horas, sin mayor precisión que una hora. Esto significa que no hay minutos ni segundos en el tiempo de entrada.

• Para MONTHLY, solo se admite de la primera fecha del mes a otra primera fecha del mes. Por ejemplo, 2020-06-01T00:00:00Z, un período máximo de 12 meses.

• Para DAILY, no se soporta mayor precisión que un día, con un período máximo de 90 días. Debe introducirlo con el formato 00:00:00. Por ejemplo, 2020-06-01T00:00:00Z.

En una respuesta de API, la dimensión solo se muestra en términos de groupBy. Por ejemplo, si "service" no está en groupBy, el campo "service" de la respuesta estará vacío.

La API puede consultar el uso (USAGE) o el costo (COST). computedQuantity representa el uso y computedAmount representa el costo. Para obtener el uso esperado, debe definir queryType en USAGE o agregar "unit" en groupByKey. Esto se debe al hecho de que el uso se agrega/agrupa correctamente cuando se agrupa por unidad.

En las solicitudes de API, está soportado el filtrado anidado. El operador es quien evalúa la lista de filtros. En cada filtro, el operador también evalúa todas las dimensiones y etiquetas. La evaluación simultánea de la lista de filtros y la dimensión/las etiquetas no está soportada, lo que significa que las dimensiones o etiquetas y la lista de filtros no pueden no estar vacías al mismo tiempo.

Los operadores soportados son AND, OR. Los dos filtros que aparecen a continuación son iguales:

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

Como se mencionó anteriormente, solo mostramos el campo en groupBy. Por lo tanto, debe agregar campos relacionados con las etiquetas en groupBy. Por ejemplo:

"tagNamespace", "tagKey", "tagValue"

Si agrega tagKey, todos los elementos de la respuesta tendrán una tagKey (clave de etiqueta). tagKey también puede estar vacía incluso si agrega una tagKey. Esto se debe a que algunos de los recursos no tienen tagKey. Sugerimos agregar estos tres campos en groupBy para que pueda ver una etiqueta completa en la respuesta:

"tagNamespace", "tagKey", "tagValue" 

Si desea filtrar por etiqueta, debe agregar la etiqueta al objeto de filtrado. Se puede filtrar por cualquier combinación de clave de etiqueta/espacio de nombres/valor de cualquier clave de etiqueta/espacio de nombres/valor.

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

"tenantId" y "tenantName" no están soportados actualmente.

Las claves relacionadas con los compartimentos de groupBy ("compartmentName", "compartmentPath", "compartmentId") son diferentes al resto de claves de groupBy.

Para obtener un resultado esperado, debe realizar una solicitud con compartmentDepth. compartmentDepth es >=1 y <=6.

Agrupar por (groupBy) compartimento significa que el uso o los costos de todos los compartimentos con una profundidad mayor se agregarán al compartimento con la profundidad especificada. Por ejemplo:

           Root             1

        B          C        2

    D    E                  3

 F                          4

Si la profundidad es 1, significa que todos los costos o el uso se agrupan en el compartimento raíz.

Si la profundidad es 2, significa que todos los compartimentos con profundidad 2 contendrán el uso o los costos con todos sus secundarios. En la respuesta, el compartimento raíz contendrá su propio uso, B agregará B, D, E y F, y C contendrá C.

Los campos solo se mostrarán cuando estos estén en groupBy. No todos los campos de la respuesta están disponibles actualmente. Solo están soportados los campos mencionados en Ejemplo válido de groupBy.

Esto se puede definir como nulo. Actualmente no está soportado.

La mejor forma de comprender cómo funciona la API es echar un vistazo a cómo la utiliza la consola. Puede encontrar el cuerpo de la solicitud en el modo de depuración del explorador 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
}

Después de realizar una solicitud sin ningún filtro, podrá ver cuál puede ser el valor de la dimensión/las etiquetas. Posteriormente, puede realizar una solicitud con un filtro y un valor de dimensión correcto.

{
  "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 escribe un script personalizado, Oracle no soporta ni presta asistencia en lo que respecta a la depuración del script. Solo están soportados la CLI, SDK y Terraform. Consulte Interfaz de línea de comandos (CLI) para obtener más información. Por ejemplo:

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