Cost Allocation Rules - Create Or Update

Referencia

Szolgáltatás:: Cost Management

API-verzió:: 2023-11-01

Szabály létrehozása/frissítése a különböző erőforrások közötti költségelosztáshoz egy számlázási fiókon vagy vállalati regisztráción belül.

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

URI-paraméterek

Name In Kötelező Típus Description

Name	In	Kötelező	Típus	Description
billingAccountId	path	True	string	BillingAccount ID
ruleName	path	True	string	Költségfelosztási szabály neve. A név nem tartalmazhat szóközöket vagy nem alfanumerikus karaktereket a "_" és a "-" karakter kivételével. A maximális hossz 260 karakter. Reguláris kifejezési minta: `[A-Za-z0-9\-_]+`
api-version	query	True	string	A művelethez használandó API-verzió.

billingAccountId

path

True

string

BillingAccount ID

ruleName

path

True

string

Költségfelosztási szabály neve. A név nem tartalmazhat szóközöket vagy nem alfanumerikus karaktereket a "_" és a "-" karakter kivételével. A maximális hossz 260 karakter.

Reguláris kifejezési minta: [A-Za-z0-9\-_]+

api-version

query

True

string

A művelethez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
properties	CostAllocationRuleProperties	Költségfelosztási szabály tulajdonságai

Válaszok

Name	Típus	Description
200 OK	CostAllocationRuleDefinition	OK gombra. A frissítési kérelem sikeres volt.
201 Created	CostAllocationRuleDefinition	Létrehozott. A kérés sikeres volt.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

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

CostAllocationRulesCreateResourceGroup

CostAllocationRulesCreateTag

CostAllocationRulesCreateResourceGroup

Mintakérelem

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule?api-version=2023-11-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
            }
          ]
        }
      ]
    }
  }
}

Mintaválasz

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

Állapotkó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

Mintakérelem

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/testRule?api-version=2023-11-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
            }
          ]
        }
      ]
    }
  }
}

Mintaválasz

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

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

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ég fel lesz osztva a megadott százalékos értékek alapján.
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álymodell definíciója
CostAllocationRuleDetails	A költségfelosztási szabály erőforrás-részletei
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őpontra 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ég fel lesz osztva a megadott százalékos értékek alapján.

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 teljes százalékos arányának 100,00-ra kell lennie.

CostAllocationResourceType

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

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

CostAllocationRuleDefinition

A költségfelosztási szabálymodell definíciója

Name	Típus	Description
id	string	A szabály Azure Resource Manager azonosítója. Ez egy olvasási érték.
name	string	A szabály neve. Ez csak olvasási é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.

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 a létrehozás sorrendjében alkalmazza.
description	string	Költségfelosztási szabály leírása.
details	CostAllocationRuleDetails	A költségfelosztási szabály erőforrás-információi
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 jelzi, hogy a művelet miért nem sikerült.

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őpontra 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 mentése 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 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 típusúnak 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 szereplő 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 típusúnak 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 szereplő 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:

Cost Allocation Rules - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

CostAllocationRulesCreateResourceGroup

Mintakérelem

Mintaválasz

CostAllocationRulesCreateTag

Mintakérelem

Mintaválasz

Definíciók

CostAllocationPolicyType

CostAllocationProportion

CostAllocationResourceType

CostAllocationRuleDefinition

CostAllocationRuleDetails

CostAllocationRuleProperties

ErrorDetails

ErrorResponse

RuleStatus

SourceCostAllocationResource

TargetCostAllocationResource

További források