Cost Allocation Rules - Create Or Update

Reference

Služba:: Cost Management

Verze rozhraní API:: 2024-08-01

Vytvořte nebo aktualizujte pravidlo, které přiděluje náklady mezi různé prostředky v rámci fakturačního účtu nebo podnikové registrace.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName}?api-version=2024-08-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description

Name	V	Vyžadováno	Typ	Description
billingAccountId	path	True	string	ID fakturačního účtu
ruleName	path	True	string	Název pravidla alokace nákladů Název nesmí obsahovat mezery ani žádné jiné než alfanumerické znaky než "_" a "-". Maximální délka je 260 znaků. Vzor regulárního výrazu: `[A-Za-z0-9\-_]+`
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

billingAccountId

path

True

string

ID fakturačního účtu

ruleName

path

True

string

Název pravidla alokace nákladů Název nesmí obsahovat mezery ani žádné jiné než alfanumerické znaky než "_" a "-". Maximální délka je 260 znaků.

Vzor regulárního výrazu: [A-Za-z0-9\-_]+

api-version

query

True

string

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

Text požadavku

Name	Typ	Description
properties	CostAllocationRuleProperties	Vlastnosti pravidla alokace nákladů

Odpovědi

Name	Typ	Description
200 OK	CostAllocationRuleDefinition	OK. Žádost o aktualizaci byla úspěšná.
201 Created	CostAllocationRuleDefinition	Vytvořil. Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

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

Rozsahy

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

Příklady

CostAllocationRulesCreateResourceGroup

CostAllocationRulesCreateTag

CostAllocationRulesCreateResourceGroup

Ukázkový požadavek

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule?api-version=2024-08-01

{
  "properties": {
    "description": "This is a testRule",
    "status": "Active",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Dimension",
          "name": "ResourceGroupName",
          "values": [
            "sampleRG",
            "secondRG"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 45
            },
            {
              "name": "destinationRG2",
              "percentage": 54
            }
          ]
        }
      ]
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule",
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules",
  "properties": {
    "description": "This is a testRule",
    "createdDate": "2020-06-18T22:21:51.1287144Z",
    "updatedDate": "2020-06-18T22:21:51.1287144Z",
    "status": "Creating",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Dimension",
          "name": "ResourceGroupName",
          "values": [
            "sampleRG"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 50
            },
            {
              "name": "destinationRG2",
              "percentage": 50
            }
          ]
        }
      ]
    }
  }
}

Stavový kód:: 201

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule",
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules",
  "properties": {
    "description": "This is a testRule",
    "createdDate": "2020-06-18T22:21:51.1287144Z",
    "updatedDate": "2020-06-18T22:21:51.1287144Z",
    "status": "Creating",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Dimension",
          "name": "ResourceGroupName",
          "values": [
            "sampleRG"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 50
            },
            {
              "name": "destinationRG2",
              "percentage": 50
            }
          ]
        }
      ]
    }
  }
}

CostAllocationRulesCreateTag

Ukázkový požadavek

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule?api-version=2024-08-01

{
  "properties": {
    "description": "This is a testRule",
    "status": "Active",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Tag",
          "name": "category",
          "values": [
            "devops"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 33.33
            },
            {
              "name": "destinationRG2",
              "percentage": 33.33
            },
            {
              "name": "destinationRG3",
              "percentage": 33.34
            }
          ]
        }
      ]
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule",
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules",
  "properties": {
    "description": "This is a testRule",
    "createdDate": "2020-06-18T22:21:51.1287144Z",
    "updatedDate": "2020-06-18T22:21:51.1287144Z",
    "status": "Creating",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Dimension",
          "name": "ResourceGroupName",
          "values": [
            "sampleRG"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 50
            },
            {
              "name": "destinationRG2",
              "percentage": 50
            }
          ]
        }
      ]
    }
  }
}

Stavový kód:: 201

{
  "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule",
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules",
  "properties": {
    "description": "This is a testRule",
    "createdDate": "2020-06-18T22:21:51.1287144Z",
    "updatedDate": "2020-06-18T22:21:51.1287144Z",
    "status": "Creating",
    "details": {
      "sourceResources": [
        {
          "resourceType": "Dimension",
          "name": "ResourceGroupName",
          "values": [
            "sampleRG"
          ]
        }
      ],
      "targetResources": [
        {
          "resourceType": "Dimension",
          "policyType": "FixedProportion",
          "name": "ResourceGroupName",
          "values": [
            {
              "name": "destinationRG",
              "percentage": 50
            },
            {
              "name": "destinationRG2",
              "percentage": 50
            }
          ]
        }
      ]
    }
  }
}

Definice

Name	Description
CostAllocationPolicyType	Metoda, která se má použít pro přidělování nákladů. FixedProportion označuje, že náklady budou rozděleny na základě zadaných procentuálních hodnot.
CostAllocationProportion	Cílové prostředky a přidělení
CostAllocationResourceType	Kategorie zdroje, který se má použít k přidělení
CostAllocationRuleDefinition	Definice modelu pravidla alokace nákladů
CostAllocationRuleDetails	Podrobnosti o prostředku pravidla alokace nákladů
CostAllocationRuleProperties	Vlastnosti pravidla alokace nákladů
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
RuleStatus	Aktuální stav pravidla
SourceCostAllocationResource	Zdrojové prostředky pro alokaci nákladů
TargetCostAllocationResource	Cílové prostředky pro alokaci nákladů

CostAllocationPolicyType

Metoda, která se má použít pro přidělování nákladů. FixedProportion označuje, že náklady budou rozděleny na základě zadaných procentuálních hodnot.

Name	Typ	Description
FixedProportion	string

CostAllocationProportion

Cílové prostředky a přidělení

Name	Typ	Description
name	string	Cílový prostředek pro přidělování nákladů
percentage	number	Procento zdrojových nákladů, které se mají přidělit tomuto zdroji Tuto hodnotu je možné zadat na dvě desetinná místa a celkové procento všech prostředků v tomto pravidle musí být součet 100,00.

CostAllocationResourceType

Kategorie zdroje, který se má použít k přidělení

Name	Typ	Description
Dimension	string	Označuje dimenzi Azure, jako je ID předplatného nebo název skupiny prostředků, se používá k přidělení.
Tag	string	Přidělí náklady na základě párů klíč-hodnota značky Azure.

CostAllocationRuleDefinition

Definice modelu pravidla alokace nákladů

Name	Typ	Description
id	string	ID Azure Resource Manageru pro pravidlo Jedná se o hodnotu čtení.
name	string	Název pravidla. Jedná se o hodnotu jen pro čtení.
properties	CostAllocationRuleProperties	Vlastnosti pravidla alokace nákladů
type	string	Typ prostředku pravidla Jedná se o hodnotu Microsoft.CostManagement/CostAllocationRule jen pro čtení.

CostAllocationRuleDetails

Podrobnosti o prostředku pravidla alokace nákladů

Name	Typ	Description
sourceResources	SourceCostAllocationResource[]	Zdrojové prostředky pro alokaci nákladů V tuto chvíli nemůže tento seznam obsahovat více než jeden prvek.
targetResources	TargetCostAllocationResource[]	Cílové prostředky pro alokaci nákladů V tuto chvíli nemůže tento seznam obsahovat více než jeden prvek.

CostAllocationRuleProperties

Vlastnosti pravidla alokace nákladů

Name	Typ	Description
createdDate	string	Čas vytvoření pravidla Pravidla, která mění náklady na stejný prostředek, se použijí v pořadí vytváření.
description	string	Popis pravidla alokace nákladů
details	CostAllocationRuleDetails	Informace o zdroji pravidla alokace nákladů
status	RuleStatus	Stav pravidla
updatedDate	string	Čas poslední aktualizace pravidla

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

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

Některé chybové odpovědi:

429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

RuleStatus

Aktuální stav pravidla

Name	Typ	Description
Active	string	Pravidlo se uloží a ovlivní přidělení nákladů.
NotActive	string	Pravidlo se ukládá, ale nepoužívá se k přidělování nákladů.
Processing	string	Pravidlo se ukládá a aktualizuje se přidělení nákladů. Hodnota jen pro čtení, kterou nelze odeslat v požadavku put.

SourceCostAllocationResource

Zdrojové prostředky pro alokaci nákladů

Name	Typ	Description
name	string	Pokud je typ prostředku dimenze, musí to být ResourceGroupName nebo SubscriptionId. Pokud je typ prostředku značkou, musí se jednat o platnou značku Azure.
resourceType	CostAllocationResourceType	Typ prostředků obsažených v tomto pravidle alokace nákladů
values	string[]	Zdrojové prostředky pro alokaci nákladů Tento seznam nesmí obsahovat více než 25 hodnot.

TargetCostAllocationResource

Cílové prostředky pro alokaci nákladů

Name	Typ	Description
name	string	Pokud je typ prostředku dimenze, musí to být ResourceGroupName nebo SubscriptionId. Pokud je typ prostředku značkou, musí se jednat o platnou značku Azure.
policyType	CostAllocationPolicyType	Metoda alokace nákladů pro pravidlo
resourceType	CostAllocationResourceType	Typ prostředků obsažených v tomto pravidle alokace nákladů
values	CostAllocationProportion[]	Cílové prostředky pro alokaci nákladů Tento seznam nesmí obsahovat více než 25 hodnot.

Sdílet prostřednictvím

Cost Allocation Rules - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

CostAllocationRulesCreateResourceGroup

Ukázkový požadavek

Ukázková odpověď

CostAllocationRulesCreateTag

Ukázkový požadavek

Ukázková odpověď

Definice

CostAllocationPolicyType

CostAllocationProportion

CostAllocationResourceType

CostAllocationRuleDefinition

CostAllocationRuleDetails

CostAllocationRuleProperties

ErrorDetails

ErrorResponse

RuleStatus

SourceCostAllocationResource

TargetCostAllocationResource

Další materiály