エージェントを取得する
get
/oaa-policy/agent/v1/{agentgid}
リクエスト
パス・パラメータ
- agentgid(required): string
エージェントの識別子。
この操作にはリクエスト本文はありません。
先頭に戻るレスポンス
サポートされるメディア・タイプ
- application/xml
- application/json
200レスポンス
エージェント情報
ルート・スキーマ: AgentResponse
型:
ソースの表示
object
-
agent: object schema
エージェントの詳細
-
agentgid: string
後続のリクエストで使用できるエージェントのグローバル識別子。
-
message: string
リクエストのステータスに関連するメッセージ
-
status: string
リクエストのステータス
ネストされたスキーマ: schema
型:
object
エージェントの詳細
ソースの表示
-
agentgid: string
エージェントの一意の識別子。
-
agentName(required): string
エージェントの一意の名前
-
clientId: string
エージェントの識別に使用されるエージェントのクライアントID
-
clientSecret: string
クライアントの認証に使用されるクライアント・シークレット
-
clientType(required): string
クライアント・タイプ。このフィールドで使用可能な値はOAM、RadiusまたはAPIです。
-
createTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
-
description: string
エージェントの説明
-
privateKey: string
リクエスト・パラメータを暗号化/復号化するために使用できるエージェントの秘密キーの文字列表現。
-
privateKeyFile: string
秘密キーのファイル名。
-
privateKeyPassword: string
秘密キーのBase64でエンコードされたパスワード。
-
updateTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
401レスポンス
未認可
405レスポンス
無効な入力
ルート・スキーマ: AgentResponse
型:
ソースの表示
object
-
agent: object schema
エージェントの詳細
-
agentgid: string
後続のリクエストで使用できるエージェントのグローバル識別子。
-
message: string
リクエストのステータスに関連するメッセージ
-
status: string
リクエストのステータス
ネストされたスキーマ: schema
型:
object
エージェントの詳細
ソースの表示
-
agentgid: string
エージェントの一意の識別子。
-
agentName(required): string
エージェントの一意の名前
-
clientId: string
エージェントの識別に使用されるエージェントのクライアントID
-
clientSecret: string
クライアントの認証に使用されるクライアント・シークレット
-
clientType(required): string
クライアント・タイプ。このフィールドで使用可能な値はOAM、RadiusまたはAPIです。
-
createTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
-
description: string
エージェントの説明
-
privateKey: string
リクエスト・パラメータを暗号化/復号化するために使用できるエージェントの秘密キーの文字列表現。
-
privateKeyFile: string
秘密キーのファイル名。
-
privateKeyPassword: string
秘密キーのBase64でエンコードされたパスワード。
-
updateTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
500レスポンス
内部サーバー・エラー
503レスポンス
サービス使用不可
例
次の例は、エージェントを取得するサンプルのリクエストとレスポンスを示します。
JSON形式でエージェントを取得するcURLコマンド
curl --location --request GET '<PolicyUrl>/oaa-policy/agent/v1/dede64d3-1d6a-42e9-89e1-714e88f8967c' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'
JSON形式のサンプル・レスポンス
{ "status": "200", "message": "Successful", "agentgid": "dede64d3-1d6a-42e9-89e1-714e88f8967c", "agent": { "agentName": "APIAgent", "description": "Agent for REST API", "clientId": "c1e08e6a-b555-47e1-84a5-36edd06fbf57", "clientSecret": "b2484989-5f42-4ad8-b0ab-7bbaa06ee786", "clientType": "api", "agentgid": "dede64d3-1d6a-42e9-89e1-714e88f8967c", "createTime": { "parseFailed": false, "dateTime": "2021-04-01T09:06:13.668Z", "rawParam": "2021-04-01T09:06:13.668Z" }, "updateTime": { "parseFailed": false, "dateTime": "2021-04-01T09:06:13.668Z", "rawParam": "2021-04-01T09:06:13.668Z" } } }
XML形式でエージェントを取得するcURLコマンド
curl --location --request GET '<PolicyUrl>/oaa-policy/agent/v1/dede64d3-1d6a-42e9-89e1-714e88f8967c' \ --header 'Content-Type: application/xml' \ --header 'Accept: application/xml' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'
XML形式のサンプル・レスポンス
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AgentResponse> <status>200</status> <message>Successful</message> <agentgid>dede64d3-1d6a-42e9-89e1-714e88f8967c</agentgid> <agent> <agentName>APIAgent</agentName> <description>Agent for REST API</description> <clientId>c1e08e6a-b555-47e1-84a5-36edd06fbf57</clientId> <clientSecret>b2484989-5f42-4ad8-b0ab-7bbaa06ee786</clientSecret> <clientType>api</clientType> <agentgid>dede64d3-1d6a-42e9-89e1-714e88f8967c</agentgid> <createTime> <parseFailed>false</parseFailed> <dateTime>2021-04-01T09:06:13.668Z</dateTime> <rawParam>2021-04-01T09:06:13.668Z</rawParam> </createTime> <updateTime> <parseFailed>false</parseFailed> <dateTime>2021-04-01T09:06:13.668Z</dateTime> <rawParam>2021-04-01T09:06:13.668Z</rawParam> </updateTime> </agent> </AgentResponse>