Exports - Create Or Update

Référence

Service:: Cost Management

Version d'API:: 2024-08-01

Opération de création ou de mise à jour d’une exportation. L’opération de mise à jour nécessite la définition du dernier eTag dans la requête. Vous pouvez obtenir le dernier eTag en effectuant une opération get. L’opération de création ne nécessite pas d’eTag.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
exportName	path	True	string	Nom de l’exportation.
scope	path	True	string	Étendue associée aux opérations d’exportation. Cela inclut « /subscriptions/{subscriptionId} / » pour l’étendue de l’abonnement, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' pour l’étendue resourceGroup, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' pour l’étendue du compte de facturation et '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} pour l’étendue EnrollmentAccount, '/providers/Microsoft.Management/managementGroups/{managementGroupId} for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' pour l’étendue billingProfile, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' pour l’étendue invoiceSection et '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' spécifique aux partenaires.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.definition	True	ExportDefinition	A la définition de l’exportation.
properties.deliveryInfo	True	ExportDeliveryInfo	Contient des informations de remise pour l’exportation.
eTag		string	eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ sera utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non.
identity		SystemAssignedServiceIdentity	Identité managée associée à l’exportation
location		string	Emplacement de l’identité managée de l’exportation. Obligatoire uniquement lors de l’utilisation de l’identité managée.
properties.format		FormatType	Format de l’exportation en cours de remise. Actuellement, seul « Csv » est pris en charge.
properties.partitionData		boolean	Si la valeur est true, les données exportées sont partitionnés par taille et placées dans un répertoire d’objets blob avec un fichier manifeste. Remarque : cette option est actuellement disponible uniquement pour les étendues commerciales du Contrat client Microsoft.
properties.runHistory		ExportExecutionListResult	Si nécessaire, dispose de l’historique d’exécution le plus récent pour l’exportation.
properties.schedule		ExportSchedule	Contient des informations de planification pour l’exportation.

Réponses

Nom	Type	Description
200 OK	Export	D’ACCORD. La demande a réussi.
201 Created	Export	Créé.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

ExportCreateOrUpdateByBillingAccount

ExportCreateOrUpdateByDepartment

ExportCreateOrUpdateByEnrollmentAccount

ExportCreateOrUpdateByManagementGroup

ExportCreateOrUpdateByResourceGroup

ExportCreateOrUpdateBySubscription

ExportCreateOrUpdateByBillingAccount

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Code d’état:: 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"
          ]
        }
      }
    }
  }
}

Définitions

Nom	Description
CommonExportProperties	Propriétés communes de l’exportation.
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. Réponses d’erreur : 429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». 503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».
ExecutionStatus	Dernier état connu de l’exécution d’exportation.
ExecutionType	Type de l’exécution d’exportation.
Export	Ressource d’exportation.
ExportDataset	Définition des données dans l’exportation.
ExportDatasetConfiguration	Configuration du jeu de données d’exportation. Permet de sélectionner des colonnes pour l’exportation. Si elle n’est pas fournie, l’exportation inclut toutes les colonnes disponibles.
ExportDefinition	Définition d’une exportation.
ExportDeliveryDestination	Cela représente l’emplacement du compte de stockage d’objets blob où les exportations de coûts seront livrées. Il existe deux façons de configurer la destination. L’approche recommandée pour la plupart des clients consiste à spécifier l’ID de ressource du compte de stockage. Cela nécessite une inscription ponctuelle de l’abonnement du compte auprès du fournisseur de ressources Microsoft.CostManagementExports pour permettre aux services Cost Management d’accéder au stockage. Lors de la création d’une exportation dans le portail Azure, cette inscription est effectuée automatiquement, mais les utilisateurs de l’API peuvent avoir besoin d’inscrire explicitement l’abonnement (pour plus d’informations, consultez https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Une autre façon de configurer la destination est disponible uniquement pour les partenaires disposant d’un plan contrat partenaire Microsoft qui sont des administrateurs généraux de leur compte de facturation. Ces partenaires, au lieu de spécifier l’ID de ressource d’un compte de stockage, peuvent spécifier le nom du compte de stockage ainsi qu’un jeton SAP pour le compte. Cela permet d’exporter des coûts vers un compte de stockage dans n’importe quel locataire. Le jeton SAP doit être créé pour le service blob avec les types de ressources Service/Container/Object et avec les autorisations Lecture/Écriture/Supprimer/List/Ajouter/Créer (pour plus d’informations, voir https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).
ExportDeliveryInfo	Informations de remise associées à une exportation.
ExportExecutionListResult	Résultat de la liste de l’historique des exécutions d’une exportation.
ExportRecurrencePeriod	Date de début et de fin de la planification de périodicité.
ExportRun	Exécution d’exportation.
ExportSchedule	Planification associée à l’exportation.
ExportTimePeriod	Plage de dates pour les données de l’exportation. Cela ne doit être spécifié que si le timeFrame est défini sur « Personnalisé ». La plage de dates maximale est de 3 mois.
ExportType	Type de l’exportation. Notez que « Utilisation » équivaut à « ActualCost » et s’applique aux exportations qui ne fournissent pas encore de données pour les frais ou l’amortissement des réservations de service.
FormatType	Format de l’exportation en cours de remise. Actuellement, seul « Csv » est pris en charge.
GranularityType	Granularité des lignes de l’exportation. Actuellement, seul « Quotidien » est pris en charge.
RecurrenceType	Périodicité de la planification.
StatusType	État de la planification de l’exportation. Si elle est inactive, la planification de l’exportation est suspendue.
SystemAssignedServiceIdentity	Identité de service managée (affectée par le système ou aucun)
SystemAssignedServiceIdentityType	Type d’identité de service managé (soit le système affecté, soit aucun).
TimeframeType	Délai d’extraction des données pour l’exportation. Si elle est personnalisée, une période spécifique doit être fournie.

CommonExportProperties

Propriétés communes de l’exportation.

Nom	Type	Description
definition	ExportDefinition	A la définition de l’exportation.
deliveryInfo	ExportDeliveryInfo	Contient des informations de remise pour l’exportation.
format	FormatType	Format de l’exportation en cours de remise. Actuellement, seul « Csv » est pris en charge.
nextRunTimeEstimate	string	Si l’exportation a une planification active, fournit une estimation de la prochaine exécution.
partitionData	boolean	Si la valeur est true, les données exportées sont partitionnés par taille et placées dans un répertoire d’objets blob avec un fichier manifeste. Remarque : cette option est actuellement disponible uniquement pour les étendues commerciales du Contrat client Microsoft.
runHistory	ExportExecutionListResult	Si nécessaire, dispose de l’historique d’exécution le plus récent pour l’exportation.

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Réponses d’erreur :

429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ».
503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

ExecutionStatus

Dernier état connu de l’exécution d’exportation.

Nom	Type	Description
Completed	string
DataNotAvailable	string
Failed	string
InProgress	string
NewDataNotAvailable	string
Queued	string
Timeout	string

ExecutionType

Type de l’exécution d’exportation.

Nom	Type	Description
OnDemand	string
Scheduled	string

Export

Ressource d’exportation.

Nom	Type	Description
eTag	string	eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ sera utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non.
id	string	ID de ressource.
identity	SystemAssignedServiceIdentity	Identité managée associée à l’exportation
location	string	Emplacement de l’identité managée de l’exportation. Obligatoire uniquement lors de l’utilisation de l’identité managée.
name	string	Nom de la ressource.
properties.definition	ExportDefinition	A la définition de l’exportation.
properties.deliveryInfo	ExportDeliveryInfo	Contient des informations de remise pour l’exportation.
properties.format	FormatType	Format de l’exportation en cours de remise. Actuellement, seul « Csv » est pris en charge.
properties.nextRunTimeEstimate	string	Si l’exportation a une planification active, fournit une estimation de la prochaine exécution.
properties.partitionData	boolean	Si la valeur est true, les données exportées sont partitionnés par taille et placées dans un répertoire d’objets blob avec un fichier manifeste. Remarque : cette option est actuellement disponible uniquement pour les étendues commerciales du Contrat client Microsoft.
properties.runHistory	ExportExecutionListResult	Si nécessaire, dispose de l’historique d’exécution le plus récent pour l’exportation.
properties.schedule	ExportSchedule	Contient des informations de planification pour l’exportation.
type	string	Type de ressource.

ExportDataset

Définition des données dans l’exportation.

Nom	Type	Description
configuration	ExportDatasetConfiguration	Configuration du jeu de données d’exportation.
granularity	GranularityType	Granularité des lignes de l’exportation. Actuellement, seul « Quotidien » est pris en charge.

ExportDatasetConfiguration

Configuration du jeu de données d’exportation. Permet de sélectionner des colonnes pour l’exportation. Si elle n’est pas fournie, l’exportation inclut toutes les colonnes disponibles.

Nom	Type	Description
columns	string[]	Tableau de noms de colonnes à inclure dans l’exportation. Si elle n’est pas fournie, l’exportation inclut toutes les colonnes disponibles. Les colonnes disponibles peuvent varier selon le canal client (voir des exemples).

ExportDefinition

Définition d’une exportation.

Nom	Type	Description
dataSet	ExportDataset	Définition des données dans l’exportation.
timePeriod	ExportTimePeriod	Période pendant laquelle les données d’extraction sont extraites pour l’exportation.
timeframe	TimeframeType	Délai d’extraction des données pour l’exportation. Si elle est personnalisée, une période spécifique doit être fournie.
type	ExportType	Type de l’exportation. Notez que « Utilisation » équivaut à « ActualCost » et s’applique aux exportations qui ne fournissent pas encore de données pour les frais ou l’amortissement des réservations de service.

ExportDeliveryDestination

Cela représente l’emplacement du compte de stockage d’objets blob où les exportations de coûts seront livrées. Il existe deux façons de configurer la destination. L’approche recommandée pour la plupart des clients consiste à spécifier l’ID de ressource du compte de stockage. Cela nécessite une inscription ponctuelle de l’abonnement du compte auprès du fournisseur de ressources Microsoft.CostManagementExports pour permettre aux services Cost Management d’accéder au stockage. Lors de la création d’une exportation dans le portail Azure, cette inscription est effectuée automatiquement, mais les utilisateurs de l’API peuvent avoir besoin d’inscrire explicitement l’abonnement (pour plus d’informations, consultez https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services). Une autre façon de configurer la destination est disponible uniquement pour les partenaires disposant d’un plan contrat partenaire Microsoft qui sont des administrateurs généraux de leur compte de facturation. Ces partenaires, au lieu de spécifier l’ID de ressource d’un compte de stockage, peuvent spécifier le nom du compte de stockage ainsi qu’un jeton SAP pour le compte. Cela permet d’exporter des coûts vers un compte de stockage dans n’importe quel locataire. Le jeton SAP doit être créé pour le service blob avec les types de ressources Service/Container/Object et avec les autorisations Lecture/Écriture/Supprimer/List/Ajouter/Créer (pour plus d’informations, voir https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key).

Nom	Type	Description
container	string	Nom du conteneur dans lequel les exportations seront chargées. Si le conteneur n’existe pas, il sera créé.
resourceId	string	ID de ressource du compte de stockage où les exportations seront livrées. Cela n’est pas obligatoire si un sasToken et storageAccount sont spécifiés.
rootFolderPath	string	Nom du répertoire dans lequel les exportations seront chargées.
sasToken	string	Jeton SAP pour le compte de stockage. Pour un ensemble restreint de clients Azure, ainsi que storageAccount peut être spécifié au lieu de resourceId. Remarque : la valeur retournée par l’API pour cette propriété sera toujours obfuscatée. Le renvoi de cette même valeur obfuscatée n’entraîne pas la mise à jour du jeton SAP. Pour mettre à jour cette valeur, un nouveau jeton SAP doit être spécifié.
storageAccount	string	Compte de stockage où les exportations seront chargées. Pour un ensemble restreint de clients Azure, ainsi que sasToken, peuvent être spécifiés au lieu de resourceId.

ExportDeliveryInfo

Informations de remise associées à une exportation.

Nom	Type	Description
destination	ExportDeliveryDestination	A la destination de l’exportation en cours de livraison.

ExportExecutionListResult

Résultat de la liste de l’historique des exécutions d’une exportation.

Nom	Type	Description
value	ExportRun[]	Liste des exécutions d’exportation.

ExportRecurrencePeriod

Date de début et de fin de la planification de périodicité.

Nom	Type	Description
from	string	Date de début de la périodicité.
to	string	Date de fin de périodicité.

ExportRun

Exécution d’exportation.

Nom	Type	Description
eTag	string	eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ sera utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non.
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.error	ErrorDetails	Détails de toute erreur.
properties.executionType	ExecutionType	Type de l’exécution d’exportation.
properties.fileName	string	Nom du fichier exporté.
properties.processingEndTime	string	Heure de fin de l’exécution de l’exportation.
properties.processingStartTime	string	Heure à laquelle l’exportation a été récupérée pour être exécutée.
properties.runSettings	CommonExportProperties	Paramètres d’exportation qui étaient en vigueur pour cette exécution.
properties.status	ExecutionStatus	Dernier état connu de l’exécution d’exportation.
properties.submittedBy	string	Identificateur de l’entité qui a déclenché l’exportation. Pour les exécutions à la demande, il s’agit de l’e-mail de l’utilisateur. Pour les exécutions planifiées, il s’agit de « Système ».
properties.submittedTime	string	Heure à laquelle l’exportation a été mise en file d’attente pour être exécutée.
type	string	Type de ressource.

ExportSchedule

Planification associée à l’exportation.

Nom	Type	Description
recurrence	RecurrenceType	Périodicité de la planification.
recurrencePeriod	ExportRecurrencePeriod	A la date de début et de fin de la périodicité. La date de début doit être à l’avenir. Si elle est présente, la date de fin doit être supérieure à la date de début.
status	StatusType	État de la planification de l’exportation. Si elle est inactive, la planification de l’exportation est suspendue.

ExportTimePeriod

Plage de dates pour les données de l’exportation. Cela ne doit être spécifié que si le timeFrame est défini sur « Personnalisé ». La plage de dates maximale est de 3 mois.

Nom	Type	Description
from	string	Date de début des données d’exportation.
to	string	Date de fin des données d’exportation.

ExportType

Type de l’exportation. Notez que « Utilisation » équivaut à « ActualCost » et s’applique aux exportations qui ne fournissent pas encore de données pour les frais ou l’amortissement des réservations de service.

Nom	Type	Description
ActualCost	string
AmortizedCost	string
Usage	string

FormatType

Format de l’exportation en cours de remise. Actuellement, seul « Csv » est pris en charge.

Nom	Type	Description
Csv	string

GranularityType

Granularité des lignes de l’exportation. Actuellement, seul « Quotidien » est pris en charge.

Nom	Type	Description
Daily	string

RecurrenceType

Périodicité de la planification.

Nom	Type	Description
Annually	string
Daily	string
Monthly	string
Weekly	string

StatusType

État de la planification de l’exportation. Si elle est inactive, la planification de l’exportation est suspendue.

Nom	Type	Description
Active	string
Inactive	string

SystemAssignedServiceIdentity

Identité de service managée (affectée par le système ou aucun)

Nom	Type	Description
principalId	string	ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	SystemAssignedServiceIdentityType	Type d’identité de service managé (soit le système affecté, soit aucun).

SystemAssignedServiceIdentityType

Type d’identité de service managé (soit le système affecté, soit aucun).

Nom	Type	Description
None	string
SystemAssigned	string

TimeframeType

Délai d’extraction des données pour l’exportation. Si elle est personnalisée, une période spécifique doit être fournie.

Nom	Type	Description
BillingMonthToDate	string
Custom	string
MonthToDate	string
TheLastBillingMonth	string
TheLastMonth	string
WeekToDate	string

Partager via

Exports - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

ExportCreateOrUpdateByBillingAccount

Exemple de requête

Exemple de réponse

ExportCreateOrUpdateByDepartment

Exemple de requête

Exemple de réponse

ExportCreateOrUpdateByEnrollmentAccount

Exemple de requête

Exemple de réponse

ExportCreateOrUpdateByManagementGroup

Exemple de requête

Exemple de réponse

ExportCreateOrUpdateByResourceGroup

Exemple de requête

Exemple de réponse

ExportCreateOrUpdateBySubscription

Exemple de requête

Exemple de réponse

Définitions

CommonExportProperties

ErrorDetails

ErrorResponse

ExecutionStatus

ExecutionType

Export

ExportDataset

ExportDatasetConfiguration

ExportDefinition

ExportDeliveryDestination

ExportDeliveryInfo

ExportExecutionListResult

ExportRecurrencePeriod

ExportRun

ExportSchedule

ExportTimePeriod

ExportType

FormatType

GranularityType

RecurrenceType

StatusType

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

TimeframeType

Ressources supplémentaires