Exports - Create Or Update

  • Referenz
Dienst:
Cost Management
API-Version:
2024-08-01

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

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2024-08-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}' für resourceGroup-Bereich, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' für Abrechnungskontobereich und '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' für Abteilungsbereich, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' für enrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}, for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' für billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' für invoiceSection scope, and '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' speziell für Partner.
api-version
 query True

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.definition True

ExportDefinition

Weist die Definition für den Export auf.
properties.deliveryInfo True

ExportDeliveryInfo

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

string

eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
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.
properties.format

FormatType

Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
properties.partitionData

boolean

Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
properties.runHistory

ExportExecutionListResult

Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.
properties.schedule

ExportSchedule

Enthält Zeitplaninformationen für den Export.

Antworten

Name Typ Beschreibung
200 OK

Export

OKAY. Die Anforderung ist erfolgreich.
201 Created

Export

Erstellt.
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

ExportCreateOrUpdateByBillingAccount
ExportCreateOrUpdateByDepartment
ExportCreateOrUpdateByEnrollmentAccount
ExportCreateOrUpdateByManagementGroup
ExportCreateOrUpdateByResourceGroup
ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2024-08-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"
          ]
        }
      }
    }
  }
}

Beispiel für eine Antwort

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

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

Einige Fehlerantworten:

  • 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

  • 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.
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 Export-Datasets. 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 BLOB-Speicherkontos dar, an den Exporte von Kosten übermittelt werden. Es gibt zwei Möglichkeiten zum Konfigurieren des Ziels. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Microsoft.CostManagementExports-Ressourcenanbieter, um Kostenverwaltungsdienste 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 Agreement-Plan verfügbar, der globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Namen des Speicherkontos zusammen mit einem SAS-Token für das Konto angeben. Auf diese Weise können Kosten in ein Speicherkonto in jedem Mandanten exportiert werden. Das SAS-Token sollte für den BLOB-Dienst mit Dienst-/Container-/Objektressourcentypen und mit Lese-/Schreibzugriff/Delete/List/Add/Create-Berechtigungen 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 Serienzeitplan.
ExportRun

Ein Exportlauf.
ExportSchedule

Der mit dem Export verknüpfte Zeitplan.
ExportTimePeriod

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

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

Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
GranularityType

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

Die Terminserie.
StatusType

Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.
SystemAssignedServiceIdentity

Identität des verwalteten Diensts (entweder vom System zugewiesen oder ohne)
SystemAssignedServiceIdentityType

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

Der Zeitrahmen zum Abrufen 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

Weist die Definition für den Export auf.
deliveryInfo

ExportDeliveryInfo

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

FormatType

Das Format des zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.
nextRunTimeEstimate

string

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

boolean

Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
runHistory

ExportExecutionListResult

Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.

ErrorDetails

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Fehlercode.
message

string

Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

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

Einige Fehlerantworten:

  • 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

  • 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

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 das Szenario für gleichzeitige Updates zu behandeln, 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

Ressourcenname.
properties.definition

ExportDefinition

Weist die Definition für den Export auf.
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, wird eine Schätzung der nächsten Laufzeit bereitgestellt.
properties.partitionData

boolean

Bei Festlegung auf "true" werden exportierte Daten nach Größe partitioniert und in einem BLOB-Verzeichnis zusammen mit einer Manifestdatei platziert. Hinweis: Diese Option ist derzeit nur für Microsoft Customer Agreement Commerce-Bereiche verfügbar.
properties.runHistory

ExportExecutionListResult

Falls angefordert, weist den letzten Ausführungsverlauf für den Export auf.
properties.schedule

ExportSchedule

Enthält Zeitplaninformationen für den Export.
type

string

Ressourcentyp.

ExportDataset

Die Definition für Daten im Export.

Name Typ Beschreibung
configuration

ExportDatasetConfiguration

Die Konfiguration des Export-Datasets.
granularity

GranularityType

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

ExportDatasetConfiguration

Die Konfiguration des Export-Datasets. 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 im Export enthalten sein 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

Hat einen Zeitraum für das Abrufen von Daten für den Export.
timeframe

TimeframeType

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

ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" gleichbedeutend mit "ActualCost" ist 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 BLOB-Speicherkontos dar, an den Exporte von Kosten übermittelt werden. Es gibt zwei Möglichkeiten zum Konfigurieren des Ziels. Der für die meisten Kunden empfohlene Ansatz besteht darin, die resourceId des Speicherkontos anzugeben. Dies erfordert eine einmalige Registrierung des Kontoabonnements beim Microsoft.CostManagementExports-Ressourcenanbieter, um Kostenverwaltungsdienste 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 Agreement-Plan verfügbar, der globale Administratoren ihres Abrechnungskontos sind. Diese Partner können anstelle der resourceId eines Speicherkontos den Namen des Speicherkontos zusammen mit einem SAS-Token für das Konto angeben. Auf diese Weise können Kosten in ein Speicherkonto in jedem Mandanten exportiert werden. Das SAS-Token sollte für den BLOB-Dienst mit Dienst-/Container-/Objektressourcentypen und mit Lese-/Schreibzugriff/Delete/List/Add/Create-Berechtigungen 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 dem Exporte übermittelt werden. Dies ist nicht erforderlich, wenn ein sasToken und storageAccount angegeben sind.
rootFolderPath

string

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

string

Ein SAS-Token für das Speicherkonto. Für einen eingeschränkten Satz 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. Das Zurückgeben 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, für das Exporte hochgeladen werden. Für einen eingeschränkten Satz 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 Serienzeitplan.

Name Typ Beschreibung
from

string

Das Startdatum der Serie.
to

string

Das Enddatum der Serie.

ExportRun

Ein Exportlauf.

Name Typ Beschreibung
eTag

string

eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id

string

Ressourcen-ID.
name

string

Ressourcenname.
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 der Exportvorgang abgeschlossen ist.
properties.processingStartTime

string

Die Zeit, zu der der Export aufgenommen wurde, um ausgeführt zu werden.
properties.runSettings

CommonExportProperties

Die Exporteinstellungen, die für diese Ausführung wirksam 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 Benutzer-E-Mail. Bei geplanten Ausführungen ist es "System".
properties.submittedTime

string

Die Zeit, zu der der Export in die Warteschlange gestellt wurde, um ausgeführt zu werden.
type

string

Ressourcentyp.

ExportSchedule

Der mit dem Export verknüpfte Zeitplan.

Name Typ Beschreibung
recurrence

RecurrenceType

Die Terminserie.
recurrencePeriod

ExportRecurrencePeriod

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

StatusType

Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.

ExportTimePeriod

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

Name Typ Beschreibung
from

string

Das Startdatum für Exportdaten.
to

string

Das Enddatum für exportdaten.

ExportType

Der Typ des Exports. Beachten Sie, dass "Usage" gleichbedeutend mit "ActualCost" ist 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 zugestellten Exports. Derzeit wird nur 'CSV' unterstützt.

Name Typ Beschreibung
Csv

string

GranularityType

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

Name Typ Beschreibung
Daily

string

RecurrenceType

Die Terminserie.

Name Typ Beschreibung
Annually

string

Daily

string

Monthly

string

Weekly

string

StatusType

Der Status des Exportzeitplans. Wenn "Inaktiv" ist der Exportzeitplan angehalten.

Name Typ Beschreibung
Active

string

Inactive

string

SystemAssignedServiceIdentity

Identität des verwalteten Diensts (entweder vom System zugewiesen oder ohne)

Name Typ Beschreibung
principalId

string

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

string

Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System 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 zum Abrufen 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