Cost Allocation Rules - List

Referencia

Szolgáltatás:: Cost Management

API-verzió:: 2023-11-01

Lekérheti egy számlázási fiók vagy vállalati regisztráció összes költségfelosztási szabályának listáját.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	CostAllocationRuleList	A számlázási fiók vagy a vállalati regisztráció költségfelosztási szabályainak listája.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért hiúsult meg a művelet

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

CostAllocationRulesList

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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
}

Definíciók

Name	Description
CostAllocationPolicyType	A költség kiosztásához használandó módszer. A FixProportion azt jelzi, hogy a költségek a megadott százalékos értékek alapján lesznek felosztva.
CostAllocationProportion	Célerőforrások és kiosztás
CostAllocationResourceType	A foglaláshoz használandó erőforrás kategóriája.
CostAllocationRuleDefinition	A költségfelosztási szabály modelldefiníciója
CostAllocationRuleDetails	A költségfelosztási szabály erőforrás-részletei
CostAllocationRuleList	A költségfelosztási szabályok listázásának eredménye. A megadott számlázási fiókban vagy vállalati regisztrációban elérhető szabályok listáját tartalmazza.
CostAllocationRuleProperties	A költségfelosztási szabály tulajdonságai
ErrorDetails	A hiba részletei.
ErrorResponse	A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. Néhány hibaválasz: 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után. 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.
RuleStatus	A szabály aktuális állapota.
SourceCostAllocationResource	Forráserőforrások a költségfelosztáshoz
TargetCostAllocationResource	Célerőforrások a költségfelosztáshoz.

CostAllocationPolicyType

A költség kiosztásához használandó módszer. A FixProportion azt jelzi, hogy a költségek a megadott százalékos értékek alapján lesznek felosztva.

Name	Típus	Description
FixedProportion	string

CostAllocationProportion

Célerőforrások és kiosztás

Name	Típus	Description
name	string	Célerőforrás a költségfelosztáshoz
percentage	number	Az erőforráshoz lefoglalandó forrásköltség százalékos aránya. Ez az érték két tizedesjegyre adható meg, és a szabályban szereplő összes erőforrás százalékos arányának 100,00-nak kell lennie.

CostAllocationResourceType

A foglaláshoz használandó erőforrás kategóriája.

Name	Típus	Description
Dimension	string	Azt jelzi, hogy a rendszer egy Azure-dimenziót, például egy előfizetés-azonosítót vagy egy erőforráscsoport-nevet használ a foglaláshoz.
Tag	string	A költségeket az Azure-címkekulcs értékpárjai alapján foglalja le.

CostAllocationRuleDefinition

A költségfelosztási szabály modelldefiníciója

Name	Típus	Description
id	string	A szabály Azure Resource Manager azonosítója. Ez egy olvasási ony érték.
name	string	A szabály neve. Ez egy írásvédett érték.
properties	CostAllocationRuleProperties	Költségfelosztási szabály tulajdonságai
type	string	A szabály erőforrástípusa. Ez a Microsoft.CostManagement/CostAllocationRule írásvédett értéke.

CostAllocationRuleDetails

A költségfelosztási szabály erőforrás-részletei

Name	Típus	Description
sourceResources	SourceCostAllocationResource[]	Forráserőforrások a költségfelosztáshoz. Ez a lista jelenleg legfeljebb egy elemet tartalmazhat.
targetResources	TargetCostAllocationResource[]	Célerőforrások a költségfelosztáshoz. Ez a lista jelenleg legfeljebb egy elemet tartalmazhat.

CostAllocationRuleList

A költségfelosztási szabályok listázásának eredménye. A megadott számlázási fiókban vagy vállalati regisztrációban elérhető szabályok listáját tartalmazza.

Name	Típus	Description
nextLink	string	URL-cím a következő szabálylista eredményeinek lekéréséhez, ha vannak ilyenek.
value	CostAllocationRuleDefinition[]	A költségfelosztási szabályok listája.

CostAllocationRuleProperties

A költségfelosztási szabály tulajdonságai

Name	Típus	Description
createdDate	string	A szabály létrehozásának időpontja. Az ugyanahhoz az erőforráshoz tartozó költségeket módosító szabályokat a rendszer létrehozási sorrendben alkalmazza.
description	string	Költségfelosztási szabály leírása.
details	CostAllocationRuleDetails	Erőforrás-információk a költségfelosztási szabályhoz
status	RuleStatus	A szabály állapota
updatedDate	string	A szabály utolsó frissítésének időpontja.

ErrorDetails

A hiba részletei.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet, amely jelzi, hogy a művelet miért hiúsult meg.

ErrorResponse

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Néhány hibaválasz:

429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után.
503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.

Name	Típus	Description
error	ErrorDetails	A hiba részletei.

RuleStatus

A szabály aktuális állapota.

Name	Típus	Description
Active	string	A szabály mentve van, és hatással van a költségfelosztásra.
NotActive	string	A rendszer menti a szabályt, de nem használja a költségek lefoglalására.
Processing	string	A szabály mentése és a költségfelosztás frissítése folyamatban van. Írásvédett érték, amely nem küldhető el az elküldéses kérelemben.

SourceCostAllocationResource

Forráserőforrások a költségfelosztáshoz

Name	Típus	Description
name	string	Ha az erőforrás típusa dimenzió, ennek ResourceGroupName vagy SubscriptionId értéknek kell lennie. Ha az erőforrás típusa címke, annak érvényes Azure-címkének kell lennie
resourceType	CostAllocationResourceType	Az ebben a költségfelosztási szabályban foglalt erőforrások típusa
values	string[]	Forráserőforrások a költségfelosztáshoz. Ez a lista legfeljebb 25 értéket tartalmazhat.

TargetCostAllocationResource

Célerőforrások a költségfelosztáshoz.

Name	Típus	Description
name	string	Ha az erőforrás típusa dimenzió, ennek ResourceGroupName vagy SubscriptionId értéknek kell lennie. Ha az erőforrás típusa címke, annak érvényes Azure-címkének kell lennie
policyType	CostAllocationPolicyType	A szabály költségfelosztási módszere
resourceType	CostAllocationResourceType	Az ebben a költségfelosztási szabályban foglalt erőforrások típusa
values	CostAllocationProportion[]	Célerőforrások a költségfelosztáshoz. Ez a lista legfeljebb 25 értéket tartalmazhat.

Megosztás a következőn keresztül: