vaults

package
v0.20230803.1095722 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2023 License: MPL-2.0 Imports: 14 Imported by: 0

README

github.com/hashicorp/go-azure-sdk/resource-manager/recoveryservices/2022-08-01/vaults Documentation

The vaults SDK allows for interaction with the Azure Resource Manager Service recoveryservices (API Version 2022-08-01).

This readme covers example usages, but further information on using this SDK can be found in the project root.

Import Path

import "github.com/hashicorp/go-azure-sdk/resource-manager/recoveryservices/2022-08-01/vaults"

Client Initialization

client := vaults.NewVaultsClientWithBaseURI("https://management.azure.com")
client.Client.Authorizer = authorizer

Example Usage: VaultsClient.CreateOrUpdate

ctx := context.TODO()
id := vaults.NewVaultID("12345678-1234-9876-4563-123456789012", "example-resource-group", "vaultValue")

payload := vaults.Vault{
	// ...
}


if err := client.CreateOrUpdateThenPoll(ctx, id, payload); err != nil {
	// handle the error
}

Example Usage: VaultsClient.Delete

ctx := context.TODO()
id := vaults.NewVaultID("12345678-1234-9876-4563-123456789012", "example-resource-group", "vaultValue")

read, err := client.Delete(ctx, id)
if err != nil {
	// handle the error
}
if model := read.Model; model != nil {
	// do something with the model/response object
}

Example Usage: VaultsClient.Get

ctx := context.TODO()
id := vaults.NewVaultID("12345678-1234-9876-4563-123456789012", "example-resource-group", "vaultValue")

read, err := client.Get(ctx, id)
if err != nil {
	// handle the error
}
if model := read.Model; model != nil {
	// do something with the model/response object
}

Example Usage: VaultsClient.ListByResourceGroup

ctx := context.TODO()
id := vaults.NewResourceGroupID("12345678-1234-9876-4563-123456789012", "example-resource-group")

// alternatively `client.ListByResourceGroup(ctx, id)` can be used to do batched pagination
items, err := client.ListByResourceGroupComplete(ctx, id)
if err != nil {
	// handle the error
}
for _, item := range items {
	// do something
}

Example Usage: VaultsClient.ListBySubscriptionId

ctx := context.TODO()
id := vaults.NewSubscriptionID("12345678-1234-9876-4563-123456789012")

// alternatively `client.ListBySubscriptionId(ctx, id)` can be used to do batched pagination
items, err := client.ListBySubscriptionIdComplete(ctx, id)
if err != nil {
	// handle the error
}
for _, item := range items {
	// do something
}

Example Usage: VaultsClient.Update

ctx := context.TODO()
id := vaults.NewVaultID("12345678-1234-9876-4563-123456789012", "example-resource-group", "vaultValue")

payload := vaults.PatchVault{
	// ...
}


if err := client.UpdateThenPoll(ctx, id, payload); err != nil {
	// handle the error
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func PossibleValuesForAlertsState

func PossibleValuesForAlertsState() []string

func PossibleValuesForBackupStorageVersion

func PossibleValuesForBackupStorageVersion() []string

func PossibleValuesForCrossRegionRestore

func PossibleValuesForCrossRegionRestore() []string

func PossibleValuesForImmutabilityState

func PossibleValuesForImmutabilityState() []string

func PossibleValuesForInfrastructureEncryptionState

func PossibleValuesForInfrastructureEncryptionState() []string

func PossibleValuesForPrivateEndpointConnectionStatus

func PossibleValuesForPrivateEndpointConnectionStatus() []string

func PossibleValuesForProvisioningState

func PossibleValuesForProvisioningState() []string

func PossibleValuesForResourceMoveState

func PossibleValuesForResourceMoveState() []string

func PossibleValuesForSkuName

func PossibleValuesForSkuName() []string

func PossibleValuesForStandardTierStorageRedundancy

func PossibleValuesForStandardTierStorageRedundancy() []string

func PossibleValuesForTriggerType

func PossibleValuesForTriggerType() []string

func PossibleValuesForVaultPrivateEndpointState

func PossibleValuesForVaultPrivateEndpointState() []string

func PossibleValuesForVaultUpgradeState

func PossibleValuesForVaultUpgradeState() []string

func ValidateVaultID

func ValidateVaultID(input interface{}, key string) (warnings []string, errors []error)

ValidateVaultID checks that 'input' can be parsed as a Vault ID

Types

type AlertsState

type AlertsState string
const (
	AlertsStateDisabled AlertsState = "Disabled"
	AlertsStateEnabled  AlertsState = "Enabled"
)

type AzureMonitorAlertSettings

type AzureMonitorAlertSettings struct {
	AlertsForAllJobFailures *AlertsState `json:"alertsForAllJobFailures,omitempty"`
}

type BackupStorageVersion

type BackupStorageVersion string
const (
	BackupStorageVersionUnassigned BackupStorageVersion = "Unassigned"
	BackupStorageVersionVOne       BackupStorageVersion = "V1"
	BackupStorageVersionVTwo       BackupStorageVersion = "V2"
)

type ClassicAlertSettings

type ClassicAlertSettings struct {
	AlertsForCriticalOperations *AlertsState `json:"alertsForCriticalOperations,omitempty"`
}

type CmkKekIdentity

type CmkKekIdentity struct {
	UseSystemAssignedIdentity *bool   `json:"useSystemAssignedIdentity,omitempty"`
	UserAssignedIdentity      *string `json:"userAssignedIdentity,omitempty"`
}

type CmkKeyVaultProperties

type CmkKeyVaultProperties struct {
	KeyUri *string `json:"keyUri,omitempty"`
}

type CreateOrUpdateOperationResponse

type CreateOrUpdateOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type CrossRegionRestore

type CrossRegionRestore string
const (
	CrossRegionRestoreDisabled CrossRegionRestore = "Disabled"
	CrossRegionRestoreEnabled  CrossRegionRestore = "Enabled"
)

type DeleteOperationResponse

type DeleteOperationResponse struct {
	HttpResponse *http.Response
}

type GetOperationResponse

type GetOperationResponse struct {
	HttpResponse *http.Response
	Model        *Vault
}

type ImmutabilitySettings

type ImmutabilitySettings struct {
	State *ImmutabilityState `json:"state,omitempty"`
}

type ImmutabilityState

type ImmutabilityState string
const (
	ImmutabilityStateDisabled ImmutabilityState = "Disabled"
	ImmutabilityStateLocked   ImmutabilityState = "Locked"
	ImmutabilityStateUnlocked ImmutabilityState = "Unlocked"
)

type InfrastructureEncryptionState

type InfrastructureEncryptionState string
const (
	InfrastructureEncryptionStateDisabled InfrastructureEncryptionState = "Disabled"
	InfrastructureEncryptionStateEnabled  InfrastructureEncryptionState = "Enabled"
)

type ListByResourceGroupCompleteResult

type ListByResourceGroupCompleteResult struct {
	Items []Vault
}

type ListByResourceGroupOperationResponse

type ListByResourceGroupOperationResponse struct {
	HttpResponse *http.Response
	Model        *[]Vault
	// contains filtered or unexported fields
}

func (ListByResourceGroupOperationResponse) HasMore

func (ListByResourceGroupOperationResponse) LoadMore

type ListBySubscriptionIdCompleteResult

type ListBySubscriptionIdCompleteResult struct {
	Items []Vault
}

type ListBySubscriptionIdOperationResponse

type ListBySubscriptionIdOperationResponse struct {
	HttpResponse *http.Response
	Model        *[]Vault
	// contains filtered or unexported fields
}

func (ListBySubscriptionIdOperationResponse) HasMore

func (ListBySubscriptionIdOperationResponse) LoadMore

type MonitoringSettings

type MonitoringSettings struct {
	AzureMonitorAlertSettings *AzureMonitorAlertSettings `json:"azureMonitorAlertSettings,omitempty"`
	ClassicAlertSettings      *ClassicAlertSettings      `json:"classicAlertSettings,omitempty"`
}

type PatchVault

type PatchVault struct {
	Etag       *string                            `json:"etag,omitempty"`
	Id         *string                            `json:"id,omitempty"`
	Identity   *identity.SystemAndUserAssignedMap `json:"identity,omitempty"`
	Location   *string                            `json:"location,omitempty"`
	Name       *string                            `json:"name,omitempty"`
	Properties *VaultProperties                   `json:"properties,omitempty"`
	Sku        *Sku                               `json:"sku,omitempty"`
	Tags       *map[string]string                 `json:"tags,omitempty"`
	Type       *string                            `json:"type,omitempty"`
}

type PrivateEndpoint

type PrivateEndpoint struct {
	Id *string `json:"id,omitempty"`
}

type PrivateEndpointConnection

type PrivateEndpointConnection struct {
	PrivateEndpoint                   *PrivateEndpoint                   `json:"privateEndpoint,omitempty"`
	PrivateLinkServiceConnectionState *PrivateLinkServiceConnectionState `json:"privateLinkServiceConnectionState,omitempty"`
	ProvisioningState                 *ProvisioningState                 `json:"provisioningState,omitempty"`
}

type PrivateEndpointConnectionStatus

type PrivateEndpointConnectionStatus string
const (
	PrivateEndpointConnectionStatusApproved     PrivateEndpointConnectionStatus = "Approved"
	PrivateEndpointConnectionStatusDisconnected PrivateEndpointConnectionStatus = "Disconnected"
	PrivateEndpointConnectionStatusPending      PrivateEndpointConnectionStatus = "Pending"
	PrivateEndpointConnectionStatusRejected     PrivateEndpointConnectionStatus = "Rejected"
)

type PrivateEndpointConnectionVaultProperties

type PrivateEndpointConnectionVaultProperties struct {
	Id         *string                    `json:"id,omitempty"`
	Location   *string                    `json:"location,omitempty"`
	Name       *string                    `json:"name,omitempty"`
	Properties *PrivateEndpointConnection `json:"properties,omitempty"`
	Type       *string                    `json:"type,omitempty"`
}

type PrivateLinkServiceConnectionState

type PrivateLinkServiceConnectionState struct {
	ActionsRequired *string                          `json:"actionsRequired,omitempty"`
	Description     *string                          `json:"description,omitempty"`
	Status          *PrivateEndpointConnectionStatus `json:"status,omitempty"`
}

type ProvisioningState

type ProvisioningState string
const (
	ProvisioningStateDeleting  ProvisioningState = "Deleting"
	ProvisioningStateFailed    ProvisioningState = "Failed"
	ProvisioningStatePending   ProvisioningState = "Pending"
	ProvisioningStateSucceeded ProvisioningState = "Succeeded"
)

type ResourceMoveState

type ResourceMoveState string
const (
	ResourceMoveStateCommitFailed    ResourceMoveState = "CommitFailed"
	ResourceMoveStateCommitTimedout  ResourceMoveState = "CommitTimedout"
	ResourceMoveStateCriticalFailure ResourceMoveState = "CriticalFailure"
	ResourceMoveStateFailure         ResourceMoveState = "Failure"
	ResourceMoveStateInProgress      ResourceMoveState = "InProgress"
	ResourceMoveStateMoveSucceeded   ResourceMoveState = "MoveSucceeded"
	ResourceMoveStatePartialSuccess  ResourceMoveState = "PartialSuccess"
	ResourceMoveStatePrepareFailed   ResourceMoveState = "PrepareFailed"
	ResourceMoveStatePrepareTimedout ResourceMoveState = "PrepareTimedout"
	ResourceMoveStateUnknown         ResourceMoveState = "Unknown"
)

type SecuritySettings

type SecuritySettings struct {
	ImmutabilitySettings *ImmutabilitySettings `json:"immutabilitySettings,omitempty"`
}

type Sku

type Sku struct {
	Capacity *string `json:"capacity,omitempty"`
	Family   *string `json:"family,omitempty"`
	Name     SkuName `json:"name"`
	Size     *string `json:"size,omitempty"`
	Tier     *string `json:"tier,omitempty"`
}

type SkuName

type SkuName string
const (
	SkuNameRSZero   SkuName = "RS0"
	SkuNameStandard SkuName = "Standard"
)

type StandardTierStorageRedundancy

type StandardTierStorageRedundancy string
const (
	StandardTierStorageRedundancyGeoRedundant     StandardTierStorageRedundancy = "GeoRedundant"
	StandardTierStorageRedundancyLocallyRedundant StandardTierStorageRedundancy = "LocallyRedundant"
	StandardTierStorageRedundancyZoneRedundant    StandardTierStorageRedundancy = "ZoneRedundant"
)

type TriggerType

type TriggerType string
const (
	TriggerTypeForcedUpgrade TriggerType = "ForcedUpgrade"
	TriggerTypeUserTriggered TriggerType = "UserTriggered"
)

type UpdateOperationResponse

type UpdateOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type UpgradeDetails

type UpgradeDetails struct {
	EndTimeUtc         *string            `json:"endTimeUtc,omitempty"`
	LastUpdatedTimeUtc *string            `json:"lastUpdatedTimeUtc,omitempty"`
	Message            *string            `json:"message,omitempty"`
	OperationId        *string            `json:"operationId,omitempty"`
	PreviousResourceId *string            `json:"previousResourceId,omitempty"`
	StartTimeUtc       *string            `json:"startTimeUtc,omitempty"`
	Status             *VaultUpgradeState `json:"status,omitempty"`
	TriggerType        *TriggerType       `json:"triggerType,omitempty"`
	UpgradedResourceId *string            `json:"upgradedResourceId,omitempty"`
}

func (*UpgradeDetails) GetEndTimeUtcAsTime

func (o *UpgradeDetails) GetEndTimeUtcAsTime() (*time.Time, error)

func (*UpgradeDetails) GetLastUpdatedTimeUtcAsTime

func (o *UpgradeDetails) GetLastUpdatedTimeUtcAsTime() (*time.Time, error)

func (*UpgradeDetails) GetStartTimeUtcAsTime

func (o *UpgradeDetails) GetStartTimeUtcAsTime() (*time.Time, error)

func (*UpgradeDetails) SetEndTimeUtcAsTime

func (o *UpgradeDetails) SetEndTimeUtcAsTime(input time.Time)

func (*UpgradeDetails) SetLastUpdatedTimeUtcAsTime

func (o *UpgradeDetails) SetLastUpdatedTimeUtcAsTime(input time.Time)

func (*UpgradeDetails) SetStartTimeUtcAsTime

func (o *UpgradeDetails) SetStartTimeUtcAsTime(input time.Time)

type Vault

type Vault struct {
	Etag       *string                            `json:"etag,omitempty"`
	Id         *string                            `json:"id,omitempty"`
	Identity   *identity.SystemAndUserAssignedMap `json:"identity,omitempty"`
	Location   string                             `json:"location"`
	Name       *string                            `json:"name,omitempty"`
	Properties *VaultProperties                   `json:"properties,omitempty"`
	Sku        *Sku                               `json:"sku,omitempty"`
	SystemData *systemdata.SystemData             `json:"systemData,omitempty"`
	Tags       *map[string]string                 `json:"tags,omitempty"`
	Type       *string                            `json:"type,omitempty"`
}

type VaultId

type VaultId struct {
	SubscriptionId    string
	ResourceGroupName string
	VaultName         string
}

VaultId is a struct representing the Resource ID for a Vault

func NewVaultID

func NewVaultID(subscriptionId string, resourceGroupName string, vaultName string) VaultId

NewVaultID returns a new VaultId struct

func ParseVaultID

func ParseVaultID(input string) (*VaultId, error)

ParseVaultID parses 'input' into a VaultId

func ParseVaultIDInsensitively

func ParseVaultIDInsensitively(input string) (*VaultId, error)

ParseVaultIDInsensitively parses 'input' case-insensitively into a VaultId note: this method should only be used for API response data and not user input

func (VaultId) ID

func (id VaultId) ID() string

ID returns the formatted Vault ID

func (VaultId) Segments

func (id VaultId) Segments() []resourceids.Segment

Segments returns a slice of Resource ID Segments which comprise this Vault ID

func (VaultId) String

func (id VaultId) String() string

String returns a human-readable description of this Vault ID

type VaultOperationPredicate

type VaultOperationPredicate struct {
	Etag     *string
	Id       *string
	Location *string
	Name     *string
	Type     *string
}

func (VaultOperationPredicate) Matches

func (p VaultOperationPredicate) Matches(input Vault) bool

type VaultPrivateEndpointState

type VaultPrivateEndpointState string
const (
	VaultPrivateEndpointStateEnabled VaultPrivateEndpointState = "Enabled"
	VaultPrivateEndpointStateNone    VaultPrivateEndpointState = "None"
)

type VaultProperties

type VaultProperties struct {
	BackupStorageVersion                *BackupStorageVersion                       `json:"backupStorageVersion,omitempty"`
	Encryption                          *VaultPropertiesEncryption                  `json:"encryption,omitempty"`
	MonitoringSettings                  *MonitoringSettings                         `json:"monitoringSettings,omitempty"`
	MoveDetails                         *VaultPropertiesMoveDetails                 `json:"moveDetails,omitempty"`
	MoveState                           *ResourceMoveState                          `json:"moveState,omitempty"`
	PrivateEndpointConnections          *[]PrivateEndpointConnectionVaultProperties `json:"privateEndpointConnections,omitempty"`
	PrivateEndpointStateForBackup       *VaultPrivateEndpointState                  `json:"privateEndpointStateForBackup,omitempty"`
	PrivateEndpointStateForSiteRecovery *VaultPrivateEndpointState                  `json:"privateEndpointStateForSiteRecovery,omitempty"`
	ProvisioningState                   *string                                     `json:"provisioningState,omitempty"`
	RedundancySettings                  *VaultPropertiesRedundancySettings          `json:"redundancySettings,omitempty"`
	SecuritySettings                    *SecuritySettings                           `json:"securitySettings,omitempty"`
	UpgradeDetails                      *UpgradeDetails                             `json:"upgradeDetails,omitempty"`
}

type VaultPropertiesEncryption

type VaultPropertiesEncryption struct {
	InfrastructureEncryption *InfrastructureEncryptionState `json:"infrastructureEncryption,omitempty"`
	KekIdentity              *CmkKekIdentity                `json:"kekIdentity,omitempty"`
	KeyVaultProperties       *CmkKeyVaultProperties         `json:"keyVaultProperties,omitempty"`
}

type VaultPropertiesMoveDetails

type VaultPropertiesMoveDetails struct {
	CompletionTimeUtc *string `json:"completionTimeUtc,omitempty"`
	OperationId       *string `json:"operationId,omitempty"`
	SourceResourceId  *string `json:"sourceResourceId,omitempty"`
	StartTimeUtc      *string `json:"startTimeUtc,omitempty"`
	TargetResourceId  *string `json:"targetResourceId,omitempty"`
}

func (*VaultPropertiesMoveDetails) GetCompletionTimeUtcAsTime

func (o *VaultPropertiesMoveDetails) GetCompletionTimeUtcAsTime() (*time.Time, error)

func (*VaultPropertiesMoveDetails) GetStartTimeUtcAsTime

func (o *VaultPropertiesMoveDetails) GetStartTimeUtcAsTime() (*time.Time, error)

func (*VaultPropertiesMoveDetails) SetCompletionTimeUtcAsTime

func (o *VaultPropertiesMoveDetails) SetCompletionTimeUtcAsTime(input time.Time)

func (*VaultPropertiesMoveDetails) SetStartTimeUtcAsTime

func (o *VaultPropertiesMoveDetails) SetStartTimeUtcAsTime(input time.Time)

type VaultPropertiesRedundancySettings

type VaultPropertiesRedundancySettings struct {
	CrossRegionRestore            *CrossRegionRestore            `json:"crossRegionRestore,omitempty"`
	StandardTierStorageRedundancy *StandardTierStorageRedundancy `json:"standardTierStorageRedundancy,omitempty"`
}

type VaultUpgradeState

type VaultUpgradeState string
const (
	VaultUpgradeStateFailed     VaultUpgradeState = "Failed"
	VaultUpgradeStateInProgress VaultUpgradeState = "InProgress"
	VaultUpgradeStateUnknown    VaultUpgradeState = "Unknown"
	VaultUpgradeStateUpgraded   VaultUpgradeState = "Upgraded"
)

type VaultsClient

type VaultsClient struct {
	Client autorest.Client
	// contains filtered or unexported fields
}

func NewVaultsClientWithBaseURI

func NewVaultsClientWithBaseURI(endpoint string) VaultsClient

func (VaultsClient) CreateOrUpdate

func (c VaultsClient) CreateOrUpdate(ctx context.Context, id VaultId, input Vault) (result CreateOrUpdateOperationResponse, err error)

CreateOrUpdate ...

func (VaultsClient) CreateOrUpdateThenPoll

func (c VaultsClient) CreateOrUpdateThenPoll(ctx context.Context, id VaultId, input Vault) error

CreateOrUpdateThenPoll performs CreateOrUpdate then polls until it's completed

func (VaultsClient) Delete

func (c VaultsClient) Delete(ctx context.Context, id VaultId) (result DeleteOperationResponse, err error)

Delete ...

func (VaultsClient) Get

func (c VaultsClient) Get(ctx context.Context, id VaultId) (result GetOperationResponse, err error)

Get ...

func (VaultsClient) ListByResourceGroup

ListByResourceGroup ...

func (VaultsClient) ListByResourceGroupComplete

ListByResourceGroupComplete retrieves all of the results into a single object

func (VaultsClient) ListByResourceGroupCompleteMatchingPredicate

func (c VaultsClient) ListByResourceGroupCompleteMatchingPredicate(ctx context.Context, id commonids.ResourceGroupId, predicate VaultOperationPredicate) (resp ListByResourceGroupCompleteResult, err error)

ListByResourceGroupCompleteMatchingPredicate retrieves all of the results and then applied the predicate

func (VaultsClient) ListBySubscriptionId

ListBySubscriptionId ...

func (VaultsClient) ListBySubscriptionIdComplete

ListBySubscriptionIdComplete retrieves all of the results into a single object

func (VaultsClient) ListBySubscriptionIdCompleteMatchingPredicate

func (c VaultsClient) ListBySubscriptionIdCompleteMatchingPredicate(ctx context.Context, id commonids.SubscriptionId, predicate VaultOperationPredicate) (resp ListBySubscriptionIdCompleteResult, err error)

ListBySubscriptionIdCompleteMatchingPredicate retrieves all of the results and then applied the predicate

func (VaultsClient) Update

func (c VaultsClient) Update(ctx context.Context, id VaultId, input PatchVault) (result UpdateOperationResponse, err error)

Update ...

func (VaultsClient) UpdateThenPoll

func (c VaultsClient) UpdateThenPoll(ctx context.Context, id VaultId, input PatchVault) error

UpdateThenPoll performs Update then polls until it's completed

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL