次の項では、Oracle Virtual Assembly BuilderデプロイヤWebサービスAPIにおけるデプロイヤ操作について説明します(この操作は、そこに含まれるソフトウェア・システムのアセンブリ・アーカイブおよびデプロイメントの側面を管理するために使用されます)。
次の定義は、各操作の「HTTP問合せ文字列における他のパラメータ」の項に示すパラメータに適用されます。
1..1 : パラメータは必須で、指定できるのは1回だけです。
1..* : パラメータは必須で、複数回指定できます。
0..1 : パラメータはオプションで、指定する場合は1回だけ指定できます。
0..* : パラメータはオプションで、指定する場合は複数回指定できます。
この操作によって、他のユーザーにアセンブリへのアクセス権が付与されます。この操作は、アセンブリの所有者またはクラウド管理者によってのみ呼出し可能です。所有者は、デプロイヤにアセンブリを最初にアップロードしたユーザーとして定義されます。
アクセス権が付与されるユーザーは、ターゲットにアセンブリを登録でき、アセンブリ・インスタンスを作成できます。
HTTP問合せ文字列における他のパラメータ
user 1..*
assembly.name 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: AddAssemblyUsersResult
この操作によって、アセンブリにアセンブリ・インスタンスを作成します。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
target 1..1
HTTPメソッド
POST
リクエストのコンテンツ
application/octetstream
プラン・ファイル
動作
同期。
レスポンスのコンテンツ
text/xml要素: CreateAssemblyInstanceResult
この操作によって、リソースに1つ以上のタグを作成します。
HTTP問合せ文字列における他のパラメータ
tag 1..*
resource.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: CreateTagsResult
この操作によって、デプロイヤからアセンブリ・アーカイブを削除します。この操作は、アセンブリ・アーカイブの登録がない場合にのみ実行できます。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DeleteAssemblyArchiveResult
この操作によって、アセンブリ・インスタンスを削除します。この操作は、アセンブリがアンデプロイ済の状態である場合にのみ実行可能です。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id
1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DeleteAssemblyInstanceResult
この操作によって、以前に完了したリクエストを1つ以上削除します。
HTTP問合せ文字列における他のパラメータ
request.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DeleteRequestsResult
この操作によって、リソースのタグを1つ以上削除します。
HTTP問合せ文字列における他のパラメータ
tag 1..*
resource.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DeleteTagsResult
この操作によって、アセンブリ・インスタンスをデプロイします。この操作によって、OVFおよびデプロイメント計画で定義されたデプロイメントの初期インスタンスの作成が編成されます。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: DeployAssemblyInstanceResult
この操作によって、デプロイヤの1つ以上のアセンブリを記述します。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeAssemblyArchivesResult
この操作によって、アセンブリの1つ以上のデプロイ済インスタンスを記述します。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 0..1
appliance.id 0..1
instance.id 0..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeApplianceInstancesResult
この操作によって、1つ以上のアセンブリ・インスタンスを記述します。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeAssemblyInstancesResult
この操作によって、アセンブリの1つ以上のユーザーを記述します。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeAssemblyUsersResult
この操作によって、デプロイヤのバージョン情報が提供されます。
HTTP問合せ文字列における他のパラメータ
N/A
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: RedeployAssemblyInstanceResult
この操作によって、1つ以上のアセンブリ登録を記述します。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeRegistrationsResult
この操作によって、以前に発行された1つ以上のリクエストを記述します。
HTTP問合せ文字列における他のパラメータ
request.id 1..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeRequestsResult
この操作によって、1つ以上のスケーリング・グループを記述します。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 0..*
scalinggroup.id 0..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeScalingGroupsResult
この操作によって、リソースの1つ以上のタグを記述します。
HTTP問合せ文字列における他のパラメータ
tag 1..*
resource.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeTagsResult
この操作によって、1つ以上のアセンブリ・インスタンス・ターゲットを記述します。
HTTP問合せ文字列における他のパラメータ
target 1..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeTargetsResult
この操作によって、1つ以上のネットワークを記述します。
HTTP問合せ文字列における他のパラメータ
target 1..1
id 0..*
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: DescribeVnetsResult
この操作によって、デプロイヤからアセンブリをダウンロードします。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
application/octet-stream
アセンブリ・アーカイブ(.ovaファイル)
この操作によって、デプロイヤからアセンブリ・メタデータ記述子をダウンロードします。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
application/octet-stream
アセンブリ・メタデータ(.ovfファイル)
この操作によって、既存のデプロイメントからデプロイメント計画をダウンロードします。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
application/octet-stream
プラン・ファイル
この操作によって、アセンブリ・インスタンスを再デプロイします。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: RedeployAssemblyInstanceResult
この操作によって、バックエンド仮想化システム(Oracle VMまたはOracle Exalogic)にアーカイブを登録します。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
assembly.desc 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: RegisterAssemblyArchiveResult
この操作によって、アセンブリからユーザーを削除します。
HTTP問合せ文字列における他のパラメータ
user 1..*
assembly.name 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: RemoveAssemblyUsersResult
この操作によって、アセンブリ・インスタンスを再起動します。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: RestartAssemblyInstanceResult
この操作によって、アプライアンスをスケールします。この操作によって、アプライアンスに必要なインスタンス数を変更し、この新しい数値に応じてインスタンスを作成して開始するか、または停止して破棄します。
HTTP問合せ文字列における他のパラメータ
scalinggroup.id 1..1
target 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: ScaleApplianceResult
この操作によって、アセンブリ・インスタンスを起動します。
HTTP問合せ文字列における他のパラメータ
deployment.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: StartAssemblyInstanceResult
この操作によって、アセンブリ・インスタンスを停止します。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
force 0..1(デフォルトはfalse)
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
非同期。
レスポンスのコンテンツ
text/xml要素: StopAssemblyInstanceResult
この操作によって、アセンブリ・インスタンスをアンデプロイします。
HTTP問合せ文字列における他のパラメータ
assembly.instance.id 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: UndeployAssemblyInstanceResult
この操作によって、バックエンド仮想化システム(ターゲット)から、登録のアーティファクトを削除します。ターゲットのこのアセンブリ・アーカイブのアセンブリ・インスタンスが存在しない場合にのみ、この操作を呼び出すことができます。
HTTP問合せ文字列における他のパラメータ
assembly.version 1..1
assembly.name 1..1
target 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: UnregisterAssemblyArchiveResult
この操作によって、アセンブリ・アーカイブの記述情報を変更することが許可されます。
注意: 新規バージョンをアップロードするには、 |
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
assembly.version 1..1
assembly.desc 1..1
HTTPメソッド
GET
リクエストのコンテンツ
N/A
動作
同期。
レスポンスのコンテンツ
text/xml要素: UpdateAssemblyArchiveResult
この操作を使用して、クライアントからデプロイヤにアセンブリ操作をアップロードします。デプロイヤはアセンブリ・アーカイブの複数のバージョンを保持するため、同じアセンブリに対しこの操作を複数回呼び出す可能性があります。
HTTP問合せ文字列における他のパラメータ
assembly.name 1..1
HTTPメソッド
POST
リクエストのコンテンツ
application/octetstream
アセンブリ・アーカイブ(.ovaファイル)
動作
同期。
レスポンスのコンテンツ
text/xml要素: UploadAssemblyArchiveResult