Exports - Create Or Update

  • Reference
Služba:
Cost Management
Verze rozhraní API:
2024-08-01

Operace pro vytvoření nebo aktualizaci exportu. Operace aktualizace vyžaduje nastavení nejnovější značky eTag v požadavku. Nejnovější eTag můžete získat provedením operace get. Operace vytvoření nevyžaduje eTag.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
exportName
 path True

string

Název exportu
scope
 path True

string

Obor přidružený k operacím exportu. To zahrnuje předplatné /subscriptions/{subscriptionId}/' pro rozsah předplatného. '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' pro obor resourceGroup, /providers/Microsoft.Billing/billingAccounts/{billingAccountId} pro rozsah fakturačního účtu a /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId} pro obor oddělení, /providers/Microsoft.Billing/billingAccounts/{billingAccounts}/enrollmentAccounts/{ enrollmentAccountId} pro obor EnrollmentAccount, /providers/Microsoft.Management/managementGroups/{managementGroupId} pro obor skupiny pro správu, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} pro rozsah billingProfile, /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' pro rozsah invoiceSection a /providers/Microsoft. Fakturace/billingAccounts/{billingAccountId}/customers/{customerId} specifická pro partnery.
api-version
 query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Vyžadováno Typ Description
properties.definition True

ExportDefinition

Má definici pro export.
properties.deliveryInfo True

ExportDeliveryInfo

Obsahuje informace o doručení pro export.
eTag

string

eTag prostředku. Pro zpracování scénáře souběžné aktualizace se toto pole použije k určení, jestli uživatel aktualizuje nejnovější verzi, nebo ne.
identity

SystemAssignedServiceIdentity

Spravovaná identita přidružená k exportu
location

string

Umístění spravované identity exportu. Vyžaduje se pouze při využití spravované identity.
properties.format

FormatType

Formát doručované exportu. V současné době se podporuje jenom csv.
properties.partitionData

boolean

Pokud je nastavená hodnota true, exportovaná data se rozdělí podle velikosti a umístí se do adresáře objektů blob společně se souborem manifestu. Poznámka: Tato možnost je aktuálně dostupná jenom pro rozsahy obchodu se smlouvou se zákazníkem Microsoftu.
properties.runHistory

ExportExecutionListResult

Pokud je to požadováno, obsahuje nejnovější historii spuštění pro export.
properties.schedule

ExportSchedule

Obsahuje informace o plánu exportu.

Odpovědi

Name Typ Description
200 OK

Export

OK. Požadavek byl úspěšný.
201 Created

Export

Vytvořil.
Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

ExportCreateOrUpdateByBillingAccount
ExportCreateOrUpdateByDepartment
ExportCreateOrUpdateByEnrollmentAccount
ExportCreateOrUpdateByManagementGroup
ExportCreateOrUpdateByResourceGroup
ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  }
}
Stavový kód:
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"
          ]
        }
      }
    }
  }
}

Definice

Name Description
CommonExportProperties

Společné vlastnosti exportu.
ErrorDetails

Podrobnosti o chybě.
ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

  • 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

  • 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
ExecutionStatus

Poslední známý stav spuštění exportu.
ExecutionType

Typ spuštění exportu.
Export

Prostředek exportu.
ExportDataset

Definice dat v exportu.
ExportDatasetConfiguration

Konfigurace exportu datové sady Umožňuje výběr sloupců pro export. Pokud není zadaný, export bude obsahovat všechny dostupné sloupce.
ExportDefinition

Definice exportu.
ExportDeliveryDestination

Představuje umístění účtu úložiště objektů blob, kde se budou doručovat exporty nákladů. Cíl můžete nakonfigurovat dvěma způsoby. Doporučeným přístupem pro většinu zákazníků je zadat ID prostředku účtu úložiště. To vyžaduje jednorázovou registraci předplatného účtu u poskytovatele prostředků Microsoft.CostManagementExports, aby služba Cost Management získala přístup k úložišti. Při vytváření exportu na webu Azure Portal se tato registrace provádí automaticky, ale uživatelé rozhraní API možná budou muset předplatné zaregistrovat explicitně (další informace najdete v tématu https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Další způsob konfigurace cíle je k dispozici pouze partnerům s plánem smlouvy s partnerem Microsoftu, kteří jsou globálními správci svého fakturačního účtu. Tito partneři můžou místo zadání ID prostředku účtu úložiště zadat název účtu úložiště spolu s tokenem SAS pro daný účet. To umožňuje export nákladů do účtu úložiště v libovolném tenantovi. Token SAS by se měl vytvořit pro službu blob se službou Service, kontejnerem nebo objektovými typy prostředků a s oprávněními ke čtení, zápisu, odstranění, přidání nebo vytvoření (další informace najdete v tématu https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).
ExportDeliveryInfo

Informace o doručení přidružené k exportu.
ExportExecutionListResult

Výsledek výpisu historie spuštění exportu
ExportRecurrencePeriod

Počáteční a koncové datum pro plán opakování.
ExportRun

Spuštění exportu
ExportSchedule

Plán přidružený k exportu.
ExportTimePeriod

Rozsah kalendářních dat pro data v exportu Tento parametr by měl být zadán pouze s časovým rámcem nastaveným na Vlastní. Maximální rozsah dat je 3 měsíce.
ExportType

Typ exportu. Všimněte si, že "Usage" je ekvivalentní "ActualCost" a vztahuje se na exporty, které ještě neposkytují data za poplatky nebo amortizaci rezervací služeb.
FormatType

Formát doručované exportu. V současné době se podporuje jenom csv.
GranularityType

Členitost řádků v exportu V současné době se podporuje jenom denní.
RecurrenceType

Opakování plánu.
StatusType

Stav plánu exportu Pokud je neaktivní, plán exportu se pozastaví.
SystemAssignedServiceIdentity

Identita spravované služby (přiřazená systémem nebo žádná)
SystemAssignedServiceIdentityType

Typ identity spravované služby (přiřazený systémem nebo žádný).
TimeframeType

Časový rámec pro vyžádání dat pro export. Pokud je vlastní, je nutné zadat konkrétní časové období.

CommonExportProperties

Společné vlastnosti exportu.

Name Typ Description
definition

ExportDefinition

Má definici pro export.
deliveryInfo

ExportDeliveryInfo

Obsahuje informace o doručení pro export.
format

FormatType

Formát doručované exportu. V současné době se podporuje jenom csv.
nextRunTimeEstimate

string

Pokud má export aktivní plán, poskytne odhad příštího běhu.
partitionData

boolean

Pokud je nastavená hodnota true, exportovaná data se rozdělí podle velikosti a umístí se do adresáře objektů blob společně se souborem manifestu. Poznámka: Tato možnost je aktuálně dostupná jenom pro rozsahy obchodu se smlouvou se zákazníkem Microsoftu.
runHistory

ExportExecutionListResult

Pokud je to požadováno, obsahuje nejnovější historii spuštění pro export.

ErrorDetails

Podrobnosti o chybě.

Name Typ Description
code

string

Kód chyby
message

string

Chybová zpráva označující, proč operace selhala.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

  • 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

  • 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name Typ Description
error

ErrorDetails

Podrobnosti o chybě.

ExecutionStatus

Poslední známý stav spuštění exportu.

Name Typ Description
Completed

string

DataNotAvailable

string

Failed

string

InProgress

string

NewDataNotAvailable

string

Queued

string

Timeout

string

ExecutionType

Typ spuštění exportu.

Name Typ Description
OnDemand

string

Scheduled

string

Export

Prostředek exportu.

Name Typ Description
eTag

string

eTag prostředku. Pro zpracování scénáře souběžné aktualizace se toto pole použije k určení, jestli uživatel aktualizuje nejnovější verzi, nebo ne.
id

string

ID prostředku.
identity

SystemAssignedServiceIdentity

Spravovaná identita přidružená k exportu
location

string

Umístění spravované identity exportu. Vyžaduje se pouze při využití spravované identity.
name

string

Název prostředku
properties.definition

ExportDefinition

Má definici pro export.
properties.deliveryInfo

ExportDeliveryInfo

Obsahuje informace o doručení pro export.
properties.format

FormatType

Formát doručované exportu. V současné době se podporuje jenom csv.
properties.nextRunTimeEstimate

string

Pokud má export aktivní plán, poskytne odhad příštího běhu.
properties.partitionData

boolean

Pokud je nastavená hodnota true, exportovaná data se rozdělí podle velikosti a umístí se do adresáře objektů blob společně se souborem manifestu. Poznámka: Tato možnost je aktuálně dostupná jenom pro rozsahy obchodu se smlouvou se zákazníkem Microsoftu.
properties.runHistory

ExportExecutionListResult

Pokud je to požadováno, obsahuje nejnovější historii spuštění pro export.
properties.schedule

ExportSchedule

Obsahuje informace o plánu exportu.
type

string

Typ prostředku.

ExportDataset

Definice dat v exportu.

Name Typ Description
configuration

ExportDatasetConfiguration

Konfigurace exportu datové sady
granularity

GranularityType

Členitost řádků v exportu V současné době se podporuje jenom denní.

ExportDatasetConfiguration

Konfigurace exportu datové sady Umožňuje výběr sloupců pro export. Pokud není zadaný, export bude obsahovat všechny dostupné sloupce.

Name Typ Description
columns

string[]

Pole názvů sloupců, které se mají zahrnout do exportu. Pokud není zadaný, export bude obsahovat všechny dostupné sloupce. Dostupné sloupce se můžou lišit podle kanálu zákazníka (viz příklady).

ExportDefinition

Definice exportu.

Name Typ Description
dataSet

ExportDataset

Definice dat v exportu.
timePeriod

ExportTimePeriod

Má časové období pro vyžádání dat pro export.
timeframe

TimeframeType

Časový rámec pro vyžádání dat pro export. Pokud je vlastní, je nutné zadat konkrétní časové období.
type

ExportType

Typ exportu. Všimněte si, že "Usage" je ekvivalentní "ActualCost" a vztahuje se na exporty, které ještě neposkytují data za poplatky nebo amortizaci rezervací služeb.

ExportDeliveryDestination

Představuje umístění účtu úložiště objektů blob, kde se budou doručovat exporty nákladů. Cíl můžete nakonfigurovat dvěma způsoby. Doporučeným přístupem pro většinu zákazníků je zadat ID prostředku účtu úložiště. To vyžaduje jednorázovou registraci předplatného účtu u poskytovatele prostředků Microsoft.CostManagementExports, aby služba Cost Management získala přístup k úložišti. Při vytváření exportu na webu Azure Portal se tato registrace provádí automaticky, ale uživatelé rozhraní API možná budou muset předplatné zaregistrovat explicitně (další informace najdete v tématu https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Další způsob konfigurace cíle je k dispozici pouze partnerům s plánem smlouvy s partnerem Microsoftu, kteří jsou globálními správci svého fakturačního účtu. Tito partneři můžou místo zadání ID prostředku účtu úložiště zadat název účtu úložiště spolu s tokenem SAS pro daný účet. To umožňuje export nákladů do účtu úložiště v libovolném tenantovi. Token SAS by se měl vytvořit pro službu blob se službou Service, kontejnerem nebo objektovými typy prostředků a s oprávněními ke čtení, zápisu, odstranění, přidání nebo vytvoření (další informace najdete v tématu https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).

Name Typ Description
container

string

Název kontejneru, ve kterém se exporty nahrají. Pokud kontejner neexistuje, vytvoří se.
resourceId

string

ID prostředku účtu úložiště, do kterého se exporty doručí. To se nevyžaduje, pokud je zadán sasToken a storageAccount.
rootFolderPath

string

Název adresáře, do kterého se exporty nahrají.
sasToken

string

Token SAS pro účet úložiště. Pro omezenou sadu zákazníků Azure je možné místo id prostředku zadat parametr storageAccount. Poznámka: Hodnota vrácená rozhraním API pro tuto vlastnost bude vždy obfuskována. Vrácení stejné obfuskované hodnoty nebude mít za následek aktualizaci tokenu SAS. Chcete-li tuto hodnotu aktualizovat, musí být zadán nový token SAS.
storageAccount

string

Účet úložiště, do kterého se exporty nahrají. Pro omezenou sadu zákazníků Azure je možné místo id prostředku zadat sasToken.

ExportDeliveryInfo

Informace o doručení přidružené k exportu.

Name Typ Description
destination

ExportDeliveryDestination

Má cíl pro doručení exportu.

ExportExecutionListResult

Výsledek výpisu historie spuštění exportu

Name Typ Description
value

ExportRun[]

Seznam spuštění exportu

ExportRecurrencePeriod

Počáteční a koncové datum pro plán opakování.

Name Typ Description
from

string

Počáteční datum opakování.
to

string

Koncové datum opakování.

ExportRun

Spuštění exportu

Name Typ Description
eTag

string

eTag prostředku. Pro zpracování scénáře souběžné aktualizace se toto pole použije k určení, jestli uživatel aktualizuje nejnovější verzi, nebo ne.
id

string

ID prostředku.
name

string

Název prostředku
properties.error

ErrorDetails

Podrobnosti o jakékoli chybě.
properties.executionType

ExecutionType

Typ spuštění exportu.
properties.fileName

string

Název exportovaného souboru.
properties.processingEndTime

string

Čas dokončení exportu
properties.processingStartTime

string

Čas, kdy se export vyzvedl, aby se spustil.
properties.runSettings

CommonExportProperties

Nastavení exportu, která se pro toto spuštění projevila.
properties.status

ExecutionStatus

Poslední známý stav spuštění exportu.
properties.submittedBy

string

Identifikátor entity, která aktivovala export. Pro spuštění na vyžádání se jedná o e-mail uživatele. Pro naplánovaná spuštění se jedná o systém.
properties.submittedTime

string

Čas, kdy se export zařadil do fronty, aby se spustil.
type

string

Typ prostředku.

ExportSchedule

Plán přidružený k exportu.

Name Typ Description
recurrence

RecurrenceType

Opakování plánu.
recurrencePeriod

ExportRecurrencePeriod

Má počáteční a koncové datum opakování. Počáteční datum musí být v budoucnu. Pokud je k dispozici, koncové datum musí být větší než počáteční datum.
status

StatusType

Stav plánu exportu Pokud je neaktivní, plán exportu se pozastaví.

ExportTimePeriod

Rozsah kalendářních dat pro data v exportu Tento parametr by měl být zadán pouze s časovým rámcem nastaveným na Vlastní. Maximální rozsah dat je 3 měsíce.

Name Typ Description
from

string

Počáteční datum exportu dat.
to

string

Koncové datum exportu dat.

ExportType

Typ exportu. Všimněte si, že "Usage" je ekvivalentní "ActualCost" a vztahuje se na exporty, které ještě neposkytují data za poplatky nebo amortizaci rezervací služeb.

Name Typ Description
ActualCost

string

AmortizedCost

string

Usage

string

FormatType

Formát doručované exportu. V současné době se podporuje jenom csv.

Name Typ Description
Csv

string

GranularityType

Členitost řádků v exportu V současné době se podporuje jenom denní.

Name Typ Description
Daily

string

RecurrenceType

Opakování plánu.

Name Typ Description
Annually

string

Daily

string

Monthly

string

Weekly

string

StatusType

Stav plánu exportu Pokud je neaktivní, plán exportu se pozastaví.

Name Typ Description
Active

string

Inactive

string

SystemAssignedServiceIdentity

Identita spravované služby (přiřazená systémem nebo žádná)

Name Typ Description
principalId

string

ID instančního objektu identity přiřazené systémem. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
tenantId

string

ID tenanta přiřazené identity systému. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
type

SystemAssignedServiceIdentityType

Typ identity spravované služby (přiřazený systémem nebo žádný).

SystemAssignedServiceIdentityType

Typ identity spravované služby (přiřazený systémem nebo žádný).

Name Typ Description
None

string

SystemAssigned

string

TimeframeType

Časový rámec pro vyžádání dat pro export. Pokud je vlastní, je nutné zadat konkrétní časové období.

Name Typ Description
BillingMonthToDate

string

Custom

string

MonthToDate

string

TheLastBillingMonth

string

TheLastMonth

string

WeekToDate

string