Compartir a través de

Query - Usage By Scope

  • Referencia
Servicio:
Cost Management
Versión de la API:
2019-09-01

Consulte los datos de uso para el ámbito definido.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/query?api-version=2019-09-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
scope
 path True

string

Ámbito asociado a las operaciones de consulta y exportación. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para el ámbito de la cuenta de facturación y '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para el ámbito del departamento, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}" para el ámbito EnrollmentAccount y "/providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración.
api-version
 query True

string

Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2018-05-31.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
timeframe True

TimeframeType

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.
type True

ExportType

Tipo de la consulta.
dataset

QueryDataset

Tiene la definición de los datos de esta consulta.
timePeriod

QueryTimePeriod

Tiene un período de tiempo para extraer datos de la consulta.

Respuestas

Nombre Tipo Description
200 OK

QueryResult

De acuerdo. La solicitud se ha realizado correctamente.
Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

BillingAccountQuery
BillingAccountQueryGrouping
DepartmentQuery
DepartmentQueryGrouping
EnrollmentAccountQuery
EnrollmentAccountQueryGrouping
ManagementGroupQuery
ManagementGroupQueryGrouping
ResourceGroupQuery
ResourceGroupQueryGrouping
SubscriptionQuery
SubscriptionQueryGrouping

BillingAccountQuery

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query?api-version=2018-05-31&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ],
          [
            0.16677720329728665,
            "gs-stms-dev",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

BillingAccountQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "None",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceGroup"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query?api-version=2018-05-31&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            "USD"
          ]
        ]
      }
    }
  ]
}

DepartmentQuery

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/departments/123/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/departments/123/providers/Microsoft.CostManagement/Query?api-version=2019-01-01&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ],
          [
            0.16677720329728665,
            "gs-stms-dev",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

DepartmentQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "None",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceGroup"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/departments/123/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/departments/123/providers/Microsoft.CostManagement/Query?api-version=2019-01-01&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            "USD"
          ]
        ]
      }
    }
  ]
}

EnrollmentAccountQuery

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/enrollmentAccounts/456/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/enrollmentAccounts/456/providers/Microsoft.CostManagement/Query?api-version=2019-01-01&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ],
          [
            0.16677720329728665,
            "gs-stms-dev",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

EnrollmentAccountQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "Daily",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceGroup"
      }
    ],
    "sorting": [
      {
        "name": "ResourceGroup"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/enrollmentAccounts/456/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/enrollmentAccounts/456/providers/Microsoft.CostManagement/Query?api-version=2019-01-01&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

ManagementGroupQuery

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/Query?api-version=2018-05-31&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ],
          [
            0.16677720329728665,
            "gs-stms-dev",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

ManagementGroupQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "None",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceGroup"
      }
    ],
    "sorting": [
      {
        "name": "ResourceGroup",
        "querySortingDirection": "Descending"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/Query?api-version=2018-05-31&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331,
            "USD"
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331,
            "USD"
          ],
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331,
            "USD"
          ]
        ]
      }
    }
  ]
}

ResourceGroupQuery

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "subscriptions/55312978-ba1b-415c-9304-c4b9c43c0481/resourcegroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/Query/9af9459d-441d-4055-9ed0-83d4c4a363fb",
      "name": "9af9459d-441d-4055-9ed0-83d4c4a363fb",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": null,
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            2.10333307059661,
            "ScreenSharingTest-peer",
            20180417,
            "USD"
          ],
          [
            20.10333307059661,
            "ScreenSharingTest-peer",
            20180418,
            "USD"
          ]
        ]
      }
    }
  ]
}

ResourceGroupQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "Daily",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceType"
      }
    ],
    "sorting": [
      {
        "name": "ResourceType",
        "querySortingDirection": "Descending"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ScreenSharingTest-peer/providers/Microsoft.CostManagement/Query/9af9459d-441d-4055-9ed0-83d4c4a363fb",
      "name": "9af9459d-441d-4055-9ed0-83d4c4a363fb",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": null,
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceType",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            2.10333307059661,
            "Microsoft.SqlServer",
            20180417,
            "USD"
          ],
          [
            20.10333307059661,
            "Microsoft.Compute",
            20180418,
            "USD"
          ]
        ]
      }
    }
  ]
}

SubscriptionQuery

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    },
    "sorting": [
      {
        "name": "UsageDate",
        "querySortingDirection": "Ascending"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/Query/00000000-0000-0000-0000-000000000000",
      "name": "55312978-ba1b-415c-9304-cfd9c43c0481",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": null,
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            2.10333307059661,
            "ScreenSharingTest-peer",
            20180331,
            "USD"
          ],
          [
            218.68795741935486,
            "Ict_StratAndPlan_GoldSprova_Prod",
            20180331,
            "USD"
          ],
          [
            0.14384913581657052,
            "ssbciotelement01",
            20180401,
            "USD"
          ],
          [
            0.009865586851323632,
            "ict_stratandplan_goldsprova_prod",
            20180429,
            "USD"
          ]
        ]
      }
    }
  ]
}

SubscriptionQueryGrouping

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/query?api-version=2019-09-01

{
  "type": "Usage",
  "timeframe": "TheLastMonth",
  "dataset": {
    "granularity": "None",
    "aggregation": {
      "totalCost": {
        "name": "PreTaxCost",
        "function": "Sum"
      }
    },
    "grouping": [
      {
        "type": "Dimension",
        "name": "ResourceGroup"
      }
    ],
    "sorting": [
      {
        "name": "ResourceGroup"
      }
    ]
  }
}

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/Query/00000000-0000-0000-0000-000000000000",
      "name": "55312978-ba1b-415c-9304-cfd9c43c0481",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": null,
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "Currency",
            "type": "String"
          }
        ],
        "rows": [
          [
            0.009865586851323632,
            "Ict_StratAndPlan_GoldSprova_Prod_0",
            "USD"
          ],
          [
            218.68795741935486,
            "Ict_StratAndPlan_GoldSprova_Prod_1",
            "USD"
          ],
          [
            2.10333307059661,
            "ScreenSharingTest-peer1",
            "USD"
          ],
          [
            0.14384913581657052,
            "Ssbciotelement01",
            "USD"
          ]
        ]
      }
    }
  ]
}

Definiciones

Nombre Description
ErrorDetails

Detalles del error.
ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
ExportType

Tipo de la consulta.
FunctionType

Nombre de la función de agregación que se va a usar.
GranularityType

Granularidad de las filas de la consulta.
OperatorType

Operador que se va a usar para la comparación.
Query
QueryAggregation

Expresión de agregación que se va a usar en la consulta.
QueryColumn
QueryColumnType

Tipo de la columna de la exportación.
QueryComparisonExpression

Expresión de comparación que se va a usar en la consulta.
QueryDataset

Definición de los datos presentes en la consulta.
QueryDatasetConfiguration

Configuración del conjunto de datos en la consulta.
QueryDefinition

Definición de una consulta.
QueryFilter

Expresión de filtro que se va a usar en la exportación.
QueryGrouping

Grupo por expresión que se va a usar en la consulta.
QueryResult

Resultado de la consulta. Contiene todas las columnas enumeradas en agrupaciones y agregaciones.
QuerySortingConfiguration

Configuración para ordenar en la consulta.
QueryTimePeriod

Fecha de inicio y finalización para extraer datos de la consulta.
SortDirection

Dirección de ordenación
TimeframeType

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.

ErrorDetails

Object

Detalles del error.

Nombre Tipo Description
code

string

Código de error.
message

string

Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

Object

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Nombre Tipo Description
error

ErrorDetails

Detalles del error.

ExportType

Enumeración

Tipo de la consulta.

Valor Description
Usage

FunctionType

Enumeración

Nombre de la función de agregación que se va a usar.

Valor Description
Sum

GranularityType

Enumeración

Granularidad de las filas de la consulta.

Valor Description
Daily
Hourly

OperatorType

Enumeración

Operador que se va a usar para la comparación.

Valor Description
In

Query

Object
Nombre Tipo Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties.columns

QueryColumn[]

Matriz de columnas
properties.nextLink

string

properties.rows

Rows[]

tags

object

Etiquetas de recursos.
type

string

Tipo de recurso.

QueryAggregation

Object

Expresión de agregación que se va a usar en la consulta.

Nombre Tipo Description
function

FunctionType

Nombre de la función de agregación que se va a usar.
name

string

Nombre de la columna que se va a agregar.

QueryColumn

Object
Nombre Tipo Description
name

string

type

string

QueryColumnType

Enumeración

Tipo de la columna de la exportación.

Valor Description
Dimension
Tag

QueryComparisonExpression

Object

Expresión de comparación que se va a usar en la consulta.

Nombre Tipo Description
name

string

Nombre de la columna que se va a usar en comparación.
operator

OperatorType

Operador que se va a usar para la comparación.
values

string[]

Matriz de valores que se van a usar para la comparación

QueryDataset

Object

Definición de los datos presentes en la consulta.

Nombre Tipo Description
aggregation

<string,  QueryAggregation>

Diccionario de expresiones de agregación que se van a usar en la consulta. La clave de cada elemento del diccionario es el alias de la columna agregada. La consulta puede tener hasta 2 cláusulas de agregación.
configuration

QueryDatasetConfiguration

Tiene información de configuración para los datos de la exportación. La configuración se omitirá si se proporcionan la agregación y la agrupación.
filter

QueryFilter

Expresión de filtro que se va a usar en la consulta. Consulte la documentación de REST de la API de consulta para obtener el formato correcto del filtro.
granularity

GranularityType

Granularidad de las filas de la consulta.
grouping

QueryGrouping[]

Matriz de agrupación por expresión que se va a usar en la consulta. La consulta puede tener hasta 2 cláusulas group by.
sorting

QuerySortingConfiguration[]

Matriz de ordenación por columnas en la consulta.

QueryDatasetConfiguration

Object

Configuración del conjunto de datos en la consulta.

Nombre Tipo Description
columns

string[]

Matriz de nombres de columna que se van a incluir en la consulta. Se permite cualquier nombre de columna de consulta válido. Si no se proporciona, la consulta incluye todas las columnas.

QueryDefinition

Object

Definición de una consulta.

Nombre Tipo Description
dataset

QueryDataset

Tiene la definición de los datos de esta consulta.
timePeriod

QueryTimePeriod

Tiene un período de tiempo para extraer datos de la consulta.
timeframe

TimeframeType

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.
type

ExportType

Tipo de la consulta.

QueryFilter

Object

Expresión de filtro que se va a usar en la exportación.

Nombre Tipo Description
and

QueryFilter[]

Expresión "AND" lógica. Debe tener al menos 2 elementos.
dimension

QueryComparisonExpression

Tiene una expresión de comparación para una dimensión
not

QueryFilter

Expresión lógica "NOT".
or

QueryFilter[]

Expresión "OR" lógica. Debe tener al menos 2 elementos.
tag

QueryComparisonExpression

Tiene expresión de comparación para una etiqueta

QueryGrouping

Object

Grupo por expresión que se va a usar en la consulta.

Nombre Tipo Description
name

string

Nombre de la columna que se va a agrupar.
type

QueryColumnType

Tiene el tipo de columna que se va a agrupar.

QueryResult

Object

Resultado de la consulta. Contiene todas las columnas enumeradas en agrupaciones y agregaciones.

Nombre Tipo Description
value

Query[]

Lista de datos de uso.

QuerySortingConfiguration

Object

Configuración para ordenar en la consulta.

Nombre Tipo Description
name

string

Nombre de la columna que se va a usar en la ordenación.
querySortingDirection

SortDirection

Dirección de ordenación

QueryTimePeriod

Object

Fecha de inicio y finalización para extraer datos de la consulta.

Nombre Tipo Description
from

string (date-time)

Fecha de inicio de la que se van a extraer datos.
to

string (date-time)

Fecha de finalización a la que se van a extraer los datos.

SortDirection

Enumeración

Dirección de ordenación

Valor Description
Ascending
Descending

TimeframeType

Enumeración

Período de tiempo para extraer datos de la consulta. Si es personalizado, se debe proporcionar un período de tiempo específico.

Valor Description
Custom
MonthToDate
TheLastMonth
TheLastWeek
TheLastYear
WeekToDate
YearToDate