Exports - Create Or Update

  • Referenz
Service:
Cost Management
API Version:
2023-11-01

Der Vorgang zum Erstellen oder Aktualisieren eines Exports. Für den Updatevorgang muss das neueste eTag in der Anforderung festgelegt werden. Sie können das neueste eTag abrufen, indem Sie einen Get-Vorgang ausführen. Der Erstellungsvorgang erfordert kein eTag.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
exportName
 path True

string

Exportname.
scope
 path True

string

Der Bereich, der Exportvorgängen zugeordnet ist. Dies schließt "/subscriptions/{subscriptionId}/" für den Abonnementbereich ein. '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope and '/providers/Microsoft.Billing/billingAccounts/billingAccounts/billing{{AccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' für EnrollmentAccount-Bereich, "/providers/Microsoft.Management/managementGroups/{managementGroupId}" für Den Bereich "Verwaltungsgruppe", "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" für billingProfile-Bereich, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" für den bereich invoiceSection und "/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' spezifisch für Partner.
api-version
 query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.definition True

ExportDefinition

Hat die Definition für den Export.
properties.deliveryInfo True

ExportDeliveryInfo

Enthält Übermittlungsinformationen für den Export.
eTag

string

eTag der Ressource. Um gleichzeitiges Updateszenario zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
identity

SystemAssignedServiceIdentity

Die dem Export zugeordnete verwaltete Identität
location

string

Der Speicherort der verwalteten Identität des Exports. Nur erforderlich, wenn verwaltete Identität verwendet wird.
properties.format

FormatType

Das Format des zu liefernden Exports. Derzeit wird nur "Csv" unterstützt.
properties.partitionData

boolean

Wenn auf true festgelegt ist, werden exportierte Daten nach Größe partitioniert und zusammen mit einer Manifestdatei in einem Blobverzeichnis abgelegt. Hinweis: Diese Option ist derzeit nur für Microsoft-Kundenvereinbarung Commerce-Bereiche verfügbar.
properties.runHistory

ExportExecutionListResult

Verfügt bei Bedarf über den neuesten Ausführungsverlauf für den Export.
properties.schedule

ExportSchedule

Verfügt über Zeitplaninformationen für den Export.

Antworten

Name Typ Beschreibung
200 OK

Export

OK. Die Anforderung wurde erfolgreich durchgeführt.
201 Created

Export

Erstellt.
Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ExportCreateOrUpdateByBillingAccount
ExportCreateOrUpdateByDepartment
ExportCreateOrUpdateByEnrollmentAccount
ExportCreateOrUpdateByManagementGroup
ExportCreateOrUpdateByResourceGroup
ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Sample Request

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

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

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

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

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

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

Definitionen

Name Beschreibung
CommonExportProperties

Die allgemeinen Eigenschaften des Exports.
ErrorDetails

Die Details des Fehlers.
ErrorResponse

Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

  • 429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben.

  • 503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.
ExecutionStatus

Der letzte bekannte status der Exportausführung.
ExecutionType

Der Typ der Exportausführung.
Export

Eine Exportressource.
ExportDataset

Die Definition für Daten im Export.
ExportDatasetConfiguration

Die Konfiguration des Exportdatasets. Ermöglicht die Auswahl von Spalten für den Export. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten.
ExportDefinition

Die Definition eines Exports.
ExportDeliveryDestination

Dies stellt den Speicherort des Blobspeicherkontos dar, an dem Kostenexporte übermittelt werden. Es gibt zwei Möglichkeiten, das Ziel zu konfigurieren. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Ressourcenanbieter Microsoft.CostManagementExports, um Cost Management-Diensten Zugriff auf den Speicher zu gewähren. Beim Erstellen eines Exports im Azure-Portal wird diese Registrierung automatisch ausgeführt, api-Benutzer müssen das Abonnement jedoch möglicherweise explizit registrieren (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Eine weitere Möglichkeit zum Konfigurieren des Ziels ist NUR für Partner mit einem Microsoft Partner-Vereinbarung Plan verfügbar, die globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Speicherkontonamen zusammen mit einem SAS-Token für das Konto angeben. Dies ermöglicht das Exportieren von Kosten in ein Speicherkonto in einem beliebigen Mandanten. Das SAS-Token sollte für den Blobdienst mit Den Ressourcentypen Service/Container/Object und mit Lese-/Schreibzugriff/Löschen/Liste/Hinzufügen/Erstellen erstellt werden (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).
ExportDeliveryInfo

Die Übermittlungsinformationen, die einem Export zugeordnet sind.
ExportExecutionListResult

Ergebnis der Auflistung des Ausführungsverlaufs eines Exports.
ExportRecurrencePeriod

Das Start- und Enddatum für den Wiederholungszeitplan.
ExportRun

Eine Exportausführung.
ExportSchedule

Der Zeitplan, der dem Export zugeordnet ist.
ExportTimePeriod

Der Datumsbereich für Daten im Export. Dies sollte nur angegeben werden, wobei der Zeitrahmen auf "Benutzerdefiniert" festgelegt ist. Der maximale Datumsbereich beträgt 3 Monate.
ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" "ActualCost" entspricht und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.
FormatType

Das Format des zu liefernden Exports. Derzeit wird nur "Csv" unterstützt.
GranularityType

Die Granularität der Zeilen im Export. Derzeit wird nur "Daily" unterstützt.
RecurrenceType

Die Zeitplanserie.
StatusType

Die status des Exportzeitplans. Bei "Inactive" wird der Zeitplan für den Export angehalten.
SystemAssignedServiceIdentity

Verwaltete Dienstidentität (entweder systemseitig zugewiesen oder keine)
SystemAssignedServiceIdentityType

Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).
TimeframeType

Der Zeitrahmen für das Pullen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.

CommonExportProperties

Die allgemeinen Eigenschaften des Exports.

Name Typ Beschreibung
definition

ExportDefinition

Hat die Definition für den Export.
deliveryInfo

ExportDeliveryInfo

Enthält Übermittlungsinformationen für den Export.
format

FormatType

Das Format des zu liefernden Exports. Derzeit wird nur "Csv" unterstützt.
nextRunTimeEstimate

string

Wenn der Export über einen aktiven Zeitplan verfügt, gibt eine Schätzung der nächsten Laufzeit an.
partitionData

boolean

Wenn auf true festgelegt ist, werden exportierte Daten nach Größe partitioniert und zusammen mit einer Manifestdatei in einem Blobverzeichnis abgelegt. Hinweis: Diese Option ist derzeit nur für Microsoft-Kundenvereinbarung Commerce-Bereiche verfügbar.
runHistory

ExportExecutionListResult

Verfügt bei Bedarf über den neuesten Ausführungsverlauf für den Export.

ErrorDetails

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Fehlercode
message

string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

  • 429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben.

  • 503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.

Name Typ Beschreibung
error

ErrorDetails

Die Details des Fehlers.

ExecutionStatus

Der letzte bekannte status der Exportausführung.

Name Typ Beschreibung
Completed

string

DataNotAvailable

string

Failed

string

InProgress

string

NewDataNotAvailable

string

Queued

string

Timeout

string

ExecutionType

Der Typ der Exportausführung.

Name Typ Beschreibung
OnDemand

string

Scheduled

string

Export

Eine Exportressource.

Name Typ Beschreibung
eTag

string

eTag der Ressource. Um gleichzeitige Updates zu verarbeiten, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id

string

Ressourcen-ID.
identity

SystemAssignedServiceIdentity

Die verwaltete Identität, die dem Export zugeordnet ist
location

string

Der Speicherort der verwalteten Identität des Exports. Nur erforderlich, wenn verwaltete Identität verwendet wird.
name

string

Name der Ressource.
properties.definition

ExportDefinition

Hat die Definition für den Export.
properties.deliveryInfo

ExportDeliveryInfo

Enthält Übermittlungsinformationen für den Export.
properties.format

FormatType

Das Format des zugestellten Exports. Derzeit wird nur "Csv" unterstützt.
properties.nextRunTimeEstimate

string

Wenn der Export über einen aktiven Zeitplan verfügt, gibt eine Schätzung der nächsten Laufzeit an.
properties.partitionData

boolean

Wenn dieser Wert auf TRUE festgelegt ist, werden exportierte Daten nach Größe partitioniert und zusammen mit einer Manifestdatei in einem Blobverzeichnis platziert. Hinweis: Diese Option ist derzeit nur für Microsoft-Kundenvereinbarung Commerce-Bereiche verfügbar.
properties.runHistory

ExportExecutionListResult

Hat bei Bedarf den letzten Ausführungsverlauf für den Export.
properties.schedule

ExportSchedule

Verfügt über Zeitplaninformationen für den Export.
type

string

Der Ressourcentyp.

ExportDataset

Die Definition für Daten im Export.

Name Typ Beschreibung
configuration

ExportDatasetConfiguration

Die Konfiguration des Exportdatasets.
granularity

GranularityType

Die Granularität der Zeilen im Export. Derzeit wird nur "Daily" unterstützt.

ExportDatasetConfiguration

Die Konfiguration des Exportdatasets. Ermöglicht die Auswahl von Spalten für den Export. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten.

Name Typ Beschreibung
columns

string[]

Array von Spaltennamen, die in den Export eingeschlossen werden sollen. Wenn nicht angegeben, enthält der Export alle verfügbaren Spalten. Die verfügbaren Spalten können je nach Kundenkanal variieren (siehe Beispiele).

ExportDefinition

Die Definition eines Exports.

Name Typ Beschreibung
dataSet

ExportDataset

Die Definition für Daten im Export.
timePeriod

ExportTimePeriod

Weist einen Zeitraum für das Pullen von Daten für den Export auf.
timeframe

TimeframeType

Der Zeitrahmen für das Pullen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.
type

ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" "ActualCost" entspricht und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.

ExportDeliveryDestination

Dies stellt den Speicherort des Blobspeicherkontos dar, an dem Kostenexporte übermittelt werden. Es gibt zwei Möglichkeiten, das Ziel zu konfigurieren. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Ressourcenanbieter Microsoft.CostManagementExports, um Cost Management-Diensten Zugriff auf den Speicher zu gewähren. Beim Erstellen eines Exports im Azure-Portal wird diese Registrierung automatisch ausgeführt, api-Benutzer müssen das Abonnement jedoch möglicherweise explizit registrieren (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Eine weitere Möglichkeit zum Konfigurieren des Ziels ist NUR für Partner mit einem Microsoft Partner-Vereinbarung Plan verfügbar, die globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Speicherkontonamen zusammen mit einem SAS-Token für das Konto angeben. Dies ermöglicht das Exportieren von Kosten in ein Speicherkonto in einem beliebigen Mandanten. Das SAS-Token sollte für den Blobdienst mit Den Ressourcentypen Service/Container/Object und mit Lese-/Schreibzugriff/Löschen/Liste/Hinzufügen/Erstellen erstellt werden (weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

Name Typ Beschreibung
container

string

Der Name des Containers, in den Exporte hochgeladen werden. Wenn der Container nicht vorhanden ist, wird er erstellt.
resourceId

string

Die Ressourcen-ID des Speicherkontos, in das Exporte übermittelt werden. Dies ist nicht erforderlich, wenn sasToken und storageAccount angegeben werden.
rootFolderPath

string

Der Name des Verzeichnisses, in das Exporte hochgeladen werden.
sasToken

string

Ein SAS-Token für das Speicherkonto. Für eine eingeschränkte Gruppe von Azure-Kunden kann dies zusammen mit storageAccount anstelle von resourceId angegeben werden. Hinweis: Der von der API für diese Eigenschaft zurückgegebene Wert wird immer verschleiert. Die Rückgabe dieses verschleierten Werts führt nicht dazu, dass das SAS-Token aktualisiert wird. Um diesen Wert zu aktualisieren, muss ein neues SAS-Token angegeben werden.
storageAccount

string

Das Speicherkonto, in das Exporte hochgeladen werden. Für eine eingeschränkte Gruppe von Azure-Kunden kann dies zusammen mit sasToken anstelle von resourceId angegeben werden.

ExportDeliveryInfo

Die Übermittlungsinformationen, die einem Export zugeordnet sind.

Name Typ Beschreibung
destination

ExportDeliveryDestination

Hat das Ziel für den zugestellten Export.

ExportExecutionListResult

Ergebnis der Auflistung des Ausführungsverlaufs eines Exports.

Name Typ Beschreibung
value

ExportRun[]

Eine Liste der Exportausführungen.

ExportRecurrencePeriod

Das Start- und Enddatum für den Wiederholungszeitplan.

Name Typ Beschreibung
from

string

Das Startdatum der Wiederholung.
to

string

Das Enddatum der Wiederholung.

ExportRun

Eine Exportausführung.

Name Typ Beschreibung
eTag

string

eTag der Ressource. Um gleichzeitiges Updateszenario zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id

string

Ressourcen-ID.
name

string

Name der Ressource.
properties.error

ErrorDetails

Die Details eines Fehlers.
properties.executionType

ExecutionType

Der Typ der Exportausführung.
properties.fileName

string

Der Name der exportierten Datei.
properties.processingEndTime

string

Der Zeitpunkt, zu dem die Exportausführung abgeschlossen wurde.
properties.processingStartTime

string

Der Zeitpunkt, zu dem der Export für die Ausführung aufgenommen wurde.
properties.runSettings

CommonExportProperties

Die Exporteinstellungen, die für diese Ausführung gültig waren.
properties.status

ExecutionStatus

Der letzte bekannte status der Exportausführung.
properties.submittedBy

string

Der Bezeichner für die Entität, die den Export ausgelöst hat. Bei bedarfsgesteuerten Ausführungen handelt es sich um die E-Mail-Adresse des Benutzers. Bei geplanten Ausführungen lautet dies "System".
properties.submittedTime

string

Der Zeitpunkt, zu dem der Export für die Ausführung in die Warteschlange eingereiht wurde.
type

string

Der Ressourcentyp.

ExportSchedule

Der Zeitplan, der dem Export zugeordnet ist.

Name Typ Beschreibung
recurrence

RecurrenceType

Die Zeitplanserie.
recurrencePeriod

ExportRecurrencePeriod

Hat das Start- und Enddatum der Wiederholung. Das Startdatum muss in der Zukunft sein. Falls vorhanden, muss das Enddatum größer als das Startdatum sein.
status

StatusType

Die status des Exportzeitplans. Bei "Inactive" wird der Zeitplan für den Export angehalten.

ExportTimePeriod

Der Datumsbereich für Daten im Export. Dies sollte nur angegeben werden, wobei der Zeitrahmen auf "Benutzerdefiniert" festgelegt ist. Der maximale Datumsbereich beträgt 3 Monate.

Name Typ Beschreibung
from

string

Das Startdatum für den Export von Daten.
to

string

Das Enddatum für den Export von Daten.

ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" "ActualCost" entspricht und für Exporte gilt, die noch keine Daten für Gebühren oder Amortisierungen für Servicereservierungen bereitstellen.

Name Typ Beschreibung
ActualCost

string

AmortizedCost

string

Usage

string

FormatType

Das Format des zu liefernden Exports. Derzeit wird nur "Csv" unterstützt.

Name Typ Beschreibung
Csv

string

GranularityType

Die Granularität der Zeilen im Export. Derzeit wird nur "Daily" unterstützt.

Name Typ Beschreibung
Daily

string

RecurrenceType

Die Zeitplanserie.

Name Typ Beschreibung
Annually

string

Daily

string

Monthly

string

Weekly

string

StatusType

Die status des Exportzeitplans. Bei "Inactive" wird der Zeitplan für den Export angehalten.

Name Typ Beschreibung
Active

string

Inactive

string

SystemAssignedServiceIdentity

Verwaltete Dienstidentität (entweder systemseitig zugewiesen oder keine)

Name Typ Beschreibung
principalId

string

Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
tenantId

string

Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
type

SystemAssignedServiceIdentityType

Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).

SystemAssignedServiceIdentityType

Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne).

Name Typ Beschreibung
None

string

SystemAssigned

string

TimeframeType

Der Zeitrahmen für das Pullen von Daten für den Export. Wenn benutzerdefiniert, muss ein bestimmter Zeitraum angegeben werden.

Name Typ Beschreibung
BillingMonthToDate

string

Custom

string

MonthToDate

string

TheLastBillingMonth

string

TheLastMonth

string

WeekToDate

string