IComputeProviderRebuildServer Method |
Initiates an asynchronous rebuild of the specified server.
Namespace: net.openstack.Core.ProvidersAssembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax Server RebuildServer(
string serverId,
string serverName,
string imageName,
string flavor,
string adminPassword,
IPAddress accessIPv4 = null,
IPAddress accessIPv6 = null,
Metadata metadata = null,
DiskConfiguration diskConfig = null,
Personality personality = null,
string region = null,
CloudIdentity identity = null
)
Function RebuildServer (
serverId As String,
serverName As String,
imageName As String,
flavor As String,
adminPassword As String,
Optional accessIPv4 As IPAddress = Nothing,
Optional accessIPv6 As IPAddress = Nothing,
Optional metadata As Metadata = Nothing,
Optional diskConfig As DiskConfiguration = Nothing,
Optional personality As Personality = Nothing,
Optional region As String = Nothing,
Optional identity As CloudIdentity = Nothing
) As Server
Server^ RebuildServer(
String^ serverId,
String^ serverName,
String^ imageName,
String^ flavor,
String^ adminPassword,
IPAddress^ accessIPv4 = nullptr,
IPAddress^ accessIPv6 = nullptr,
Metadata^ metadata = nullptr,
DiskConfiguration^ diskConfig = nullptr,
Personality^ personality = nullptr,
String^ region = nullptr,
CloudIdentity^ identity = nullptr
)
abstract RebuildServer :
serverId : string *
serverName : string *
imageName : string *
flavor : string *
adminPassword : string *
?accessIPv4 : IPAddress *
?accessIPv6 : IPAddress *
?metadata : Metadata *
?diskConfig : DiskConfiguration *
?personality : Personality *
?region : string *
?identity : CloudIdentity
(* Defaults:
let _accessIPv4 = defaultArg accessIPv4 null
let _accessIPv6 = defaultArg accessIPv6 null
let _metadata = defaultArg metadata null
let _diskConfig = defaultArg diskConfig null
let _personality = defaultArg personality null
let _region = defaultArg region null
let _identity = defaultArg identity null
*)
-> Server
Parameters
- serverId
- Type: SystemString
The server ID. This is obtained from ServerBase.Id. - serverName
- Type: SystemString
The new name for the server. If the value is , the server name is not changed. - imageName
- Type: SystemString
The image to rebuild the server from. This is specified as an image ID (see Id) or a full URL. - flavor
- Type: SystemString
The new flavor for server. This is obtained from Id. - adminPassword
- Type: SystemString
The new admin password for the server. - accessIPv4 (Optional)
- Type: System.NetIPAddress
The new IP v4 address for the server, or None to remove the configured IP v4 address for the server. If the value is , the server's IP v4 address is not updated. - accessIPv6 (Optional)
- Type: System.NetIPAddress
The new IP v6 address for the server, or None to remove the configured IP v6 address for the server. If the value is , the server's IP v6 address is not updated. - metadata (Optional)
- Type: net.openstack.Core.DomainMetadata
The list of metadata to associate with the server. If the value is , the metadata associated with the server is not changed during the rebuild operation. - diskConfig (Optional)
- Type: net.openstack.Core.DomainDiskConfiguration
The disk configuration. If the value is , the default configuration for the specified image is used. - personality (Optional)
- Type: net.openstack.Core.DomainPersonality
The path and contents of a file to inject in the target file system during the rebuild operation. If the value is , no file is injected. - region (Optional)
- Type: SystemString
The region in which to execute this action. If not specified, the user's default region will be used. - identity (Optional)
- Type: net.openstack.Core.DomainCloudIdentity
The cloud identity to use for this request. If not specified, the default identity for the current provider instance will be used.
Return Value
Type:
ServerA
Server object containing the details for the given server.
Exceptions Exception | Condition |
---|
ArgumentNullException |
If serverId is .
-or- If imageName is . -or- If flavor is . -or- If adminPassword is . |
ArgumentException |
If serverId is empty.
-or- If imageName is empty. -or- If flavor is empty. -or- If adminPassword is empty. -or- If accessIPv4 is not None and the AddressFamily of accessIPv4 is not InterNetwork. -or- If accessIPv6 is not None and the AddressFamily of accessIPv6 is not InterNetworkV6. |
NotSupportedException |
If the provider does not support the given diskConfig.
-or- If the provider does not support the given identity type. -or- The specified region is not supported. |
InvalidOperationException |
If identity is and no default identity is available for the provider.
-or- If region is and no default region is available for the provider. |
ResponseException | If the REST API request failed. |
Version Information .NET Framework
Supported in: 4.5
openstack.net
Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also