import "github.com/Azure/azure-sdk-for-go/services/compute/mgmt/2019-03-01/compute"
Package compute implements the Azure ARM Compute service API version .
Compute Client
availabilitysets.go client.go containerservices.go dedicatedhostgroups.go dedicatedhosts.go disks.go galleries.go galleryapplications.go galleryapplicationversions.go galleryimages.go galleryimageversions.go images.go loganalytics.go models.go operations.go proximityplacementgroups.go resourceskus.go snapshots.go usage.go version.go virtualmachineextensionimages.go virtualmachineextensions.go virtualmachineimages.go virtualmachineruncommands.go virtualmachines.go virtualmachinescalesetextensions.go virtualmachinescalesetrollingupgrades.go virtualmachinescalesets.go virtualmachinescalesetvms.go virtualmachinesizes.go
const (
// DefaultBaseURI is the default URI used for the service Compute
DefaultBaseURI = "https://management.azure.com"
)UserAgent returns the UserAgent string to use when sending http.Requests.
Version returns the semantic version (see http://semver.org) of the client.
type APIEntityReference struct {
// ID - The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...
ID *string `json:"id,omitempty"`
}APIEntityReference the API entity reference.
type APIError struct {
// Details - The Api error details
Details *[]APIErrorBase `json:"details,omitempty"`
// Innererror - The Api inner error
Innererror *InnerError `json:"innererror,omitempty"`
// Code - The error code.
Code *string `json:"code,omitempty"`
// Target - The target of the particular error.
Target *string `json:"target,omitempty"`
// Message - The error message.
Message *string `json:"message,omitempty"`
}APIError api error.
type APIErrorBase struct {
// Code - The error code.
Code *string `json:"code,omitempty"`
// Target - The target of the particular error.
Target *string `json:"target,omitempty"`
// Message - The error message.
Message *string `json:"message,omitempty"`
}APIErrorBase api error base.
AccessLevel enumerates the values for access level.
const (
// None ...
None AccessLevel = "None"
// Read ...
Read AccessLevel = "Read"
// Write ...
Write AccessLevel = "Write"
)func PossibleAccessLevelValues() []AccessLevel
PossibleAccessLevelValues returns an array of possible values for the AccessLevel const type.
type AccessURI struct {
autorest.Response `json:"-"`
// AccessSAS - READ-ONLY; A SAS uri for accessing a disk.
AccessSAS *string `json:"accessSAS,omitempty"`
}AccessURI a disk access SAS uri.
type AdditionalCapabilities struct {
// UltraSSDEnabled - The flag that enables or disables a capability to have one or more managed data disks with UltraSSD_LRS storage account type on the VM or VMSS. Managed disks with storage account type UltraSSD_LRS can be added to a virtual machine or virtual machine scale set only if this property is enabled.
UltraSSDEnabled *bool `json:"ultraSSDEnabled,omitempty"`
}AdditionalCapabilities enables or disables a capability on the virtual machine or virtual machine scale set.
type AdditionalUnattendContent struct {
// PassName - The pass name. Currently, the only allowable value is OobeSystem. Possible values include: 'OobeSystem'
PassName PassNames `json:"passName,omitempty"`
// ComponentName - The component name. Currently, the only allowable value is Microsoft-Windows-Shell-Setup. Possible values include: 'MicrosoftWindowsShellSetup'
ComponentName ComponentNames `json:"componentName,omitempty"`
// SettingName - Specifies the name of the setting to which the content applies. Possible values are: FirstLogonCommands and AutoLogon. Possible values include: 'AutoLogon', 'FirstLogonCommands'
SettingName SettingNames `json:"settingName,omitempty"`
// Content - Specifies the XML formatted content that is added to the unattend.xml file for the specified path and component. The XML must be less than 4KB and must include the root element for the setting or feature that is being inserted.
Content *string `json:"content,omitempty"`
}AdditionalUnattendContent specifies additional XML formatted information that can be included in the Unattend.xml file, which is used by Windows Setup. Contents are defined by setting name, component name, and the pass in which the content is applied.
AggregatedReplicationState enumerates the values for aggregated replication state.
const (
// Completed ...
Completed AggregatedReplicationState = "Completed"
// Failed ...
Failed AggregatedReplicationState = "Failed"
// InProgress ...
InProgress AggregatedReplicationState = "InProgress"
// Unknown ...
Unknown AggregatedReplicationState = "Unknown"
)func PossibleAggregatedReplicationStateValues() []AggregatedReplicationState
PossibleAggregatedReplicationStateValues returns an array of possible values for the AggregatedReplicationState const type.
type AutomaticOSUpgradePolicy struct {
// EnableAutomaticOSUpgrade - Indicates whether OS upgrades should automatically be applied to scale set instances in a rolling fashion when a newer version of the OS image becomes available. Default value is false. <br><br> If this is set to true for Windows based scale sets, [enableAutomaticUpdates](https://docs.microsoft.com/dotnet/api/microsoft.azure.management.compute.models.windowsconfiguration.enableautomaticupdates?view=azure-dotnet) is automatically set to false and cannot be set to true.
EnableAutomaticOSUpgrade *bool `json:"enableAutomaticOSUpgrade,omitempty"`
// DisableAutomaticRollback - Whether OS image rollback feature should be disabled. Default value is false.
DisableAutomaticRollback *bool `json:"disableAutomaticRollback,omitempty"`
}AutomaticOSUpgradePolicy the configuration parameters used for performing automatic OS upgrade.
type AutomaticOSUpgradeProperties struct {
// AutomaticOSUpgradeSupported - Specifies whether automatic OS upgrade is supported on the image.
AutomaticOSUpgradeSupported *bool `json:"automaticOSUpgradeSupported,omitempty"`
}AutomaticOSUpgradeProperties describes automatic OS upgrade properties on the image.
type AutomaticRepairsPolicy struct {
// Enabled - Specifies whether automatic repairs should be enabled on the virtual machine scale set. The default value is false.
Enabled *bool `json:"enabled,omitempty"`
// GracePeriod - The amount of time for which automatic repairs are suspended due to a state change on VM. The grace time starts after the state change has completed. This helps avoid premature or accidental repairs. The time duration should be specified in ISO 8601 format. The minimum allowed grace period is 30 minutes (PT30M), which is also the default value.
GracePeriod *string `json:"gracePeriod,omitempty"`
}AutomaticRepairsPolicy specifies the configuration parameters for automatic repairs on the virtual machine scale set.
type AvailabilitySet struct {
autorest.Response `json:"-"`
*AvailabilitySetProperties `json:"properties,omitempty"`
// Sku - Sku of the availability set, only name is required to be set. See AvailabilitySetSkuTypes for possible set of values. Use 'Aligned' for virtual machines with managed disks and 'Classic' for virtual machines with unmanaged disks. Default value is 'Classic'.
Sku *Sku `json:"sku,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}AvailabilitySet specifies information about the availability set that the virtual machine should be assigned to. Virtual machines specified in the same availability set are allocated to different nodes to maximize availability. For more information about availability sets, see [Manage the availability of virtual machines](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-manage-availability?toc=%2fazure%2fvirtual-machines%2fwindows%2ftoc.json). <br><br> For more information on Azure planned maintenance, see [Planned maintenance for virtual machines in Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-planned-maintenance?toc=%2fazure%2fvirtual-machines%2fwindows%2ftoc.json) <br><br> Currently, a VM can only be added to availability set at creation time. An existing VM cannot be added to an availability set.
func (as AvailabilitySet) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for AvailabilitySet.
func (as *AvailabilitySet) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for AvailabilitySet struct.
type AvailabilitySetListResult struct {
autorest.Response `json:"-"`
// Value - The list of availability sets
Value *[]AvailabilitySet `json:"value,omitempty"`
// NextLink - The URI to fetch the next page of AvailabilitySets. Call ListNext() with this URI to fetch the next page of AvailabilitySets.
NextLink *string `json:"nextLink,omitempty"`
}AvailabilitySetListResult the List Availability Set operation response.
func (aslr AvailabilitySetListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type AvailabilitySetListResultIterator struct {
// contains filtered or unexported fields
}AvailabilitySetListResultIterator provides access to a complete listing of AvailabilitySet values.
func NewAvailabilitySetListResultIterator(page AvailabilitySetListResultPage) AvailabilitySetListResultIterator
Creates a new instance of the AvailabilitySetListResultIterator type.
func (iter *AvailabilitySetListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *AvailabilitySetListResultIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter AvailabilitySetListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter AvailabilitySetListResultIterator) Response() AvailabilitySetListResult
Response returns the raw server response from the last page request.
func (iter AvailabilitySetListResultIterator) Value() AvailabilitySet
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type AvailabilitySetListResultPage struct {
// contains filtered or unexported fields
}AvailabilitySetListResultPage contains a page of AvailabilitySet values.
func NewAvailabilitySetListResultPage(getNextPage func(context.Context, AvailabilitySetListResult) (AvailabilitySetListResult, error)) AvailabilitySetListResultPage
Creates a new instance of the AvailabilitySetListResultPage type.
func (page *AvailabilitySetListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *AvailabilitySetListResultPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page AvailabilitySetListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page AvailabilitySetListResultPage) Response() AvailabilitySetListResult
Response returns the raw server response from the last page request.
func (page AvailabilitySetListResultPage) Values() []AvailabilitySet
Values returns the slice of values for the current page or nil if there are no values.
type AvailabilitySetProperties struct {
// PlatformUpdateDomainCount - Update Domain count.
PlatformUpdateDomainCount *int32 `json:"platformUpdateDomainCount,omitempty"`
// PlatformFaultDomainCount - Fault Domain count.
PlatformFaultDomainCount *int32 `json:"platformFaultDomainCount,omitempty"`
// VirtualMachines - A list of references to all virtual machines in the availability set.
VirtualMachines *[]SubResource `json:"virtualMachines,omitempty"`
// ProximityPlacementGroup - Specifies information about the proximity placement group that the availability set should be assigned to. <br><br>Minimum api-version: 2018-04-01.
ProximityPlacementGroup *SubResource `json:"proximityPlacementGroup,omitempty"`
// Statuses - READ-ONLY; The resource status information.
Statuses *[]InstanceViewStatus `json:"statuses,omitempty"`
}AvailabilitySetProperties the instance view of a resource.
AvailabilitySetSkuTypes enumerates the values for availability set sku types.
const (
// Aligned ...
Aligned AvailabilitySetSkuTypes = "Aligned"
// Classic ...
Classic AvailabilitySetSkuTypes = "Classic"
)func PossibleAvailabilitySetSkuTypesValues() []AvailabilitySetSkuTypes
PossibleAvailabilitySetSkuTypesValues returns an array of possible values for the AvailabilitySetSkuTypes const type.
type AvailabilitySetUpdate struct {
*AvailabilitySetProperties `json:"properties,omitempty"`
// Sku - Sku of the availability set
Sku *Sku `json:"sku,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}AvailabilitySetUpdate specifies information about the availability set that the virtual machine should be assigned to. Only tags may be updated.
func (asu AvailabilitySetUpdate) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for AvailabilitySetUpdate.
func (asu *AvailabilitySetUpdate) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for AvailabilitySetUpdate struct.
type AvailabilitySetsClient struct {
BaseClient
}AvailabilitySetsClient is the compute Client
func NewAvailabilitySetsClient(subscriptionID string) AvailabilitySetsClient
NewAvailabilitySetsClient creates an instance of the AvailabilitySetsClient client.
func NewAvailabilitySetsClientWithBaseURI(baseURI string, subscriptionID string) AvailabilitySetsClient
NewAvailabilitySetsClientWithBaseURI creates an instance of the AvailabilitySetsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client AvailabilitySetsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, availabilitySetName string, parameters AvailabilitySet) (result AvailabilitySet, err error)
CreateOrUpdate create or update an availability set. Parameters: resourceGroupName - the name of the resource group. availabilitySetName - the name of the availability set. parameters - parameters supplied to the Create Availability Set operation.
func (client AvailabilitySetsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, availabilitySetName string, parameters AvailabilitySet) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client AvailabilitySetsClient) CreateOrUpdateResponder(resp *http.Response) (result AvailabilitySet, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client AvailabilitySetsClient) CreateOrUpdateSender(req *http.Request) (*http.Response, error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) Delete(ctx context.Context, resourceGroupName string, availabilitySetName string) (result autorest.Response, err error)
Delete delete an availability set. Parameters: resourceGroupName - the name of the resource group. availabilitySetName - the name of the availability set.
func (client AvailabilitySetsClient) DeletePreparer(ctx context.Context, resourceGroupName string, availabilitySetName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client AvailabilitySetsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) Get(ctx context.Context, resourceGroupName string, availabilitySetName string) (result AvailabilitySet, err error)
Get retrieves information about an availability set. Parameters: resourceGroupName - the name of the resource group. availabilitySetName - the name of the availability set.
func (client AvailabilitySetsClient) GetPreparer(ctx context.Context, resourceGroupName string, availabilitySetName string) (*http.Request, error)
GetPreparer prepares the Get request.
func (client AvailabilitySetsClient) GetResponder(resp *http.Response) (result AvailabilitySet, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) List(ctx context.Context, resourceGroupName string) (result AvailabilitySetListResultPage, err error)
List lists all availability sets in a resource group. Parameters: resourceGroupName - the name of the resource group.
func (client AvailabilitySetsClient) ListAvailableSizes(ctx context.Context, resourceGroupName string, availabilitySetName string) (result VirtualMachineSizeListResult, err error)
ListAvailableSizes lists all available virtual machine sizes that can be used to create a new virtual machine in an existing availability set. Parameters: resourceGroupName - the name of the resource group. availabilitySetName - the name of the availability set.
func (client AvailabilitySetsClient) ListAvailableSizesPreparer(ctx context.Context, resourceGroupName string, availabilitySetName string) (*http.Request, error)
ListAvailableSizesPreparer prepares the ListAvailableSizes request.
func (client AvailabilitySetsClient) ListAvailableSizesResponder(resp *http.Response) (result VirtualMachineSizeListResult, err error)
ListAvailableSizesResponder handles the response to the ListAvailableSizes request. The method always closes the http.Response Body.
func (client AvailabilitySetsClient) ListAvailableSizesSender(req *http.Request) (*http.Response, error)
ListAvailableSizesSender sends the ListAvailableSizes request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) ListBySubscription(ctx context.Context, expand string) (result AvailabilitySetListResultPage, err error)
ListBySubscription lists all availability sets in a subscription. Parameters: expand - the expand expression to apply to the operation.
func (client AvailabilitySetsClient) ListBySubscriptionComplete(ctx context.Context, expand string) (result AvailabilitySetListResultIterator, err error)
ListBySubscriptionComplete enumerates all values, automatically crossing page boundaries as required.
func (client AvailabilitySetsClient) ListBySubscriptionPreparer(ctx context.Context, expand string) (*http.Request, error)
ListBySubscriptionPreparer prepares the ListBySubscription request.
func (client AvailabilitySetsClient) ListBySubscriptionResponder(resp *http.Response) (result AvailabilitySetListResult, err error)
ListBySubscriptionResponder handles the response to the ListBySubscription request. The method always closes the http.Response Body.
func (client AvailabilitySetsClient) ListBySubscriptionSender(req *http.Request) (*http.Response, error)
ListBySubscriptionSender sends the ListBySubscription request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) ListComplete(ctx context.Context, resourceGroupName string) (result AvailabilitySetListResultIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
func (client AvailabilitySetsClient) ListPreparer(ctx context.Context, resourceGroupName string) (*http.Request, error)
ListPreparer prepares the List request.
func (client AvailabilitySetsClient) ListResponder(resp *http.Response) (result AvailabilitySetListResult, err error)
ListResponder handles the response to the List request. The method always closes the http.Response Body.
ListSender sends the List request. The method will close the http.Response Body if it receives an error.
func (client AvailabilitySetsClient) Update(ctx context.Context, resourceGroupName string, availabilitySetName string, parameters AvailabilitySetUpdate) (result AvailabilitySet, err error)
Update update an availability set. Parameters: resourceGroupName - the name of the resource group. availabilitySetName - the name of the availability set. parameters - parameters supplied to the Update Availability Set operation.
func (client AvailabilitySetsClient) UpdatePreparer(ctx context.Context, resourceGroupName string, availabilitySetName string, parameters AvailabilitySetUpdate) (*http.Request, error)
UpdatePreparer prepares the Update request.
func (client AvailabilitySetsClient) UpdateResponder(resp *http.Response) (result AvailabilitySet, err error)
UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.
UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.
BaseClient is the base client for Compute.
func New(subscriptionID string) BaseClient
New creates an instance of the BaseClient client.
func NewWithBaseURI(baseURI string, subscriptionID string) BaseClient
NewWithBaseURI creates an instance of the BaseClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
type BillingProfile struct {
// MaxPrice - Specifies the maximum price you are willing to pay for a Azure Spot VM/VMSS. This price is in US Dollars. <br><br> This price will be compared with the current Azure Spot price for the VM size. Also, the prices are compared at the time of create/update of Azure Spot VM/VMSS and the operation will only succeed if the maxPrice is greater than the current Azure Spot price. <br><br> The maxPrice will also be used for evicting a Azure Spot VM/VMSS if the current Azure Spot price goes beyond the maxPrice after creation of VM/VMSS. <br><br> Possible values are: <br><br> - Any decimal value greater than zero. Example: 0.01538 <br><br> -1 – indicates default price to be up-to on-demand. <br><br> You can set the maxPrice to -1 to indicate that the Azure Spot VM/VMSS should not be evicted for price reasons. Also, the default max price is -1 if it is not provided by you. <br><br>Minimum api-version: 2019-03-01.
MaxPrice *float64 `json:"maxPrice,omitempty"`
}BillingProfile specifies the billing related details of a Azure Spot VM or VMSS. <br><br>Minimum api-version: 2019-03-01.
type BootDiagnostics struct {
// Enabled - Whether boot diagnostics should be enabled on the Virtual Machine.
Enabled *bool `json:"enabled,omitempty"`
// StorageURI - Uri of the storage account to use for placing the console output and screenshot.
StorageURI *string `json:"storageUri,omitempty"`
}BootDiagnostics boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status. <br><br> You can easily view the output of your console log. <br><br> Azure also enables you to see a screenshot of the VM from the hypervisor.
type BootDiagnosticsInstanceView struct {
// ConsoleScreenshotBlobURI - READ-ONLY; The console screenshot blob URI.
ConsoleScreenshotBlobURI *string `json:"consoleScreenshotBlobUri,omitempty"`
// SerialConsoleLogBlobURI - READ-ONLY; The Linux serial console log blob Uri.
SerialConsoleLogBlobURI *string `json:"serialConsoleLogBlobUri,omitempty"`
// Status - READ-ONLY; The boot diagnostics status information for the VM. <br><br> NOTE: It will be set only if there are errors encountered in enabling boot diagnostics.
Status *InstanceViewStatus `json:"status,omitempty"`
}BootDiagnosticsInstanceView the instance view of a virtual machine boot diagnostics.
CachingTypes enumerates the values for caching types.
const (
// CachingTypesNone ...
CachingTypesNone CachingTypes = "None"
// CachingTypesReadOnly ...
CachingTypesReadOnly CachingTypes = "ReadOnly"
// CachingTypesReadWrite ...
CachingTypesReadWrite CachingTypes = "ReadWrite"
)func PossibleCachingTypesValues() []CachingTypes
PossibleCachingTypesValues returns an array of possible values for the CachingTypes const type.
CloudError an error response from the Gallery service.
ComponentNames enumerates the values for component names.
const (
// MicrosoftWindowsShellSetup ...
MicrosoftWindowsShellSetup ComponentNames = "Microsoft-Windows-Shell-Setup"
)func PossibleComponentNamesValues() []ComponentNames
PossibleComponentNamesValues returns an array of possible values for the ComponentNames const type.
type ContainerService struct {
autorest.Response `json:"-"`
*ContainerServiceProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}ContainerService container service.
func (cs ContainerService) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for ContainerService.
func (cs *ContainerService) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for ContainerService struct.
type ContainerServiceAgentPoolProfile struct {
// Name - Unique name of the agent pool profile in the context of the subscription and resource group.
Name *string `json:"name,omitempty"`
// Count - Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1.
Count *int32 `json:"count,omitempty"`
// VMSize - Size of agent VMs. Possible values include: 'StandardA0', 'StandardA1', 'StandardA2', 'StandardA3', 'StandardA4', 'StandardA5', 'StandardA6', 'StandardA7', 'StandardA8', 'StandardA9', 'StandardA10', 'StandardA11', 'StandardD1', 'StandardD2', 'StandardD3', 'StandardD4', 'StandardD11', 'StandardD12', 'StandardD13', 'StandardD14', 'StandardD1V2', 'StandardD2V2', 'StandardD3V2', 'StandardD4V2', 'StandardD5V2', 'StandardD11V2', 'StandardD12V2', 'StandardD13V2', 'StandardD14V2', 'StandardG1', 'StandardG2', 'StandardG3', 'StandardG4', 'StandardG5', 'StandardDS1', 'StandardDS2', 'StandardDS3', 'StandardDS4', 'StandardDS11', 'StandardDS12', 'StandardDS13', 'StandardDS14', 'StandardGS1', 'StandardGS2', 'StandardGS3', 'StandardGS4', 'StandardGS5'
VMSize ContainerServiceVMSizeTypes `json:"vmSize,omitempty"`
// DNSPrefix - DNS prefix to be used to create the FQDN for the agent pool.
DNSPrefix *string `json:"dnsPrefix,omitempty"`
// Fqdn - READ-ONLY; FQDN for the agent pool.
Fqdn *string `json:"fqdn,omitempty"`
}ContainerServiceAgentPoolProfile profile for the container service agent pool.
type ContainerServiceCustomProfile struct {
// Orchestrator - The name of the custom orchestrator to use.
Orchestrator *string `json:"orchestrator,omitempty"`
}ContainerServiceCustomProfile properties to configure a custom container service cluster.
type ContainerServiceDiagnosticsProfile struct {
// VMDiagnostics - Profile for the container service VM diagnostic agent.
VMDiagnostics *ContainerServiceVMDiagnostics `json:"vmDiagnostics,omitempty"`
}ContainerServiceDiagnosticsProfile ...
type ContainerServiceLinuxProfile struct {
// AdminUsername - The administrator username to use for Linux VMs.
AdminUsername *string `json:"adminUsername,omitempty"`
// SSH - The ssh key configuration for Linux VMs.
SSH *ContainerServiceSSHConfiguration `json:"ssh,omitempty"`
}ContainerServiceLinuxProfile profile for Linux VMs in the container service cluster.
type ContainerServiceListResult struct {
autorest.Response `json:"-"`
// Value - the list of container services.
Value *[]ContainerService `json:"value,omitempty"`
// NextLink - The URL to get the next set of container service results.
NextLink *string `json:"nextLink,omitempty"`
}ContainerServiceListResult the response from the List Container Services operation.
func (cslr ContainerServiceListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type ContainerServiceListResultIterator struct {
// contains filtered or unexported fields
}ContainerServiceListResultIterator provides access to a complete listing of ContainerService values.
func NewContainerServiceListResultIterator(page ContainerServiceListResultPage) ContainerServiceListResultIterator
Creates a new instance of the ContainerServiceListResultIterator type.
func (iter *ContainerServiceListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *ContainerServiceListResultIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter ContainerServiceListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter ContainerServiceListResultIterator) Response() ContainerServiceListResult
Response returns the raw server response from the last page request.
func (iter ContainerServiceListResultIterator) Value() ContainerService
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type ContainerServiceListResultPage struct {
// contains filtered or unexported fields
}ContainerServiceListResultPage contains a page of ContainerService values.
func NewContainerServiceListResultPage(getNextPage func(context.Context, ContainerServiceListResult) (ContainerServiceListResult, error)) ContainerServiceListResultPage
Creates a new instance of the ContainerServiceListResultPage type.
func (page *ContainerServiceListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *ContainerServiceListResultPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page ContainerServiceListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page ContainerServiceListResultPage) Response() ContainerServiceListResult
Response returns the raw server response from the last page request.
func (page ContainerServiceListResultPage) Values() []ContainerService
Values returns the slice of values for the current page or nil if there are no values.
type ContainerServiceMasterProfile struct {
// Count - Number of masters (VMs) in the container service cluster. Allowed values are 1, 3, and 5. The default value is 1.
Count *int32 `json:"count,omitempty"`
// DNSPrefix - DNS prefix to be used to create the FQDN for master.
DNSPrefix *string `json:"dnsPrefix,omitempty"`
// Fqdn - READ-ONLY; FQDN for the master.
Fqdn *string `json:"fqdn,omitempty"`
}ContainerServiceMasterProfile profile for the container service master.
type ContainerServiceOrchestratorProfile struct {
// OrchestratorType - The orchestrator to use to manage container service cluster resources. Valid values are Swarm, DCOS, and Custom. Possible values include: 'Swarm', 'DCOS', 'Custom', 'Kubernetes'
OrchestratorType ContainerServiceOrchestratorTypes `json:"orchestratorType,omitempty"`
}ContainerServiceOrchestratorProfile profile for the container service orchestrator.
ContainerServiceOrchestratorTypes enumerates the values for container service orchestrator types.
const (
// Custom ...
Custom ContainerServiceOrchestratorTypes = "Custom"
// DCOS ...
DCOS ContainerServiceOrchestratorTypes = "DCOS"
// Kubernetes ...
Kubernetes ContainerServiceOrchestratorTypes = "Kubernetes"
// Swarm ...
Swarm ContainerServiceOrchestratorTypes = "Swarm"
)func PossibleContainerServiceOrchestratorTypesValues() []ContainerServiceOrchestratorTypes
PossibleContainerServiceOrchestratorTypesValues returns an array of possible values for the ContainerServiceOrchestratorTypes const type.
type ContainerServiceProperties struct {
// ProvisioningState - READ-ONLY; the current deployment or provisioning state, which only appears in the response.
ProvisioningState *string `json:"provisioningState,omitempty"`
// OrchestratorProfile - Properties of the orchestrator.
OrchestratorProfile *ContainerServiceOrchestratorProfile `json:"orchestratorProfile,omitempty"`
// CustomProfile - Properties for custom clusters.
CustomProfile *ContainerServiceCustomProfile `json:"customProfile,omitempty"`
// ServicePrincipalProfile - Properties for cluster service principals.
ServicePrincipalProfile *ContainerServiceServicePrincipalProfile `json:"servicePrincipalProfile,omitempty"`
// MasterProfile - Properties of master agents.
MasterProfile *ContainerServiceMasterProfile `json:"masterProfile,omitempty"`
// AgentPoolProfiles - Properties of the agent pool.
AgentPoolProfiles *[]ContainerServiceAgentPoolProfile `json:"agentPoolProfiles,omitempty"`
// WindowsProfile - Properties of Windows VMs.
WindowsProfile *ContainerServiceWindowsProfile `json:"windowsProfile,omitempty"`
// LinuxProfile - Properties of Linux VMs.
LinuxProfile *ContainerServiceLinuxProfile `json:"linuxProfile,omitempty"`
// DiagnosticsProfile - Properties of the diagnostic agent.
DiagnosticsProfile *ContainerServiceDiagnosticsProfile `json:"diagnosticsProfile,omitempty"`
}ContainerServiceProperties properties of the container service.
type ContainerServiceSSHConfiguration struct {
// PublicKeys - the list of SSH public keys used to authenticate with Linux-based VMs.
PublicKeys *[]ContainerServiceSSHPublicKey `json:"publicKeys,omitempty"`
}ContainerServiceSSHConfiguration SSH configuration for Linux-based VMs running on Azure.
type ContainerServiceSSHPublicKey struct {
// KeyData - Certificate public key used to authenticate with VMs through SSH. The certificate must be in PEM format with or without headers.
KeyData *string `json:"keyData,omitempty"`
}ContainerServiceSSHPublicKey contains information about SSH certificate public key data.
type ContainerServiceServicePrincipalProfile struct {
// ClientID - The ID for the service principal.
ClientID *string `json:"clientId,omitempty"`
// Secret - The secret password associated with the service principal.
Secret *string `json:"secret,omitempty"`
}ContainerServiceServicePrincipalProfile information about a service principal identity for the cluster to use for manipulating Azure APIs.
type ContainerServiceVMDiagnostics struct {
// Enabled - Whether the VM diagnostic agent is provisioned on the VM.
Enabled *bool `json:"enabled,omitempty"`
// StorageURI - READ-ONLY; The URI of the storage account where diagnostics are stored.
StorageURI *string `json:"storageUri,omitempty"`
}ContainerServiceVMDiagnostics profile for diagnostics on the container service VMs.
ContainerServiceVMSizeTypes enumerates the values for container service vm size types.
const (
// StandardA0 ...
StandardA0 ContainerServiceVMSizeTypes = "Standard_A0"
// StandardA1 ...
StandardA1 ContainerServiceVMSizeTypes = "Standard_A1"
// StandardA10 ...
StandardA10 ContainerServiceVMSizeTypes = "Standard_A10"
// StandardA11 ...
StandardA11 ContainerServiceVMSizeTypes = "Standard_A11"
// StandardA2 ...
StandardA2 ContainerServiceVMSizeTypes = "Standard_A2"
// StandardA3 ...
StandardA3 ContainerServiceVMSizeTypes = "Standard_A3"
// StandardA4 ...
StandardA4 ContainerServiceVMSizeTypes = "Standard_A4"
// StandardA5 ...
StandardA5 ContainerServiceVMSizeTypes = "Standard_A5"
// StandardA6 ...
StandardA6 ContainerServiceVMSizeTypes = "Standard_A6"
// StandardA7 ...
StandardA7 ContainerServiceVMSizeTypes = "Standard_A7"
// StandardA8 ...
StandardA8 ContainerServiceVMSizeTypes = "Standard_A8"
// StandardA9 ...
StandardA9 ContainerServiceVMSizeTypes = "Standard_A9"
// StandardD1 ...
StandardD1 ContainerServiceVMSizeTypes = "Standard_D1"
// StandardD11 ...
StandardD11 ContainerServiceVMSizeTypes = "Standard_D11"
// StandardD11V2 ...
StandardD11V2 ContainerServiceVMSizeTypes = "Standard_D11_v2"
// StandardD12 ...
StandardD12 ContainerServiceVMSizeTypes = "Standard_D12"
// StandardD12V2 ...
StandardD12V2 ContainerServiceVMSizeTypes = "Standard_D12_v2"
// StandardD13 ...
StandardD13 ContainerServiceVMSizeTypes = "Standard_D13"
// StandardD13V2 ...
StandardD13V2 ContainerServiceVMSizeTypes = "Standard_D13_v2"
// StandardD14 ...
StandardD14 ContainerServiceVMSizeTypes = "Standard_D14"
// StandardD14V2 ...
StandardD14V2 ContainerServiceVMSizeTypes = "Standard_D14_v2"
// StandardD1V2 ...
StandardD1V2 ContainerServiceVMSizeTypes = "Standard_D1_v2"
// StandardD2 ...
StandardD2 ContainerServiceVMSizeTypes = "Standard_D2"
// StandardD2V2 ...
StandardD2V2 ContainerServiceVMSizeTypes = "Standard_D2_v2"
// StandardD3 ...
StandardD3 ContainerServiceVMSizeTypes = "Standard_D3"
// StandardD3V2 ...
StandardD3V2 ContainerServiceVMSizeTypes = "Standard_D3_v2"
// StandardD4 ...
StandardD4 ContainerServiceVMSizeTypes = "Standard_D4"
// StandardD4V2 ...
StandardD4V2 ContainerServiceVMSizeTypes = "Standard_D4_v2"
// StandardD5V2 ...
StandardD5V2 ContainerServiceVMSizeTypes = "Standard_D5_v2"
// StandardDS1 ...
StandardDS1 ContainerServiceVMSizeTypes = "Standard_DS1"
// StandardDS11 ...
StandardDS11 ContainerServiceVMSizeTypes = "Standard_DS11"
// StandardDS12 ...
StandardDS12 ContainerServiceVMSizeTypes = "Standard_DS12"
// StandardDS13 ...
StandardDS13 ContainerServiceVMSizeTypes = "Standard_DS13"
// StandardDS14 ...
StandardDS14 ContainerServiceVMSizeTypes = "Standard_DS14"
// StandardDS2 ...
StandardDS2 ContainerServiceVMSizeTypes = "Standard_DS2"
// StandardDS3 ...
StandardDS3 ContainerServiceVMSizeTypes = "Standard_DS3"
// StandardDS4 ...
StandardDS4 ContainerServiceVMSizeTypes = "Standard_DS4"
// StandardG1 ...
StandardG1 ContainerServiceVMSizeTypes = "Standard_G1"
// StandardG2 ...
StandardG2 ContainerServiceVMSizeTypes = "Standard_G2"
// StandardG3 ...
StandardG3 ContainerServiceVMSizeTypes = "Standard_G3"
// StandardG4 ...
StandardG4 ContainerServiceVMSizeTypes = "Standard_G4"
// StandardG5 ...
StandardG5 ContainerServiceVMSizeTypes = "Standard_G5"
// StandardGS1 ...
StandardGS1 ContainerServiceVMSizeTypes = "Standard_GS1"
// StandardGS2 ...
StandardGS2 ContainerServiceVMSizeTypes = "Standard_GS2"
// StandardGS3 ...
StandardGS3 ContainerServiceVMSizeTypes = "Standard_GS3"
// StandardGS4 ...
StandardGS4 ContainerServiceVMSizeTypes = "Standard_GS4"
// StandardGS5 ...
StandardGS5 ContainerServiceVMSizeTypes = "Standard_GS5"
)func PossibleContainerServiceVMSizeTypesValues() []ContainerServiceVMSizeTypes
PossibleContainerServiceVMSizeTypesValues returns an array of possible values for the ContainerServiceVMSizeTypes const type.
type ContainerServiceWindowsProfile struct {
// AdminUsername - The administrator username to use for Windows VMs.
AdminUsername *string `json:"adminUsername,omitempty"`
// AdminPassword - The administrator password to use for Windows VMs.
AdminPassword *string `json:"adminPassword,omitempty"`
}ContainerServiceWindowsProfile profile for Windows VMs in the container service cluster.
type ContainerServicesClient struct {
BaseClient
}ContainerServicesClient is the compute Client
func NewContainerServicesClient(subscriptionID string) ContainerServicesClient
NewContainerServicesClient creates an instance of the ContainerServicesClient client.
func NewContainerServicesClientWithBaseURI(baseURI string, subscriptionID string) ContainerServicesClient
NewContainerServicesClientWithBaseURI creates an instance of the ContainerServicesClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client ContainerServicesClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, containerServiceName string, parameters ContainerService) (result ContainerServicesCreateOrUpdateFuture, err error)
CreateOrUpdate creates or updates a container service with the specified configuration of orchestrator, masters, and agents. Parameters: resourceGroupName - the name of the resource group. containerServiceName - the name of the container service in the specified subscription and resource group. parameters - parameters supplied to the Create or Update a Container Service operation.
func (client ContainerServicesClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, containerServiceName string, parameters ContainerService) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client ContainerServicesClient) CreateOrUpdateResponder(resp *http.Response) (result ContainerService, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client ContainerServicesClient) CreateOrUpdateSender(req *http.Request) (future ContainerServicesCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client ContainerServicesClient) Delete(ctx context.Context, resourceGroupName string, containerServiceName string) (result ContainerServicesDeleteFuture, err error)
Delete deletes the specified container service in the specified subscription and resource group. The operation does not delete other resources created as part of creating a container service, including storage accounts, VMs, and availability sets. All the other resources created with the container service are part of the same resource group and can be deleted individually. Parameters: resourceGroupName - the name of the resource group. containerServiceName - the name of the container service in the specified subscription and resource group.
func (client ContainerServicesClient) DeletePreparer(ctx context.Context, resourceGroupName string, containerServiceName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client ContainerServicesClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client ContainerServicesClient) DeleteSender(req *http.Request) (future ContainerServicesDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client ContainerServicesClient) Get(ctx context.Context, resourceGroupName string, containerServiceName string) (result ContainerService, err error)
Get gets the properties of the specified container service in the specified subscription and resource group. The operation returns the properties including state, orchestrator, number of masters and agents, and FQDNs of masters and agents. Parameters: resourceGroupName - the name of the resource group. containerServiceName - the name of the container service in the specified subscription and resource group.
func (client ContainerServicesClient) GetPreparer(ctx context.Context, resourceGroupName string, containerServiceName string) (*http.Request, error)
GetPreparer prepares the Get request.
func (client ContainerServicesClient) GetResponder(resp *http.Response) (result ContainerService, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client ContainerServicesClient) List(ctx context.Context) (result ContainerServiceListResultPage, err error)
List gets a list of container services in the specified subscription. The operation returns properties of each container service including state, orchestrator, number of masters and agents, and FQDNs of masters and agents.
func (client ContainerServicesClient) ListByResourceGroup(ctx context.Context, resourceGroupName string) (result ContainerServiceListResultPage, err error)
ListByResourceGroup gets a list of container services in the specified subscription and resource group. The operation returns properties of each container service including state, orchestrator, number of masters and agents, and FQDNs of masters and agents. Parameters: resourceGroupName - the name of the resource group.
func (client ContainerServicesClient) ListByResourceGroupComplete(ctx context.Context, resourceGroupName string) (result ContainerServiceListResultIterator, err error)
ListByResourceGroupComplete enumerates all values, automatically crossing page boundaries as required.
func (client ContainerServicesClient) ListByResourceGroupPreparer(ctx context.Context, resourceGroupName string) (*http.Request, error)
ListByResourceGroupPreparer prepares the ListByResourceGroup request.
func (client ContainerServicesClient) ListByResourceGroupResponder(resp *http.Response) (result ContainerServiceListResult, err error)
ListByResourceGroupResponder handles the response to the ListByResourceGroup request. The method always closes the http.Response Body.
func (client ContainerServicesClient) ListByResourceGroupSender(req *http.Request) (*http.Response, error)
ListByResourceGroupSender sends the ListByResourceGroup request. The method will close the http.Response Body if it receives an error.
func (client ContainerServicesClient) ListComplete(ctx context.Context) (result ContainerServiceListResultIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
ListPreparer prepares the List request.
func (client ContainerServicesClient) ListResponder(resp *http.Response) (result ContainerServiceListResult, err error)
ListResponder handles the response to the List request. The method always closes the http.Response Body.
ListSender sends the List request. The method will close the http.Response Body if it receives an error.
ContainerServicesCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *ContainerServicesCreateOrUpdateFuture) Result(client ContainerServicesClient) (cs ContainerService, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
ContainerServicesDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *ContainerServicesDeleteFuture) Result(client ContainerServicesClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type CreationData struct {
// CreateOption - This enumerates the possible sources of a disk's creation. Possible values include: 'Empty', 'Attach', 'FromImage', 'Import', 'Copy', 'Restore', 'Upload'
CreateOption DiskCreateOption `json:"createOption,omitempty"`
// StorageAccountID - If createOption is Import, the Azure Resource Manager identifier of the storage account containing the blob to import as a disk. Required only if the blob is in a different subscription
StorageAccountID *string `json:"storageAccountId,omitempty"`
// ImageReference - Disk source information.
ImageReference *ImageDiskReference `json:"imageReference,omitempty"`
// SourceURI - If createOption is Import, this is the URI of a blob to be imported into a managed disk.
SourceURI *string `json:"sourceUri,omitempty"`
// SourceResourceID - If createOption is Copy, this is the ARM id of the source snapshot or disk.
SourceResourceID *string `json:"sourceResourceId,omitempty"`
// SourceUniqueID - READ-ONLY; If this field is set, this is the unique id identifying the source of this resource.
SourceUniqueID *string `json:"sourceUniqueId,omitempty"`
// UploadSizeBytes - If createOption is Upload, this is the size of the contents of the upload including the VHD footer. This value should be between 20972032 (20 MiB + 512 bytes for the VHD footer) and 35183298347520 bytes (32 TiB + 512 bytes for the VHD footer).
UploadSizeBytes *int64 `json:"uploadSizeBytes,omitempty"`
}CreationData data used when creating a disk.
type DataDisk struct {
// Lun - Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM.
Lun *int32 `json:"lun,omitempty"`
// Name - The disk name.
Name *string `json:"name,omitempty"`
// Vhd - The virtual hard disk.
Vhd *VirtualHardDisk `json:"vhd,omitempty"`
// Image - The source user image virtual hard disk. The virtual hard disk will be copied before being attached to the virtual machine. If SourceImage is provided, the destination virtual hard drive must not exist.
Image *VirtualHardDisk `json:"image,omitempty"`
// Caching - Specifies the caching requirements. <br><br> Possible values are: <br><br> **None** <br><br> **ReadOnly** <br><br> **ReadWrite** <br><br> Default: **None for Standard storage. ReadOnly for Premium storage**. Possible values include: 'CachingTypesNone', 'CachingTypesReadOnly', 'CachingTypesReadWrite'
Caching CachingTypes `json:"caching,omitempty"`
// WriteAcceleratorEnabled - Specifies whether writeAccelerator should be enabled or disabled on the disk.
WriteAcceleratorEnabled *bool `json:"writeAcceleratorEnabled,omitempty"`
// CreateOption - Specifies how the virtual machine should be created.<br><br> Possible values are:<br><br> **Attach** \u2013 This value is used when you are using a specialized disk to create the virtual machine.<br><br> **FromImage** \u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described. Possible values include: 'DiskCreateOptionTypesFromImage', 'DiskCreateOptionTypesEmpty', 'DiskCreateOptionTypesAttach'
CreateOption DiskCreateOptionTypes `json:"createOption,omitempty"`
// DiskSizeGB - Specifies the size of an empty data disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. <br><br> This value cannot be larger than 1023 GB
DiskSizeGB *int32 `json:"diskSizeGB,omitempty"`
// ManagedDisk - The managed disk parameters.
ManagedDisk *ManagedDiskParameters `json:"managedDisk,omitempty"`
// ToBeDetached - Specifies whether the data disk is in process of detachment from the VirtualMachine/VirtualMachineScaleset
ToBeDetached *bool `json:"toBeDetached,omitempty"`
}DataDisk describes a data disk.
type DataDiskImage struct {
// Lun - READ-ONLY; Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM.
Lun *int32 `json:"lun,omitempty"`
}DataDiskImage contains the data disk images information.
type DedicatedHost struct {
autorest.Response `json:"-"`
*DedicatedHostProperties `json:"properties,omitempty"`
// Sku - SKU of the dedicated host for Hardware Generation and VM family. Only name is required to be set. List Microsoft.Compute SKUs for a list of possible values.
Sku *Sku `json:"sku,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}DedicatedHost specifies information about the Dedicated host.
func (dh DedicatedHost) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for DedicatedHost.
func (dh *DedicatedHost) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for DedicatedHost struct.
type DedicatedHostAllocatableVM struct {
// VMSize - VM size in terms of which the unutilized capacity is represented.
VMSize *string `json:"vmSize,omitempty"`
// Count - Maximum number of VMs of size vmSize that can fit in the dedicated host's remaining capacity.
Count *float64 `json:"count,omitempty"`
}DedicatedHostAllocatableVM represents the dedicated host unutilized capacity in terms of a specific VM size.
type DedicatedHostAvailableCapacity struct {
// AllocatableVMs - The unutilized capacity of the dedicated host represented in terms of each VM size that is allowed to be deployed to the dedicated host.
AllocatableVMs *[]DedicatedHostAllocatableVM `json:"allocatableVMs,omitempty"`
}DedicatedHostAvailableCapacity dedicated host unutilized capacity.
type DedicatedHostGroup struct {
autorest.Response `json:"-"`
*DedicatedHostGroupProperties `json:"properties,omitempty"`
// Zones - Availability Zone to use for this host group. Only single zone is supported. The zone can be assigned only during creation. If not provided, the group supports all zones in the region. If provided, enforces each host in the group to be in the same zone.
Zones *[]string `json:"zones,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}DedicatedHostGroup specifies information about the dedicated host group that the dedicated hosts should be assigned to. <br><br> Currently, a dedicated host can only be added to a dedicated host group at creation time. An existing dedicated host cannot be added to another dedicated host group.
func (dhg DedicatedHostGroup) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for DedicatedHostGroup.
func (dhg *DedicatedHostGroup) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for DedicatedHostGroup struct.
type DedicatedHostGroupListResult struct {
autorest.Response `json:"-"`
// Value - The list of dedicated host groups
Value *[]DedicatedHostGroup `json:"value,omitempty"`
// NextLink - The URI to fetch the next page of Dedicated Host Groups. Call ListNext() with this URI to fetch the next page of Dedicated Host Groups.
NextLink *string `json:"nextLink,omitempty"`
}DedicatedHostGroupListResult the List Dedicated Host Group with resource group response.
func (dhglr DedicatedHostGroupListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type DedicatedHostGroupListResultIterator struct {
// contains filtered or unexported fields
}DedicatedHostGroupListResultIterator provides access to a complete listing of DedicatedHostGroup values.
func NewDedicatedHostGroupListResultIterator(page DedicatedHostGroupListResultPage) DedicatedHostGroupListResultIterator
Creates a new instance of the DedicatedHostGroupListResultIterator type.
func (iter *DedicatedHostGroupListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *DedicatedHostGroupListResultIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter DedicatedHostGroupListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter DedicatedHostGroupListResultIterator) Response() DedicatedHostGroupListResult
Response returns the raw server response from the last page request.
func (iter DedicatedHostGroupListResultIterator) Value() DedicatedHostGroup
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type DedicatedHostGroupListResultPage struct {
// contains filtered or unexported fields
}DedicatedHostGroupListResultPage contains a page of DedicatedHostGroup values.
func NewDedicatedHostGroupListResultPage(getNextPage func(context.Context, DedicatedHostGroupListResult) (DedicatedHostGroupListResult, error)) DedicatedHostGroupListResultPage
Creates a new instance of the DedicatedHostGroupListResultPage type.
func (page *DedicatedHostGroupListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *DedicatedHostGroupListResultPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page DedicatedHostGroupListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page DedicatedHostGroupListResultPage) Response() DedicatedHostGroupListResult
Response returns the raw server response from the last page request.
func (page DedicatedHostGroupListResultPage) Values() []DedicatedHostGroup
Values returns the slice of values for the current page or nil if there are no values.
type DedicatedHostGroupProperties struct {
// PlatformFaultDomainCount - Number of fault domains that the host group can span.
PlatformFaultDomainCount *int32 `json:"platformFaultDomainCount,omitempty"`
// Hosts - READ-ONLY; A list of references to all dedicated hosts in the dedicated host group.
Hosts *[]SubResourceReadOnly `json:"hosts,omitempty"`
}DedicatedHostGroupProperties dedicated Host Group Properties.
type DedicatedHostGroupUpdate struct {
*DedicatedHostGroupProperties `json:"properties,omitempty"`
// Zones - Availability Zone to use for this host group. Only single zone is supported. The zone can be assigned only during creation. If not provided, the group supports all zones in the region. If provided, enforces each host in the group to be in the same zone.
Zones *[]string `json:"zones,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}DedicatedHostGroupUpdate specifies information about the dedicated host group that the dedicated host should be assigned to. Only tags may be updated.
func (dhgu DedicatedHostGroupUpdate) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for DedicatedHostGroupUpdate.
func (dhgu *DedicatedHostGroupUpdate) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for DedicatedHostGroupUpdate struct.
type DedicatedHostGroupsClient struct {
BaseClient
}DedicatedHostGroupsClient is the compute Client
func NewDedicatedHostGroupsClient(subscriptionID string) DedicatedHostGroupsClient
NewDedicatedHostGroupsClient creates an instance of the DedicatedHostGroupsClient client.
func NewDedicatedHostGroupsClientWithBaseURI(baseURI string, subscriptionID string) DedicatedHostGroupsClient
NewDedicatedHostGroupsClientWithBaseURI creates an instance of the DedicatedHostGroupsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client DedicatedHostGroupsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, hostGroupName string, parameters DedicatedHostGroup) (result DedicatedHostGroup, err error)
CreateOrUpdate create or update a dedicated host group. For details of Dedicated Host and Dedicated Host Groups please see [Dedicated Host Documentation] (https://go.microsoft.com/fwlink/?linkid=2082596) Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. parameters - parameters supplied to the Create Dedicated Host Group.
func (client DedicatedHostGroupsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, hostGroupName string, parameters DedicatedHostGroup) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client DedicatedHostGroupsClient) CreateOrUpdateResponder(resp *http.Response) (result DedicatedHostGroup, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client DedicatedHostGroupsClient) CreateOrUpdateSender(req *http.Request) (*http.Response, error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostGroupsClient) Delete(ctx context.Context, resourceGroupName string, hostGroupName string) (result autorest.Response, err error)
Delete delete a dedicated host group. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group.
func (client DedicatedHostGroupsClient) DeletePreparer(ctx context.Context, resourceGroupName string, hostGroupName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client DedicatedHostGroupsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostGroupsClient) Get(ctx context.Context, resourceGroupName string, hostGroupName string) (result DedicatedHostGroup, err error)
Get retrieves information about a dedicated host group. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group.
func (client DedicatedHostGroupsClient) GetPreparer(ctx context.Context, resourceGroupName string, hostGroupName string) (*http.Request, error)
GetPreparer prepares the Get request.
func (client DedicatedHostGroupsClient) GetResponder(resp *http.Response) (result DedicatedHostGroup, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostGroupsClient) ListByResourceGroup(ctx context.Context, resourceGroupName string) (result DedicatedHostGroupListResultPage, err error)
ListByResourceGroup lists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups. Parameters: resourceGroupName - the name of the resource group.
func (client DedicatedHostGroupsClient) ListByResourceGroupComplete(ctx context.Context, resourceGroupName string) (result DedicatedHostGroupListResultIterator, err error)
ListByResourceGroupComplete enumerates all values, automatically crossing page boundaries as required.
func (client DedicatedHostGroupsClient) ListByResourceGroupPreparer(ctx context.Context, resourceGroupName string) (*http.Request, error)
ListByResourceGroupPreparer prepares the ListByResourceGroup request.
func (client DedicatedHostGroupsClient) ListByResourceGroupResponder(resp *http.Response) (result DedicatedHostGroupListResult, err error)
ListByResourceGroupResponder handles the response to the ListByResourceGroup request. The method always closes the http.Response Body.
func (client DedicatedHostGroupsClient) ListByResourceGroupSender(req *http.Request) (*http.Response, error)
ListByResourceGroupSender sends the ListByResourceGroup request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostGroupsClient) ListBySubscription(ctx context.Context) (result DedicatedHostGroupListResultPage, err error)
ListBySubscription lists all of the dedicated host groups in the subscription. Use the nextLink property in the response to get the next page of dedicated host groups.
func (client DedicatedHostGroupsClient) ListBySubscriptionComplete(ctx context.Context) (result DedicatedHostGroupListResultIterator, err error)
ListBySubscriptionComplete enumerates all values, automatically crossing page boundaries as required.
func (client DedicatedHostGroupsClient) ListBySubscriptionPreparer(ctx context.Context) (*http.Request, error)
ListBySubscriptionPreparer prepares the ListBySubscription request.
func (client DedicatedHostGroupsClient) ListBySubscriptionResponder(resp *http.Response) (result DedicatedHostGroupListResult, err error)
ListBySubscriptionResponder handles the response to the ListBySubscription request. The method always closes the http.Response Body.
func (client DedicatedHostGroupsClient) ListBySubscriptionSender(req *http.Request) (*http.Response, error)
ListBySubscriptionSender sends the ListBySubscription request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostGroupsClient) Update(ctx context.Context, resourceGroupName string, hostGroupName string, parameters DedicatedHostGroupUpdate) (result DedicatedHostGroup, err error)
Update update an dedicated host group. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. parameters - parameters supplied to the Update Dedicated Host Group operation.
func (client DedicatedHostGroupsClient) UpdatePreparer(ctx context.Context, resourceGroupName string, hostGroupName string, parameters DedicatedHostGroupUpdate) (*http.Request, error)
UpdatePreparer prepares the Update request.
func (client DedicatedHostGroupsClient) UpdateResponder(resp *http.Response) (result DedicatedHostGroup, err error)
UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.
UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.
type DedicatedHostInstanceView struct {
// AssetID - READ-ONLY; Specifies the unique id of the dedicated physical machine on which the dedicated host resides.
AssetID *string `json:"assetId,omitempty"`
// AvailableCapacity - Unutilized capacity of the dedicated host.
AvailableCapacity *DedicatedHostAvailableCapacity `json:"availableCapacity,omitempty"`
// Statuses - The resource status information.
Statuses *[]InstanceViewStatus `json:"statuses,omitempty"`
}DedicatedHostInstanceView the instance view of a dedicated host.
DedicatedHostLicenseTypes enumerates the values for dedicated host license types.
const (
// DedicatedHostLicenseTypesNone ...
DedicatedHostLicenseTypesNone DedicatedHostLicenseTypes = "None"
// DedicatedHostLicenseTypesWindowsServerHybrid ...
DedicatedHostLicenseTypesWindowsServerHybrid DedicatedHostLicenseTypes = "Windows_Server_Hybrid"
// DedicatedHostLicenseTypesWindowsServerPerpetual ...
DedicatedHostLicenseTypesWindowsServerPerpetual DedicatedHostLicenseTypes = "Windows_Server_Perpetual"
)func PossibleDedicatedHostLicenseTypesValues() []DedicatedHostLicenseTypes
PossibleDedicatedHostLicenseTypesValues returns an array of possible values for the DedicatedHostLicenseTypes const type.
type DedicatedHostListResult struct {
autorest.Response `json:"-"`
// Value - The list of dedicated hosts
Value *[]DedicatedHost `json:"value,omitempty"`
// NextLink - The URI to fetch the next page of dedicated hosts. Call ListNext() with this URI to fetch the next page of dedicated hosts.
NextLink *string `json:"nextLink,omitempty"`
}DedicatedHostListResult the list dedicated host operation response.
func (dhlr DedicatedHostListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type DedicatedHostListResultIterator struct {
// contains filtered or unexported fields
}DedicatedHostListResultIterator provides access to a complete listing of DedicatedHost values.
func NewDedicatedHostListResultIterator(page DedicatedHostListResultPage) DedicatedHostListResultIterator
Creates a new instance of the DedicatedHostListResultIterator type.
func (iter *DedicatedHostListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *DedicatedHostListResultIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter DedicatedHostListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter DedicatedHostListResultIterator) Response() DedicatedHostListResult
Response returns the raw server response from the last page request.
func (iter DedicatedHostListResultIterator) Value() DedicatedHost
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type DedicatedHostListResultPage struct {
// contains filtered or unexported fields
}DedicatedHostListResultPage contains a page of DedicatedHost values.
func NewDedicatedHostListResultPage(getNextPage func(context.Context, DedicatedHostListResult) (DedicatedHostListResult, error)) DedicatedHostListResultPage
Creates a new instance of the DedicatedHostListResultPage type.
func (page *DedicatedHostListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *DedicatedHostListResultPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page DedicatedHostListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page DedicatedHostListResultPage) Response() DedicatedHostListResult
Response returns the raw server response from the last page request.
func (page DedicatedHostListResultPage) Values() []DedicatedHost
Values returns the slice of values for the current page or nil if there are no values.
type DedicatedHostProperties struct {
// PlatformFaultDomain - Fault domain of the dedicated host within a dedicated host group.
PlatformFaultDomain *int32 `json:"platformFaultDomain,omitempty"`
// AutoReplaceOnFailure - Specifies whether the dedicated host should be replaced automatically in case of a failure. The value is defaulted to 'true' when not provided.
AutoReplaceOnFailure *bool `json:"autoReplaceOnFailure,omitempty"`
// HostID - READ-ONLY; A unique id generated and assigned to the dedicated host by the platform. <br><br> Does not change throughout the lifetime of the host.
HostID *string `json:"hostId,omitempty"`
// VirtualMachines - READ-ONLY; A list of references to all virtual machines in the Dedicated Host.
VirtualMachines *[]SubResourceReadOnly `json:"virtualMachines,omitempty"`
// LicenseType - Specifies the software license type that will be applied to the VMs deployed on the dedicated host. <br><br> Possible values are: <br><br> **None** <br><br> **Windows_Server_Hybrid** <br><br> **Windows_Server_Perpetual** <br><br> Default: **None**. Possible values include: 'DedicatedHostLicenseTypesNone', 'DedicatedHostLicenseTypesWindowsServerHybrid', 'DedicatedHostLicenseTypesWindowsServerPerpetual'
LicenseType DedicatedHostLicenseTypes `json:"licenseType,omitempty"`
// ProvisioningTime - READ-ONLY; The date when the host was first provisioned.
ProvisioningTime *date.Time `json:"provisioningTime,omitempty"`
// ProvisioningState - READ-ONLY; The provisioning state, which only appears in the response.
ProvisioningState *string `json:"provisioningState,omitempty"`
// InstanceView - READ-ONLY; The dedicated host instance view.
InstanceView *DedicatedHostInstanceView `json:"instanceView,omitempty"`
}DedicatedHostProperties properties of the dedicated host.
type DedicatedHostUpdate struct {
*DedicatedHostProperties `json:"properties,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}DedicatedHostUpdate specifies information about the dedicated host. Only tags, autoReplaceOnFailure and licenseType may be updated.
func (dhu DedicatedHostUpdate) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for DedicatedHostUpdate.
func (dhu *DedicatedHostUpdate) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for DedicatedHostUpdate struct.
type DedicatedHostsClient struct {
BaseClient
}DedicatedHostsClient is the compute Client
func NewDedicatedHostsClient(subscriptionID string) DedicatedHostsClient
NewDedicatedHostsClient creates an instance of the DedicatedHostsClient client.
func NewDedicatedHostsClientWithBaseURI(baseURI string, subscriptionID string) DedicatedHostsClient
NewDedicatedHostsClientWithBaseURI creates an instance of the DedicatedHostsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client DedicatedHostsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, parameters DedicatedHost) (result DedicatedHostsCreateOrUpdateFuture, err error)
CreateOrUpdate create or update a dedicated host . Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. hostName - the name of the dedicated host . parameters - parameters supplied to the Create Dedicated Host.
func (client DedicatedHostsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, parameters DedicatedHost) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client DedicatedHostsClient) CreateOrUpdateResponder(resp *http.Response) (result DedicatedHost, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client DedicatedHostsClient) CreateOrUpdateSender(req *http.Request) (future DedicatedHostsCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostsClient) Delete(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string) (result DedicatedHostsDeleteFuture, err error)
Delete delete a dedicated host. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. hostName - the name of the dedicated host.
func (client DedicatedHostsClient) DeletePreparer(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client DedicatedHostsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client DedicatedHostsClient) DeleteSender(req *http.Request) (future DedicatedHostsDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostsClient) Get(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, expand InstanceViewTypes) (result DedicatedHost, err error)
Get retrieves information about a dedicated host. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. hostName - the name of the dedicated host. expand - the expand expression to apply on the operation.
func (client DedicatedHostsClient) GetPreparer(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, expand InstanceViewTypes) (*http.Request, error)
GetPreparer prepares the Get request.
func (client DedicatedHostsClient) GetResponder(resp *http.Response) (result DedicatedHost, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostsClient) ListByHostGroup(ctx context.Context, resourceGroupName string, hostGroupName string) (result DedicatedHostListResultPage, err error)
ListByHostGroup lists all of the dedicated hosts in the specified dedicated host group. Use the nextLink property in the response to get the next page of dedicated hosts. Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group.
func (client DedicatedHostsClient) ListByHostGroupComplete(ctx context.Context, resourceGroupName string, hostGroupName string) (result DedicatedHostListResultIterator, err error)
ListByHostGroupComplete enumerates all values, automatically crossing page boundaries as required.
func (client DedicatedHostsClient) ListByHostGroupPreparer(ctx context.Context, resourceGroupName string, hostGroupName string) (*http.Request, error)
ListByHostGroupPreparer prepares the ListByHostGroup request.
func (client DedicatedHostsClient) ListByHostGroupResponder(resp *http.Response) (result DedicatedHostListResult, err error)
ListByHostGroupResponder handles the response to the ListByHostGroup request. The method always closes the http.Response Body.
func (client DedicatedHostsClient) ListByHostGroupSender(req *http.Request) (*http.Response, error)
ListByHostGroupSender sends the ListByHostGroup request. The method will close the http.Response Body if it receives an error.
func (client DedicatedHostsClient) Update(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, parameters DedicatedHostUpdate) (result DedicatedHostsUpdateFuture, err error)
Update update an dedicated host . Parameters: resourceGroupName - the name of the resource group. hostGroupName - the name of the dedicated host group. hostName - the name of the dedicated host . parameters - parameters supplied to the Update Dedicated Host operation.
func (client DedicatedHostsClient) UpdatePreparer(ctx context.Context, resourceGroupName string, hostGroupName string, hostName string, parameters DedicatedHostUpdate) (*http.Request, error)
UpdatePreparer prepares the Update request.
func (client DedicatedHostsClient) UpdateResponder(resp *http.Response) (result DedicatedHost, err error)
UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.
func (client DedicatedHostsClient) UpdateSender(req *http.Request) (future DedicatedHostsUpdateFuture, err error)
UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.
DedicatedHostsCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DedicatedHostsCreateOrUpdateFuture) Result(client DedicatedHostsClient) (dh DedicatedHost, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DedicatedHostsDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DedicatedHostsDeleteFuture) Result(client DedicatedHostsClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DedicatedHostsUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DedicatedHostsUpdateFuture) Result(client DedicatedHostsClient) (dh DedicatedHost, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type DiagnosticsProfile struct {
// BootDiagnostics - Boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status. <br><br> You can easily view the output of your console log. <br><br> Azure also enables you to see a screenshot of the VM from the hypervisor.
BootDiagnostics *BootDiagnostics `json:"bootDiagnostics,omitempty"`
}DiagnosticsProfile specifies the boot diagnostic settings state. <br><br>Minimum api-version: 2015-06-15.
DiffDiskOptions enumerates the values for diff disk options.
const (
// Local ...
Local DiffDiskOptions = "Local"
)func PossibleDiffDiskOptionsValues() []DiffDiskOptions
PossibleDiffDiskOptionsValues returns an array of possible values for the DiffDiskOptions const type.
type DiffDiskSettings struct {
// Option - Specifies the ephemeral disk settings for operating system disk. Possible values include: 'Local'
Option DiffDiskOptions `json:"option,omitempty"`
}DiffDiskSettings describes the parameters of ephemeral disk settings that can be specified for operating system disk. <br><br> NOTE: The ephemeral disk settings can only be specified for managed disk.
type Disallowed struct {
// DiskTypes - A list of disk types.
DiskTypes *[]string `json:"diskTypes,omitempty"`
}Disallowed describes the disallowed disk types.
type Disk struct {
autorest.Response `json:"-"`
// ManagedBy - READ-ONLY; A relative URI containing the ID of the VM that has the disk attached.
ManagedBy *string `json:"managedBy,omitempty"`
Sku *DiskSku `json:"sku,omitempty"`
// Zones - The Logical zone list for Disk.
Zones *[]string `json:"zones,omitempty"`
*DiskProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}Disk disk resource.
MarshalJSON is the custom marshaler for Disk.
UnmarshalJSON is the custom unmarshaler for Disk struct.
DiskCreateOption enumerates the values for disk create option.
const (
// Attach Disk will be attached to a VM.
Attach DiskCreateOption = "Attach"
// Copy Create a new disk or snapshot by copying from a disk or snapshot specified by the given
// sourceResourceId.
Copy DiskCreateOption = "Copy"
// Empty Create an empty data disk of a size given by diskSizeGB.
Empty DiskCreateOption = "Empty"
// FromImage Create a new disk from a platform image specified by the given imageReference.
FromImage DiskCreateOption = "FromImage"
// Import Create a disk by importing from a blob specified by a sourceUri in a storage account specified by
// storageAccountId.
Import DiskCreateOption = "Import"
// Restore Create a new disk by copying from a backup recovery point.
Restore DiskCreateOption = "Restore"
// Upload Create a new disk by obtaining a write token and using it to directly upload the contents of the
// disk.
Upload DiskCreateOption = "Upload"
)func PossibleDiskCreateOptionValues() []DiskCreateOption
PossibleDiskCreateOptionValues returns an array of possible values for the DiskCreateOption const type.
DiskCreateOptionTypes enumerates the values for disk create option types.
const (
// DiskCreateOptionTypesAttach ...
DiskCreateOptionTypesAttach DiskCreateOptionTypes = "Attach"
// DiskCreateOptionTypesEmpty ...
DiskCreateOptionTypesEmpty DiskCreateOptionTypes = "Empty"
// DiskCreateOptionTypesFromImage ...
DiskCreateOptionTypesFromImage DiskCreateOptionTypes = "FromImage"
)func PossibleDiskCreateOptionTypesValues() []DiskCreateOptionTypes
PossibleDiskCreateOptionTypesValues returns an array of possible values for the DiskCreateOptionTypes const type.
type DiskEncryptionSettings struct {
// DiskEncryptionKey - Specifies the location of the disk encryption key, which is a Key Vault Secret.
DiskEncryptionKey *KeyVaultSecretReference `json:"diskEncryptionKey,omitempty"`
// KeyEncryptionKey - Specifies the location of the key encryption key in Key Vault.
KeyEncryptionKey *KeyVaultKeyReference `json:"keyEncryptionKey,omitempty"`
// Enabled - Specifies whether disk encryption should be enabled on the virtual machine.
Enabled *bool `json:"enabled,omitempty"`
}DiskEncryptionSettings describes a Encryption Settings for a Disk
type DiskInstanceView struct {
// Name - The disk name.
Name *string `json:"name,omitempty"`
// EncryptionSettings - Specifies the encryption settings for the OS Disk. <br><br> Minimum api-version: 2015-06-15
EncryptionSettings *[]DiskEncryptionSettings `json:"encryptionSettings,omitempty"`
// Statuses - The resource status information.
Statuses *[]InstanceViewStatus `json:"statuses,omitempty"`
}DiskInstanceView the instance view of the disk.
type DiskList struct {
autorest.Response `json:"-"`
// Value - A list of disks.
Value *[]Disk `json:"value,omitempty"`
// NextLink - The uri to fetch the next page of disks. Call ListNext() with this to fetch the next page of disks.
NextLink *string `json:"nextLink,omitempty"`
}DiskList the List Disks operation response.
IsEmpty returns true if the ListResult contains no values.
type DiskListIterator struct {
// contains filtered or unexported fields
}DiskListIterator provides access to a complete listing of Disk values.
func NewDiskListIterator(page DiskListPage) DiskListIterator
Creates a new instance of the DiskListIterator type.
func (iter *DiskListIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *DiskListIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter DiskListIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter DiskListIterator) Response() DiskList
Response returns the raw server response from the last page request.
func (iter DiskListIterator) Value() Disk
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type DiskListPage struct {
// contains filtered or unexported fields
}DiskListPage contains a page of Disk values.
Creates a new instance of the DiskListPage type.
func (page *DiskListPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *DiskListPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page DiskListPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page DiskListPage) Response() DiskList
Response returns the raw server response from the last page request.
func (page DiskListPage) Values() []Disk
Values returns the slice of values for the current page or nil if there are no values.
type DiskProperties struct {
// TimeCreated - READ-ONLY; The time when the disk was created.
TimeCreated *date.Time `json:"timeCreated,omitempty"`
// OsType - The Operating System type. Possible values include: 'Windows', 'Linux'
OsType OperatingSystemTypes `json:"osType,omitempty"`
// HyperVGeneration - The hypervisor generation of the Virtual Machine. Applicable to OS disks only. Possible values include: 'V1', 'V2'
HyperVGeneration HyperVGeneration `json:"hyperVGeneration,omitempty"`
// CreationData - Disk source information. CreationData information cannot be changed after the disk has been created.
CreationData *CreationData `json:"creationData,omitempty"`
// DiskSizeGB - If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.
DiskSizeGB *int32 `json:"diskSizeGB,omitempty"`
// DiskSizeBytes - READ-ONLY; The size of the disk in bytes. This field is read only.
DiskSizeBytes *int64 `json:"diskSizeBytes,omitempty"`
// UniqueID - READ-ONLY; Unique Guid identifying the resource.
UniqueID *string `json:"uniqueId,omitempty"`
// EncryptionSettingsCollection - Encryption settings collection used for Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.
EncryptionSettingsCollection *EncryptionSettingsCollection `json:"encryptionSettingsCollection,omitempty"`
// ProvisioningState - READ-ONLY; The disk provisioning state.
ProvisioningState *string `json:"provisioningState,omitempty"`
// DiskIOPSReadWrite - The number of IOPS allowed for this disk; only settable for UltraSSD disks. One operation can transfer between 4k and 256k bytes.
DiskIOPSReadWrite *int64 `json:"diskIOPSReadWrite,omitempty"`
// DiskMBpsReadWrite - The bandwidth allowed for this disk; only settable for UltraSSD disks. MBps means millions of bytes per second - MB here uses the ISO notation, of powers of 10.
DiskMBpsReadWrite *int32 `json:"diskMBpsReadWrite,omitempty"`
// DiskState - READ-ONLY; The state of the disk. Possible values include: 'Unattached', 'Attached', 'Reserved', 'ActiveSAS', 'ReadyToUpload', 'ActiveUpload'
DiskState DiskState `json:"diskState,omitempty"`
}DiskProperties disk resource properties.
type DiskSku struct {
// Name - The sku name. Possible values include: 'StandardLRS', 'PremiumLRS', 'StandardSSDLRS', 'UltraSSDLRS'
Name DiskStorageAccountTypes `json:"name,omitempty"`
// Tier - READ-ONLY; The sku tier.
Tier *string `json:"tier,omitempty"`
}DiskSku the disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, or UltraSSD_LRS.
DiskState enumerates the values for disk state.
const (
// ActiveSAS The disk currently has an Active SAS Uri associated with it.
ActiveSAS DiskState = "ActiveSAS"
// ActiveUpload A disk is created for upload and a write token has been issued for uploading to it.
ActiveUpload DiskState = "ActiveUpload"
// Attached The disk is currently mounted to a running VM.
Attached DiskState = "Attached"
// ReadyToUpload A disk is ready to be created by upload by requesting a write token.
ReadyToUpload DiskState = "ReadyToUpload"
// Reserved The disk is mounted to a stopped-deallocated VM
Reserved DiskState = "Reserved"
// Unattached The disk is not being used and can be attached to a VM.
Unattached DiskState = "Unattached"
)PossibleDiskStateValues returns an array of possible values for the DiskState const type.
DiskStorageAccountTypes enumerates the values for disk storage account types.
const (
// PremiumLRS Premium SSD locally redundant storage. Best for production and performance sensitive
// workloads.
PremiumLRS DiskStorageAccountTypes = "Premium_LRS"
// StandardLRS Standard HDD locally redundant storage. Best for backup, non-critical, and infrequent
// access.
StandardLRS DiskStorageAccountTypes = "Standard_LRS"
// StandardSSDLRS Standard SSD locally redundant storage. Best for web servers, lightly used enterprise
// applications and dev/test.
StandardSSDLRS DiskStorageAccountTypes = "StandardSSD_LRS"
// UltraSSDLRS Ultra SSD locally redundant storage. Best for IO-intensive workloads such as SAP HANA, top
// tier databases (for example, SQL, Oracle), and other transaction-heavy workloads.
UltraSSDLRS DiskStorageAccountTypes = "UltraSSD_LRS"
)func PossibleDiskStorageAccountTypesValues() []DiskStorageAccountTypes
PossibleDiskStorageAccountTypesValues returns an array of possible values for the DiskStorageAccountTypes const type.
type DiskUpdate struct {
*DiskUpdateProperties `json:"properties,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
Sku *DiskSku `json:"sku,omitempty"`
}DiskUpdate disk update resource.
func (du DiskUpdate) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for DiskUpdate.
func (du *DiskUpdate) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for DiskUpdate struct.
type DiskUpdateProperties struct {
// OsType - the Operating System type. Possible values include: 'Windows', 'Linux'
OsType OperatingSystemTypes `json:"osType,omitempty"`
// DiskSizeGB - If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.
DiskSizeGB *int32 `json:"diskSizeGB,omitempty"`
// EncryptionSettingsCollection - Encryption settings collection used be Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.
EncryptionSettingsCollection *EncryptionSettingsCollection `json:"encryptionSettingsCollection,omitempty"`
// DiskIOPSReadWrite - The number of IOPS allowed for this disk; only settable for UltraSSD disks. One operation can transfer between 4k and 256k bytes.
DiskIOPSReadWrite *int64 `json:"diskIOPSReadWrite,omitempty"`
// DiskMBpsReadWrite - The bandwidth allowed for this disk; only settable for UltraSSD disks. MBps means millions of bytes per second - MB here uses the ISO notation, of powers of 10.
DiskMBpsReadWrite *int32 `json:"diskMBpsReadWrite,omitempty"`
}DiskUpdateProperties disk resource update properties.
type DisksClient struct {
BaseClient
}DisksClient is the compute Client
func NewDisksClient(subscriptionID string) DisksClient
NewDisksClient creates an instance of the DisksClient client.
func NewDisksClientWithBaseURI(baseURI string, subscriptionID string) DisksClient
NewDisksClientWithBaseURI creates an instance of the DisksClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client DisksClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, diskName string, disk Disk) (result DisksCreateOrUpdateFuture, err error)
CreateOrUpdate creates or updates a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters. disk - disk object supplied in the body of the Put disk operation.
func (client DisksClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, diskName string, disk Disk) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client DisksClient) CreateOrUpdateSender(req *http.Request) (future DisksCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) Delete(ctx context.Context, resourceGroupName string, diskName string) (result DisksDeleteFuture, err error)
Delete deletes a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters.
func (client DisksClient) DeletePreparer(ctx context.Context, resourceGroupName string, diskName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client DisksClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client DisksClient) DeleteSender(req *http.Request) (future DisksDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) Get(ctx context.Context, resourceGroupName string, diskName string) (result Disk, err error)
Get gets information about a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters.
func (client DisksClient) GetPreparer(ctx context.Context, resourceGroupName string, diskName string) (*http.Request, error)
GetPreparer prepares the Get request.
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) GrantAccess(ctx context.Context, resourceGroupName string, diskName string, grantAccessData GrantAccessData) (result DisksGrantAccessFuture, err error)
GrantAccess grants access to a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters. grantAccessData - access data object supplied in the body of the get disk access operation.
func (client DisksClient) GrantAccessPreparer(ctx context.Context, resourceGroupName string, diskName string, grantAccessData GrantAccessData) (*http.Request, error)
GrantAccessPreparer prepares the GrantAccess request.
GrantAccessResponder handles the response to the GrantAccess request. The method always closes the http.Response Body.
func (client DisksClient) GrantAccessSender(req *http.Request) (future DisksGrantAccessFuture, err error)
GrantAccessSender sends the GrantAccess request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) List(ctx context.Context) (result DiskListPage, err error)
List lists all the disks under a subscription.
func (client DisksClient) ListByResourceGroup(ctx context.Context, resourceGroupName string) (result DiskListPage, err error)
ListByResourceGroup lists all the disks under a resource group. Parameters: resourceGroupName - the name of the resource group.
func (client DisksClient) ListByResourceGroupComplete(ctx context.Context, resourceGroupName string) (result DiskListIterator, err error)
ListByResourceGroupComplete enumerates all values, automatically crossing page boundaries as required.
func (client DisksClient) ListByResourceGroupPreparer(ctx context.Context, resourceGroupName string) (*http.Request, error)
ListByResourceGroupPreparer prepares the ListByResourceGroup request.
func (client DisksClient) ListByResourceGroupResponder(resp *http.Response) (result DiskList, err error)
ListByResourceGroupResponder handles the response to the ListByResourceGroup request. The method always closes the http.Response Body.
ListByResourceGroupSender sends the ListByResourceGroup request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) ListComplete(ctx context.Context) (result DiskListIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
ListPreparer prepares the List request.
ListResponder handles the response to the List request. The method always closes the http.Response Body.
ListSender sends the List request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) RevokeAccess(ctx context.Context, resourceGroupName string, diskName string) (result DisksRevokeAccessFuture, err error)
RevokeAccess revokes access to a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters.
func (client DisksClient) RevokeAccessPreparer(ctx context.Context, resourceGroupName string, diskName string) (*http.Request, error)
RevokeAccessPreparer prepares the RevokeAccess request.
func (client DisksClient) RevokeAccessResponder(resp *http.Response) (result autorest.Response, err error)
RevokeAccessResponder handles the response to the RevokeAccess request. The method always closes the http.Response Body.
func (client DisksClient) RevokeAccessSender(req *http.Request) (future DisksRevokeAccessFuture, err error)
RevokeAccessSender sends the RevokeAccess request. The method will close the http.Response Body if it receives an error.
func (client DisksClient) Update(ctx context.Context, resourceGroupName string, diskName string, disk DiskUpdate) (result DisksUpdateFuture, err error)
Update updates (patches) a disk. Parameters: resourceGroupName - the name of the resource group. diskName - the name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9 and _. The maximum name length is 80 characters. disk - disk object supplied in the body of the Patch disk operation.
func (client DisksClient) UpdatePreparer(ctx context.Context, resourceGroupName string, diskName string, disk DiskUpdate) (*http.Request, error)
UpdatePreparer prepares the Update request.
UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.
func (client DisksClient) UpdateSender(req *http.Request) (future DisksUpdateFuture, err error)
UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.
DisksCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DisksCreateOrUpdateFuture) Result(client DisksClient) (d Disk, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DisksDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DisksDeleteFuture) Result(client DisksClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DisksGrantAccessFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DisksGrantAccessFuture) Result(client DisksClient) (au AccessURI, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DisksRevokeAccessFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DisksRevokeAccessFuture) Result(client DisksClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
DisksUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *DisksUpdateFuture) Result(client DisksClient) (d Disk, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type EncryptionSettingsCollection struct {
// Enabled - Set this flag to true and provide DiskEncryptionKey and optional KeyEncryptionKey to enable encryption. Set this flag to false and remove DiskEncryptionKey and KeyEncryptionKey to disable encryption. If EncryptionSettings is null in the request object, the existing settings remain unchanged.
Enabled *bool `json:"enabled,omitempty"`
// EncryptionSettings - A collection of encryption settings, one for each disk volume.
EncryptionSettings *[]EncryptionSettingsElement `json:"encryptionSettings,omitempty"`
// EncryptionSettingsVersion - Describes what type of encryption is used for the disks. Once this field is set, it cannot be overwritten. '1.0' corresponds to Azure Disk Encryption with AAD app.'1.1' corresponds to Azure Disk Encryption.
EncryptionSettingsVersion *string `json:"encryptionSettingsVersion,omitempty"`
}EncryptionSettingsCollection encryption settings for disk or snapshot
type EncryptionSettingsElement struct {
// DiskEncryptionKey - Key Vault Secret Url and vault id of the disk encryption key
DiskEncryptionKey *KeyVaultAndSecretReference `json:"diskEncryptionKey,omitempty"`
// KeyEncryptionKey - Key Vault Key Url and vault id of the key encryption key. KeyEncryptionKey is optional and when provided is used to unwrap the disk encryption key.
KeyEncryptionKey *KeyVaultAndKeyReference `json:"keyEncryptionKey,omitempty"`
}EncryptionSettingsElement encryption settings for one disk volume.
type GalleriesClient struct {
BaseClient
}GalleriesClient is the compute Client
func NewGalleriesClient(subscriptionID string) GalleriesClient
NewGalleriesClient creates an instance of the GalleriesClient client.
func NewGalleriesClientWithBaseURI(baseURI string, subscriptionID string) GalleriesClient
NewGalleriesClientWithBaseURI creates an instance of the GalleriesClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client GalleriesClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, galleryName string, gallery Gallery) (result GalleriesCreateOrUpdateFuture, err error)
CreateOrUpdate create or update a Shared Image Gallery. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters. gallery - parameters supplied to the create or update Shared Image Gallery operation.
func (client GalleriesClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, galleryName string, gallery Gallery) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client GalleriesClient) CreateOrUpdateResponder(resp *http.Response) (result Gallery, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client GalleriesClient) CreateOrUpdateSender(req *http.Request) (future GalleriesCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client GalleriesClient) Delete(ctx context.Context, resourceGroupName string, galleryName string) (result GalleriesDeleteFuture, err error)
Delete delete a Shared Image Gallery. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery to be deleted.
func (client GalleriesClient) DeletePreparer(ctx context.Context, resourceGroupName string, galleryName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client GalleriesClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client GalleriesClient) DeleteSender(req *http.Request) (future GalleriesDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client GalleriesClient) Get(ctx context.Context, resourceGroupName string, galleryName string) (result Gallery, err error)
Get retrieves information about a Shared Image Gallery. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery.
func (client GalleriesClient) GetPreparer(ctx context.Context, resourceGroupName string, galleryName string) (*http.Request, error)
GetPreparer prepares the Get request.
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client GalleriesClient) List(ctx context.Context) (result GalleryListPage, err error)
List list galleries under a subscription.
func (client GalleriesClient) ListByResourceGroup(ctx context.Context, resourceGroupName string) (result GalleryListPage, err error)
ListByResourceGroup list galleries under a resource group. Parameters: resourceGroupName - the name of the resource group.
func (client GalleriesClient) ListByResourceGroupComplete(ctx context.Context, resourceGroupName string) (result GalleryListIterator, err error)
ListByResourceGroupComplete enumerates all values, automatically crossing page boundaries as required.
func (client GalleriesClient) ListByResourceGroupPreparer(ctx context.Context, resourceGroupName string) (*http.Request, error)
ListByResourceGroupPreparer prepares the ListByResourceGroup request.
func (client GalleriesClient) ListByResourceGroupResponder(resp *http.Response) (result GalleryList, err error)
ListByResourceGroupResponder handles the response to the ListByResourceGroup request. The method always closes the http.Response Body.
ListByResourceGroupSender sends the ListByResourceGroup request. The method will close the http.Response Body if it receives an error.
func (client GalleriesClient) ListComplete(ctx context.Context) (result GalleryListIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
ListPreparer prepares the List request.
func (client GalleriesClient) ListResponder(resp *http.Response) (result GalleryList, err error)
ListResponder handles the response to the List request. The method always closes the http.Response Body.
ListSender sends the List request. The method will close the http.Response Body if it receives an error.
GalleriesCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleriesCreateOrUpdateFuture) Result(client GalleriesClient) (g Gallery, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
GalleriesDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleriesDeleteFuture) Result(client GalleriesClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type Gallery struct {
autorest.Response `json:"-"`
*GalleryProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}Gallery specifies information about the Shared Image Gallery that you want to create or update.
MarshalJSON is the custom marshaler for Gallery.
UnmarshalJSON is the custom unmarshaler for Gallery struct.
type GalleryApplication struct {
autorest.Response `json:"-"`
*GalleryApplicationProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}GalleryApplication specifies information about the gallery Application Definition that you want to create or update.
func (ga GalleryApplication) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for GalleryApplication.
func (ga *GalleryApplication) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for GalleryApplication struct.
type GalleryApplicationList struct {
autorest.Response `json:"-"`
// Value - A list of Gallery Applications.
Value *[]GalleryApplication `json:"value,omitempty"`
// NextLink - The uri to fetch the next page of Application Definitions in the Application Gallery. Call ListNext() with this to fetch the next page of gallery Application Definitions.
NextLink *string `json:"nextLink,omitempty"`
}GalleryApplicationList the List Gallery Applications operation response.
func (gal GalleryApplicationList) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type GalleryApplicationListIterator struct {
// contains filtered or unexported fields
}GalleryApplicationListIterator provides access to a complete listing of GalleryApplication values.
func NewGalleryApplicationListIterator(page GalleryApplicationListPage) GalleryApplicationListIterator
Creates a new instance of the GalleryApplicationListIterator type.
func (iter *GalleryApplicationListIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *GalleryApplicationListIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter GalleryApplicationListIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter GalleryApplicationListIterator) Response() GalleryApplicationList
Response returns the raw server response from the last page request.
func (iter GalleryApplicationListIterator) Value() GalleryApplication
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type GalleryApplicationListPage struct {
// contains filtered or unexported fields
}GalleryApplicationListPage contains a page of GalleryApplication values.
func NewGalleryApplicationListPage(getNextPage func(context.Context, GalleryApplicationList) (GalleryApplicationList, error)) GalleryApplicationListPage
Creates a new instance of the GalleryApplicationListPage type.
func (page *GalleryApplicationListPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *GalleryApplicationListPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page GalleryApplicationListPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page GalleryApplicationListPage) Response() GalleryApplicationList
Response returns the raw server response from the last page request.
func (page GalleryApplicationListPage) Values() []GalleryApplication
Values returns the slice of values for the current page or nil if there are no values.
type GalleryApplicationProperties struct {
// Description - The description of this gallery Application Definition resource. This property is updatable.
Description *string `json:"description,omitempty"`
// Eula - The Eula agreement for the gallery Application Definition.
Eula *string `json:"eula,omitempty"`
// PrivacyStatementURI - The privacy statement uri.
PrivacyStatementURI *string `json:"privacyStatementUri,omitempty"`
// ReleaseNoteURI - The release note uri.
ReleaseNoteURI *string `json:"releaseNoteUri,omitempty"`
// EndOfLifeDate - The end of life date of the gallery Application Definition. This property can be used for decommissioning purposes. This property is updatable.
EndOfLifeDate *date.Time `json:"endOfLifeDate,omitempty"`
// SupportedOSType - This property allows you to specify the supported type of the OS that application is built for. <br><br> Possible values are: <br><br> **Windows** <br><br> **Linux**. Possible values include: 'Windows', 'Linux'
SupportedOSType OperatingSystemTypes `json:"supportedOSType,omitempty"`
}GalleryApplicationProperties describes the properties of a gallery Application Definition.
type GalleryApplicationVersion struct {
autorest.Response `json:"-"`
*GalleryApplicationVersionProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}GalleryApplicationVersion specifies information about the gallery Application Version that you want to create or update.
func (gav GalleryApplicationVersion) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for GalleryApplicationVersion.
func (gav *GalleryApplicationVersion) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for GalleryApplicationVersion struct.
type GalleryApplicationVersionList struct {
autorest.Response `json:"-"`
// Value - A list of gallery Application Versions.
Value *[]GalleryApplicationVersion `json:"value,omitempty"`
// NextLink - The uri to fetch the next page of gallery Application Versions. Call ListNext() with this to fetch the next page of gallery Application Versions.
NextLink *string `json:"nextLink,omitempty"`
}GalleryApplicationVersionList the List Gallery Application version operation response.
func (gavl GalleryApplicationVersionList) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type GalleryApplicationVersionListIterator struct {
// contains filtered or unexported fields
}GalleryApplicationVersionListIterator provides access to a complete listing of GalleryApplicationVersion values.
func NewGalleryApplicationVersionListIterator(page GalleryApplicationVersionListPage) GalleryApplicationVersionListIterator
Creates a new instance of the GalleryApplicationVersionListIterator type.
func (iter *GalleryApplicationVersionListIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *GalleryApplicationVersionListIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter GalleryApplicationVersionListIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter GalleryApplicationVersionListIterator) Response() GalleryApplicationVersionList
Response returns the raw server response from the last page request.
func (iter GalleryApplicationVersionListIterator) Value() GalleryApplicationVersion
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type GalleryApplicationVersionListPage struct {
// contains filtered or unexported fields
}GalleryApplicationVersionListPage contains a page of GalleryApplicationVersion values.
func NewGalleryApplicationVersionListPage(getNextPage func(context.Context, GalleryApplicationVersionList) (GalleryApplicationVersionList, error)) GalleryApplicationVersionListPage
Creates a new instance of the GalleryApplicationVersionListPage type.
func (page *GalleryApplicationVersionListPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *GalleryApplicationVersionListPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page GalleryApplicationVersionListPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page GalleryApplicationVersionListPage) Response() GalleryApplicationVersionList
Response returns the raw server response from the last page request.
func (page GalleryApplicationVersionListPage) Values() []GalleryApplicationVersion
Values returns the slice of values for the current page or nil if there are no values.
type GalleryApplicationVersionProperties struct {
PublishingProfile *GalleryApplicationVersionPublishingProfile `json:"publishingProfile,omitempty"`
// ProvisioningState - READ-ONLY; The provisioning state, which only appears in the response. Possible values include: 'ProvisioningState1Creating', 'ProvisioningState1Updating', 'ProvisioningState1Failed', 'ProvisioningState1Succeeded', 'ProvisioningState1Deleting', 'ProvisioningState1Migrating'
ProvisioningState ProvisioningState1 `json:"provisioningState,omitempty"`
// ReplicationStatus - READ-ONLY
ReplicationStatus *ReplicationStatus `json:"replicationStatus,omitempty"`
}GalleryApplicationVersionProperties describes the properties of a gallery Image Version.
type GalleryApplicationVersionPublishingProfile struct {
Source *UserArtifactSource `json:"source,omitempty"`
// ContentType - Optional. May be used to help process this file. The type of file contained in the source, e.g. zip, json, etc.
ContentType *string `json:"contentType,omitempty"`
// EnableHealthCheck - Optional. Whether or not this application reports health.
EnableHealthCheck *bool `json:"enableHealthCheck,omitempty"`
// TargetRegions - The target regions where the Image Version is going to be replicated to. This property is updatable.
TargetRegions *[]TargetRegion `json:"targetRegions,omitempty"`
// ReplicaCount - The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable.
ReplicaCount *int32 `json:"replicaCount,omitempty"`
// ExcludeFromLatest - If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version.
ExcludeFromLatest *bool `json:"excludeFromLatest,omitempty"`
// PublishedDate - READ-ONLY; The timestamp for when the gallery Image Version is published.
PublishedDate *date.Time `json:"publishedDate,omitempty"`
// EndOfLifeDate - The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable.
EndOfLifeDate *date.Time `json:"endOfLifeDate,omitempty"`
// StorageAccountType - Specifies the storage account type to be used to store the image. This property is not updatable. Possible values include: 'StorageAccountTypeStandardLRS', 'StorageAccountTypeStandardZRS'
StorageAccountType StorageAccountType `json:"storageAccountType,omitempty"`
}GalleryApplicationVersionPublishingProfile the publishing profile of a gallery Image Version.
type GalleryApplicationVersionsClient struct {
BaseClient
}GalleryApplicationVersionsClient is the compute Client
func NewGalleryApplicationVersionsClient(subscriptionID string) GalleryApplicationVersionsClient
NewGalleryApplicationVersionsClient creates an instance of the GalleryApplicationVersionsClient client.
func NewGalleryApplicationVersionsClientWithBaseURI(baseURI string, subscriptionID string) GalleryApplicationVersionsClient
NewGalleryApplicationVersionsClientWithBaseURI creates an instance of the GalleryApplicationVersionsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client GalleryApplicationVersionsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string, galleryApplicationVersion GalleryApplicationVersion) (result GalleryApplicationVersionsCreateOrUpdateFuture, err error)
CreateOrUpdate create or update a gallery Application Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition resides. galleryApplicationName - the name of the gallery Application Definition in which the Application Version is to be created. galleryApplicationVersionName - the name of the gallery Application Version to be created. Needs to follow semantic version name pattern: The allowed characters are digit and period. Digits must be within the range of a 32-bit integer. Format: <MajorVersion>.<MinorVersion>.<Patch> galleryApplicationVersion - parameters supplied to the create or update gallery Application Version operation.
func (client GalleryApplicationVersionsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string, galleryApplicationVersion GalleryApplicationVersion) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client GalleryApplicationVersionsClient) CreateOrUpdateResponder(resp *http.Response) (result GalleryApplicationVersion, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client GalleryApplicationVersionsClient) CreateOrUpdateSender(req *http.Request) (future GalleryApplicationVersionsCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationVersionsClient) Delete(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string) (result GalleryApplicationVersionsDeleteFuture, err error)
Delete delete a gallery Application Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition resides. galleryApplicationName - the name of the gallery Application Definition in which the Application Version resides. galleryApplicationVersionName - the name of the gallery Application Version to be deleted.
func (client GalleryApplicationVersionsClient) DeletePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client GalleryApplicationVersionsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client GalleryApplicationVersionsClient) DeleteSender(req *http.Request) (future GalleryApplicationVersionsDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationVersionsClient) Get(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string, expand ReplicationStatusTypes) (result GalleryApplicationVersion, err error)
Get retrieves information about a gallery Application Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition resides. galleryApplicationName - the name of the gallery Application Definition in which the Application Version resides. galleryApplicationVersionName - the name of the gallery Application Version to be retrieved. expand - the expand expression to apply on the operation.
func (client GalleryApplicationVersionsClient) GetPreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplicationVersionName string, expand ReplicationStatusTypes) (*http.Request, error)
GetPreparer prepares the Get request.
func (client GalleryApplicationVersionsClient) GetResponder(resp *http.Response) (result GalleryApplicationVersion, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
func (client GalleryApplicationVersionsClient) GetSender(req *http.Request) (*http.Response, error)
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationVersionsClient) ListByGalleryApplication(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (result GalleryApplicationVersionListPage, err error)
ListByGalleryApplication list gallery Application Versions in a gallery Application Definition. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition resides. galleryApplicationName - the name of the Shared Application Gallery Application Definition from which the Application Versions are to be listed.
func (client GalleryApplicationVersionsClient) ListByGalleryApplicationComplete(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (result GalleryApplicationVersionListIterator, err error)
ListByGalleryApplicationComplete enumerates all values, automatically crossing page boundaries as required.
func (client GalleryApplicationVersionsClient) ListByGalleryApplicationPreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (*http.Request, error)
ListByGalleryApplicationPreparer prepares the ListByGalleryApplication request.
func (client GalleryApplicationVersionsClient) ListByGalleryApplicationResponder(resp *http.Response) (result GalleryApplicationVersionList, err error)
ListByGalleryApplicationResponder handles the response to the ListByGalleryApplication request. The method always closes the http.Response Body.
func (client GalleryApplicationVersionsClient) ListByGalleryApplicationSender(req *http.Request) (*http.Response, error)
ListByGalleryApplicationSender sends the ListByGalleryApplication request. The method will close the http.Response Body if it receives an error.
GalleryApplicationVersionsCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleryApplicationVersionsCreateOrUpdateFuture) Result(client GalleryApplicationVersionsClient) (gav GalleryApplicationVersion, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
GalleryApplicationVersionsDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleryApplicationVersionsDeleteFuture) Result(client GalleryApplicationVersionsClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type GalleryApplicationsClient struct {
BaseClient
}GalleryApplicationsClient is the compute Client
func NewGalleryApplicationsClient(subscriptionID string) GalleryApplicationsClient
NewGalleryApplicationsClient creates an instance of the GalleryApplicationsClient client.
func NewGalleryApplicationsClientWithBaseURI(baseURI string, subscriptionID string) GalleryApplicationsClient
NewGalleryApplicationsClientWithBaseURI creates an instance of the GalleryApplicationsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client GalleryApplicationsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplication GalleryApplication) (result GalleryApplicationsCreateOrUpdateFuture, err error)
CreateOrUpdate create or update a gallery Application Definition. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition is to be created. galleryApplicationName - the name of the gallery Application Definition to be created or updated. The allowed characters are alphabets and numbers with dots, dashes, and periods allowed in the middle. The maximum length is 80 characters. galleryApplication - parameters supplied to the create or update gallery Application operation.
func (client GalleryApplicationsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string, galleryApplication GalleryApplication) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client GalleryApplicationsClient) CreateOrUpdateResponder(resp *http.Response) (result GalleryApplication, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client GalleryApplicationsClient) CreateOrUpdateSender(req *http.Request) (future GalleryApplicationsCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationsClient) Delete(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (result GalleryApplicationsDeleteFuture, err error)
Delete delete a gallery Application. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery in which the Application Definition is to be deleted. galleryApplicationName - the name of the gallery Application Definition to be deleted.
func (client GalleryApplicationsClient) DeletePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client GalleryApplicationsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client GalleryApplicationsClient) DeleteSender(req *http.Request) (future GalleryApplicationsDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationsClient) Get(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (result GalleryApplication, err error)
Get retrieves information about a gallery Application Definition. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery from which the Application Definitions are to be retrieved. galleryApplicationName - the name of the gallery Application Definition to be retrieved.
func (client GalleryApplicationsClient) GetPreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryApplicationName string) (*http.Request, error)
GetPreparer prepares the Get request.
func (client GalleryApplicationsClient) GetResponder(resp *http.Response) (result GalleryApplication, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (client GalleryApplicationsClient) ListByGallery(ctx context.Context, resourceGroupName string, galleryName string) (result GalleryApplicationListPage, err error)
ListByGallery list gallery Application Definitions in a gallery. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Application Gallery from which Application Definitions are to be listed.
func (client GalleryApplicationsClient) ListByGalleryComplete(ctx context.Context, resourceGroupName string, galleryName string) (result GalleryApplicationListIterator, err error)
ListByGalleryComplete enumerates all values, automatically crossing page boundaries as required.
func (client GalleryApplicationsClient) ListByGalleryPreparer(ctx context.Context, resourceGroupName string, galleryName string) (*http.Request, error)
ListByGalleryPreparer prepares the ListByGallery request.
func (client GalleryApplicationsClient) ListByGalleryResponder(resp *http.Response) (result GalleryApplicationList, err error)
ListByGalleryResponder handles the response to the ListByGallery request. The method always closes the http.Response Body.
func (client GalleryApplicationsClient) ListByGallerySender(req *http.Request) (*http.Response, error)
ListByGallerySender sends the ListByGallery request. The method will close the http.Response Body if it receives an error.
GalleryApplicationsCreateOrUpdateFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleryApplicationsCreateOrUpdateFuture) Result(client GalleryApplicationsClient) (ga GalleryApplication, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
GalleryApplicationsDeleteFuture an abstraction for monitoring and retrieving the results of a long-running operation.
func (future *GalleryApplicationsDeleteFuture) Result(client GalleryApplicationsClient) (ar autorest.Response, err error)
Result returns the result of the asynchronous operation. If the operation has not completed it will return an error.
type GalleryArtifactPublishingProfileBase struct {
// TargetRegions - The target regions where the Image Version is going to be replicated to. This property is updatable.
TargetRegions *[]TargetRegion `json:"targetRegions,omitempty"`
// ReplicaCount - The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable.
ReplicaCount *int32 `json:"replicaCount,omitempty"`
// ExcludeFromLatest - If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version.
ExcludeFromLatest *bool `json:"excludeFromLatest,omitempty"`
// PublishedDate - READ-ONLY; The timestamp for when the gallery Image Version is published.
PublishedDate *date.Time `json:"publishedDate,omitempty"`
// EndOfLifeDate - The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable.
EndOfLifeDate *date.Time `json:"endOfLifeDate,omitempty"`
// StorageAccountType - Specifies the storage account type to be used to store the image. This property is not updatable. Possible values include: 'StorageAccountTypeStandardLRS', 'StorageAccountTypeStandardZRS'
StorageAccountType StorageAccountType `json:"storageAccountType,omitempty"`
}GalleryArtifactPublishingProfileBase describes the basic gallery artifact publishing profile.
type GalleryArtifactSource struct {
ManagedImage *ManagedArtifact `json:"managedImage,omitempty"`
}GalleryArtifactSource the source image from which the Image Version is going to be created.
type GalleryDataDiskImage struct {
// Lun - READ-ONLY; This property specifies the logical unit number of the data disk. This value is used to identify data disks within the Virtual Machine and therefore must be unique for each data disk attached to the Virtual Machine.
Lun *int32 `json:"lun,omitempty"`
// SizeInGB - READ-ONLY; This property indicates the size of the VHD to be created.
SizeInGB *int32 `json:"sizeInGB,omitempty"`
// HostCaching - READ-ONLY; The host caching of the disk. Valid values are 'None', 'ReadOnly', and 'ReadWrite'. Possible values include: 'HostCachingNone', 'HostCachingReadOnly', 'HostCachingReadWrite'
HostCaching HostCaching `json:"hostCaching,omitempty"`
}GalleryDataDiskImage this is the data disk image.
type GalleryDiskImage struct {
// SizeInGB - READ-ONLY; This property indicates the size of the VHD to be created.
SizeInGB *int32 `json:"sizeInGB,omitempty"`
// HostCaching - READ-ONLY; The host caching of the disk. Valid values are 'None', 'ReadOnly', and 'ReadWrite'. Possible values include: 'HostCachingNone', 'HostCachingReadOnly', 'HostCachingReadWrite'
HostCaching HostCaching `json:"hostCaching,omitempty"`
}GalleryDiskImage this is the disk image base class.
type GalleryIdentifier struct {
// UniqueName - READ-ONLY; The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
UniqueName *string `json:"uniqueName,omitempty"`
}GalleryIdentifier describes the gallery unique name.
type GalleryImage struct {
autorest.Response `json:"-"`
*GalleryImageProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}GalleryImage specifies information about the gallery Image Definition that you want to create or update.
func (gi GalleryImage) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for GalleryImage.
func (gi *GalleryImage) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for GalleryImage struct.
type GalleryImageIdentifier struct {
// Publisher - The name of the gallery Image Definition publisher.
Publisher *string `json:"publisher,omitempty"`
// Offer - The name of the gallery Image Definition offer.
Offer *string `json:"offer,omitempty"`
// Sku - The name of the gallery Image Definition SKU.
Sku *string `json:"sku,omitempty"`
}GalleryImageIdentifier this is the gallery Image Definition identifier.
type GalleryImageList struct {
autorest.Response `json:"-"`
// Value - A list of Shared Image Gallery images.
Value *[]GalleryImage `json:"value,omitempty"`
// NextLink - The uri to fetch the next page of Image Definitions in the Shared Image Gallery. Call ListNext() with this to fetch the next page of gallery Image Definitions.
NextLink *string `json:"nextLink,omitempty"`
}GalleryImageList the List Gallery Images operation response.
func (gil GalleryImageList) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type GalleryImageListIterator struct {
// contains filtered or unexported fields
}GalleryImageListIterator provides access to a complete listing of GalleryImage values.
func NewGalleryImageListIterator(page GalleryImageListPage) GalleryImageListIterator
Creates a new instance of the GalleryImageListIterator type.
func (iter *GalleryImageListIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *GalleryImageListIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter GalleryImageListIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter GalleryImageListIterator) Response() GalleryImageList
Response returns the raw server response from the last page request.
func (iter GalleryImageListIterator) Value() GalleryImage
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type GalleryImageListPage struct {
// contains filtered or unexported fields
}GalleryImageListPage contains a page of GalleryImage values.
func NewGalleryImageListPage(getNextPage func(context.Context, GalleryImageList) (GalleryImageList, error)) GalleryImageListPage
Creates a new instance of the GalleryImageListPage type.
func (page *GalleryImageListPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *GalleryImageListPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page GalleryImageListPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page GalleryImageListPage) Response() GalleryImageList
Response returns the raw server response from the last page request.
func (page GalleryImageListPage) Values() []GalleryImage
Values returns the slice of values for the current page or nil if there are no values.
type GalleryImageProperties struct {
// Description - The description of this gallery Image Definition resource. This property is updatable.
Description *string `json:"description,omitempty"`
// Eula - The Eula agreement for the gallery Image Definition.
Eula *string `json:"eula,omitempty"`
// PrivacyStatementURI - The privacy statement uri.
PrivacyStatementURI *string `json:"privacyStatementUri,omitempty"`
// ReleaseNoteURI - The release note uri.
ReleaseNoteURI *string `json:"releaseNoteUri,omitempty"`
// OsType - This property allows you to specify the type of the OS that is included in the disk when creating a VM from a managed image. <br><br> Possible values are: <br><br> **Windows** <br><br> **Linux**. Possible values include: 'Windows', 'Linux'
OsType OperatingSystemTypes `json:"osType,omitempty"`
// OsState - This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or 'Specialized'. Possible values include: 'Generalized', 'Specialized'
OsState OperatingSystemStateTypes `json:"osState,omitempty"`
// EndOfLifeDate - The end of life date of the gallery Image Definition. This property can be used for decommissioning purposes. This property is updatable.
EndOfLifeDate *date.Time `json:"endOfLifeDate,omitempty"`
Identifier *GalleryImageIdentifier `json:"identifier,omitempty"`
Recommended *RecommendedMachineConfiguration `json:"recommended,omitempty"`
Disallowed *Disallowed `json:"disallowed,omitempty"`
PurchasePlan *ImagePurchasePlan `json:"purchasePlan,omitempty"`
// ProvisioningState - READ-ONLY; The provisioning state, which only appears in the response. Possible values include: 'ProvisioningState2Creating', 'ProvisioningState2Updating', 'ProvisioningState2Failed', 'ProvisioningState2Succeeded', 'ProvisioningState2Deleting', 'ProvisioningState2Migrating'
ProvisioningState ProvisioningState2 `json:"provisioningState,omitempty"`
}GalleryImageProperties describes the properties of a gallery Image Definition.
type GalleryImageVersion struct {
autorest.Response `json:"-"`
*GalleryImageVersionProperties `json:"properties,omitempty"`
// ID - READ-ONLY; Resource Id
ID *string `json:"id,omitempty"`
// Name - READ-ONLY; Resource name
Name *string `json:"name,omitempty"`
// Type - READ-ONLY; Resource type
Type *string `json:"type,omitempty"`
// Location - Resource location
Location *string `json:"location,omitempty"`
// Tags - Resource tags
Tags map[string]*string `json:"tags"`
}GalleryImageVersion specifies information about the gallery Image Version that you want to create or update.
func (giv GalleryImageVersion) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for GalleryImageVersion.
func (giv *GalleryImageVersion) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for GalleryImageVersion struct.
type GalleryImageVersionList struct {
autorest.Response `json:"-"`
// Value - A list of gallery Image Versions.
Value *[]GalleryImageVersion `json:"value,omitempty"`
// NextLink - The uri to fetch the next page of gallery Image Versions. Call ListNext() with this to fetch the next page of gallery Image Versions.
NextLink *string `json:"nextLink,omitempty"`
}GalleryImageVersionList the List Gallery Image version operation response.
func (givl GalleryImageVersionList) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type GalleryImageVersionListIterator struct {
// contains filtered or unexported fields
}GalleryImageVersionListIterator provides access to a complete listing of GalleryImageVersion values.
func NewGalleryImageVersionListIterator(page GalleryImageVersionListPage) GalleryImageVersionListIterator
Creates a new instance of the GalleryImageVersionListIterator type.
func (iter *GalleryImageVersionListIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (iter *GalleryImageVersionListIterator) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (iter GalleryImageVersionListIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (iter GalleryImageVersionListIterator) Response() GalleryImageVersionList
Response returns the raw server response from the last page request.
func (iter GalleryImageVersionListIterator) Value() GalleryImageVersion
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type GalleryImageVersionListPage struct {
// contains filtered or unexported fields
}GalleryImageVersionListPage contains a page of GalleryImageVersion values.
func NewGalleryImageVersionListPage(getNextPage func(context.Context, GalleryImageVersionList) (GalleryImageVersionList, error)) GalleryImageVersionListPage
Creates a new instance of the GalleryImageVersionListPage type.
func (page *GalleryImageVersionListPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned. Deprecated: Use NextWithContext() instead.
func (page *GalleryImageVersionListPage) NextWithContext(ctx context.Context) (err error)
NextWithContext advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (page GalleryImageVersionListPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (page GalleryImageVersionListPage) Response() GalleryImageVersionList
Response returns the raw server response from the last page request.
func (page GalleryImageVersionListPage) Values() []GalleryImageVersion
Values returns the slice of values for the current page or nil if there are no values.
type GalleryImageVersionProperties struct {
PublishingProfile *GalleryImageVersionPublishingProfile `json:"publishingProfile,omitempty"`
// ProvisioningState - READ-ONLY; The provisioning state, which only appears in the response. Possible values include: 'ProvisioningState3Creating', 'ProvisioningState3Updating', 'ProvisioningState3Failed', 'ProvisioningState3Succeeded', 'ProvisioningState3Deleting', 'ProvisioningState3Migrating'
ProvisioningState ProvisioningState3 `json:"provisioningState,omitempty"`
// StorageProfile - READ-ONLY
StorageProfile *GalleryImageVersionStorageProfile `json:"storageProfile,omitempty"`
// ReplicationStatus - READ-ONLY
ReplicationStatus *ReplicationStatus `json:"replicationStatus,omitempty"`
}GalleryImageVersionProperties describes the properties of a gallery Image Version.
type GalleryImageVersionPublishingProfile struct {
Source *GalleryArtifactSource `json:"source,omitempty"`
// TargetRegions - The target regions where the Image Version is going to be replicated to. This property is updatable.
TargetRegions *[]TargetRegion `json:"targetRegions,omitempty"`
// ReplicaCount - The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable.
ReplicaCount *int32 `json:"replicaCount,omitempty"`
// ExcludeFromLatest - If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version.
ExcludeFromLatest *bool `json:"excludeFromLatest,omitempty"`
// PublishedDate - READ-ONLY; The timestamp for when the gallery Image Version is published.
PublishedDate *date.Time `json:"publishedDate,omitempty"`
// EndOfLifeDate - The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable.
EndOfLifeDate *date.Time `json:"endOfLifeDate,omitempty"`
// StorageAccountType - Specifies the storage account type to be used to store the image. This property is not updatable. Possible values include: 'StorageAccountTypeStandardLRS', 'StorageAccountTypeStandardZRS'
StorageAccountType StorageAccountType `json:"storageAccountType,omitempty"`
}GalleryImageVersionPublishingProfile the publishing profile of a gallery Image Version.
type GalleryImageVersionStorageProfile struct {
// OsDiskImage - READ-ONLY
OsDiskImage *GalleryOSDiskImage `json:"osDiskImage,omitempty"`
// DataDiskImages - READ-ONLY; A list of data disk images.
DataDiskImages *[]GalleryDataDiskImage `json:"dataDiskImages,omitempty"`
}GalleryImageVersionStorageProfile this is the storage profile of a Gallery Image Version.
type GalleryImageVersionsClient struct {
BaseClient
}GalleryImageVersionsClient is the compute Client
func NewGalleryImageVersionsClient(subscriptionID string) GalleryImageVersionsClient
NewGalleryImageVersionsClient creates an instance of the GalleryImageVersionsClient client.
func NewGalleryImageVersionsClientWithBaseURI(baseURI string, subscriptionID string) GalleryImageVersionsClient
NewGalleryImageVersionsClientWithBaseURI creates an instance of the GalleryImageVersionsClient client using a custom endpoint. Use this when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
func (client GalleryImageVersionsClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, galleryName string, galleryImageName string, galleryImageVersionName string, galleryImageVersion GalleryImageVersion) (result GalleryImageVersionsCreateOrUpdateFuture, err error)
CreateOrUpdate create or update a gallery Image Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery in which the Image Definition resides. galleryImageName - the name of the gallery Image Definition in which the Image Version is to be created. galleryImageVersionName - the name of the gallery Image Version to be created. Needs to follow semantic version name pattern: The allowed characters are digit and period. Digits must be within the range of a 32-bit integer. Format: <MajorVersion>.<MinorVersion>.<Patch> galleryImageVersion - parameters supplied to the create or update gallery Image Version operation.
func (client GalleryImageVersionsClient) CreateOrUpdatePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryImageName string, galleryImageVersionName string, galleryImageVersion GalleryImageVersion) (*http.Request, error)
CreateOrUpdatePreparer prepares the CreateOrUpdate request.
func (client GalleryImageVersionsClient) CreateOrUpdateResponder(resp *http.Response) (result GalleryImageVersion, err error)
CreateOrUpdateResponder handles the response to the CreateOrUpdate request. The method always closes the http.Response Body.
func (client GalleryImageVersionsClient) CreateOrUpdateSender(req *http.Request) (future GalleryImageVersionsCreateOrUpdateFuture, err error)
CreateOrUpdateSender sends the CreateOrUpdate request. The method will close the http.Response Body if it receives an error.
func (client GalleryImageVersionsClient) Delete(ctx context.Context, resourceGroupName string, galleryName string, galleryImageName string, galleryImageVersionName string) (result GalleryImageVersionsDeleteFuture, err error)
Delete delete a gallery Image Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery in which the Image Definition resides. galleryImageName - the name of the gallery Image Definition in which the Image Version resides. galleryImageVersionName - the name of the gallery Image Version to be deleted.
func (client GalleryImageVersionsClient) DeletePreparer(ctx context.Context, resourceGroupName string, galleryName string, galleryImageName string, galleryImageVersionName string) (*http.Request, error)
DeletePreparer prepares the Delete request.
func (client GalleryImageVersionsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)
DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.
func (client GalleryImageVersionsClient) DeleteSender(req *http.Request) (future GalleryImageVersionsDeleteFuture, err error)
DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.
func (client GalleryImageVersionsClient) Get(ctx context.Context, resourceGroupName string, galleryName string, galleryImageName string, galleryImageVersionName string, expand ReplicationStatusTypes) (result GalleryImageVersion, err error)
Get retrieves information about a gallery Image Version. Parameters: resourceGroupName - the name of the resource group. galleryName - the name of the Shared Image Gallery in which the Image Definition resides. gallery