移動先

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

ロック済ブロックのリスト

get

/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/locks/blocks

指定されたアプリケーションおよびデータベースからすべてのロック済ブロックを返します。

リクエスト

パス・パラメータ

• applicationName(required): string

  アプリケーション名。

• databaseName(required): string

  データベース名。

問合せパラメータ

• limit: integer(int32)
  返される最大ブロック数。デフォルトは50です。

  デフォルト値: 50
• offset: integer(int32)

  結果セットの先頭から省略するアイテムの数。

  デフォルト値: 0

先頭に戻る

レスポンス

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

• application/json
• application/xml

200 レスポンス

OK

ロック済ブロックが正常に返されました。ロック済ブロックの詳細、およびオブジェクトをロック解除するためのリンクが含まれています。

本体()

ルート・スキーマ : schema

型: array

ソースの表示

• 配列: object LockBlockList

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

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

型: object

ソースの表示

• count: integer(int64)
• hasMore: boolean
• items: array items
• limit: integer(int64)
• offset: integer(int64)
• properties: object properties
  使用可能なその他のプロパティ: additionalProperties
• totalResults: integer(int64)

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LockBlock"
            }
        },
        "totalResults":{
            "type":"integer",
            "format":"int64"
        },
        "limit":{
            "type":"integer",
            "format":"int64"
        },
        "offset":{
            "type":"integer",
            "format":"int64"
        },
        "hasMore":{
            "type":"boolean"
        },
        "count":{
            "type":"integer",
            "format":"int64"
        },
        "properties":{
            "type":"object",
            "additionalProperties":{
                "type":"string"
            }
        }
    }
}

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

型: array

ソースの表示

• 配列: object LockBlock

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

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

型: object

使用可能なその他のプロパティ

ソースの表示

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

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

型: object

ソースの表示

• count: integer(int32)
• duration: integer(int32)
• links: array links
• user: string

{
    "type":"object",
    "properties":{
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        },
        "user":{
            "type":"string"
        },
        "count":{
            "type":"integer",
            "format":"int32"
        },
        "duration":{
            "type":"integer",
            "format":"int32"
        }
    }
}

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

型: array

ソースの表示

• 配列: object Link

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

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

型: object

ソースの表示

• href: string
• method: string
• rel: string
• type: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "method":{
            "type":"string"
        },
        "type":{
            "type":"string"
        }
    }
}

400 レスポンス

不正なリクエスト

ロック済ブロックの取得に失敗しました。アプリケーション名またはデータベース名が正しくない可能性があります。

500 レスポンス

サーバーの内部エラーです。

先頭に戻る

例

次の例では、Essbaseブロック・ストレージ・キューブ内のロック済データ・ブロックをリストする方法を示します。

この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。

cURLコマンドを含むスクリプト

call properties.bat
curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/databases/Basic/locks/blocks?offset=0&limit=50" -H  accept: application/json -u %User%:%Password%

レスポンス本体の例

次の例では、ロックされたブロックのロックを解除するリンクを含め、レスポンス本体の内容をJSON形式で示します。

{
  "items": [
    {
      "user": "power1",
      "count": 1,
      "duration": 450,
      "links": [
        {
          "rel": "unlock",
          "href": "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/databases/Basic/locks/blocks/unlock",
          "method": "POST"
        }
      ]
    }
  ],
  "totalResults": 1,
  "limit": 25,
  "count": 1,
  "offset": 0,
  "hasMore": false
}

先頭に戻る