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

HTTP

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

HTTP

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

HTTP

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

HTTP

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

HTTP

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

HTTP

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

Sdílet prostřednictvím

Exports - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ExportCreateOrUpdateByBillingAccount

Ukázkový požadavek

Ukázková odpověď

ExportCreateOrUpdateByDepartment

Ukázkový požadavek

Ukázková odpověď

ExportCreateOrUpdateByEnrollmentAccount

Ukázkový požadavek

Ukázková odpověď

ExportCreateOrUpdateByManagementGroup

Ukázkový požadavek

Ukázková odpověď

ExportCreateOrUpdateByResourceGroup

Ukázkový požadavek

Ukázková odpověď

ExportCreateOrUpdateBySubscription

Ukázkový požadavek

Ukázková odpověď

Definice

CommonExportProperties

ErrorDetails

ErrorResponse

ExecutionStatus

ExecutionType

Export

ExportDataset

ExportDatasetConfiguration

ExportDefinition

ExportDeliveryDestination

ExportDeliveryInfo

ExportExecutionListResult

ExportRecurrencePeriod

ExportRun

ExportSchedule

ExportTimePeriod

ExportType

FormatType

GranularityType

RecurrenceType

StatusType

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

TimeframeType

Další materiály