Condividi tramite


Exports - Get Execution History

Operazione per ottenere la cronologia di esecuzione di un'esportazione per l'ambito definito e il nome di esportazione.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}/runHistory?api-version=2023-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
exportName
path True

string

Nome esportazione.

scope
path True

string

Ambito associato alle operazioni di esportazione. Sono inclusi '/subscriptions/{subscriptionId}/' per l'ambito della sottoscrizione, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per ambito resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' per ambito account di fatturazione e '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' per ambito reparto, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' per ambito EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} per l'ambito del gruppo di gestione, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' per ambito billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' per l'ambito invoiceSection e '/providers/Microsoft. Fatturazione/billingAccounts/{billingAccountId}/customers/{customerId}' specifico per i partner.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

ExportExecutionListResult

OK. La richiesta ha avuto esito positivo.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ExportRunHistoryGetByBillingAccount
ExportRunHistoryGetByDepartment
ExportRunHistoryGetByEnrollmentAccount
ExportRunHistoryGetByManagementGroup
ExportRunHistoryGetByResourceGroup
ExportRunHistoryGetBySubscription

ExportRunHistoryGetByBillingAccount

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/{billingAccount-id}/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/{billingAccount-id}/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

ExportRunHistoryGetByDepartment

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

ExportRunHistoryGetByEnrollmentAccount

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

ExportRunHistoryGetByManagementGroup

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledForTestExport/TestExportSchedule/20180729-20180804/TestExportSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledForTestExport/TestExportSchedule/20180729-20180804/TestExportSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

ExportRunHistoryGetByResourceGroup

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

ExportRunHistoryGetBySubscription

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport/runHistory?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/1e25d58a-a3b0-4916-9542-6e04a89bc100",
      "properties": {
        "executionType": "OnDemand",
        "status": "Completed",
        "submittedBy": "john.doe@gmail.com",
        "submittedTime": "2018-08-03T07:52:15.6016681Z",
        "processingStartTime": "2018-08-03T07:52:16.9123797Z",
        "processingEndTime": "2018-08-03T07:52:28.0373318Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_1e25d58a-a3b0-4916-9542-6e04a89bc100.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    },
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/JohnDoeSchedule/Run/11ac6811-dca3-46ad-b326-4704cf0c58ef",
      "properties": {
        "executionType": "Scheduled",
        "status": "Completed",
        "submittedBy": "System",
        "submittedTime": "2018-08-03T09:03:58.5710244Z",
        "processingStartTime": "2018-08-03T09:03:58.5710244Z",
        "processingEndTime": "2018-08-03T09:04:19.7223808Z",
        "fileName": "ScheduledTestsForJohnDoe/JohnDoeSchedule/20180729-20180804/JohnDoeSchedule_11ac6811-dca3-46ad-b326-4704cf0c58ef.csv",
        "runSettings": {
          "format": "Csv",
          "deliveryInfo": {
            "destination": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
              "container": "exports",
              "rootFolderPath": "ScheduledTestsForJohnDoe"
            }
          },
          "definition": {
            "type": "ActualCost",
            "timeframe": "Custom",
            "timePeriod": {
              "from": "2020-06-01T00:00:00Z",
              "to": "2020-10-31T00:00:00Z"
            },
            "dataSet": {
              "granularity": "Daily",
              "configuration": {
                "columns": [
                  "Date",
                  "MeterId",
                  "ResourceId",
                  "ResourceLocation",
                  "Quantity"
                ]
              }
            }
          }
        }
      }
    }
  ]
}

Definizioni

Nome Descrizione
CommonExportProperties

Proprietà comuni dell'esportazione.

ErrorDetails

Dettagli dell'errore.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

  • 429 TooManyRequests - La richiesta è limitata. Riprovare dopo l'attesa del tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver atteso il tempo specificato nell'intestazione "Retry-After".

ExecutionStatus

Ultimo stato noto dell'esecuzione dell'esportazione.

ExecutionType

Tipo dell'esecuzione dell'esportazione.

ExportDataset

Definizione dei dati nell'esportazione.

ExportDatasetConfiguration

Configurazione del set di dati di esportazione. Consente di selezionare le colonne per l'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili.

ExportDefinition

Definizione di un'esportazione.

ExportDeliveryDestination

Rappresenta il percorso dell'account di archiviazione BLOB in cui verranno recapitate le esportazioni dei costi. Esistono due modi per configurare la destinazione. L'approccio consigliato per la maggior parte dei clienti consiste nel specificare l'ID risorsa dell'account di archiviazione. Ciò richiede una registrazione una tantum della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nel portale di Azure questa registrazione viene eseguita automaticamente, ma gli utenti dell'API potrebbero dover registrare la sottoscrizione in modo esplicito (per altre informazioni vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Un altro modo per configurare la destinazione è disponibile SOLO per i partner con un piano di Contratto Microsoft Partner che sono amministratori globali del proprio account di fatturazione. Questi partner, invece di specificare il valore resourceId di un account di archiviazione, possono specificare il nome dell'account di archiviazione insieme a un token di firma di accesso condiviso per l'account. In questo modo è possibile esportare i costi in un account di archiviazione in qualsiasi tenant. Il token di firma di accesso condiviso deve essere creato per il servizio BLOB con tipi di risorse Service/Container/Object e con autorizzazioni di lettura/scrittura/eliminazione/elenco/aggiunta/creazione (per altre informazioni vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

ExportDeliveryInfo

Informazioni sul recapito associate a un'esportazione.

ExportExecutionListResult

Risultato dell'elenco della cronologia di esecuzione di un'esportazione.

ExportRun

Esecuzione dell'esportazione.

ExportTimePeriod

Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con l'intervallo di tempo impostato su "Personalizzato". L'intervallo massimo di date è di 3 mesi.

ExportType

Tipo dell'esportazione. Si noti che "Utilizzo" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per addebiti o ammortamenti per le prenotazioni di servizi.

FormatType

Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".

GranularityType

Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".

TimeframeType

Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.

CommonExportProperties

Proprietà comuni dell'esportazione.

Nome Tipo Descrizione
definition

ExportDefinition

Ha la definizione per l'esportazione.

deliveryInfo

ExportDeliveryInfo

Contiene informazioni sul recapito per l'esportazione.

format

FormatType

Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".

nextRunTimeEstimate

string

Se l'esportazione ha una pianificazione attiva, fornisce una stima della fase di esecuzione successiva.

partitionData

boolean

Se impostato su true, i dati esportati verranno partizionati in base alle dimensioni e inseriti in una directory BLOB insieme a un file manifesto. Nota: questa opzione è attualmente disponibile solo per Contratto del cliente Microsoft ambiti commerciali.

runHistory

ExportExecutionListResult

Se richiesto, contiene la cronologia di esecuzione più recente per l'esportazione.

ErrorDetails

Dettagli dell'errore.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

  • 429 TooManyRequests - La richiesta è limitata. Riprovare dopo l'attesa del tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver atteso il tempo specificato nell'intestazione "Retry-After".

Nome Tipo Descrizione
error

ErrorDetails

Dettagli dell'errore.

ExecutionStatus

Ultimo stato noto dell'esecuzione dell'esportazione.

Nome Tipo Descrizione
Completed

string

DataNotAvailable

string

Failed

string

InProgress

string

NewDataNotAvailable

string

Queued

string

Timeout

string

ExecutionType

Tipo dell'esecuzione dell'esportazione.

Nome Tipo Descrizione
OnDemand

string

Scheduled

string

ExportDataset

Definizione dei dati nell'esportazione.

Nome Tipo Descrizione
configuration

ExportDatasetConfiguration

Configurazione del set di dati di esportazione.

granularity

GranularityType

Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".

ExportDatasetConfiguration

Configurazione del set di dati di esportazione. Consente di selezionare le colonne per l'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili.

Nome Tipo Descrizione
columns

string[]

Matrice di nomi di colonna da includere nell'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili. Le colonne disponibili possono variare in base al canale del cliente (vedere esempi).

ExportDefinition

Definizione di un'esportazione.

Nome Tipo Descrizione
dataSet

ExportDataset

Definizione dei dati nell'esportazione.

timePeriod

ExportTimePeriod

Periodo di tempo per il pull dei dati per l'esportazione.

timeframe

TimeframeType

Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.

type

ExportType

Tipo dell'esportazione. Si noti che "Utilizzo" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per addebiti o ammortamenti per le prenotazioni di servizi.

ExportDeliveryDestination

Rappresenta il percorso dell'account di archiviazione BLOB in cui verranno recapitate le esportazioni dei costi. Esistono due modi per configurare la destinazione. L'approccio consigliato per la maggior parte dei clienti consiste nel specificare l'ID risorsa dell'account di archiviazione. Ciò richiede una registrazione una tantum della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nel portale di Azure questa registrazione viene eseguita automaticamente, ma gli utenti dell'API potrebbero dover registrare la sottoscrizione in modo esplicito (per altre informazioni vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Un altro modo per configurare la destinazione è disponibile SOLO per i partner con un piano di Contratto Microsoft Partner che sono amministratori globali del proprio account di fatturazione. Questi partner, invece di specificare il valore resourceId di un account di archiviazione, possono specificare il nome dell'account di archiviazione insieme a un token di firma di accesso condiviso per l'account. In questo modo è possibile esportare i costi in un account di archiviazione in qualsiasi tenant. Il token di firma di accesso condiviso deve essere creato per il servizio BLOB con tipi di risorse Service/Container/Object e con autorizzazioni di lettura/scrittura/eliminazione/elenco/aggiunta/creazione (per altre informazioni vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

Nome Tipo Descrizione
container

string

Nome del contenitore in cui verranno caricate le esportazioni. Se il contenitore non esiste, verrà creato.

resourceId

string

ID risorsa dell'account di archiviazione in cui verranno recapitate le esportazioni. Questa operazione non è necessaria se vengono specificati sasToken e storageAccount.

rootFolderPath

string

Nome della directory in cui verranno caricate le esportazioni.

sasToken

string

Token di firma di accesso condiviso per l'account di archiviazione. Per un set limitato di clienti di Azure, è possibile specificare questo insieme a storageAccount anziché resourceId. Nota: il valore restituito dall'API per questa proprietà verrà sempre offuscato. La restituzione dello stesso valore offuscato non comporterà l'aggiornamento del token di firma di accesso condiviso. Per aggiornare questo valore è necessario specificare un nuovo token di firma di accesso condiviso.

storageAccount

string

Account di archiviazione in cui verranno caricate le esportazioni. Per un set limitato di clienti di Azure, è possibile specificare questo insieme a sasToken anziché resourceId.

ExportDeliveryInfo

Informazioni sul recapito associate a un'esportazione.

Nome Tipo Descrizione
destination

ExportDeliveryDestination

Destinazione dell'esportazione recapitata.

ExportExecutionListResult

Risultato dell'elenco della cronologia di esecuzione di un'esportazione.

Nome Tipo Descrizione
value

ExportRun[]

Elenco di esecuzioni di esportazione.

ExportRun

Esecuzione dell'esportazione.

Nome Tipo Descrizione
eTag

string

eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.

id

string

ID risorsa.

name

string

Nome risorsa.

properties.error

ErrorDetails

Dettagli di qualsiasi errore.

properties.executionType

ExecutionType

Tipo dell'esecuzione dell'esportazione.

properties.fileName

string

Nome del file esportato.

properties.processingEndTime

string

Ora di fine dell'esecuzione dell'esportazione.

properties.processingStartTime

string

Ora in cui l'esportazione è stata prelevata per l'esecuzione.

properties.runSettings

CommonExportProperties

Impostazioni di esportazione applicate per questa esecuzione.

properties.status

ExecutionStatus

Ultimo stato noto dell'esecuzione dell'esportazione.

properties.submittedBy

string

Identificatore per l'entità che ha attivato l'esportazione. Per l'esecuzione su richiesta, si tratta del messaggio di posta elettronica dell'utente. Per le esecuzioni pianificate, è "System".

properties.submittedTime

string

Ora in cui l'esportazione è stata accodata per l'esecuzione.

type

string

Tipo di risorsa.

ExportTimePeriod

Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con l'intervallo di tempo impostato su "Personalizzato". L'intervallo massimo di date è di 3 mesi.

Nome Tipo Descrizione
from

string

Data di inizio per l'esportazione dei dati.

to

string

Data di fine per i dati di esportazione.

ExportType

Tipo dell'esportazione. Si noti che "Utilizzo" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per addebiti o ammortamenti per le prenotazioni di servizi.

Nome Tipo Descrizione
ActualCost

string

AmortizedCost

string

Usage

string

FormatType

Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".

Nome Tipo Descrizione
Csv

string

GranularityType

Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".

Nome Tipo Descrizione
Daily

string

TimeframeType

Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.

Nome Tipo Descrizione
BillingMonthToDate

string

Custom

string

MonthToDate

string

TheLastBillingMonth

string

TheLastMonth

string

WeekToDate

string