ジャンプ先

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

すべての割当て済証明の取得

get

/iam/governance/selfservice/api/v1/certifications

ログイン・ユーザーに割り当てられたすべての証明を返します。

リクエスト

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

• application/json

問合せパラメータ

• q(optional): string
  証明を取得する検索フィルタ。SCIMフィルタを受け入れます。フィルタ値に空白は使用できません。属性値に空白を渡す場合、"::"に置き換えます。フィルタでサポートされている属性は、typeおよびuseridです。フィルタのサンプル値は、"type eq Application"または"type eq Role and userid={userId}"です。

先頭に戻る

レスポンス

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

• application/json

200レスポンス

成功

ヘッダー

• ResponseTime: string
  リクエストの処理にかかった時間(ミリ秒)を取得します。

本文()

ルート・スキーマ: CertificationsResponse

型: object

ソースを表示

• certifications(optional): array certifications
• count(optional): integer
• hasMore(optional): boolean
• totalResult(optional): integer(int32)

{
    "properties":{
        "count":{
            "type":"integer"
        },
        "hasMore":{
            "type":"boolean"
        },
        "totalResult":{
            "type":"integer",
            "format":"int32"
        },
        "certifications":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/CertificationInstance"
            }
        }
    }
}

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

型: array

ソースを表示

• 配列: オブジェクト CertificationInstance

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

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

型: object

ソースを表示

• id(optional): string
• links(optional): array links

{
    "properties":{
        "id":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkDataInstances"
            }
        }
    }
}

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

型: array

ソースを表示

• 配列: オブジェクト LinkDataInstances

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

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

型: object

ソースを表示

• href(optional): string
• rel(optional): string

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

401レスポンス

未認可

404レスポンス

リソースが見つからない

500レスポンス

内部サーバー・エラー

デフォルト・レスポンス

予期しないエラー

先頭に戻る

例

この例では、状態が割り当てられているすべての証明を取得します。ここで表示された情報は疑似システムに対するものであり、プロトタイプとして使用します。

cURLの例

curl  -H "Content-Type: application/json"  -X GET  -u username:password  https://pseudo.com/iam/governance/selfservice/api/v1/certifications?q=state+eq+assigned

GETレスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
    "links": [
        {
            "rel": "self",
            "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/certifications?
offset=1&limit=10&q=state+eq+assigned"
        },
        {
            "rel": "first",
            "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/certifications?
offset=1&limit=10&q=state+eq+assigned"
        }
    ],
    "count": 2,
    "hasMore": false,
    "totalResult": -1,
    "certifications": [
        {
            "links": [
                {
                    "rel": "self",
                    "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/certifications/3/tasks/be
a5a9e0-8e4c-455f-a34b-33ca190f0bce"
                }
            ],
            "state": "ASSIGNED",
            "name": "usercert  [ Bud Spencer ] Reassigned [ Ajay Arora ]",
            "type": "User",
            "id": "3",
            "asignee": "aarora",
            "createdDate": "2019-04-01T20:09:53Z",
            "soaTaskId": "d8a1bfb5-3f8d-4f51-b0f8-d24f1a3982a6",
            "taskId": "bea5a9e0-8e4c-455f-a34b-33ca190f0bce"
        },
        {
            "links": [
                {
                    "rel": "self",
                    "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/certifications/21/tasks/e
1d5e5dd-5f9e-4747-bd5f-e00dc0b99d58"
                }
            ],
            "state": "ASSIGNED",
            "name": "usercert [ Ajay Arora ]",
            "type": "User",
            "id": "21",
            "asignee": "aarora",
            "createdDate": "2019-04-08T16:33:18Z",
            "soaTaskId": "6899dc3d-645c-42b1-8d9d-39eb9719261f",
            "taskId": "e1d5e5dd-5f9e-4747-bd5f-e00dc0b99d58"
        }
    ]
}

先頭に戻る