Cost Allocation Rules - Get

Referens

Tjänst:: Cost Management

API-version:: 2024-08-01

Hämta en kostnadsallokeringsregel efter regelnamn och faktureringskonto eller företagsregistrering.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountId	path	True	string	FaktureringKonto-ID
ruleName	path	True	string pattern: [A-Za-z0-9\-_]+	Namn på kostnadsallokeringsregel. Namnet får inte innehålla blanksteg eller andra icke-alfanumeriska tecken än '_' och '-'. Maxlängden är 260 tecken.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	CostAllocationRuleDefinition	OKEJ. Begäran har slutförts.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

CostAllocationRules

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 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": "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
            }
          ]
        }
      ]
    }
  }
}

Definitioner

Name	Description
CostAllocationPolicyType	Metod som ska användas för att allokera kostnader. FixedProportion anger att kostnaden delas upp baserat på angivna procentvärden.
CostAllocationProportion	Målresurser och allokering
CostAllocationResourceType	Resurskategori som ska användas för allokering.
CostAllocationRuleDefinition	Modelldefinitionen för kostnadsallokeringsregel
CostAllocationRuleDetails	Resursinformation om kostnadsallokeringsregeln
CostAllocationRuleProperties	Egenskaperna för en kostnadsallokeringsregel
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
RuleStatus	Aktuell status för regeln.
SourceCostAllocationResource	Källresurser för kostnadsallokering
TargetCostAllocationResource	Målresurser för kostnadsallokering.

CostAllocationPolicyType

Uppräkning

Metod som ska användas för att allokera kostnader. FixedProportion anger att kostnaden delas upp baserat på angivna procentvärden.

Värde	Description
FixedProportion

CostAllocationProportion

Objekt

Målresurser och allokering

Name	Typ	Description
name	string	Målresurs för kostnadsallokering
percentage	number	Procentandel av källkostnaden som ska allokeras till den här resursen. Det här värdet kan anges till två decimaler och den totala procentandelen av alla resurser i den här regeln måste summeras till 100,00.

CostAllocationResourceType

Uppräkning

Resurskategori som ska användas för allokering.

Värde	Description
Dimension	Anger att en Azure-dimension, till exempel ett prenumerations-ID eller resursgruppsnamn, används för allokering.
Tag	Allokerar kostnader baserat på Nyckelvärdepar för Azure-taggar.

CostAllocationRuleDefinition

Objekt

Modelldefinitionen för kostnadsallokeringsregel

Name	Typ	Description
id	string	Azure Resource Manager-ID för regeln. Det här är ett read ony-värde.
name	string	Namnet på regeln. Det här är ett skrivskyddat värde.
properties	CostAllocationRuleProperties	Egenskaper för kostnadsallokeringsregel
type	string	Regelns resurstyp. Det här är ett skrivskyddat värde för Microsoft.CostManagement/CostAllocationRule.

CostAllocationRuleDetails

Objekt

Resursinformation om kostnadsallokeringsregeln

Name	Typ	Description
sourceResources	SourceCostAllocationResource[]	Källresurser för kostnadsallokering. För närvarande får den här listan inte innehålla mer än ett element.
targetResources	TargetCostAllocationResource[]	Målresurser för kostnadsallokering. För närvarande får den här listan inte innehålla mer än ett element.

CostAllocationRuleProperties

Objekt

Egenskaperna för en kostnadsallokeringsregel

Name	Typ	Description
createdDate	string (date-time)	Tidpunkt då regeln skapades. Regler som ändrar kostnaden för samma resurs tillämpas i skapandeordning.
description	string	Beskrivning av en kostnadsallokeringsregel.
details	CostAllocationRuleDetails	Resursinformation för kostnadsallokeringsregeln
status	RuleStatus	Status för regeln
updatedDate	string (date-time)	Tidpunkt då regeln senast uppdaterades.

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name	Typ	Description
error	ErrorDetails	Information om felet.

RuleStatus

Uppräkning

Aktuell status för regeln.

Värde	Description
Active	Regeln sparas och påverkar kostnadsallokeringen.
NotActive	Regeln sparas men används inte för att allokera kostnader.
Processing	Regeln sparas och kostnadsallokeringen uppdateras. Skrivskyddat värde som inte kan skickas i en put-begäran.

SourceCostAllocationResource

Objekt

Källresurser för kostnadsallokering

Name	Typ	Description
name	string	Om resurstypen är dimension måste detta vara antingen ResourceGroupName eller SubscriptionId. Om resurstypen är tagg måste detta vara en giltig Azure-tagg
resourceType	CostAllocationResourceType	Typ av resurser som ingår i den här kostnadsallokeringsregeln
values	string[]	Källresurser för kostnadsallokering. Den här listan får inte innehålla fler än 25 värden.

TargetCostAllocationResource

Objekt

Målresurser för kostnadsallokering.

Name	Typ	Description
name	string	Om resurstypen är dimension måste detta vara antingen ResourceGroupName eller SubscriptionId. Om resurstypen är tagg måste detta vara en giltig Azure-tagg
policyType	CostAllocationPolicyType	Metod för kostnadsallokering för regeln
resourceType	CostAllocationResourceType	Typ av resurser som ingår i den här kostnadsallokeringsregeln
values	CostAllocationProportion[]	Målresurser för kostnadsallokering. Den här listan får inte innehålla fler än 25 värden.

Dela via

Cost Allocation Rules - Get

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

CostAllocationRules

Exempelbegäran

Exempelsvar

Definitioner

CostAllocationPolicyType

CostAllocationProportion

CostAllocationResourceType

CostAllocationRuleDefinition

CostAllocationRuleDetails

CostAllocationRuleProperties

ErrorDetails

ErrorResponse

RuleStatus

SourceCostAllocationResource

TargetCostAllocationResource

Ytterligare resurser