Exports - Create Or Update

Service:

Cost Management

API Version:

2023-11-01

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
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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.definition	True	ExportDefinition	Ha la definizione per l'esportazione.
properties.deliveryInfo	True	ExportDeliveryInfo	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		SystemAssignedServiceIdentity	Identità gestita associata all'esportazione
location		string	Posizione dell'identità gestita dell'esportazione. Obbligatorio solo quando si usa l'identità gestita.
properties.format		FormatType	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		ExportExecutionListResult	Se richiesto, contiene la cronologia di esecuzione più recente per l'esportazione.
properties.schedule		ExportSchedule	Contiene informazioni sulla pianificazione per l'esportazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Export	OK. La richiesta ha avuto esito positivo.
201 Created	Export	Creazione riuscita.
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

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

201

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

Status code:

200

{
  "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
CommonExportProperties	Proprietà comuni dell'esportazione.
ErrorDetails	Dettagli dell'errore.
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".
ExecutionStatus	Ultimo stato noto dell'esecuzione dell'esportazione.
ExecutionType	Tipo dell'esecuzione dell'esportazione.
Export	Risorsa di esportazione.
ExportDataset	Definizione per i 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	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 ).
ExportDeliveryInfo	Informazioni sul recapito associate a un'esportazione.
ExportExecutionListResult	Risultato dell'elenco della cronologia di esecuzione di un'esportazione.
ExportRecurrencePeriod	Data di inizio e fine per la pianificazione delle ricorrenze.
ExportRun	Esecuzione di esportazione.
ExportSchedule	Pianificazione associata all'esportazione.
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.
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.
FormatType	Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".
GranularityType	Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".
RecurrenceType	Ricorrenza della pianificazione.
StatusType	Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa.
SystemAssignedServiceIdentity	Identità del servizio gestita (assegnata dal sistema o none)
SystemAssignedServiceIdentityType	Tipo di identità del servizio gestito (sistema assegnato o none).
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

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	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

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	SystemAssignedServiceIdentity	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	ExportDefinition	Ha la definizione per l'esportazione.
properties.deliveryInfo	ExportDeliveryInfo	Contiene informazioni di recapito per l'esportazione.
properties.format	FormatType	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	ExportExecutionListResult	Se richiesto, è disponibile la cronologia di esecuzione più recente per l'esportazione.
properties.schedule	ExportSchedule	Contiene informazioni sulla pianificazione per l'esportazione.
type	string	Tipo di risorsa.

ExportDataset

Definizione per i 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 per i 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 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	ExportDeliveryDestination	Destinazione dell'esportazione in corso di consegna.

ExportExecutionListResult

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

Nome	Tipo	Descrizione
value	ExportRun[]	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	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 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	RecurrenceType	Ricorrenza della pianificazione.
recurrencePeriod	ExportRecurrencePeriod	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	StatusType	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	SystemAssignedServiceIdentityType	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