Oracle Enterprise ManagerのREST API

権限に対するユーザーのセキュア・リソースのリスト

get

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/users/{userId}/privilegeGrants/{privilegeName}/secureResources

このAPIは、デフォルトでは名前順(昇順)でユーザーに付与された権限のセキュア・リソースのリストを返します。

リクエスト

パス・パラメータ

privilegeName(必須): string
付与された権限の名前
例:
```
FULL_JOB
```
userId(必須): string

ユーザーのID。

問合せパラメータ

limit: integer

最小値: 1

最大値: 2000

リストのページ分割用。ページ当たりの最大結果数、またはページ分割される"List"コールで返すアイテムの最大数。このAPIでは、limitとして指定した数より多を返すことはありませんが、その数が必ずしも返されるというわけではありません。

デフォルト値: 20
name: string
フィルタ処理するセキュア・リソースの正確な名前
例:
```
REFRESH_DOMAIN_230
```
nameContains: string
フィルタ処理に使用されるセキュア・リソースの名前の一部
例:
```
REFRESH
```
page: string

ページのシステム生成ページ・トークン。
sort: string
方向付きの結果セットの順序。許容されるソート・フィールドは名前です。指定可能な方向はDESCとASCです
例:
```
name:DESC
```
type: string
セキュア・リソースのサブタイプ
例:
```
NORMAL_JOB
```

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

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

application/json

200レスポンス

権限のセキュア・リソースが正常に返されました

ルート・スキーマ: SecureResourceCollection

型: object

これは、SecureResourcesのリストを表すものです。

ソースの表示

count(必須): integer

このページ内のリソースの数

例: 20
items(必須): array items

SecureResourceリスト
links(必須): object links

読取り専用: true

結果セットのナビゲーション・リンク

{
    "required":[
        "count",
        "items",
        "links"
    ],
    "type":"object",
    "properties":{
        "count":{
            "type":"integer",
            "description":"the number of Resources in this page",
            "example":"20"
        },
        "links":{
            "type":"object",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                },
                "previous":{
                    "$ref":"#/components/schemas/Link"
                },
                "next":{
                    "$ref":"#/components/schemas/Link"
                }
            },
            "description":"the result set navigation links",
            "readOnly":true
        },
        "items":{
            "type":"array",
            "description":"the SecureResource list",
            "items":{
                "$ref":"#/components/schemas/SecureResourceSummary"
            }
        }
    },
    "description":"This is the representation of List of SecureResources."
}

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

型: array

SecureResourceリスト

ソースの表示

配列: object SecureResourceSummary

ターゲット・インスタンス、ジョブ・インスタンスなどのSecureResourceを表します。

{
    "type":"array",
    "description":"the SecureResource list",
    "items":{
        "$ref":"#/components/schemas/SecureResourceSummary"
    }
}

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

型: object

読取り専用: true

結果セットのナビゲーション・リンク

ソースの表示

next: object Link

REST APIを参照するリンク。
previous: object Link

REST APIを参照するリンク。
self: object Link

REST APIを参照するリンク。

{
    "type":"object",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        },
        "previous":{
            "$ref":"#/components/schemas/Link"
        },
        "next":{
            "$ref":"#/components/schemas/Link"
        }
    },
    "description":"the result set navigation links",
    "readOnly":true
}

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

型: object

ターゲット・インスタンス、ジョブ・インスタンスなどのSecureResourceを表します。

ソースの表示

id: string

リソースのID

例: DE5CD14CE9D0C0EBEFFFDDEBAA83DA33
name: string

読取り専用: true

リソースの名前

例: /EMGC_EMGC_DOMAIN/EMGC_DOMAIN
owner: string

読取り専用: true

リソースの所有者

例: SYSMAN
propagationPolicy: array propagationPolicy

権限が適用されるスコープ。これは、TARGETと呼ばれるセキュア・リソース・タイプにのみ適用されます。
type: string

読取り専用: true

リソースのリソース・セット・タイプの内部名

例: weblogic_domain_name
typeDisplayName: string

読取り専用: true

リソースのリソース・セット・タイプの表示名

例: Oracle WebLogic Domain

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Id of the Resource",
            "example":"DE5CD14CE9D0C0EBEFFFDDEBAA83DA33"
        },
        "name":{
            "type":"string",
            "description":"Name of the Resource",
            "readOnly":true,
            "example":"/EMGC_EMGC_DOMAIN/EMGC_DOMAIN"
        },
        "type":{
            "type":"string",
            "description":"Internal name of Resource Set Type of the Resource",
            "readOnly":true,
            "example":"weblogic_domain_name"
        },
        "typeDisplayName":{
            "type":"string",
            "description":"Display name of Resource Set Type of the Resource",
            "readOnly":true,
            "example":"Oracle WebLogic Domain"
        },
        "propagationPolicy":{
            "type":"array",
            "description":"Scope where the privilege is applicable to. This is applicable only for Secure Resource Type called TARGET.",
            "example":"MEMBERS",
            "items":{
                "$ref":"#/components/schemas/PropagationPolicy"
            }
        },
        "owner":{
            "type":"string",
            "description":"Owner of the Resource",
            "readOnly":true,
            "example":"SYSMAN"
        }
    },
    "description":"It represents a SecureResource like Target Instance, Job Instance etc."
}

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

型: array

権限が適用されるスコープ。これは、TARGETと呼ばれるセキュア・リソース・タイプにのみ適用されます。

ソースの表示

配列: string

指定可能な値: [ "ALL", "SELF", "MEMBERS" ]

これにより、コンポジット・リソースのどの部分に権限が適用されるかを示すタイプが得られます。- ALLは、コンポジット・リソースとそのメンバーに権限が付与されることを意味します。- SELFは、コンポジット・リソースにのみ権限が付与されることを意味します。- MEMBERSは、コンポジット・リソースのメンバーにのみ権限が付与されることを意味します。

{
    "type":"array",
    "description":"Scope where the privilege is applicable to. This is applicable only for Secure Resource Type called TARGET.",
    "example":"MEMBERS",
    "items":{
        "$ref":"#/components/schemas/PropagationPolicy"
    }
}

例:

MEMBERS

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

型: object

REST APIを参照するリンク。

ソースの表示

href: string

リンクURL

{
    "x-em-sdk-level":"emSDK",
    "description":"A link referencing a REST API.",
    "type":"object",
    "properties":{
        "href":{
            "description":"Link URL",
            "type":"string"
        }
    }
}

400レスポンス

不正なリクエスト

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

401レスポンス

認証に失敗しました

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

500レスポンス

内部サーバー・エラー

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

先頭に戻る