Cost Allocation Rules - List

Reference

Service:: Cost Management

API Version:: 2023-11-01

Získejte seznam všech pravidel alokace nákladů pro fakturační účet nebo podnikovou registraci.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules?api-version=2023-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
billingAccountId	path	True	string	ID fakturačního účtu
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	CostAllocationRuleList	Seznam pravidel alokace nákladů pro fakturační účet nebo podnikovou registraci
Other Status Codes	ErrorResponse	Odpověď na chybu popisující příčinu selhání operace

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Příklady

CostAllocationRulesList

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules?api-version=2023-11-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "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": "NotActive",
        "details": {
          "sourceResources": [
            {
              "resourceType": "Dimension",
              "name": "ResourceGroupName",
              "values": [
                "sampleRG"
              ]
            }
          ],
          "targetResources": [
            {
              "resourceType": "Dimension",
              "policyType": "FixedProportion",
              "name": "ResourceGroupName",
              "values": [
                {
                  "name": "destinationRG",
                  "percentage": 50
                },
                {
                  "name": "destinationRG2",
                  "percentage": 50
                }
              ]
            }
          ]
        }
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule2",
      "name": "testRule2",
      "type": "Microsoft.CostManagement/costAllocationRules",
      "properties": {
        "description": "This is a second test Rule",
        "createdDate": "2020-06-18T22:21:51.1287144Z",
        "updatedDate": "2020-06-18T22:21:51.1287144Z",
        "status": "Active",
        "details": {
          "sourceResources": [
            {
              "resourceType": "Dimension",
              "name": "SubscriptionId",
              "values": [
                "2A002F2D-536F-4D7C-90DA-3D0BAE879B0E"
              ]
            }
          ],
          "targetResources": [
            {
              "resourceType": "Tag",
              "policyType": "FixedProportion",
              "name": "category",
              "values": [
                {
                  "name": "devops",
                  "percentage": 100
                }
              ]
            }
          ]
        }
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule3",
      "name": "testRule3",
      "type": "Microsoft.CostManagement/costAllocationRules",
      "properties": {
        "description": "This is a third test Rule",
        "createdDate": "2020-06-18T22:21:51.1287144Z",
        "updatedDate": "2020-06-18T22:21:51.1287144Z",
        "status": "Active",
        "details": {
          "sourceResources": [
            {
              "resourceType": "Tag",
              "name": "category",
              "values": [
                "devops"
              ]
            }
          ],
          "targetResources": [
            {
              "resourceType": "Dimension",
              "policyType": "FixedProportion",
              "name": "ResourceGroupName",
              "values": [
                {
                  "name": "ResourceGroup",
                  "percentage": 55.55
                },
                {
                  "name": "ResourceGroupSecond",
                  "percentage": 44.45
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "nextLink": null
}

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 prostředku, který se má použít pro přidělení.
CostAllocationRuleDefinition	Definice modelu pravidla alokace nákladů
CostAllocationRuleDetails	Podrobnosti o zdroji pravidla alokace nákladů
CostAllocationRuleList	Výsledek výpisu pravidel alokace nákladů Obsahuje seznam dostupných pravidel v zadaném fakturačním účtu nebo podnikové registraci.
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ý. Zkuste to znovu po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Po uplynutí časového limitu uvedeného v hlavičce Retry-After zkuste operaci zopakovat.
RuleStatus	Aktuální stav pravidla.
SourceCostAllocationResource	Zdrojové zdroje 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 alokaci nákladů
percentage	number	Procento zdrojových nákladů, které se mají tomuto prostředku přidělit Tuto hodnotu lze zadat na dvě desetinná místa a celkové procento všech prostředků v tomto pravidle musí být 100,00.

CostAllocationResourceType

Kategorie prostředku, který se má použít pro přidělení.

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

CostAllocationRuleDefinition

Definice modelu pravidla alokace nákladů

Name	Typ	Description
id	string	ID Resource Manager Azure pro pravidlo. Jedná se o hodnotu read ony.
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. Toto je hodnota Microsoft.CostManagement/CostAllocationRule určená jen pro čtení.

CostAllocationRuleDetails

Podrobnosti o zdroji pravidla alokace nákladů

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

CostAllocationRuleList

Výsledek výpisu pravidel alokace nákladů Obsahuje seznam dostupných pravidel v zadaném fakturačním účtu nebo podnikové registraci.

Name	Typ	Description
nextLink	string	Adresa URL pro získání další sady výsledků seznamu pravidel, pokud existují.
value	CostAllocationRuleDefinition[]	Seznam pravidel alokace nákladů

CostAllocationRuleProperties

Vlastnosti pravidla alokace nákladů

Name	Typ	Description
createdDate	string	Čas, ve kterém bylo pravidlo vytvořeno. Pravidla, která mění náklady na stejný prostředek, se použijí v pořadí vytvoření.
description	string	Popis pravidla alokace nákladů
details	CostAllocationRuleDetails	Informace o zdroji pro pravidlo 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ý. Zkuste to znovu po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable – Služba je dočasně nedostupná. Po uplynutí časového limitu uvedeného v hlavičce Retry-After zkuste operaci zopakovat.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

RuleStatus

Aktuální stav pravidla.

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

SourceCostAllocationResource

Zdrojové zdroje 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čka, 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čka, 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