The following sections describes administrative operations in the Oracle Virtual Assembly Builder Deployer Web Service API:
The following designations apply to parameters in the "Other Parameters in HTTP Query String" sections of each operation:
1..1 : Parameter is required, and can have exactly one occurrence.
1..* : Parameter is required, and can have multiple occurrences.
0..1 : Parameter is optional, and can have exactly one occurrence, if provided.
0..* : Parameter is optional, and can have multiple occurrences, if provided.
The response types for the operations correspond to definitions in the Web service schema. See Appendix A, "Web Service Schema".
This operation adds user configuration information for the named user to the target. The purpose of AddTargetUser
, in addition to indicating that a user will be using the target, is to supply user specific information to be used when interacting with the target, if required.
For the Deployer which is used with Oracle VM, AddTargetUser
is called by the Cloud Administrator to grant access to the target. In this case, no other properties are provided because the Cloud Administrator provides credentials for the virtualization environment when the target is created. Application Administrators are not allowed to call this operation for the generic Deployer because the credentials must be protected.
For the Deployer in Oracle Exalogic, AddTargetUser
is called by the Application Administrator who will be using the target. In this case, the user provides his or her own credentials for accessing the target.
Other Parameters in HTTP Query String
target 1..1
user 1..1
Other parameters are used as properties for the user
GET
N/A
text/xml Element: AddTargetUserResult
Required Role and Authorization
In the Oracle VM Deployer, only the Cloud Administrator is allowed to call AddTargetUser
. In the Oracle Exalogic Deployer, any Application Administrator can call AddTargetUser
.
The reason for this difference is that in the generic case, the credentials are provided in the target configuration and must be protected, but in the Oracle Exalogic Deployer, the user supplies their own credential.
A Cloud Administrator who calls this operation can specify a username other than their own.
This operation creates a target for deployment operations. The call includes configuration information that defines the connection information, but depending on the type of target, credential information may or may not be included. Specifically, for the Oracle VM 3.0 target, credentials are supplied, but for the Oracle Exalogic target, credentials are not supplied here and you must supply them later in the AddTargetUser
operation.
Other Parameters in HTTP Query String
name 1..1
type 1..1
default 0..1 (default value is false)
Other parameters are used as properties for the target
GET
N/A
text/xml Element: CreateTargetResult
Required Role and Authorization
This operation can only be called by the Cloud Admin.
This operation deletes the deployment target and all configuration information. If this target was a default for a user or all users, then that default is unset.
Other Parameters in HTTP Query String
name 1..1
GET
N/A
text/xml Element: DeleteTargetResult
Required Role and Authorization
This operation can only be called by the Cloud Admin.
This operation describes configuration information for a target.
Other Parameters in HTTP Query String
target 1..1
GET
N/A
text/xml Element: DescribeTargetConfigurationsResult
Required Role and Authorization
This operation can only be called by the Cloud Admin.
This operation lists created targets for deployment operations for the given type.
Other Parameters in HTTP Query String
type 1..1
GET
N/A
text/xml Element: ListTargetsResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
This operation lists users for the given target.
Other Parameters in HTTP Query String
target 1..1
GET
N/A
text/xml Element: DescribeTargetUsersResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
This operation lists targets for the given user.
Other Parameters in HTTP Query String
user 1..1
GET
N/A
text/xml Element: DescribeUserTargetsResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
This operation gets the default target of that type for all users.
Other Parameters in HTTP Query String
type 1..1
GET
N/A
text/xml Element: GetDefaultTargetResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
This operation gets the target type (exalogic
, or ovm
) for the given target name.
Other Parameters in HTTP Query String
target 1..1
GET
N/A
text/xml Element: GetTargetTypeResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
This operation removes a user from a target.
Other Parameters in HTTP Query String
target 1..1
user 1..*
GET
N/A
text/xml Element: RemoveTargetUsersResult
Required Role and Authorization
This operation can be called by the Application Admin or Cloud Admin.
A caller holding the Cloud Admin role can call the method and specify a username other than their own. A non-admin user can only specify their own username.
This operation sets the target type of the given name as the default target for all targets of that type for all users. The specified target is used if the user calls an Oracle Virtual Assembly Builder operation and has neither specified a target nor has previously called setUserDefaultTarget
for the target type.
Other Parameters in HTTP Query String
name 1..1
GET
N/A
text/xml Element: SetDefaultTargetResult
Required Role and Authorization
This operation can only be called by the Cloud Admin.