機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

アカウントのタグ付きリソース使用コストの表示

get

/metering/api/v1/usagecost/{accountId}/tagged

指定されたタグでタグ付けされたすべてのリソースの使用コストを取得します。

リクエスト

パス・パラメータ

• accountId: string
  cacctで始まるアカウント名。

問合せパラメータ

• computeTypeEnabled: string
  Yの場合、使用費はcomputeTypeでグループ化され、発生するコストの性質(使用、超過、販促、PAYGなど)を示すために使用されます。これはオプションです。
• dataCenter: string
  コストを取得する必要があるデータセンターのフィルタ。 これはOCI Classicサービスで使用され、OCIサービスからデータを取得する場合は必要ありません。 これはオプションのパラメータです。
• dcAggEnabled: string
  Yの場合、使用コストはデータセンターごとにグループ化されます。 これはオプションです。
• endTime: string
  使用コストがretrieved.Thisで必須となる間隔の終了時間を指定します。
• resourceName: string
  リソース名フィルタ。 PIC_COMPUTE_VM_STANDARD、PIC_BLOCK_STORAGE_STANDARDなどの例。これはオプションです。
• rollupLevel: string
  rollupLevelがRESOURCEに設定されている場合、リソースとタグの組合せごとの使用コストが表示されます。 その場合、繰り返される各タグ・パラメータは単一のタグである必要があります。 これはオプションです。
• serviceEntitlementId: string
  サービス資格/権利IDフィルタ。 これはオプションです。
• serviceName: string
  サービス名フィルタ。 例DATATRANSFERBM、EXADATABM。 これはオプションです。
• startTime: string
  使用費を取得する間隔の開始を指定します。 これは必須です。
• tags: array
  コレクション形式: multi

  タグ・パラメータでは、パイプ(|)を使用して、論理ANDと同時に適用される複数のタグをフィルタできます。 繰り返されるタグ・パラメータは、or句として解釈されます。 タグをURLエンコードする必要があります。つまり、. (ドット)は%3Aに置き換えられ、= (等しい)は%3Dに置き換えられます。 例、Finance.CostCenter=w1234ではなくFinance%3ACostCenter%3Dw1234。

  • [0]: string

  {
      "name":"tags",
      "in":"query",
      "type":"array",
      "items":{
          "type":"string"
      },
      "collectionFormat":"multi",
      "description":"A tags parameter can use a pipe (|) separated to filter for multiple tags applied simultaneously with a logical AND. Repeated tags parameters are interpreted as or-clauses.  You need to URL encode the tags which means . (dot) is replaced by %3A and = (equals) is replaced by %3D.  E.g. Finance%3ACostCenter%3Dw1234 instead of Finance.CostCenter=w1234."
  }

• timeZone: string
  開始時間と終了時間が指定されているタイムゾーン。 UTC、US/Pacific,America/Los_Angelesなど。
• usageType: string
  UsageTypeはTOTAL、HOURLYまたはDAILYです。 デフォルトはTOTALです。 HOURLY usageTypeの場合、最大間隔は7日間、DAILYの場合は30日間です。 結果は、選択したusageTypeに応じて時間間隔別にグループ化されます。

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/vnd.com.oracle.oraclecloud.metering.usage+json

200レスポンス

成功

本文()

ルート・スキーマ : AccountUsageCostRecord

型: object

タイトル: AccountUsageCostRecord

ソースを表示

• accountId(optional): string
• canonicalLink(optional): string
• items(optional): array items

{
    "type":"object",
    "title":"AccountUsageCostRecord",
    "properties":{
        "accountId":{
            "description":"",
            "type":"string"
        },
        "canonicalLink":{
            "description":"",
            "type":"string"
        },
        "items":{
            "description":"",
            "type":"array",
            "items":{
                "type":"array",
                "items":{
                    "$ref":"#/definitions/json_UsageCostRecord"
                }
            }
        }
    },
    "description":""
}

ネストされたスキーマ: items

型: array

ソースを表示

• Array of: array items

{
    "description":"",
    "type":"array",
    "items":{
        "type":"array",
        "items":{
            "$ref":"#/definitions/json_UsageCostRecord"
        }
    }
}

ネストされたスキーマ: items

型: array

ソースを表示

• Array of: object UsageCostRecord
  タイトル: UsageCostRecord

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/json_UsageCostRecord"
    }
}

ネストされたスキーマ : UsageCostRecord

型: object

タイトル: UsageCostRecord

ソースを表示

• costs(optional): array costs
• currency(optional): string
  Currency
• dataCenterId(optional): object dataCenterId
  データセンターID
• endTimeUtc(optional): object endTimeUtc
  コストが返される間隔の終了時間。
• gsiProductId(optional): string
  SKUのGSI製品ID。
• lastComputationDate(optional): object lastComputationDate
  請求システムからコストが同期された時間。
• quantity(optional): number
  数量
• resourceName(optional): string
  リソース名
• serviceName(オプション): string
  サービス名
• startTimeUtc(optional): object startTimeUtc
  コストが返される間隔の開始時間。
• subscriptionId(optional): string
  購買資格/権利ID。
• subscriptionType(オプション): string
  試用または本番。
• tag(optional): string
  この使用方法に適用されるタグ。

{
    "type":"object",
    "title":"UsageCostRecord",
    "properties":{
        "costs":{
            "description":"",
            "type":"array",
            "items":{
                "type":"array",
                "items":{
                    "$ref":"#/definitions/json_UsageCost"
                }
            }
        },
        "currency":{
            "description":"Currency.",
            "type":"string"
        },
        "endTimeUtc":{
            "description":"End time of the interval for which cost is returned.",
            "type":"object"
        },
        "gsiProductId":{
            "description":"GSI product id for the Sku.",
            "type":"string"
        },
        "quantity":{
            "description":"Quantity.",
            "type":"number"
        },
        "resourceName":{
            "description":"Resource Name.",
            "type":"string"
        },
        "serviceName":{
            "description":"Service Name.",
            "type":"string"
        },
        "startTimeUtc":{
            "description":"Start time of the interval for which cost is returned.",
            "type":"object"
        },
        "subscriptionId":{
            "description":"Purchase Entitlement Id.",
            "type":"string"
        },
        "subscriptionType":{
            "description":"Trial or production.",
            "type":"string"
        },
        "lastComputationDate":{
            "description":"Time at which cost was synced from billing system.",
            "type":"object"
        },
        "dataCenterId":{
            "description":"Datacenter Id",
            "type":"object"
        },
        "tag":{
            "description":"Tag applied on this usage.",
            "type":"string"
        }
    },
    "description":""
}

ネストされたスキーマ : costs

型: array

ソースを表示

• Array of: array items

{
    "description":"",
    "type":"array",
    "items":{
        "type":"array",
        "items":{
            "$ref":"#/definitions/json_UsageCost"
        }
    }
}

ネストされたスキーマ : dataCenterId

型: object

データセンターID

ネストされたスキーマ : endTimeUtc

型: object

コストが返される間隔の終了時間。

ネストされたスキーマ : lastComputationDate

型: object

請求システムからコストが同期された時間。

ネストされたスキーマ : startTimeUtc

型: object

コストが返される間隔の開始時間。

ネストされたスキーマ: items

型: array

ソースを表示

• Array of: object UsageCost
  タイトル: UsageCost

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/json_UsageCost"
    }
}

ネストされたスキーマ : UsageCost

型: object

タイトル: UsageCost

ソースを表示

• computedAmount(optional): number
  使用量に対してコンピュートされたコスト。
• computedQuantity(optional): number
  コストの計算に使用される数量です。
• overagesFlag(optional): string
  Yの場合、コストは過剰です。
• rateCardId(optional): string
  GSIレート・カード識別子。
• unitPrice(optional): number
  リソースの単価。

{
    "type":"object",
    "title":"UsageCost",
    "properties":{
        "computedAmount":{
            "description":"Cost computed for usage.",
            "type":"number"
        },
        "computedQuantity":{
            "description":"Quantity used for computing cost.",
            "type":"number"
        },
        "overagesFlag":{
            "description":"If Y, then the cost is an overage.",
            "type":"string"
        },
        "rateCardId":{
            "description":"GSI rate card identifier.",
            "type":"string"
        },
        "unitPrice":{
            "description":"Price per unit of resource.",
            "type":"number"
        }
    },
    "description":""
}

デフォルト・レスポンス

予期しないエラー

トップに戻る

例

これらのAPIは非推奨です。 Oracle Cloud Infrastructure支出を追跡および最適化する方法の詳細は、「APIを使用したコスト分析の概要」を参照してください。 置換エンドポイントがあるかどうかを確認するには、「非推奨の通知(エンドポイント)」を参照してください。

先頭に戻る