ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Virtual Assembly Builderアプリケーションおよびイントロスペクション・プラグインの開発
12c (12.1.2)
E47992-01
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
次
 

3 APIリファレンス: 管理操作

次の項では、Oracle Virtual Assembly BuilderデプロイヤWebサービスAPIにおける管理操作について説明します。

3.1 HTTP問合せ文字列におけるパラメータ

次の定義は、各操作の「HTTP問合せ文字列における他のパラメータ」の項に示すパラメータに適用されます。

3.2 レスポンスのコンテンツ

操作のレスポンスのタイプは、Webサービス・スキーマの定義に対応します。付録A「Webサービス・スキーマ」を参照してください。

3.3 AddTargetUser

この操作によって、ターゲットに指定されたユーザーのユーザー構成情報が追加されます。AddTargetUserの目的は、ユーザーがターゲットを使用することを指定することに加えて、ターゲットと対話する際に使用されるユーザー固有の情報を、必要に応じて指定することです。

Oracle VMで使用されるデプロイヤの場合、AddTargetUserは、ターゲットに対するアクセス権限を付与するためにクラウド管理者によって呼び出されます。この場合、ターゲットの作成時にクラウド管理者が仮想化環境への資格証明を提供するため、他のプロパティは提供されません。資格証明は保護される必要があるため、一般的なデプロイヤの場合は、アプリケーション管理者がこの操作を呼び出すことは許可されません。

HTTP問合せ文字列における他のパラメータ

target 1..1

user 1..1

ユーザーのプロパティとして他のパラメータが使用されます。

HTTPメソッド

POST

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: AddTargetUserResult

必要なロールおよび権限

Oracle VMデプロイヤでは、クラウド管理者のみがAddTargetUserの呼出しを許可されます。資格情報をターゲットの構成に提供し、保護する必要があります。

この操作を呼び出すクラウド管理者は、自身以外のユーザー名を指定できます。

3.4 CreateTarget

この操作によって、デプロイメント操作のターゲットを作成します。コールには接続情報を定義する構成情報が含まれます。Oracle VMターゲットの資格情報を指定します。

HTTP問合せ文字列における他のパラメータ

name 1..1

type 1..1

default 0..1(デフォルト値はfalse)

ターゲットのプロパティとして、他のパラメータが使用されます。

HTTPメソッド

POST

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: CreateTargetResult

必要なロールおよび権限

この操作は、クラウド管理者によってのみ呼出し可能です。

3.5 DeleteTarget

この操作によって、デプロイメント・ターゲットおよびすべての構成情報が削除されます。このターゲットがあるユーザーまたはすべてのユーザーのデフォルトであった場合、このデフォルト設定は解除されます。.

HTTP問合せ文字列における他のパラメータ

name 1..1

HTTPメソッド

POST

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: DeleteTargetResult

必要なロールおよび権限

この操作は、クラウド管理者によってのみ呼出し可能です。

3.6 DescribeTargetConfigurations

この操作によって、ターゲットの構成情報を記述します。

HTTP問合せ文字列における他のパラメータ

target 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: DescribeTargetConfigurationsResult

必要なロールおよび権限

この操作は、クラウド管理者によってのみ呼出し可能です。

3.7 DescribeTargetNames

この操作によって、指定されたタイプのデプロイメント操作について作成されたターゲットがリストされます。

HTTP問合せ文字列における他のパラメータ

type 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: ListTargetsResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

3.8 DescribeTargetUsers

この操作によって、指定されたターゲットのユーザーがリストされます。

HTTP問合せ文字列における他のパラメータ

target 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: DescribeTargetUsersResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

3.9 DescribeUserTargets

この操作によって、指定されたユーザーのターゲットがリストされます。

HTTP問合せ文字列における他のパラメータ

user 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: DescribeUserTargetsResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

3.10 GetDefaultTarget

この操作によって、すべてのユーザーに対し、そのタイプのデフォルトのターゲットが取得されます。

HTTP問合せ文字列における他のパラメータ

type 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: GetDefaultTargetResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

3.11 GetTargetType

この操作によって指定したターゲット名のターゲット・タイプを取得します。

HTTP問合せ文字列における他のパラメータ

target 1..1

HTTPメソッド

GET

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: GetTargetTypeResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

3.12 RemoveTargetUsers

この操作によって、ターゲットからユーザーが削除されます。

HTTP問合せ文字列における他のパラメータ

target 1..1

user 1..*

HTTPメソッド

POST

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: RemoveTargetUsersResult

必要なロールおよび権限

この操作は、アプリケーション管理者またはクラウド管理者によって呼出し可能です。

クラウド管理者ロールを保持する呼出し元は、メソッドを呼び出して自分以外のユーザー名を指定できます。管理者以外のユーザーは、自分のユーザー名の指定のみが可能です。

3.13 SetDefaultTarget

この操作によって、すべてのユーザーに対し、そのタイプのすべてのターゲットに関するデフォルト・ターゲットとして、指定した名前のターゲット・タイプが設定されます。ユーザーがOracle Virtual Assembly Builder操作を呼び出し、指定されたターゲットがない、またはそのターゲット・タイプのsetUserDefaultTargetを以前に呼び出したことがない場合は、指定されたターゲットが使用されます。

HTTP問合せ文字列における他のパラメータ

name 1..1

HTTPメソッド

POST

リクエストのコンテンツ

N/A

レスポンスのコンテンツ

text/xml要素: SetDefaultTargetResult

必要なロールおよび権限

この操作は、クラウド管理者によってのみ呼出し可能です。