Exports - Create Or Update

Servizio:

Cost Management

Versione API:

2024-08-01

Operazione per creare o aggiornare un'esportazione. L'operazione di aggiornamento richiede l'impostazione dell'eTag più recente nella richiesta. È possibile ottenere l'eTag più recente eseguendo un'operazione get. L'operazione di creazione non richiede eTag.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
exportName	path	True	string	Nome esportazione.
scope	path	True	string	Ambito associato alle operazioni di esportazione. Sono inclusi '/subscriptions/{subscriptionId}/' per l'ambito della sottoscrizione, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per ambito resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' per ambito account di fatturazione e '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' per ambito reparto, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' per ambito EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} per ambito gruppo di gestione, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' per ambito billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' per l'ambito invoiceSection e '/providers/Microsoft. Fatturazione/billingAccounts/{billingAccountId}/customers/{customerId}' specifici per i partner.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.definition	True	ExportDefinition	Ha la definizione per l'esportazione.
properties.deliveryInfo	True	ExportDeliveryInfo	Contiene informazioni sul recapito per l'esportazione.
eTag		string	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.
identity		SystemAssignedServiceIdentity	Identità gestita associata all'esportazione
location		string	Posizione dell'identità gestita dell'esportazione. Obbligatorio solo quando si usa l'identità gestita.
properties.format		FormatType	Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".
properties.partitionData		boolean	Se impostato su true, i dati esportati verranno partizionati in base alle dimensioni e inseriti in una directory BLOB insieme a un file manifesto. Nota: questa opzione è attualmente disponibile solo per gli ambiti commerciali del Contratto del cliente Microsoft.
properties.runHistory		ExportExecutionListResult	Se richiesto, ha la cronologia di esecuzione più recente per l'esportazione.
properties.schedule		ExportSchedule	Contiene informazioni sulla pianificazione per l'esportazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Export	OK. La richiesta ha avuto esito positivo.
201 Created	Export	Creato.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport",
  "name": "TestExport",
  "type": "Microsoft.CostManagement/exports",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "location": "centralus",
  "properties": {
    "schedule": {
      "status": "Active",
      "recurrence": "Weekly",
      "recurrencePeriod": {
        "from": "2020-06-01T00:00:00Z",
        "to": "2020-10-31T00:00:00Z"
      }
    },
    "format": "Csv",
    "deliveryInfo": {
      "destination": {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Storage/storageAccounts/ccmeastusdiag182",
        "container": "exports",
        "rootFolderPath": "ad-hoc"
      }
    },
    "definition": {
      "type": "ActualCost",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "configuration": {
          "columns": [
            "Date",
            "MeterId",
            "ResourceId",
            "ResourceLocation",
            "Quantity"
          ]
        }
      }
    }
  }
}

Definizioni

Nome	Descrizione
CommonExportProperties	Proprietà comuni dell'esportazione.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
ExecutionStatus	Ultimo stato noto dell'esecuzione dell'esportazione.
ExecutionType	Tipo dell'esecuzione dell'esportazione.
Export	Una risorsa di esportazione.
ExportDataset	Definizione per i dati nell'esportazione.
ExportDatasetConfiguration	Configurazione del set di dati di esportazione. Consente di selezionare le colonne per l'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili.
ExportDefinition	Definizione di un'esportazione.
ExportDeliveryDestination	Rappresenta il percorso dell'account di archiviazione BLOB in cui verranno recapitate le esportazioni dei costi. Esistono due modi per configurare la destinazione. L'approccio consigliato per la maggior parte dei clienti consiste nel specificare il valore resourceId dell'account di archiviazione. Ciò richiede una registrazione una tantum della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nel portale di Azure, questa registrazione viene eseguita automaticamente, ma gli utenti dell'API potrebbero dover registrare la sottoscrizione in modo esplicito (per altre informazioni, vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Un altro modo per configurare la destinazione è disponibile SOLO per i partner con un piano del Contratto Microsoft Partner che sono amministratori globali dell'account di fatturazione. Questi partner, invece di specificare il valore resourceId di un account di archiviazione, possono specificare il nome dell'account di archiviazione insieme a un token di firma di accesso condiviso per l'account. In questo modo è possibile esportare i costi in un account di archiviazione in qualsiasi tenant. Il token di firma di accesso condiviso deve essere creato per il servizio BLOB con tipi di risorse Service/Container/Object e con autorizzazioni lettura/scrittura/eliminazione/elenco/aggiunta/creazione (per altre informazioni, vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).
ExportDeliveryInfo	Informazioni sul recapito associate a un'esportazione.
ExportExecutionListResult	Risultato dell'elenco della cronologia di esecuzione di un'esportazione.
ExportRecurrencePeriod	Data di inizio e fine per la pianificazione della ricorrenza.
ExportRun	Esecuzione di esportazione.
ExportSchedule	Pianificazione associata all'esportazione.
ExportTimePeriod	Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con intervallo di tempo impostato su "Personalizzato". L'intervallo di date massimo è di 3 mesi.
ExportType	Tipo dell'esportazione. Si noti che "Usage" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per gli addebiti o l'ammortamento per le prenotazioni del servizio.
FormatType	Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".
GranularityType	Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".
RecurrenceType	Ricorrenza della pianificazione.
StatusType	Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa.
SystemAssignedServiceIdentity	Identità del servizio gestito (assegnata dal sistema o nessuna)
SystemAssignedServiceIdentityType	Tipo di identità del servizio gestito (assegnata dal sistema o nessuna).
TimeframeType	Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.

CommonExportProperties

Proprietà comuni dell'esportazione.

Nome	Tipo	Descrizione
definition	ExportDefinition	Ha la definizione per l'esportazione.
deliveryInfo	ExportDeliveryInfo	Contiene informazioni sul recapito per l'esportazione.
format	FormatType	Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".
nextRunTimeEstimate	string	Se l'esportazione ha una pianificazione attiva, fornisce una stima del tempo di esecuzione successivo.
partitionData	boolean	Se impostato su true, i dati esportati verranno partizionati in base alle dimensioni e inseriti in una directory BLOB insieme a un file manifesto. Nota: questa opzione è attualmente disponibile solo per gli ambiti commerciali del Contratto del cliente Microsoft.
runHistory	ExportExecutionListResult	Se richiesto, ha la cronologia di esecuzione più recente per l'esportazione.

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

• 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

ExecutionStatus

Ultimo stato noto dell'esecuzione dell'esportazione.

Nome	Tipo	Descrizione
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Tipo dell'esecuzione dell'esportazione.

Nome	Tipo	Descrizione
OnDemand	string
Scheduled	string

Export

Una risorsa di esportazione.

Nome	Tipo	Descrizione
eTag	string	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.
id	string	ID risorsa.
identity	SystemAssignedServiceIdentity	Identità gestita associata all'esportazione
location	string	Posizione dell'identità gestita dell'esportazione. Obbligatorio solo quando si usa l'identità gestita.
name	string	Nome risorsa.
properties.definition	ExportDefinition	Ha la definizione per l'esportazione.
properties.deliveryInfo	ExportDeliveryInfo	Contiene informazioni sul recapito per l'esportazione.
properties.format	FormatType	Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".
properties.nextRunTimeEstimate	string	Se l'esportazione ha una pianificazione attiva, fornisce una stima del tempo di esecuzione successivo.
properties.partitionData	boolean	Se impostato su true, i dati esportati verranno partizionati in base alle dimensioni e inseriti in una directory BLOB insieme a un file manifesto. Nota: questa opzione è attualmente disponibile solo per gli ambiti commerciali del Contratto del cliente Microsoft.
properties.runHistory	ExportExecutionListResult	Se richiesto, ha la cronologia di esecuzione più recente per l'esportazione.
properties.schedule	ExportSchedule	Contiene informazioni sulla pianificazione per l'esportazione.
type	string	Tipo di risorsa.

ExportDataset

Definizione per i dati nell'esportazione.

Nome	Tipo	Descrizione
configuration	ExportDatasetConfiguration	Configurazione del set di dati di esportazione.
granularity	GranularityType	Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".

ExportDatasetConfiguration

Configurazione del set di dati di esportazione. Consente di selezionare le colonne per l'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili.

Nome	Tipo	Descrizione
columns	string[]	Matrice di nomi di colonna da includere nell'esportazione. Se non specificato, l'esportazione includerà tutte le colonne disponibili. Le colonne disponibili possono variare in base al canale del cliente (vedere esempi).

ExportDefinition

Definizione di un'esportazione.

Nome	Tipo	Descrizione
dataSet	ExportDataset	Definizione per i dati nell'esportazione.
timePeriod	ExportTimePeriod	Periodo di tempo per il pull dei dati per l'esportazione.
timeframe	TimeframeType	Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.
type	ExportType	Tipo dell'esportazione. Si noti che "Usage" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per gli addebiti o l'ammortamento per le prenotazioni del servizio.

ExportDeliveryDestination

Rappresenta il percorso dell'account di archiviazione BLOB in cui verranno recapitate le esportazioni dei costi. Esistono due modi per configurare la destinazione. L'approccio consigliato per la maggior parte dei clienti consiste nel specificare il valore resourceId dell'account di archiviazione. Ciò richiede una registrazione una tantum della sottoscrizione dell'account con il provider di risorse Microsoft.CostManagementExports per concedere ai servizi gestione costi l'accesso all'archiviazione. Quando si crea un'esportazione nel portale di Azure, questa registrazione viene eseguita automaticamente, ma gli utenti dell'API potrebbero dover registrare la sottoscrizione in modo esplicito (per altre informazioni, vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Un altro modo per configurare la destinazione è disponibile SOLO per i partner con un piano del Contratto Microsoft Partner che sono amministratori globali dell'account di fatturazione. Questi partner, invece di specificare il valore resourceId di un account di archiviazione, possono specificare il nome dell'account di archiviazione insieme a un token di firma di accesso condiviso per l'account. In questo modo è possibile esportare i costi in un account di archiviazione in qualsiasi tenant. Il token di firma di accesso condiviso deve essere creato per il servizio BLOB con tipi di risorse Service/Container/Object e con autorizzazioni lettura/scrittura/eliminazione/elenco/aggiunta/creazione (per altre informazioni, vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).

Nome	Tipo	Descrizione
container	string	Nome del contenitore in cui verranno caricate le esportazioni. Se il contenitore non esiste, verrà creato.
resourceId	string	ID risorsa dell'account di archiviazione in cui verranno recapitate le esportazioni. Questa operazione non è necessaria se vengono specificati sasToken e storageAccount.
rootFolderPath	string	Nome della directory in cui verranno caricate le esportazioni.
sasToken	string	Token di firma di accesso condiviso per l'account di archiviazione. Per un set limitato di clienti di Azure, questo insieme a storageAccount può essere specificato invece di resourceId. Nota: il valore restituito dall'API per questa proprietà verrà sempre offuscato. La restituzione dello stesso valore offuscato non comporterà l'aggiornamento del token di firma di accesso condiviso. Per aggiornare questo valore, è necessario specificare un nuovo token di firma di accesso condiviso.
storageAccount	string	Account di archiviazione in cui verranno caricate le esportazioni. Per un set limitato di clienti di Azure, questo insieme a sasToken può essere specificato invece di resourceId.

ExportDeliveryInfo

Informazioni sul recapito associate a un'esportazione.

Nome	Tipo	Descrizione
destination	ExportDeliveryDestination	Destinazione dell'esportazione recapitata.

ExportExecutionListResult

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

Nome	Tipo	Descrizione
value	ExportRun[]	Elenco di esecuzioni di esportazione.

ExportRecurrencePeriod

Data di inizio e fine per la pianificazione della ricorrenza.

Nome	Tipo	Descrizione
from	string	Data di inizio della ricorrenza.
to	string	Data di fine della ricorrenza.

ExportRun

Esecuzione di esportazione.

Nome	Tipo	Descrizione
eTag	string	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.
id	string	ID risorsa.
name	string	Nome risorsa.
properties.error	ErrorDetails	Dettagli di qualsiasi errore.
properties.executionType	ExecutionType	Tipo dell'esecuzione dell'esportazione.
properties.fileName	string	Nome del file esportato.
properties.processingEndTime	string	Ora di fine dell'esecuzione dell'esportazione.
properties.processingStartTime	string	Ora in cui l'esportazione è stata prelevata per l'esecuzione.
properties.runSettings	CommonExportProperties	Impostazioni di esportazione applicate per l'esecuzione.
properties.status	ExecutionStatus	Ultimo stato noto dell'esecuzione dell'esportazione.
properties.submittedBy	string	Identificatore dell'entità che ha attivato l'esportazione. Per l'esecuzione su richiesta, si tratta del messaggio di posta elettronica dell'utente. Per le esecuzioni pianificate, è "System".
properties.submittedTime	string	Ora in cui l'esportazione è stata accodata per l'esecuzione.
type	string	Tipo di risorsa.

ExportSchedule

Pianificazione associata all'esportazione.

Nome	Tipo	Descrizione
recurrence	RecurrenceType	Ricorrenza della pianificazione.
recurrencePeriod	ExportRecurrencePeriod	Ha la data di inizio e di fine della ricorrenza. La data di inizio deve essere futura. Se presente, la data di fine deve essere maggiore della data di inizio.
status	StatusType	Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa.

ExportTimePeriod

Intervallo di date per i dati nell'esportazione. Questa opzione deve essere specificata solo con intervallo di tempo impostato su "Personalizzato". L'intervallo di date massimo è di 3 mesi.

Nome	Tipo	Descrizione
from	string	Data di inizio per l'esportazione dei dati.
to	string	Data di fine per l'esportazione dei dati.

ExportType

Tipo dell'esportazione. Si noti che "Usage" equivale a "ActualCost" ed è applicabile alle esportazioni che non forniscono ancora dati per gli addebiti o l'ammortamento per le prenotazioni del servizio.

Nome	Tipo	Descrizione
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

Formato dell'esportazione recapitata. Attualmente è supportato solo "Csv".

Nome	Tipo	Descrizione
Csv	string

GranularityType

Granularità delle righe nell'esportazione. Attualmente è supportato solo "Daily".

Nome	Tipo	Descrizione
Daily	string

RecurrenceType

Ricorrenza della pianificazione.

Nome	Tipo	Descrizione
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

Stato della pianificazione dell'esportazione. Se "Inattivo", la pianificazione dell'esportazione viene sospesa.

Nome	Tipo	Descrizione
Active	string
Inactive	string

SystemAssignedServiceIdentity

Identità del servizio gestito (assegnata dal sistema o nessuna)

Nome	Tipo	Descrizione
principalId	string	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	SystemAssignedServiceIdentityType	Tipo di identità del servizio gestito (assegnata dal sistema o nessuna).

SystemAssignedServiceIdentityType

Tipo di identità del servizio gestito (assegnata dal sistema o nessuna).

Nome	Tipo	Descrizione
None	string
SystemAssigned	string

TimeframeType

Intervallo di tempo per il pull dei dati per l'esportazione. Se personalizzato, è necessario specificare un periodo di tempo specifico.

Nome	Tipo	Descrizione
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string