Exports - Create Or Update
Operazione per creare o aggiornare un'esportazione. Per l'operazione di aggiornamento è necessario impostare l'eTag più recente nella richiesta. È possibile ottenere l'eTag più recente eseguendo un'operazione get. L'operazione di creazione non richiede eTag.
PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2023-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
export
|
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. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
properties.definition | True |
Ha la definizione per l'esportazione. |
|
properties.deliveryInfo | True |
Contiene informazioni sul recapito per l'esportazione. |
|
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. |
|
identity |
Identità gestita associata all'esportazione |
||
location |
string |
Posizione dell'identità gestita dell'esportazione. Obbligatorio solo quando si usa l'identità gestita. |
|
properties.format |
Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv". |
||
properties.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. |
|
properties.runHistory |
Se richiesto, contiene la cronologia di esecuzione più recente per l'esportazione. |
||
properties.schedule |
Contiene informazioni sulla pianificazione per l'esportazione. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK. La richiesta ha avuto esito positivo. |
|
201 Created |
Creazione riuscita. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
ExportCreateOrUpdateByBillingAccount
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
ExportCreateOrUpdateByDepartment
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
ExportCreateOrUpdateByEnrollmentAccount
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
ExportCreateOrUpdateByManagementGroup
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
ExportCreateOrUpdateByResourceGroup
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
ExportCreateOrUpdateBySubscription
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Risposta di esempio
{
"id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
{
"id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
"name": "TestExport",
"type": "Microsoft.CostManagement/exports",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "centralus",
"properties": {
"schedule": {
"status": "Active",
"recurrence": "Weekly",
"recurrencePeriod": {
"from": "2020-06-01T00:00:00Z",
"to": "2020-10-31T00:00:00Z"
}
},
"format": "Csv",
"deliveryInfo": {
"destination": {
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
"container": "exports",
"rootFolderPath": "ad-hoc"
}
},
"definition": {
"type": "ActualCost",
"timeframe": "MonthToDate",
"dataSet": {
"granularity": "Daily",
"configuration": {
"columns": [
"Date",
"MeterId",
"ResourceId",
"ResourceLocation",
"Quantity"
]
}
}
}
}
}
Definizioni
Nome | Descrizione |
---|---|
Common |
Proprietà comuni dell'esportazione. |
Error |
Dettagli dell'errore. |
Error |
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:
|
Execution |
Ultimo stato noto dell'esecuzione dell'esportazione. |
Execution |
Tipo dell'esecuzione dell'esportazione. |
Export |
Risorsa di esportazione. |
Export |
Definizione per i dati nell'esportazione. |
Export |
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. |
Export |
Definizione di un'esportazione. |
Export |
Questo 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 il resourceId dell'account di archiviazione. Ciò richiede una registrazione una sola volta della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi di gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nella 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 Contratto Microsoft Partner che sono amministratori globali del proprio account di fatturazione. Questi partner, anziché specificare il 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. Ciò consente di 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 Read/Write/Delete/List/Add/Create (per altre informazioni vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ). |
Export |
Informazioni sul recapito associate a un'esportazione. |
Export |
Risultato dell'elenco della cronologia di esecuzione di un'esportazione. |
Export |
Data di inizio e fine per la pianificazione delle ricorrenze. |
Export |
Esecuzione di esportazione. |
Export |
Pianificazione associata all'esportazione. |
Export |
Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con intervallo di tempo impostato su 'Personalizzato'. L'intervallo massimo di date è di 3 mesi. |
Export |
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 del servizio. |
Format |
Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv". |
Granularity |
Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily". |
Recurrence |
Ricorrenza della pianificazione. |
Status |
Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa. |
System |
Identità del servizio gestita (assegnata dal sistema o none) |
System |
Tipo di identità del servizio gestito (sistema assegnato o none). |
Timeframe |
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 |
Ha la definizione per l'esportazione. |
|
deliveryInfo |
Contiene informazioni sul recapito per l'esportazione. |
|
format |
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 |
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
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 dell'ora specificata 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 |
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 |
Export
Risorsa di 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 la versione più recente o meno. |
id |
string |
ID risorsa. |
identity |
Identità gestita associata all'esportazione |
|
location |
string |
Percorso dell'identità gestita dell'esportazione. Obbligatorio solo quando si usa l'identità gestita. |
name |
string |
Nome risorsa. |
properties.definition |
Ha la definizione per l'esportazione. |
|
properties.deliveryInfo |
Contiene informazioni di recapito per l'esportazione. |
|
properties.format |
Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv". |
|
properties.nextRunTimeEstimate |
string |
Se l'esportazione ha una pianificazione attiva, fornisce una stima dell'ora di esecuzione successiva. |
properties.partitionData |
boolean |
Se impostato su true, i dati esportati verranno partizionati per dimensione e inseriti in una directory BLOB insieme a un file manifesto. Nota: questa opzione è attualmente disponibile solo per gli ambiti commerciali di Contratto del cliente Microsoft. |
properties.runHistory |
Se richiesto, è disponibile la cronologia di esecuzione più recente per l'esportazione. |
|
properties.schedule |
Contiene informazioni sulla pianificazione per l'esportazione. |
|
type |
string |
Tipo di risorsa. |
ExportDataset
Definizione per i dati nell'esportazione.
Nome | Tipo | Descrizione |
---|---|---|
configuration |
Configurazione del set di dati di esportazione. |
|
granularity |
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 |
Definizione per i dati nell'esportazione. |
|
timePeriod |
Periodo di tempo per il pull dei dati per l'esportazione. |
|
timeframe |
Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico. |
|
type |
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 del servizio. |
ExportDeliveryDestination
Questo 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 il resourceId dell'account di archiviazione. Ciò richiede una registrazione una sola volta della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi di gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nella 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 Contratto Microsoft Partner che sono amministratori globali del proprio account di fatturazione. Questi partner, anziché specificare il 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. Ciò consente di 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 Read/Write/Delete/List/Add/Create (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. Non è necessario se viene specificato un account di archiviazione e sasToken. |
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, questo insieme a storageAccount può essere specificato anziché resourceId. Nota: il valore restituito dall'API per questa proprietà verrà sempre offuscato. La restituzione dello stesso valore offuscato non comporta 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, questo insieme a sasToken può essere specificato anziché resourceId. |
ExportDeliveryInfo
Informazioni sul recapito associate a un'esportazione.
Nome | Tipo | Descrizione |
---|---|---|
destination |
Destinazione dell'esportazione in corso di consegna. |
ExportExecutionListResult
Risultato dell'elenco della cronologia di esecuzione di un'esportazione.
Nome | Tipo | Descrizione |
---|---|---|
value |
Elenco delle esecuzioni di esportazione. |
ExportRecurrencePeriod
Data di inizio e fine per la pianificazione delle ricorrenze.
Nome | Tipo | Descrizione |
---|---|---|
from |
string |
Data di inizio della ricorrenza. |
to |
string |
Data di fine ricorrenza. |
ExportRun
Esecuzione di 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 |
Dettagli di qualsiasi errore. |
|
properties.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 |
Impostazioni di esportazione applicate per questa esecuzione. |
|
properties.status |
Ultimo stato noto dell'esecuzione dell'esportazione. |
|
properties.submittedBy |
string |
Identificatore dell'entità che ha attivato l'esportazione. Per le esecuzioni su richiesta è il 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. |
ExportSchedule
Pianificazione associata all'esportazione.
Nome | Tipo | Descrizione |
---|---|---|
recurrence |
Ricorrenza della pianificazione. |
|
recurrencePeriod |
Data di inizio e fine della ricorrenza. La data di inizio deve essere in futuro. Se presente, la data di fine deve essere maggiore della data di inizio. |
|
status |
Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa. |
ExportTimePeriod
Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con 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 l'esportazione dei dati. |
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 del servizio.
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 |
RecurrenceType
Ricorrenza della pianificazione.
Nome | Tipo | Descrizione |
---|---|---|
Annually |
string |
|
Daily |
string |
|
Monthly |
string |
|
Weekly |
string |
StatusType
Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa.
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Inactive |
string |
SystemAssignedServiceIdentity
Identità del servizio gestita (assegnata dal sistema o none)
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
ID dell'entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
tenantId |
string |
ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
type |
Tipo di identità del servizio gestito (sistema assegnato o none). |
SystemAssignedServiceIdentityType
Tipo di identità del servizio gestito (sistema assegnato o none).
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
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 |