Cost Allocation Rules - Get

リファレンス

サービス:: Cost Management

API バージョン:: 2024-08-01

ルール名と課金アカウントまたはエンタープライズ登録によってコスト割り当てルールを取得します。

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

URI パラメーター

名前 / 必須型説明

名前	/	必須	型	説明
billingAccountId	path	True	string	BillingAccount ID
ruleName	path	True	string	コスト配賦規則の名前。名前には、スペースまたは '_' および '-' 以外の英数字以外の文字を含めることはできません。最大長は 260 文字です。正規表現パターン: `[A-Za-z0-9\-_]+`
api-version	query	True	string	この操作に使用する API バージョン。

billingAccountId

path

True

string

BillingAccount ID

ruleName

path

True

string

コスト配賦規則の名前。名前には、スペースまたは '_' および '-' 以外の英数字以外の文字を含めることはできません。最大長は 260 文字です。

正規表現パターン: [A-Za-z0-9\-_]+

api-version

query

True

string

この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	CostAllocationRuleDefinition	わかりました。要求は成功しました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

CostAllocationRules

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 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
            }
          ]
        }
      ]
    }
  }
}

定義

名前	説明
CostAllocationPolicyType	コストの割り当てに使用する方法。 FixedProportion は、コストが指定されたパーセンテージ値に基づいて分割されることを示します。
CostAllocationProportion	ターゲットリソースと割り当て
CostAllocationResourceType	割り当てに使用するリソースのカテゴリ。
CostAllocationRuleDefinition	コスト配賦規則モデルの定義
CostAllocationRuleDetails	コスト割り当てルールのリソースの詳細
CostAllocationRuleProperties	コスト割り当てルールのプロパティ
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。
RuleStatus	ルールの現在の状態。
SourceCostAllocationResource	コスト割り当てのソースリソース
TargetCostAllocationResource	コスト割り当てのターゲットリソース。

CostAllocationPolicyType

コストの割り当てに使用する方法。 FixedProportion は、コストが指定されたパーセンテージ値に基づいて分割されることを示します。

名前	型	説明
FixedProportion	string

CostAllocationProportion

ターゲットリソースと割り当て

名前	型	説明
name	string	コスト割り当てのターゲットリソース
percentage	number	このリソースに割り当てるソースコストの割合。この値は小数点以下 2 桁に指定でき、このルール内のすべてのリソースの合計パーセンテージは 100.00 に合計する必要があります。

CostAllocationResourceType

割り当てに使用するリソースのカテゴリ。

名前	型	説明
Dimension	string	サブスクリプション ID やリソースグループ名などの Azure ディメンションが割り当てに使用されていることを示します。
Tag	string	Azure Tag キー値ペアに基づいてコストを割り当てます。

CostAllocationRuleDefinition

コスト配賦規則モデルの定義

名前	型	説明
id	string	ルールの Azure Resource Manager ID。これは読み取り ony 値です。
name	string	ルールの名前。これは読み取り専用の値です。
properties	CostAllocationRuleProperties	コスト割り当てルールのプロパティ
type	string	ルールのリソースの種類。これは、Microsoft.CostManagement/CostAllocationRule の読み取り専用値です。

CostAllocationRuleDetails

コスト割り当てルールのリソースの詳細

名前	型	説明
sourceResources	SourceCostAllocationResource[]	コスト割り当てのソースリソース。現時点では、このリストには複数の要素を含めることもできます。
targetResources	TargetCostAllocationResource[]	コスト割り当てのターゲットリソース。現時点では、このリストには複数の要素を含めることもできます。

CostAllocationRuleProperties

コスト割り当てルールのプロパティ

名前	型	説明
createdDate	string	ルールが作成された時刻。同じリソースのコストを変更するルールは、作成順に適用されます。
description	string	コスト配賦規則の説明。
details	CostAllocationRuleDetails	コスト配分ルールのリソース情報
status	RuleStatus	ルールの状態
updatedDate	string	ルールが最後に更新された時刻。

ErrorDetails

エラーの詳細。

名前	型	説明
code	string	エラーコード。
message	string	操作が失敗した理由を示すエラーメッセージ。

ErrorResponse

エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。

いくつかのエラー応答:

429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。
503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。

名前	型	説明
error	ErrorDetails	エラーの詳細。

RuleStatus

ルールの現在の状態。

名前	型	説明
Active	string	ルールが保存され、コストの割り当てに影響します。
NotActive	string	ルールは保存されますが、コストの割り当てには使用されません。
Processing	string	ルールが保存され、コストの割り当てが更新されます。 put 要求で送信できない読み取り専用の値。

SourceCostAllocationResource

コスト割り当てのソースリソース

名前	型	説明
name	string	リソースの種類がディメンションの場合、これは ResourceGroupName または SubscriptionId である必要があります。リソースの種類がタグの場合、これは有効な Azure タグである必要があります
resourceType	CostAllocationResourceType	このコスト割り当てルールに含まれるリソースの種類
values	string[]	コスト割り当てのソースリソース。このリストには、25 を超える値を含めることはできません。

TargetCostAllocationResource

コスト割り当てのターゲットリソース。

名前	型	説明
name	string	リソースの種類がディメンションの場合、これは ResourceGroupName または SubscriptionId である必要があります。リソースの種類がタグの場合、これは有効な Azure タグである必要があります
policyType	CostAllocationPolicyType	ルールのコスト割り当ての方法
resourceType	CostAllocationResourceType	このコスト割り当てルールに含まれるリソースの種類
values	CostAllocationProportion[]	コスト割り当てのターゲットリソース。このリストには、25 を超える値を含めることはできません。

次の方法で共有

Cost Allocation Rules - Get

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

CostAllocationRules

要求のサンプル

応答のサンプル

定義

CostAllocationPolicyType

CostAllocationProportion

CostAllocationResourceType

CostAllocationRuleDefinition

CostAllocationRuleDetails

CostAllocationRuleProperties

ErrorDetails

ErrorResponse

RuleStatus

SourceCostAllocationResource

TargetCostAllocationResource

その他のリソース