automation-cloud
latest
false
UiPath Automation Cloud API ガイド
- 基本情報
- 認証
- 範囲と権限
- プラットフォーム管理 API
このエンドポイントを使用して、特定のテナントのサービス別の消費の日次内訳を取得します。
API エンドポイント
POST {accessURL}/lease_/api/usage/{organizationId}/tenants/daily-consumption-by-service
すべてのエンドポイント パスの {accessURL} は、ご使用のクラウド プラットフォームのベース URL に置き換えてください。
| Cloud Platform | アクセス URL |
|---|---|
| Automation Cloud | https://cloud.uipath.com/ |
| Automation Cloud (公共部門向け) | https://govcloud.uipath.us/ |
| Automation Cloud (専有型) | https://{customURL}.dedicated.uipath.com/ |
要求ヘッダー
--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'
注:
{access_token}を取得するには、必ずこちらで説明する ROPC の方法で認証を行ってください。
パス パラメーター
| パス パラメーター | データ型 | 説明 |
|---|---|---|
organizationId (必須) | 文字列 (GUID) | テナントが存在する組織の ID。 |
要求本文
要求本文では、テナント、日付範囲、消費可能コード、任意のフィルターを指定します。消費可能コードの詳細なリストについては、「 消費状況」をご覧ください。
{
"tenantId": "string",
"startDate": 0,
"endDate": 0,
"consumableCode": "string",
"aggregateByOwnership": false,
"folderKeys": ["string"]
}
{
"tenantId": "string",
"startDate": 0,
"endDate": 0,
"consumableCode": "string",
"aggregateByOwnership": false,
"folderKeys": ["string"]
}
注:
startDateとendDateは、ミリ秒単位の Unix タイムスタンプです。aggregateByOwnership省略可能です (既定値:false)。trueに設定すると、消費は、プロセスが実行された場所ではなく、プロセスを所有するフォルダー別に集計されます。folderKeysは任意です。結果を特定のフォルダーのみにフィルター処理するには、フォルダー GUID のリストを指定します。
応答
200 OK
指定したテナントについて、サービス別にグループ化した日次の消費レコードのリストを返します。
要求の例
呼び出しは次の例のようになります (cURL)。
curl --location --request POST 'https://cloud.uipath.com/lease_/api/usage/11111111-1111-1111-1111-111111111111/tenants/daily-consumption-by-service' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
"tenantId": "string",
"startDate": 1704067200000,
"endDate": 1706745600000,
"consumableCode": "consumption_unit_code"
}'
curl --location --request POST 'https://cloud.uipath.com/lease_/api/usage/11111111-1111-1111-1111-111111111111/tenants/daily-consumption-by-service' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
"tenantId": "string",
"startDate": 1704067200000,
"endDate": 1706745600000,
"consumableCode": "consumption_unit_code"
}'
毎日消費数を正常に取得した場合の応答本文を次に示します。
{
"items": [
{
"date": "2024-01-15",
"service": "string",
"consumedAmount": 0
}
]
}
{
"items": [
{
"date": "2024-01-15",
"service": "string",
"consumedAmount": 0
}
]
}