Exports - Create Or Update
A operação para criar ou atualizar uma exportação. A operação de atualização requer que o eTag mais recente seja definido no pedido. Pode obter o eTag mais recente ao executar uma operação get. A operação de criação não requer eTag.
PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}?api-version=2023-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
export
|
path | True |
string |
Nome da Exportação. |
scope
|
path | True |
string |
O âmbito associado às operações de exportação. Isto inclui "/subscriptions/{subscriptionId}/" para o âmbito da subscrição, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}" para o âmbito resourceGroup, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" para o âmbito da Conta de Faturação e "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}" para o âmbito do Departamento, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}" para o âmbito EnrollmentAccount, "/providers/Microsoft.Management/managementGroups/{managementGroupId} for Management Group scope, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" para o âmbito billingProfile, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" para o âmbito invoiceSection e "/providers/Microsoft. Faturação/faturaçãoAccounts/{billingAccountId}/customers/{customerId}' específico para parceiros. |
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
properties.definition | True |
Tem a definição para a exportação. |
|
properties.deliveryInfo | True |
Tem informações de entrega para a exportação. |
|
eTag |
string |
eTag do recurso. Para lidar com o cenário de atualização em simultâneo, este campo será utilizado para determinar se o utilizador está ou não a atualizar a versão mais recente. |
|
identity |
A identidade gerida associada à Exportação |
||
location |
string |
A localização da identidade gerida da Exportação. Apenas é necessário ao utilizar a identidade gerida. |
|
properties.format |
O formato da exportação a ser entregue. Atualmente, apenas o "Csv" é suportado. |
||
properties.partitionData |
boolean |
Se definido como verdadeiro, os dados exportados serão particionados por tamanho e colocados num diretório de blobs juntamente com um ficheiro de manifesto. Nota: esta opção está atualmente disponível apenas para âmbitos de comércio Contrato de Cliente Microsoft. |
|
properties.runHistory |
Se solicitado, tem o histórico de execuções mais recente para a exportação. |
||
properties.schedule |
Tem informações de agendamento para a exportação. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK. O pedido foi bem-sucedido. |
|
201 Created |
Criado. |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
ExportCreateOrUpdateByBillingAccount
Sample Request
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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
Sample Request
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12/departments/1234/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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
Sample Request
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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
Sample Request
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/TestMG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/exports/TestExport?api-version=2023-11-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"
]
}
}
}
}
}
Sample Response
{
"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"
]
}
}
}
}
}
{
"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"
]
}
}
}
}
}
Definições
Name | Description |
---|---|
Common |
As propriedades comuns da exportação. |
Error |
Os detalhes do erro. |
Error |
A resposta a erros indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro. Algumas Respostas de erro:
|
Execution |
O último estado conhecido da execução de exportação. |
Execution |
O tipo de execução de exportação. |
Export |
Um recurso de exportação. |
Export |
A definição de dados na exportação. |
Export |
A configuração do conjunto de dados de exportação. Permite que as colunas sejam selecionadas para a exportação. Se não for fornecido, a exportação incluirá todas as colunas disponíveis. |
Export |
A definição de uma exportação. |
Export |
Isto representa a localização da conta de armazenamento de blobs onde serão entregues as exportações de custos. Existem duas formas de configurar o destino. A abordagem recomendada para a maioria dos clientes é especificar o resourceId da conta de armazenamento. Isto requer um registo único da subscrição da conta com o fornecedor de recursos Microsoft.CostManagementExports para dar acesso aos serviços do Cost Management ao armazenamento. Ao criar uma exportação no portal do Azure este registo é efetuado automaticamente, mas os utilizadores da API poderão ter de registar a subscrição explicitamente (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Outra forma de configurar o destino está disponível apenas para Parceiros com um plano de Contrato de Parceiro da Microsoft que são administradores globais da respetiva conta de faturação. Estes Parceiros, em vez de especificarem o resourceId de uma conta de armazenamento, podem especificar o nome da conta de armazenamento juntamente com um token SAS para a conta. Isto permite exportar os custos para uma conta de armazenamento em qualquer inquilino. O token de SAS deve ser criado para o serviço de blobs com tipos de recursos Serviço/Contentor/Objeto e com permissões de Leitura/Escrita/Eliminação/Lista/Adicionar/Criar (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ). |
Export |
As informações de entrega associadas a uma exportação. |
Export |
Resultado da listagem do histórico de execuções de uma exportação. |
Export |
A data de início e de fim da agenda de periodicidade. |
Export |
Uma execução de exportação. |
Export |
A agenda associada à exportação. |
Export |
O intervalo de datas dos dados na exportação. Isto só deve ser especificado com timeFrame definido como "Personalizado". O intervalo máximo de datas é de 3 meses. |
Export |
O tipo de exportação. Tenha em atenção que "Utilização" é equivalente a "ActualCost" e é aplicável às exportações que ainda não fornecem dados para custos ou amortizações para reservas de serviço. |
Format |
O formato da exportação a ser entregue. Atualmente, apenas o "Csv" é suportado. |
Granularity |
A granularidade das linhas na exportação. Atualmente, apenas é suportado "Diário". |
Recurrence |
A periodicidade da agenda. |
Status |
O estado da agenda da exportação. Se "Inativo", a agenda da exportação será colocada em pausa. |
System |
Identidade de serviço gerida (ou sistema atribuído ou nenhum) |
System |
Tipo de identidade de serviço gerida (atribuída pelo sistema ou nenhuma). |
Timeframe |
O período de tempo para solicitar dados para a exportação. Se for personalizado, tem de ser fornecido um período de tempo específico. |
CommonExportProperties
As propriedades comuns da exportação.
Name | Tipo | Description |
---|---|---|
definition |
Tem a definição para a exportação. |
|
deliveryInfo |
Tem informações de entrega para a exportação. |
|
format |
O formato da exportação a ser entregue. Atualmente, apenas o "Csv" é suportado. |
|
nextRunTimeEstimate |
string |
Se a exportação tiver uma agenda ativa, fornece uma estimativa da hora de execução seguinte. |
partitionData |
boolean |
Se definido como verdadeiro, os dados exportados serão particionados por tamanho e colocados num diretório de blobs juntamente com um ficheiro de manifesto. Nota: esta opção está atualmente disponível apenas para âmbitos de comércio Contrato de Cliente Microsoft. |
runHistory |
Se solicitado, tem o histórico de execuções mais recente para a exportação. |
ErrorDetails
Os detalhes do erro.
Name | Tipo | Description |
---|---|---|
code |
string |
Código de erro. |
message |
string |
Mensagem de erro a indicar por que motivo a operação falhou. |
ErrorResponse
A resposta a erros indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.
Algumas Respostas de erro:
429 TooManyRequests - O pedido é limitado. Repita depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - O serviço está temporariamente indisponível. Tente novamente após aguardar durante o tempo especificado no cabeçalho “Tentar novamente após”.
Name | Tipo | Description |
---|---|---|
error |
Os detalhes do erro. |
ExecutionStatus
O último estado conhecido da execução de exportação.
Name | Tipo | Description |
---|---|---|
Completed |
string |
|
DataNotAvailable |
string |
|
Failed |
string |
|
InProgress |
string |
|
NewDataNotAvailable |
string |
|
Queued |
string |
|
Timeout |
string |
ExecutionType
O tipo de execução de exportação.
Name | Tipo | Description |
---|---|---|
OnDemand |
string |
|
Scheduled |
string |
Export
Um recurso de exportação.
Name | Tipo | Description |
---|---|---|
eTag |
string |
eTag do recurso. Para lidar com o cenário de atualização em simultâneo, este campo será utilizado para determinar se o utilizador está ou não a atualizar a versão mais recente. |
id |
string |
ID do Recurso. |
identity |
A identidade gerida associada à Exportação |
|
location |
string |
A localização da identidade gerida da Exportação. Apenas é necessário ao utilizar a identidade gerida. |
name |
string |
Nome do recurso. |
properties.definition |
Tem a definição para a exportação. |
|
properties.deliveryInfo |
Tem informações de entrega para a exportação. |
|
properties.format |
O formato da exportação a ser entregue. Atualmente, apenas o "Csv" é suportado. |
|
properties.nextRunTimeEstimate |
string |
Se a exportação tiver uma agenda ativa, fornece uma estimativa da hora de execução seguinte. |
properties.partitionData |
boolean |
Se definido como verdadeiro, os dados exportados serão particionados por tamanho e colocados num diretório de blobs juntamente com um ficheiro de manifesto. Nota: esta opção está atualmente disponível apenas para âmbitos de comércio Contrato de Cliente Microsoft. |
properties.runHistory |
Se solicitado, tem o histórico de execuções mais recente para a exportação. |
|
properties.schedule |
Tem informações de agendamento para a exportação. |
|
type |
string |
Tipo de recurso. |
ExportDataset
A definição de dados na exportação.
Name | Tipo | Description |
---|---|---|
configuration |
A configuração do conjunto de dados de exportação. |
|
granularity |
A granularidade das linhas na exportação. Atualmente, apenas é suportado "Diário". |
ExportDatasetConfiguration
A configuração do conjunto de dados de exportação. Permite que as colunas sejam selecionadas para a exportação. Se não for fornecido, a exportação incluirá todas as colunas disponíveis.
Name | Tipo | Description |
---|---|---|
columns |
string[] |
Matriz de nomes de colunas a incluir na exportação. Se não for fornecido, a exportação incluirá todas as colunas disponíveis. As colunas disponíveis podem variar consoante o canal do cliente (veja exemplos). |
ExportDefinition
A definição de uma exportação.
Name | Tipo | Description |
---|---|---|
dataSet |
A definição de dados na exportação. |
|
timePeriod |
Tem um período de tempo para solicitar dados para a exportação. |
|
timeframe |
O período de tempo para solicitar dados para a exportação. Se for personalizado, tem de ser fornecido um período de tempo específico. |
|
type |
O tipo de exportação. Tenha em atenção que "Utilização" é equivalente a "ActualCost" e é aplicável às exportações que ainda não fornecem dados para custos ou amortizações para reservas de serviço. |
ExportDeliveryDestination
Isto representa a localização da conta de armazenamento de blobs onde serão entregues as exportações de custos. Existem duas formas de configurar o destino. A abordagem recomendada para a maioria dos clientes é especificar o resourceId da conta de armazenamento. Isto requer um registo único da subscrição da conta com o fornecedor de recursos Microsoft.CostManagementExports para dar acesso aos serviços do Cost Management ao armazenamento. Ao criar uma exportação no portal do Azure este registo é efetuado automaticamente, mas os utilizadores da API poderão ter de registar a subscrição explicitamente (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services ). Outra forma de configurar o destino está disponível apenas para Parceiros com um plano de Contrato de Parceiro da Microsoft que são administradores globais da respetiva conta de faturação. Estes Parceiros, em vez de especificarem o resourceId de uma conta de armazenamento, podem especificar o nome da conta de armazenamento juntamente com um token SAS para a conta. Isto permite exportar os custos para uma conta de armazenamento em qualquer inquilino. O token de SAS deve ser criado para o serviço de blobs com tipos de recursos Serviço/Contentor/Objeto e com permissões de Leitura/Escrita/Eliminação/Lista/Adicionar/Criar (para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/export-cost-data-storage-account-sas-key ).
Name | Tipo | Description |
---|---|---|
container |
string |
O nome do contentor onde as exportações serão carregadas. Se o contentor não existir, será criado. |
resourceId |
string |
O ID de recurso da conta de armazenamento onde as exportações serão entregues. Isto não é necessário se forem especificados sasToken e storageAccount. |
rootFolderPath |
string |
O nome do diretório onde as exportações serão carregadas. |
sasToken |
string |
Um token de SAS para a conta de armazenamento. Para um conjunto restrito de clientes do Azure, isto juntamente com storageAccount pode ser especificado em vez de resourceId. Nota: o valor devolvido pela API para esta propriedade será sempre obfuscado. Devolver este mesmo valor obsoluto não resultará na atualização do token de SAS. Para atualizar este valor, tem de ser especificado um novo token de SAS. |
storageAccount |
string |
A conta de armazenamento onde as exportações serão carregadas. Para um conjunto restrito de clientes do Azure, isto juntamente com sasToken pode ser especificado em vez de resourceId. |
ExportDeliveryInfo
As informações de entrega associadas a uma exportação.
Name | Tipo | Description |
---|---|---|
destination |
Tem o destino para a exportação a ser entregue. |
ExportExecutionListResult
Resultado da listagem do histórico de execuções de uma exportação.
Name | Tipo | Description |
---|---|---|
value |
Uma lista de execuções de exportação. |
ExportRecurrencePeriod
A data de início e de fim da agenda de periodicidade.
Name | Tipo | Description |
---|---|---|
from |
string |
A data de início da periodicidade. |
to |
string |
A data de fim da periodicidade. |
ExportRun
Uma execução de exportação.
Name | Tipo | Description |
---|---|---|
eTag |
string |
eTag do recurso. Para lidar com o cenário de atualização em simultâneo, este campo será utilizado para determinar se o utilizador está ou não a atualizar a versão mais recente. |
id |
string |
ID do Recurso. |
name |
string |
Nome do recurso. |
properties.error |
Os detalhes de qualquer erro. |
|
properties.executionType |
O tipo de execução de exportação. |
|
properties.fileName |
string |
O nome do ficheiro exportado. |
properties.processingEndTime |
string |
A hora em que a execução da exportação foi concluída. |
properties.processingStartTime |
string |
A hora em que a exportação foi recolhida para ser executada. |
properties.runSettings |
As definições de exportação que estavam em vigor para esta execução. |
|
properties.status |
O último estado conhecido da execução de exportação. |
|
properties.submittedBy |
string |
O identificador da entidade que acionou a exportação. Para execuções a pedido, é o e-mail do utilizador. Para execuções agendadas, é "Sistema". |
properties.submittedTime |
string |
A hora em que a exportação foi executada em fila. |
type |
string |
Tipo de recurso. |
ExportSchedule
A agenda associada à exportação.
Name | Tipo | Description |
---|---|---|
recurrence |
A periodicidade da agenda. |
|
recurrencePeriod |
Tem a data de início e de fim da periodicidade. A data de início tem de ser futura. Se estiver presente, a data de fim tem de ser maior do que a data de início. |
|
status |
O estado da agenda da exportação. Se "Inativo", a agenda da exportação será colocada em pausa. |
ExportTimePeriod
O intervalo de datas dos dados na exportação. Isto só deve ser especificado com timeFrame definido como "Personalizado". O intervalo máximo de datas é de 3 meses.
Name | Tipo | Description |
---|---|---|
from |
string |
A data de início para exportar dados. |
to |
string |
A data de fim para exportar dados. |
ExportType
O tipo de exportação. Tenha em atenção que "Utilização" é equivalente a "ActualCost" e é aplicável às exportações que ainda não fornecem dados para custos ou amortizações para reservas de serviço.
Name | Tipo | Description |
---|---|---|
ActualCost |
string |
|
AmortizedCost |
string |
|
Usage |
string |
FormatType
O formato da exportação a ser entregue. Atualmente, apenas o "Csv" é suportado.
Name | Tipo | Description |
---|---|---|
Csv |
string |
GranularityType
A granularidade das linhas na exportação. Atualmente, apenas é suportado "Diário".
Name | Tipo | Description |
---|---|---|
Daily |
string |
RecurrenceType
A periodicidade da agenda.
Name | Tipo | Description |
---|---|---|
Annually |
string |
|
Daily |
string |
|
Monthly |
string |
|
Weekly |
string |
StatusType
O estado da agenda da exportação. Se "Inativo", a agenda da exportação será colocada em pausa.
Name | Tipo | Description |
---|---|---|
Active |
string |
|
Inactive |
string |
SystemAssignedServiceIdentity
Identidade de serviço gerida (ou sistema atribuído ou nenhum)
Name | Tipo | Description |
---|---|---|
principalId |
string |
O ID do principal de serviço da identidade atribuída pelo sistema. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema. |
tenantId |
string |
O ID de inquilino da identidade atribuída pelo sistema. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema. |
type |
Tipo de identidade de serviço gerida (atribuída pelo sistema ou nenhuma). |
SystemAssignedServiceIdentityType
Tipo de identidade de serviço gerida (atribuída pelo sistema ou nenhuma).
Name | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
TimeframeType
O período de tempo para solicitar dados para a exportação. Se for personalizado, tem de ser fornecido um período de tempo específico.
Name | Tipo | Description |
---|---|---|
BillingMonthToDate |
string |
|
Custom |
string |
|
MonthToDate |
string |
|
TheLastBillingMonth |
string |
|
TheLastMonth |
string |
|
WeekToDate |
string |