Documentation
¶
Overview ¶
Package blockstorage exposes Cinder v3 volumes through shared resource policies.
Index ¶
- func GetVolumeAttachDevice[V VolumeAttachDeviceInput](volume V, serverID string) (*string, error)
- func GetVolumeAttachDeviceFields(volume map[string]json.RawMessage, serverID string) (json.RawMessage, error)
- func WaitForAvailable[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, ...) (*T, error)
- func WaitForDelete[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, ...) error
- func WaitForState[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, ...) (*T, error)
- type AttachVolumeCreatedResponse
- type AttachVolumeObservation
- type AttachVolumeObservationResponse
- type AttachVolumeOption
- type AttachVolumeOpts
- type AttachVolumeRecord
- type AttachVolumeRequest
- type AttachVolumeResult
- type AttachVolumeWaitOpts
- type BackupMutationWaitOpts
- type BackupWaitTimeoutError
- type CinderVolumeAttachOption
- type CinderVolumeAttachOpts
- type CinderVolumeDetachOption
- type CinderVolumeDetachOpts
- type CreateVolumeActionResponse
- type CreateVolumeAttributes
- type CreateVolumeBackupOption
- func WithCreateVolumeBackupDescription(value string) CreateVolumeBackupOption
- func WithCreateVolumeBackupForce(value bool) CreateVolumeBackupOption
- func WithCreateVolumeBackupIncremental(value bool) CreateVolumeBackupOption
- func WithCreateVolumeBackupLocation(value resource.CloudLocation) CreateVolumeBackupOption
- func WithCreateVolumeBackupName(value string) CreateVolumeBackupOption
- func WithCreateVolumeBackupOptions(value CreateVolumeBackupOpts) CreateVolumeBackupOption
- func WithCreateVolumeBackupSnapshotID(value string) CreateVolumeBackupOption
- func WithCreateVolumeBackupWait(value bool) CreateVolumeBackupOption
- func WithCreateVolumeBackupWaitPolicy(value BackupMutationWaitOpts) CreateVolumeBackupOption
- type CreateVolumeBackupOpts
- type CreateVolumeBackupRequest
- type CreateVolumeBackupResult
- type CreateVolumeOption
- func WithCreateVolumeAttributes(value CreateVolumeAttributes) CreateVolumeOption
- func WithCreateVolumeBootable(value bool) CreateVolumeOption
- func WithCreateVolumeDescription(value string) CreateVolumeOption
- func WithCreateVolumeFields(value map[string]json.RawMessage) CreateVolumeOption
- func WithCreateVolumeMetadata(value map[string]string) CreateVolumeOption
- func WithCreateVolumeName(value string) CreateVolumeOption
- func WithCreateVolumeOptions(value CreateVolumeOpts) CreateVolumeOption
- func WithCreateVolumeSchedulerHints(value map[string]json.RawMessage) CreateVolumeOption
- func WithCreateVolumeSnapshot(value string) CreateVolumeOption
- func WithCreateVolumeType(value string) CreateVolumeOption
- func WithCreateVolumeWait(value bool) CreateVolumeOption
- func WithCreateVolumeWaitPolicy(value CreateVolumeWaitOpts) CreateVolumeOption
- type CreateVolumeOpts
- type CreateVolumeRequest
- type CreateVolumeResponse
- type CreateVolumeResult
- type CreateVolumeSnapshotAttributes
- type CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotAttributes(value CreateVolumeSnapshotAttributes) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotDescription(value string) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotDisplayDescription(value string) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotDisplayName(value string) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotFields(value map[string]json.RawMessage) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotForce(value bool) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotLocation(value resource.CloudLocation) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotName(value string) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotOptions(value CreateVolumeSnapshotOpts) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotWait(value bool) CreateVolumeSnapshotOption
- func WithCreateVolumeSnapshotWaitPolicy(value SnapshotMutationWaitOpts) CreateVolumeSnapshotOption
- type CreateVolumeSnapshotOpts
- type CreateVolumeSnapshotRequest
- type CreateVolumeSnapshotResult
- type CreateVolumeWaitOpts
- type DeleteVolumeBackupOption
- func WithDeleteVolumeBackupForce(value bool) DeleteVolumeBackupOption
- func WithDeleteVolumeBackupLocation(value resource.CloudLocation) DeleteVolumeBackupOption
- func WithDeleteVolumeBackupOptions(value DeleteVolumeBackupOpts) DeleteVolumeBackupOption
- func WithDeleteVolumeBackupWait(value bool) DeleteVolumeBackupOption
- func WithDeleteVolumeBackupWaitPolicy(value BackupMutationWaitOpts) DeleteVolumeBackupOption
- type DeleteVolumeBackupOpts
- type DeleteVolumeBackupRequest
- type DeleteVolumeBackupResult
- type DeleteVolumeObservationResponse
- type DeleteVolumeOption
- type DeleteVolumeOpts
- type DeleteVolumeRequest
- type DeleteVolumeResponse
- type DeleteVolumeResult
- type DeleteVolumeSnapshotOption
- func WithDeleteVolumeSnapshotLocation(value resource.CloudLocation) DeleteVolumeSnapshotOption
- func WithDeleteVolumeSnapshotOptions(value DeleteVolumeSnapshotOpts) DeleteVolumeSnapshotOption
- func WithDeleteVolumeSnapshotWait(value bool) DeleteVolumeSnapshotOption
- func WithDeleteVolumeSnapshotWaitPolicy(value SnapshotMutationWaitOpts) DeleteVolumeSnapshotOption
- type DeleteVolumeSnapshotOpts
- type DeleteVolumeSnapshotRequest
- type DeleteVolumeSnapshotResult
- type DeleteVolumeWaitOpts
- type DetachVolumeDeleteResponse
- type DetachVolumeOption
- type DetachVolumeOpts
- type DetachVolumeRequest
- type DetachVolumeResult
- type DetachVolumeWaitOpts
- type ExportVolumeBackupRecordRequest
- type ExportVolumeBackupRecordResult
- type ExportVolumeBackupRequest
- type ExportVolumeBackupResult
- type GetVolumeBackupRequest
- type GetVolumeBackupResult
- type GetVolumeByIDRequest
- type GetVolumeIDRequest
- type GetVolumeIDResult
- type GetVolumeLimitsOption
- type GetVolumeLimitsOpts
- type GetVolumeLimitsPage
- type GetVolumeLimitsProjectResult
- type GetVolumeLimitsRequest
- type GetVolumeLimitsResult
- type GetVolumeRequest
- type GetVolumeResult
- type GetVolumeSnapshotByIDRequest
- type GetVolumeSnapshotRequest
- type GetVolumeSnapshotResult
- type GetVolumeTypeAccessRequest
- type GetVolumeTypeAccessResult
- type GetVolumeTypeRequest
- type GetVolumeTypeResult
- type GetVolumesOption
- type GetVolumesOpts
- type GetVolumesPage
- type GetVolumesRequest
- type GetVolumesResult
- type ImportVolumeBackupRequest
- type ImportVolumeBackupResult
- type ListVolumeBackupsResult
- type ListVolumeSnapshotsResult
- type ListVolumeTypesResult
- type ListVolumesResult
- type ResetVolumeBackupStatusRequest
- type ResetVolumeBackupStatusResult
- type RestoreVolumeBackupOption
- func WithRestoreVolumeBackupLocation(value resource.CloudLocation) RestoreVolumeBackupOption
- func WithRestoreVolumeBackupName(value string) RestoreVolumeBackupOption
- func WithRestoreVolumeBackupOptions(value RestoreVolumeBackupOpts) RestoreVolumeBackupOption
- func WithRestoreVolumeBackupSeed(value json.RawMessage) RestoreVolumeBackupOption
- func WithRestoreVolumeBackupVolumeID(value string) RestoreVolumeBackupOption
- type RestoreVolumeBackupOpts
- type RestoreVolumeBackupRequest
- type RestoreVolumeBackupResult
- type SearchVolumeBackupsRequest
- type SearchVolumeBackupsResult
- type SearchVolumeSnapshotsRequest
- type SearchVolumeSnapshotsResult
- type SearchVolumeTypesRequest
- type SearchVolumeTypesResult
- type SearchVolumesRequest
- type SearchVolumesResult
- type Service
- type SetVolumeBootableOption
- type SetVolumeBootableOpts
- type SetVolumeBootableRequest
- type SetVolumeBootableResult
- type SnapshotMutationWaitOpts
- type SnapshotWaitTimeoutError
- type UpdateVolumeAttributes
- type UpdateVolumeOption
- func WithUpdateVolumeAttributes(value UpdateVolumeAttributes) UpdateVolumeOption
- func WithUpdateVolumeDescription(value string) UpdateVolumeOption
- func WithUpdateVolumeFields(value map[string]json.RawMessage) UpdateVolumeOption
- func WithUpdateVolumeLocation(value resource.CloudLocation) UpdateVolumeOption
- func WithUpdateVolumeMetadata(value map[string]string) UpdateVolumeOption
- func WithUpdateVolumeName(value string) UpdateVolumeOption
- func WithUpdateVolumeOptions(value UpdateVolumeOpts) UpdateVolumeOption
- type UpdateVolumeOpts
- type UpdateVolumeRequest
- type UpdateVolumeResult
- type Volume
- type VolumeActionPage
- type VolumeActionRequest
- type VolumeActionResult
- func AbortVolumeDetaching(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func AttachCinderVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func BeginVolumeDetaching(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func CompleteVolumeExtend(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func CompleteVolumeMigration(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func DetachCinderVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func ExtendVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func MigrateVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func ReserveVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func ResetVolumeStatus(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func RetypeVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func RevertVolumeToSnapshot(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func SetVolumeBootableStatus(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func SetVolumeImageMetadata(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func SetVolumeReadonly(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func UnmanageVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- func UnreserveVolume(ctx context.Context, client *gophercloud.ServiceClient, ...) (*VolumeActionResult, error)
- type VolumeAttachDeviceInput
- type VolumeAttachmentInfo
- type VolumeBackupExportResponse
- type VolumeBackupListOption
- func WithVolumeBackupListAllowUnknownParams(value bool) VolumeBackupListOption
- func WithVolumeBackupListConflictingAttrs(value json.RawMessage) VolumeBackupListOption
- func WithVolumeBackupListDetailed(value bool) VolumeBackupListOption
- func WithVolumeBackupListExpression(value string) VolumeBackupListOption
- func WithVolumeBackupListFilters(value json.RawMessage) VolumeBackupListOption
- func WithVolumeBackupListHeaders(value map[string]string) VolumeBackupListOption
- func WithVolumeBackupListLocation(value resource.CloudLocation) VolumeBackupListOption
- func WithVolumeBackupListMaxItems(value int) VolumeBackupListOption
- func WithVolumeBackupListMicroversion(value string) VolumeBackupListOption
- func WithVolumeBackupListOptions(value VolumeBackupListOpts) VolumeBackupListOption
- func WithVolumeBackupListPagination(value bool) VolumeBackupListOption
- type VolumeBackupListOpts
- type VolumeBackupMutationPage
- type VolumeBackupSearchOption
- func WithVolumeBackupSearchExpression(value string) VolumeBackupSearchOption
- func WithVolumeBackupSearchFilters(value json.RawMessage) VolumeBackupSearchOption
- func WithVolumeBackupSearchLocation(value resource.CloudLocation) VolumeBackupSearchOption
- func WithVolumeBackupSearchOptions(value VolumeBackupSearchOpts) VolumeBackupSearchOption
- type VolumeBackupSearchOpts
- type VolumeBackupSelectionError
- type VolumeBackupsPage
- type VolumeExistsRequest
- type VolumeExistsResult
- type VolumeExtendCompletionOption
- type VolumeExtendCompletionOpts
- type VolumeImageMetadataDeleteOption
- type VolumeImageMetadataDeleteOpts
- type VolumeImageMetadataDeleteResult
- type VolumeImageMetadataDeletion
- type VolumeImageMetadataOption
- func WithVolumeImageMetadata(value map[string]string) VolumeImageMetadataOption
- func WithVolumeImageMetadataOptions(value VolumeImageMetadataOpts) VolumeImageMetadataOption
- func WithVolumeImageMetadataRaw(value map[string]json.RawMessage) VolumeImageMetadataOption
- func WithVolumeImageMetadataValue(key, value string) VolumeImageMetadataOption
- type VolumeImageMetadataOpts
- type VolumeImageMetadataResponse
- type VolumeImageUploadOption
- func WithVolumeImageUploadContainerFormat(value string) VolumeImageUploadOption
- func WithVolumeImageUploadDiskFormat(value string) VolumeImageUploadOption
- func WithVolumeImageUploadForce(value bool) VolumeImageUploadOption
- func WithVolumeImageUploadOptions(value VolumeImageUploadOpts) VolumeImageUploadOption
- func WithVolumeImageUploadProtected(value bool) VolumeImageUploadOption
- func WithVolumeImageUploadVisibility(value string) VolumeImageUploadOption
- type VolumeImageUploadOpts
- type VolumeImageUploadResponse
- type VolumeImageUploadResult
- type VolumeInfo
- type VolumeMigrationCompletionOption
- type VolumeMigrationCompletionOpts
- type VolumeMigrationOption
- func WithVolumeMigrationCluster(value string) VolumeMigrationOption
- func WithVolumeMigrationForceHostCopy(value bool) VolumeMigrationOption
- func WithVolumeMigrationHost(value string) VolumeMigrationOption
- func WithVolumeMigrationLockVolume(value bool) VolumeMigrationOption
- func WithVolumeMigrationOptions(value VolumeMigrationOpts) VolumeMigrationOption
- type VolumeMigrationOpts
- type VolumeMutationPage
- type VolumeReadOption
- type VolumeReadOpts
- type VolumeReadonlyOption
- type VolumeReadonlyOpts
- type VolumeRetypeOption
- type VolumeRetypeOpts
- type VolumeSearchOption
- type VolumeSearchOpts
- type VolumeSelectionError
- type VolumeSnapshotListOption
- func WithVolumeSnapshotListAllowUnknownParams(value bool) VolumeSnapshotListOption
- func WithVolumeSnapshotListConflictingAttrs(value json.RawMessage) VolumeSnapshotListOption
- func WithVolumeSnapshotListDetailed(value bool) VolumeSnapshotListOption
- func WithVolumeSnapshotListExpression(value string) VolumeSnapshotListOption
- func WithVolumeSnapshotListFilters(value json.RawMessage) VolumeSnapshotListOption
- func WithVolumeSnapshotListHeaders(value map[string]string) VolumeSnapshotListOption
- func WithVolumeSnapshotListLocation(value resource.CloudLocation) VolumeSnapshotListOption
- func WithVolumeSnapshotListMaxItems(value int) VolumeSnapshotListOption
- func WithVolumeSnapshotListMicroversion(value string) VolumeSnapshotListOption
- func WithVolumeSnapshotListOptions(value VolumeSnapshotListOpts) VolumeSnapshotListOption
- func WithVolumeSnapshotListPagination(value bool) VolumeSnapshotListOption
- type VolumeSnapshotListOpts
- type VolumeSnapshotMutationPage
- type VolumeSnapshotReadOption
- type VolumeSnapshotReadOpts
- type VolumeSnapshotSearchOption
- func WithVolumeSnapshotSearchExpression(value string) VolumeSnapshotSearchOption
- func WithVolumeSnapshotSearchFilters(value json.RawMessage) VolumeSnapshotSearchOption
- func WithVolumeSnapshotSearchLocation(value resource.CloudLocation) VolumeSnapshotSearchOption
- func WithVolumeSnapshotSearchOptions(value VolumeSnapshotSearchOpts) VolumeSnapshotSearchOption
- type VolumeSnapshotSearchOpts
- type VolumeSnapshotSelectionError
- type VolumeSnapshotsPage
- type VolumeStatusResetOption
- func WithVolumeStatusResetAttachStatus(value string) VolumeStatusResetOption
- func WithVolumeStatusResetMigrationStatus(value string) VolumeStatusResetOption
- func WithVolumeStatusResetOptions(value VolumeStatusResetOpts) VolumeStatusResetOption
- func WithVolumeStatusResetStatus(value string) VolumeStatusResetOption
- type VolumeStatusResetOpts
- type VolumeTypeAccessActionResult
- type VolumeTypeAccessRequest
- type VolumeTypeReadOption
- type VolumeTypeReadOpts
- type VolumeTypeSearchOption
- func WithVolumeTypeSearchExpression(expression string) VolumeTypeSearchOption
- func WithVolumeTypeSearchFilters(value json.RawMessage) VolumeTypeSearchOption
- func WithVolumeTypeSearchLocation(value resource.CloudLocation) VolumeTypeSearchOption
- func WithVolumeTypeSearchOptions(value VolumeTypeSearchOpts) VolumeTypeSearchOption
- type VolumeTypeSearchOpts
- type VolumeTypeSelectionError
- type VolumeTypesPage
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func GetVolumeAttachDevice ¶
func GetVolumeAttachDevice[V VolumeAttachDeviceInput](volume V, serverID string) (*string, error)
GetVolumeAttachDevice returns a copied device from the first attachment whose current ServerID exactly equals serverID. It performs no lookup or HTTP. A matched empty device is a nonnil pointer; a matched null device and no match both return nil. Missing consumed fields and nil attachments are local errors. Owned nullable fields are authoritative; Body only distinguishes key omission. For manually constructed records with Body == nil, nil pointers mean null. Native models cannot distinguish omitted/null/empty strings: their current strings are used literally, including an empty ServerID or Device.
func GetVolumeAttachDeviceFields ¶
func GetVolumeAttachDeviceFields(volume map[string]json.RawMessage, serverID string) (json.RawMessage, error)
GetVolumeAttachDeviceFields reads canonical attachments from supplied raw fields, without decoding the whole volume model. Only visited server_id and the first matched device are consumed. A returned nonnull JSON value is copied unchanged, including nonstrings: Python's typing.cast performs no conversion. Empty arrays, objects and strings are empty iterables; null attachments fail. All attachments JSON must be valid UTF-8 and syntactically valid, even when a later row's schema would never be visited. Unrelated volume fields are ignored.
func WaitForAvailable ¶
func WaitForAvailable[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, options ...resource.WaitOption) (*T, error)
WaitForAvailable waits for available with Cinder's generic status defaults.
func WaitForDelete ¶
func WaitForDelete[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, options ...resource.WaitOption) error
WaitForDelete observes deletion for up to 120 seconds by default. It does not send a delete request. Caller options apply last.
func WaitForState ¶
func WaitForState[T any](ctx context.Context, collection *resource.Collection[T], ref resource.Ref, status string, options ...resource.WaitOption) (*T, error)
WaitForState polls an SDK collection with Cinder's exact error failure default, a two-second interval and no SDK timeout. Caller options apply last.
Types ¶
type AttachVolumeCreatedResponse ¶
type AttachVolumeCreatedResponse struct {
Attachment *VolumeAttachmentInfo
Body json.RawMessage
Header http.Header
StatusCode int
}
AttachVolumeCreatedResponse preserves an accepted Nova POST. Attachment is populated only after decoding and validating its canonical identities.
type AttachVolumeObservation ¶
type AttachVolumeObservation struct {
resource.Metadata
ID *string `json:"id"`
Name *string `json:"name"`
Status *string `json:"status"`
Attachments []*AttachVolumeRecord `json:"attachments"`
}
AttachVolumeObservation preserves a fresh Cinder volume response. Nullable canonical fields and Metadata.Body retain omission, null and extension JSON.
func (*AttachVolumeObservation) UnmarshalJSON ¶
func (value *AttachVolumeObservation) UnmarshalJSON(data []byte) error
type AttachVolumeObservationResponse ¶
type AttachVolumeObservationResponse struct {
Volume *AttachVolumeObservation
Body json.RawMessage
Header http.Header
StatusCode int
}
AttachVolumeObservationResponse preserves one accepted Cinder GET, including raw evidence when body reading, decoding or a later guard fails.
type AttachVolumeOption ¶
type AttachVolumeOption func(*AttachVolumeOpts) error
AttachVolumeOption configures a concrete policy once before resource lookup.
func WithAttachVolumeDevice ¶
func WithAttachVolumeDevice(value string) AttachVolumeOption
WithAttachVolumeDevice selects a literal device name; empty omits the field.
func WithAttachVolumeOptions ¶
func WithAttachVolumeOptions(value AttachVolumeOpts) AttachVolumeOption
WithAttachVolumeOptions snapshots and replaces the complete policy.
func WithAttachVolumeWait ¶
func WithAttachVolumeWait(value bool) AttachVolumeOption
WithAttachVolumeWait controls the default post-creation wait.
func WithAttachVolumeWaitPolicy ¶
func WithAttachVolumeWaitPolicy(value AttachVolumeWaitOpts) AttachVolumeOption
WithAttachVolumeWaitPolicy snapshots and replaces the wait policy.
type AttachVolumeOpts ¶
type AttachVolumeOpts struct {
Device string
Wait *bool
WaitPolicy AttachVolumeWaitOpts
}
AttachVolumeOpts owns the workflow policy. Wait nil selects the default true; Device empty lets Nova choose the device. Later options replace earlier values.
type AttachVolumeRecord ¶
type AttachVolumeRecord struct {
ID *string `json:"id"`
AttachmentID *string `json:"attachment_id"`
VolumeID *string `json:"volume_id"`
ServerID *string `json:"server_id"`
Device *string `json:"device"`
HostName *string `json:"host_name"`
AttachedAt *string `json:"attached_at"`
Body map[string]json.RawMessage `json:"-"`
}
AttachVolumeRecord describes one Cinder attachment association. Body keeps fields that a particular Cinder deployment adds without a caller adapter.
func (*AttachVolumeRecord) UnmarshalJSON ¶
func (value *AttachVolumeRecord) UnmarshalJSON(data []byte) error
type AttachVolumeRequest ¶
AttachVolumeRequest explicitly selects a server and volume by ID or name. Names resolve once before the workflow constructs its fixed request URLs.
type AttachVolumeResult ¶
type AttachVolumeResult struct {
ServerID, VolumeID string
Checked *AttachVolumeObservationResponse
Created *AttachVolumeCreatedResponse
// Accepted proof only. Rejected status/body/headers remain in native error.
LastAccepted *AttachVolumeObservationResponse
Ready *AttachVolumeObservation
}
AttachVolumeResult retains completed phases on failure. Created.StatusCode establishes an acknowledgement; Ready proves only Cinder's in-use status. LastAccepted is the latest accepted waiting GET, not a rejected HTTP response. Each response, decoded model and Ready owns its body and header independently.
func AttachVolume ¶
func AttachVolume(ctx context.Context, computeClient, blockStorageClient *gophercloud.ServiceClient, input AttachVolumeRequest, options ...AttachVolumeOption) (*AttachVolumeResult, error)
AttachVolume checks a fresh available Cinder volume, creates its Nova attachment, and by default waits for a fresh Cinder in-use observation. It retains accepted phase responses on failure and never rolls back creation. The original providers supply live authentication while request settings and the concrete policy are captured before options or name lookup run.
type AttachVolumeWaitOpts ¶
type AttachVolumeWaitOpts struct {
Timeout, PollInterval *time.Duration
FailureStates []string
ProgressCallback func(int) error
}
AttachVolumeWaitOpts defaults to unlimited waiting, a two-second interval and exact, case-insensitive error failure detection. Timeout applies after creation. A non-nil empty FailureStates disables failure detection. ProgressCallback receives zero after nonterminal polls and may return an error to stop waiting.
type BackupMutationWaitOpts ¶
type BackupMutationWaitOpts = cloudsnapshot.MutationWaitOptions
type BackupWaitTimeoutError ¶
type BackupWaitTimeoutError = cloudbackup.WaitTimeoutError
BackupWaitTimeoutError unwraps context.DeadlineExceeded for SDK loop expiry.
type CinderVolumeAttachOption ¶
type CinderVolumeAttachOption = cinderaction.DirectAttachOption
func WithCinderVolumeAttachHostName ¶
func WithCinderVolumeAttachHostName(value string) CinderVolumeAttachOption
func WithCinderVolumeAttachInstance ¶
func WithCinderVolumeAttachInstance(value string) CinderVolumeAttachOption
func WithCinderVolumeAttachOptions ¶
func WithCinderVolumeAttachOptions(value CinderVolumeAttachOpts) CinderVolumeAttachOption
type CinderVolumeAttachOpts ¶
type CinderVolumeAttachOpts = cinderaction.DirectAttachOptions
func PrepareCinderVolumeAttachOptions ¶
func PrepareCinderVolumeAttachOptions(ctx context.Context, options ...CinderVolumeAttachOption) (CinderVolumeAttachOpts, error)
type CinderVolumeDetachOption ¶
type CinderVolumeDetachOption = cinderaction.DirectDetachOption
func WithCinderVolumeDetachConnector ¶
func WithCinderVolumeDetachConnector(value map[string]json.RawMessage) CinderVolumeDetachOption
func WithCinderVolumeDetachForce ¶
func WithCinderVolumeDetachForce(value bool) CinderVolumeDetachOption
func WithCinderVolumeDetachOptions ¶
func WithCinderVolumeDetachOptions(value CinderVolumeDetachOpts) CinderVolumeDetachOption
type CinderVolumeDetachOpts ¶
type CinderVolumeDetachOpts = cinderaction.DirectDetachOptions
func PrepareCinderVolumeDetachOptions ¶
func PrepareCinderVolumeDetachOptions(ctx context.Context, options ...CinderVolumeDetachOption) (CinderVolumeDetachOpts, error)
type CreateVolumeActionResponse ¶
type CreateVolumeActionResponse struct {
Body json.RawMessage
Header http.Header
StatusCode int
}
CreateVolumeActionResponse retains opaque accepted bootable action evidence.
type CreateVolumeAttributes ¶
type CreateVolumeAttributes struct {
Name, Description, AvailabilityZone, ConsistencyGroupID *string
SnapshotID, SourceVolumeID, SourceReplica, ImageID *string
BackupID, VolumeType, GroupID, VolumeTypeID *string
Multiattach *bool
Metadata map[string]string
SchedulerHints, Fields map[string]json.RawMessage
}
CreateVolumeAttributes provides common creation fields and known Cinder JSON attributes without a request builder. Nil omits a typed field; nonnil maps retain empty objects. Fields accepts pinned Volume attributes or wire names, with wire names taking precedence over aliases. Concrete fields override it.
type CreateVolumeBackupOption ¶
type CreateVolumeBackupOption = cloudsnapshot.BackupCreateOption
func WithCreateVolumeBackupDescription ¶
func WithCreateVolumeBackupDescription(value string) CreateVolumeBackupOption
func WithCreateVolumeBackupForce ¶
func WithCreateVolumeBackupForce(value bool) CreateVolumeBackupOption
func WithCreateVolumeBackupIncremental ¶
func WithCreateVolumeBackupIncremental(value bool) CreateVolumeBackupOption
func WithCreateVolumeBackupLocation ¶
func WithCreateVolumeBackupLocation(value resource.CloudLocation) CreateVolumeBackupOption
func WithCreateVolumeBackupName ¶
func WithCreateVolumeBackupName(value string) CreateVolumeBackupOption
func WithCreateVolumeBackupOptions ¶
func WithCreateVolumeBackupOptions(value CreateVolumeBackupOpts) CreateVolumeBackupOption
func WithCreateVolumeBackupSnapshotID ¶
func WithCreateVolumeBackupSnapshotID(value string) CreateVolumeBackupOption
func WithCreateVolumeBackupWait ¶
func WithCreateVolumeBackupWait(value bool) CreateVolumeBackupOption
func WithCreateVolumeBackupWaitPolicy ¶
func WithCreateVolumeBackupWaitPolicy(value BackupMutationWaitOpts) CreateVolumeBackupOption
type CreateVolumeBackupOpts ¶
type CreateVolumeBackupOpts = cloudsnapshot.BackupCreateOptions
func PrepareCreateVolumeBackupOptions ¶
func PrepareCreateVolumeBackupOptions(ctx context.Context, options ...CreateVolumeBackupOption) (CreateVolumeBackupOpts, error)
type CreateVolumeBackupRequest ¶
type CreateVolumeBackupRequest struct{ VolumeID string }
type CreateVolumeBackupResult ¶
type CreateVolumeBackupResult = cloudbackup.CreateResult
CreateVolumeBackupResult separates request-seeded logical stages and HTTP proof.
func CreateVolumeBackup ¶
func CreateVolumeBackup(ctx context.Context, client *gophercloud.ServiceClient, input CreateVolumeBackupRequest, options ...CreateVolumeBackupOption) (*CreateVolumeBackupResult, error)
CreateVolumeBackup submits the fixed six-field cloud body with literal IDs. It defaults to force=false, incremental=false and wait=true. A nil timeout is unlimited; a cached available resource completes without a fetch.
type CreateVolumeOption ¶
type CreateVolumeOption func(*CreateVolumeOpts) error
func WithCreateVolumeAttributes ¶
func WithCreateVolumeAttributes(value CreateVolumeAttributes) CreateVolumeOption
func WithCreateVolumeBootable ¶
func WithCreateVolumeBootable(value bool) CreateVolumeOption
func WithCreateVolumeDescription ¶
func WithCreateVolumeDescription(value string) CreateVolumeOption
func WithCreateVolumeFields ¶
func WithCreateVolumeFields(value map[string]json.RawMessage) CreateVolumeOption
func WithCreateVolumeMetadata ¶
func WithCreateVolumeMetadata(value map[string]string) CreateVolumeOption
func WithCreateVolumeName ¶
func WithCreateVolumeName(value string) CreateVolumeOption
func WithCreateVolumeOptions ¶
func WithCreateVolumeOptions(value CreateVolumeOpts) CreateVolumeOption
func WithCreateVolumeSchedulerHints ¶
func WithCreateVolumeSchedulerHints(value map[string]json.RawMessage) CreateVolumeOption
func WithCreateVolumeSnapshot ¶
func WithCreateVolumeSnapshot(value string) CreateVolumeOption
func WithCreateVolumeType ¶
func WithCreateVolumeType(value string) CreateVolumeOption
func WithCreateVolumeWait ¶
func WithCreateVolumeWait(value bool) CreateVolumeOption
func WithCreateVolumeWaitPolicy ¶
func WithCreateVolumeWaitPolicy(value CreateVolumeWaitOpts) CreateVolumeOption
type CreateVolumeOpts ¶
type CreateVolumeOpts struct {
Wait, Bootable *bool
WaitPolicy CreateVolumeWaitOpts
Attributes CreateVolumeAttributes
}
CreateVolumeOpts owns creation and completion policy. Wait nil selects true. Any nonnil Bootable forces waiting; only true adds a post-wait bootable action.
func PrepareCreateVolumeOptions ¶
func PrepareCreateVolumeOptions(ctx context.Context, options ...CreateVolumeOption) (CreateVolumeOpts, error)
PrepareCreateVolumeOptions validates and owns all effective defaults locally. Original callbacks run once; the returned policy can be reapplied with the complete-policy factory without rerunning them or selecting any service.
type CreateVolumeRequest ¶
CreateVolumeRequest supplies the required size and an optional explicit image selector. An image name resolves once; an image ID requires no Glance client or lookup. Size is sent unchanged for the Cinder server to validate.
type CreateVolumeResponse ¶
type CreateVolumeResponse struct {
Volume *VolumeInfo
Body json.RawMessage
Header http.Header
StatusCode int
}
CreateVolumeResponse retains an accepted creation or waiting response. Volume is populated after decoding; the creation model also passes canonical identity validation before assignment. A waiting model may expose a rejected identity.
type CreateVolumeResult ¶
type CreateVolumeResult struct {
VolumeID string
Created, LastAccepted *CreateVolumeResponse
Ready *VolumeInfo
BootableSet *CreateVolumeActionResponse
}
CreateVolumeResult retains completed phases alongside subsequent errors. Ready is a fresh available observation; BootableSet acknowledges an action without rewriting Ready or certifying a later observed bootable value.
func CreateVolume ¶
func CreateVolume(ctx context.Context, blockStorageClient, imageClient *gophercloud.ServiceClient, input CreateVolumeRequest, options ...CreateVolumeOption) (*CreateVolumeResult, error)
CreateVolume creates a Cinder volume and by default waits for a fresh available observation. A nonnil Bootable option forces waiting; only true sends a bootable action after readiness. Accepted responses remain available on later failures, and the workflow performs no compensating mutation. Every provided service source is captured before external options run.
type CreateVolumeSnapshotAttributes ¶
type CreateVolumeSnapshotAttributes = cloudsnapshot.CreateAttributes
type CreateVolumeSnapshotOption ¶
type CreateVolumeSnapshotOption = cloudsnapshot.CreateOption
func WithCreateVolumeSnapshotAttributes ¶
func WithCreateVolumeSnapshotAttributes(value CreateVolumeSnapshotAttributes) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotDescription ¶
func WithCreateVolumeSnapshotDescription(value string) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotDisplayDescription ¶
func WithCreateVolumeSnapshotDisplayDescription(value string) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotDisplayName ¶
func WithCreateVolumeSnapshotDisplayName(value string) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotFields ¶
func WithCreateVolumeSnapshotFields(value map[string]json.RawMessage) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotForce ¶
func WithCreateVolumeSnapshotForce(value bool) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotLocation ¶
func WithCreateVolumeSnapshotLocation(value resource.CloudLocation) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotName ¶
func WithCreateVolumeSnapshotName(value string) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotOptions ¶
func WithCreateVolumeSnapshotOptions(value CreateVolumeSnapshotOpts) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotWait ¶
func WithCreateVolumeSnapshotWait(value bool) CreateVolumeSnapshotOption
func WithCreateVolumeSnapshotWaitPolicy ¶
func WithCreateVolumeSnapshotWaitPolicy(value SnapshotMutationWaitOpts) CreateVolumeSnapshotOption
type CreateVolumeSnapshotOpts ¶
type CreateVolumeSnapshotOpts = cloudsnapshot.CreateOptions
func PrepareCreateVolumeSnapshotOptions ¶
func PrepareCreateVolumeSnapshotOptions(ctx context.Context, options ...CreateVolumeSnapshotOption) (CreateVolumeSnapshotOpts, error)
type CreateVolumeSnapshotRequest ¶
type CreateVolumeSnapshotRequest struct{ VolumeID string }
type CreateVolumeSnapshotResult ¶
type CreateVolumeSnapshotResult = cloudsnapshot.CreateResult
CreateVolumeSnapshotResult separates logical merged stages and HTTP proof.
func CreateVolumeSnapshot ¶
func CreateVolumeSnapshot(ctx context.Context, client *gophercloud.ServiceClient, input CreateVolumeSnapshotRequest, options ...CreateVolumeSnapshotOption) (*CreateVolumeSnapshotResult, error)
CreateVolumeSnapshot owns cloud-helper defaults and response merging. It defaults to force=false and wait=true; already-available creation skips GET.
type CreateVolumeWaitOpts ¶
type CreateVolumeWaitOpts = AttachVolumeWaitOpts
CreateVolumeWaitOpts applies an optional timeout after creation acknowledgement.
type DeleteVolumeBackupOption ¶
type DeleteVolumeBackupOption = cloudsnapshot.BackupDeleteOption
func WithDeleteVolumeBackupForce ¶
func WithDeleteVolumeBackupForce(value bool) DeleteVolumeBackupOption
func WithDeleteVolumeBackupLocation ¶
func WithDeleteVolumeBackupLocation(value resource.CloudLocation) DeleteVolumeBackupOption
func WithDeleteVolumeBackupOptions ¶
func WithDeleteVolumeBackupOptions(value DeleteVolumeBackupOpts) DeleteVolumeBackupOption
func WithDeleteVolumeBackupWait ¶
func WithDeleteVolumeBackupWait(value bool) DeleteVolumeBackupOption
func WithDeleteVolumeBackupWaitPolicy ¶
func WithDeleteVolumeBackupWaitPolicy(value BackupMutationWaitOpts) DeleteVolumeBackupOption
type DeleteVolumeBackupOpts ¶
type DeleteVolumeBackupOpts = cloudsnapshot.BackupDeleteOptions
func PrepareDeleteVolumeBackupOptions ¶
func PrepareDeleteVolumeBackupOptions(ctx context.Context, options ...DeleteVolumeBackupOption) (DeleteVolumeBackupOpts, error)
type DeleteVolumeBackupRequest ¶
type DeleteVolumeBackupRequest struct{ NameOrID string }
type DeleteVolumeBackupResult ¶
type DeleteVolumeBackupResult = cloudbackup.DeleteResult
DeleteVolumeBackupResult retains lookup, acknowledgement and optional wait proof.
func DeleteVolumeBackup ¶
func DeleteVolumeBackup(ctx context.Context, client *gophercloud.ServiceClient, input DeleteVolumeBackupRequest, options ...DeleteVolumeBackupOption) (*DeleteVolumeBackupResult, error)
DeleteVolumeBackup resolves exactly one Backup and defaults to wait=false. Force sends the source action's null payload at microversion3.64. Empty input and successful absence return false; rejected mutations remain errors.
type DeleteVolumeObservationResponse ¶
type DeleteVolumeObservationResponse struct {
Volume *VolumeInfo
Body json.RawMessage
Header http.Header
StatusCode int
}
DeleteVolumeObservationResponse retains an initial lookup or polling reply. A clean initial model passes canonical identity validation before assignment; a decoded waiting model may expose a rejected identity. HTTP404 has no model.
type DeleteVolumeOption ¶
type DeleteVolumeOption func(*DeleteVolumeOpts) error
DeleteVolumeOption configures a concrete policy once before initial lookup.
func WithDeleteVolumeForce ¶
func WithDeleteVolumeForce(value bool) DeleteVolumeOption
WithDeleteVolumeForce selects the force protocol for the selected Cinder microversion. It does not introduce cascade deletion or a fallback attempt.
func WithDeleteVolumeOptions ¶
func WithDeleteVolumeOptions(value DeleteVolumeOpts) DeleteVolumeOption
WithDeleteVolumeOptions snapshots and replaces the complete policy.
func WithDeleteVolumeWait ¶
func WithDeleteVolumeWait(value bool) DeleteVolumeOption
WithDeleteVolumeWait controls completion polling; initial lookup still runs.
func WithDeleteVolumeWaitPolicy ¶
func WithDeleteVolumeWaitPolicy(value DeleteVolumeWaitOpts) DeleteVolumeOption
WithDeleteVolumeWaitPolicy snapshots and replaces the wait policy.
type DeleteVolumeOpts ¶
type DeleteVolumeOpts struct {
Wait *bool
Force bool
WaitPolicy DeleteVolumeWaitOpts
}
DeleteVolumeOpts owns the deletion policy. Wait nil selects true; Force false selects ordinary deletion. Later options replace earlier values.
func PrepareDeleteVolumeOptions ¶
func PrepareDeleteVolumeOptions(ctx context.Context, options ...DeleteVolumeOption) (DeleteVolumeOpts, error)
PrepareDeleteVolumeOptions validates options locally, invokes original callbacks once, and returns an independently owned policy with defaults. Connection uses this before selecting its cached Cinder client.
type DeleteVolumeRequest ¶
DeleteVolumeRequest explicitly selects the Cinder volume by ID or name. Names resolve once before a fresh initial member GET confirms existence.
type DeleteVolumeResponse ¶
type DeleteVolumeResponse struct {
Body json.RawMessage
Header http.Header
StatusCode int
}
DeleteVolumeResponse retains opaque actual HTTP evidence. A 404 is only treated as logical absence after reading, Close and source/context guards succeed; an error may accompany this proof without completing deletion.
type DeleteVolumeResult ¶
type DeleteVolumeResult struct {
VolumeID string
Found, Deleted bool
Located, LastAccepted *DeleteVolumeObservationResponse
Deletion, Absent *DeleteVolumeResponse
Ready *VolumeInfo
}
DeleteVolumeResult preserves initial lookup and mutation/wait evidence. Found marks a clean initial200 lookup. Deleted maps the cloud helper's final boolean: initially absent is false; a successful NoWait mutation is true but does not prove fresh absence. Ready is only an actual deleted-status model. Absent independently retains the latest initial/poll GET404, including on a later handling error; a mutation404 remains only in Deletion.
func DeleteVolume ¶
func DeleteVolume(ctx context.Context, blockStorageClient *gophercloud.ServiceClient, input DeleteVolumeRequest, options ...DeleteVolumeOption) (*DeleteVolumeResult, error)
DeleteVolume confirms a volume exists, sends its selected normal or force deletion, and by default waits for a fresh disappearance or deleted status. Initial absence returns Found=false and Deleted=false with no mutation. A clean mutation 404 after lookup is tolerated before any requested completion wait. Cinder is required even without waiting. Accepted phase evidence is retained on later failure, without rollback or an SDK orchestration retry.
type DeleteVolumeSnapshotOption ¶
type DeleteVolumeSnapshotOption = cloudsnapshot.DeleteOption
func WithDeleteVolumeSnapshotLocation ¶
func WithDeleteVolumeSnapshotLocation(value resource.CloudLocation) DeleteVolumeSnapshotOption
func WithDeleteVolumeSnapshotOptions ¶
func WithDeleteVolumeSnapshotOptions(value DeleteVolumeSnapshotOpts) DeleteVolumeSnapshotOption
func WithDeleteVolumeSnapshotWait ¶
func WithDeleteVolumeSnapshotWait(value bool) DeleteVolumeSnapshotOption
func WithDeleteVolumeSnapshotWaitPolicy ¶
func WithDeleteVolumeSnapshotWaitPolicy(value SnapshotMutationWaitOpts) DeleteVolumeSnapshotOption
type DeleteVolumeSnapshotOpts ¶
type DeleteVolumeSnapshotOpts = cloudsnapshot.DeleteOptions
func PrepareDeleteVolumeSnapshotOptions ¶
func PrepareDeleteVolumeSnapshotOptions(ctx context.Context, options ...DeleteVolumeSnapshotOption) (DeleteVolumeSnapshotOpts, error)
type DeleteVolumeSnapshotRequest ¶
type DeleteVolumeSnapshotRequest struct{ NameOrID string }
type DeleteVolumeSnapshotResult ¶
type DeleteVolumeSnapshotResult = cloudsnapshot.DeleteResult
DeleteVolumeSnapshotResult retains lookup, acknowledgement and wait phases.
func DeleteVolumeSnapshot ¶
func DeleteVolumeSnapshot(ctx context.Context, client *gophercloud.ServiceClient, input DeleteVolumeSnapshotRequest, options ...DeleteVolumeSnapshotOption) (*DeleteVolumeSnapshotResult, error)
DeleteVolumeSnapshot resolves one exact snapshot and defaults to wait=false. An empty input is a service-free false result; DELETE404 is a terminal error.
type DeleteVolumeWaitOpts ¶
type DeleteVolumeWaitOpts struct {
Timeout, PollInterval *time.Duration
ProgressCallback func(int) error
}
DeleteVolumeWaitOpts defaults to unlimited waiting and two-second polling. Timeout limits the post-mutation wait; the caller context bounds all phases. ProgressCallback receives zero after nonterminal observations. Deletion has no failure-state policy: error and error_deleting may still become absent.
type DetachVolumeDeleteResponse ¶
type DetachVolumeDeleteResponse struct {
Body json.RawMessage
Header http.Header
StatusCode int
}
DetachVolumeDeleteResponse preserves an accepted Nova DELETE, including read, Close or post-send guard failures. Body is opaque bytes and need not be JSON.
type DetachVolumeOption ¶
type DetachVolumeOption func(*DetachVolumeOpts) error
DetachVolumeOption configures a concrete policy once before resource lookup.
func WithDetachVolumeOptions ¶
func WithDetachVolumeOptions(value DetachVolumeOpts) DetachVolumeOption
WithDetachVolumeOptions snapshots and replaces the complete policy.
func WithDetachVolumeWait ¶
func WithDetachVolumeWait(value bool) DetachVolumeOption
WithDetachVolumeWait controls the default post-removal wait.
func WithDetachVolumeWaitPolicy ¶
func WithDetachVolumeWaitPolicy(value DetachVolumeWaitOpts) DetachVolumeOption
WithDetachVolumeWaitPolicy snapshots and replaces the wait policy.
type DetachVolumeOpts ¶
type DetachVolumeOpts struct {
Wait *bool
WaitPolicy DetachVolumeWaitOpts
}
DetachVolumeOpts owns the removal policy. Wait nil selects the default true. Later options replace earlier values, including the complete wait subtree.
func PrepareDetachVolumeOptions ¶
func PrepareDetachVolumeOptions(ctx context.Context, options ...DetachVolumeOption) (DetachVolumeOpts, error)
PrepareDetachVolumeOptions runs each option once and returns an independent, validated policy with all defaults filled in. Connection uses this before selecting services so an explicit-ID removal without waiting needs only Nova. The returned policy can be passed to WithDetachVolumeOptions without rerunning the original callbacks. Cancellation stops preparation between callbacks.
type DetachVolumeRequest ¶
DetachVolumeRequest explicitly selects a server and volume by ID or name. Volume is the Cinder volume identity, not an attachment identity.
type DetachVolumeResult ¶
type DetachVolumeResult struct {
ServerID, VolumeID string
Deleted *DetachVolumeDeleteResponse
LastAccepted *AttachVolumeObservationResponse
Ready *AttachVolumeObservation
}
DetachVolumeResult retains acknowledged phases when waiting fails. Deleted proves Nova accepted removal; Ready proves Cinder reported available. It does not establish the absence of every attachment. LastAccepted keeps only the latest accepted waiting GET; rejected HTTP evidence remains in its error. Each raw response and decoded observation owns its body and header.
func DetachVolume ¶
func DetachVolume(ctx context.Context, computeClient, blockStorageClient *gophercloud.ServiceClient, input DetachVolumeRequest, options ...DetachVolumeOption) (*DetachVolumeResult, error)
DetachVolume sends a Nova attachment DELETE and by default waits for a fresh Cinder available observation. A missing attachment is an error. It preserves accepted responses on later failures and performs no compensating mutation. A Cinder client may be nil when waiting is disabled and Volume is an ID; every provided client is captured and validated before options run.
type DetachVolumeWaitOpts ¶
type DetachVolumeWaitOpts = AttachVolumeWaitOpts
DetachVolumeWaitOpts shares the attachment wait policy. Timeout applies only after Nova has acknowledged removal; nil or zero means unlimited waiting.
type ExportVolumeBackupRecordRequest ¶
type ExportVolumeBackupRecordRequest struct{ BackupID string }
type ExportVolumeBackupRecordResult ¶
type ExportVolumeBackupRecordResult = cloudbackup.ExportRecordResult
ExportVolumeBackupRecordResult retains an arbitrary owned JSON Value and independently owned physical Exported evidence, including on parse failure.
func ExportVolumeBackupRecord ¶
func ExportVolumeBackupRecord(ctx context.Context, client *gophercloud.ServiceClient, input ExportVolumeBackupRecordRequest) (*ExportVolumeBackupRecordResult, error)
ExportVolumeBackupRecord validates one complete UTF-8 JSON value of any shape. It preserves JSON literals and never retries an accepted response parse error.
type ExportVolumeBackupRequest ¶
type ExportVolumeBackupRequest struct{ BackupID string }
type ExportVolumeBackupResult ¶
type ExportVolumeBackupResult = cloudbackup.ExportResult
ExportVolumeBackupResult retains an admitted response on partial IO failure. A nonnil Exported response may accompany an error; success requires nil error.
func ExportVolumeBackup ¶
func ExportVolumeBackup(ctx context.Context, cinder *gophercloud.ServiceClient, input ExportVolumeBackupRequest) (*ExportVolumeBackupResult, error)
ExportVolumeBackup sends a bodyless export GET for one literal backup ID. It preserves the selected microversion and performs no lookup or wait.
type GetVolumeBackupRequest ¶
type GetVolumeBackupRequest struct{ NameOrID string }
type GetVolumeBackupResult ¶
type GetVolumeBackupResult = cloudbackup.Result
GetVolumeBackupResult retains selected logical values and physical proof.
func GetVolumeBackup ¶
func GetVolumeBackup(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeBackupRequest, options ...VolumeBackupSearchOption) (*GetVolumeBackupResult, error)
GetVolumeBackup uses exact member-first identity lookup for omitted/null filters. Every explicit nonnull filter uses complete search and JSON first selection; normal absence returns a nil logical Value and Backup.
type GetVolumeByIDRequest ¶
type GetVolumeByIDRequest struct{ ID string }
type GetVolumeIDRequest ¶
type GetVolumeIDRequest struct{ NameOrID string }
type GetVolumeIDResult ¶
type GetVolumeIDResult struct {
ID json.RawMessage
Value json.RawMessage
Volume *resource.RawResource
Observed *GetVolumesPage
Pages []*GetVolumesPage
}
GetVolumeIDResult owns the response ID independently of the normalized Value, original Volume and admitted response evidence. ID is nil on absence or error; a found null or missing ID is the literal JSON null. Volume distinguishes that found resource from absence. Observed and Pages preserve actual lookup reads.
func GetVolumeID ¶
func GetVolumeID(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeIDRequest, options ...VolumeReadOption) (*GetVolumeIDResult, error)
GetVolumeID performs ordinary exact name/ID lookup before returning the actual untyped response ID. A supplied ID never bypasses the lookup. Successful absence has a nil ID; a found resource with no ID has JSON null.
type GetVolumeLimitsOption ¶
type GetVolumeLimitsOption = cloudlimits.Option
func WithGetVolumeLimitsLocation ¶
func WithGetVolumeLimitsLocation(value resource.CloudLocation) GetVolumeLimitsOption
func WithGetVolumeLimitsOptions ¶
func WithGetVolumeLimitsOptions(value GetVolumeLimitsOpts) GetVolumeLimitsOption
type GetVolumeLimitsOpts ¶
type GetVolumeLimitsOpts = cloudlimits.Options
func PrepareGetVolumeLimitsOptions ¶
func PrepareGetVolumeLimitsOptions(ctx context.Context, options ...GetVolumeLimitsOption) (GetVolumeLimitsOpts, error)
type GetVolumeLimitsPage ¶
type GetVolumeLimitsPage = cloudlimits.Page
GetVolumeLimitsPage independently owns an admitted physical response.
type GetVolumeLimitsProjectResult ¶
type GetVolumeLimitsProjectResult = cloudlimits.ProjectResult
GetVolumeLimitsProjectResult keeps project resolution and its original proof. SeededID identifies source-compatible member lookup ID fallback, not a field that the server supplied. Project always retains the actual raw row fields.
type GetVolumeLimitsRequest ¶
type GetVolumeLimitsRequest = cloudlimits.Input
GetVolumeLimitsRequest optionally selects another project by exact name/ID. Empty NameOrID reads the authenticated project's unfiltered limits.
type GetVolumeLimitsResult ¶
type GetVolumeLimitsResult = cloudlimits.Result
GetVolumeLimitsResult keeps project resolution, limits observation and the complete nullable logical view separately. RequestedProjectID is a query filter, not confirmed ownership of the limits returned by Cinder.
func GetVolumeLimits ¶
func GetVolumeLimits(ctx context.Context, cinder, identity *gophercloud.ServiceClient, input GetVolumeLimitsRequest, options ...GetVolumeLimitsOption) (*GetVolumeLimitsResult, error)
GetVolumeLimits reads selected Cinder v3 limits. A nonempty project identity is resolved first through Identity v3 even if it resembles an ID. Empty input skips Identity and uses Cinder's unfiltered authenticated-project behavior. Selected microversions are preserved without a project-filter preflight.
type GetVolumeRequest ¶
type GetVolumeRequest struct{ NameOrID string }
type GetVolumeResult ¶
type GetVolumeResult struct {
Value json.RawMessage
Volume *resource.RawResource
Observed *GetVolumesPage
Pages []*GetVolumesPage
}
GetVolumeResult distinguishes absent/null Value from selected false, zero or empty string. Volume is an actual source row only for ordinary selection. Observed preserves an admitted member GET; Pages preserve list responses.
func GetVolume ¶
func GetVolume(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeRequest, options ...VolumeSearchOption) (*GetVolumeResult, error)
GetVolume uses shared GET-first exact identity lookup when filters are omitted or null. Every explicit nonnull filter uses full SearchVolumes and Python's outer truthiness, len, index-0 selection on its arbitrary JSON result.
func GetVolumeByID ¶
func GetVolumeByID(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeByIDRequest, options ...VolumeReadOption) (*GetVolumeResult, error)
GetVolumeByID performs one logical member GET, without name search or list fallback. Rejected statuses including 400/403/404 remain errors. The ID must be one unescaped UTF-8 URL path segment without whitespace or controls.
type GetVolumeSnapshotByIDRequest ¶
type GetVolumeSnapshotByIDRequest struct{ ID string }
type GetVolumeSnapshotRequest ¶
type GetVolumeSnapshotRequest struct{ NameOrID string }
type GetVolumeSnapshotResult ¶
type GetVolumeSnapshotResult = cloudsnapshot.Result
GetVolumeSnapshotResult keeps logical selection and current physical proof separately, without creating server fields for a source-seeded missing ID.
func GetVolumeSnapshot ¶
func GetVolumeSnapshot(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeSnapshotRequest, options ...VolumeSnapshotSearchOption) (*GetVolumeSnapshotResult, error)
GetVolumeSnapshot uses exact member-first identity lookup for omitted/null filters. Every explicit nonnull filter uses complete search and JSON first selection; normal absence returns a nil logical Value and Snapshot.
func GetVolumeSnapshotByID ¶
func GetVolumeSnapshotByID(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeSnapshotByIDRequest, options ...VolumeSnapshotReadOption) (*GetVolumeSnapshotResult, error)
GetVolumeSnapshotByID performs one logical bodyless member GET, retaining rejected statuses as errors without fallback. ID is one unescaped UTF-8 URL path segment. A missing response ID is seeded only in the normalized Value.
type GetVolumeTypeAccessRequest ¶
type GetVolumeTypeAccessRequest struct{ NameOrID string }
type GetVolumeTypeAccessResult ¶
type GetVolumeTypeAccessResult struct {
Resolved *GetVolumeTypeResult
TypeID string
Value json.RawMessage
Accesses []*resource.RawResource
Observed *VolumeTypesPage
}
GetVolumeTypeAccessResult keeps lookup and access response evidence separate. Value preserves any JSON value; a missing volume_type_access field gives []. Accesses is an optional owned projection when every array item is an object. It adds no descriptors, location, project validation or pagination.
func GetVolumeTypeAccess ¶
func GetVolumeTypeAccess(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeTypeAccessRequest, options ...VolumeTypeReadOption) (*GetVolumeTypeAccessResult, error)
GetVolumeTypeAccess resolves the type, then reads its access response once. The source field is untyped JSON; advertised links never trigger pagination.
type GetVolumeTypeRequest ¶
type GetVolumeTypeRequest struct{ NameOrID string }
type GetVolumeTypeResult ¶
type GetVolumeTypeResult struct {
Value json.RawMessage
Type *resource.RawResource
Observed *VolumeTypesPage
Pages []*VolumeTypesPage
}
GetVolumeTypeResult distinguishes absence from selected false, zero and empty string. Type belongs to an actual ordinary source row; proof survives errors.
func GetVolumeType ¶
func GetVolumeType(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumeTypeRequest, options ...VolumeTypeSearchOption) (*GetVolumeTypeResult, error)
GetVolumeType uses exact GET-first lookup with is_public=none when filters are omitted/null. Every nonnull filter uses full SearchVolumeTypes selection.
type GetVolumesOption ¶
type GetVolumesOption func(*GetVolumesOpts) error
func WithGetVolumesOptions ¶
func WithGetVolumesOptions(value GetVolumesOpts) GetVolumesOption
func WithGetVolumesServerFields ¶
func WithGetVolumesServerFields(fields map[string]json.RawMessage) GetVolumesOption
type GetVolumesOpts ¶
type GetVolumesOpts struct{ ServerFields *map[string]json.RawMessage }
GetVolumesOpts can preserve nullable or arbitrary JSON server identity. A nil pointer uses request.ServerID; a pointer to a nil map is a missing id. Only consumed id is validated, after all volume pages have been read.
func PrepareGetVolumesOptions ¶
func PrepareGetVolumesOptions(ctx context.Context, options ...GetVolumesOption) (GetVolumesOpts, error)
PrepareGetVolumesOptions applies original callbacks once without service I/O.
type GetVolumesPage ¶
type GetVolumesPage struct {
Body json.RawMessage
Header http.Header
StatusCode int
}
GetVolumesPage preserves one admitted physical list response independently.
type GetVolumesRequest ¶
type GetVolumesRequest struct{ ServerID string }
GetVolumesRequest supplies a literal server ID for local comparison.
type GetVolumesResult ¶
type GetVolumesResult struct {
Volumes []*resource.RawResource
Pages []*GetVolumesPage
}
GetVolumesResult only populates Volumes after complete list and selection success. Matching occurrences share their source row pointer deliberately; use RawResource.Clone for an independent copy. Pages remain available on error.
func GetVolumes ¶
func GetVolumes(ctx context.Context, cinder *gophercloud.ServiceClient, input GetVolumesRequest, options ...GetVolumesOption) (*GetVolumesResult, error)
GetVolumes reads the complete detailed Cinder volume list, then selects every attachment occurrence matching the supplied server identity. Device values do not affect selection. Duplicate occurrences intentionally share one owned volume pointer. Volumes is assigned only after complete success; actual page evidence remains available on an error. The helper performs no Nova lookup, per-volume GET, refresh, wait or orchestration retry.
type ImportVolumeBackupResult ¶
type ImportVolumeBackupResult = cloudbackup.ImportResult
func ImportVolumeBackup ¶
func ImportVolumeBackup(ctx context.Context, client *gophercloud.ServiceClient, input ImportVolumeBackupRequest) (*ImportVolumeBackupResult, error)
ImportVolumeBackup imports an opaque record and returns an owned Backup view.
type ListVolumeBackupsResult ¶
type ListVolumeBackupsResult = cloudbackup.ListResult
ListVolumeBackupsResult publishes a complete logical list and its raw rows.
func ListVolumeBackups ¶
func ListVolumeBackups(ctx context.Context, cinder *gophercloud.ServiceClient, options ...VolumeBackupListOption) (*ListVolumeBackupsResult, error)
ListVolumeBackups returns the complete owned cloud view. Detailed and pagination default to true; typed controls override raw dictionary controls.
type ListVolumeSnapshotsResult ¶
type ListVolumeSnapshotsResult = cloudsnapshot.ListResult
ListVolumeSnapshotsResult commits an owned complete list after success.
func ListVolumeSnapshots ¶
func ListVolumeSnapshots(ctx context.Context, cinder *gophercloud.ServiceClient, options ...VolumeSnapshotListOption) (*ListVolumeSnapshotsResult, error)
ListVolumeSnapshots returns the complete owned cloud view. Detailed and pagination default to true; typed controls override raw dictionary controls.
type ListVolumeTypesResult ¶
type ListVolumeTypesResult struct {
Value json.RawMessage
Types []*resource.RawResource
Pages []*VolumeTypesPage
}
ListVolumeTypesResult commits a full normalized array and wire rows only after complete success. Actual admitted Pages remain available on errors.
func ListVolumeTypes ¶
func ListVolumeTypes(ctx context.Context, cinder *gophercloud.ServiceClient, options ...VolumeTypeReadOption) (*ListVolumeTypesResult, error)
ListVolumeTypes materializes the complete type list with no visibility query or extra-spec enrichment. Each row is normalized before pagination continues.
type ListVolumesResult ¶
type ListVolumesResult struct {
Value json.RawMessage
Volumes []*resource.RawResource
Pages []*GetVolumesPage
}
ListVolumesResult commits a full owned normalized array and original wire rows only after success. Pages preserve actual admitted responses on errors.
func ListVolumes ¶
func ListVolumes(ctx context.Context, cinder *gophercloud.ServiceClient, options ...VolumeReadOption) (*ListVolumesResult, error)
ListVolumes reads the complete Cinder v3 detailed list and eagerly normalizes every row. No identifier/filter, cache toggle or all-project query is added.
type ResetVolumeBackupStatusRequest ¶
type ResetVolumeBackupStatusRequest struct{ BackupID, Status string }
type ResetVolumeBackupStatusResult ¶
type ResetVolumeBackupStatusResult = cloudbackup.ResetStatusResult
func ResetVolumeBackupStatus ¶
func ResetVolumeBackupStatus(ctx context.Context, client *gophercloud.ServiceClient, input ResetVolumeBackupStatusRequest) (*ResetVolumeBackupStatusResult, error)
type RestoreVolumeBackupOption ¶
type RestoreVolumeBackupOption = cloudsnapshot.BackupRestoreOption
func WithRestoreVolumeBackupLocation ¶
func WithRestoreVolumeBackupLocation(value resource.CloudLocation) RestoreVolumeBackupOption
func WithRestoreVolumeBackupName ¶
func WithRestoreVolumeBackupName(value string) RestoreVolumeBackupOption
func WithRestoreVolumeBackupOptions ¶
func WithRestoreVolumeBackupOptions(value RestoreVolumeBackupOpts) RestoreVolumeBackupOption
func WithRestoreVolumeBackupSeed ¶
func WithRestoreVolumeBackupSeed(value json.RawMessage) RestoreVolumeBackupOption
func WithRestoreVolumeBackupVolumeID ¶
func WithRestoreVolumeBackupVolumeID(value string) RestoreVolumeBackupOption
type RestoreVolumeBackupOpts ¶
type RestoreVolumeBackupOpts = cloudsnapshot.BackupRestoreOptions
func PrepareRestoreVolumeBackupOptions ¶
func PrepareRestoreVolumeBackupOptions(ctx context.Context, options ...RestoreVolumeBackupOption) (RestoreVolumeBackupOpts, error)
type RestoreVolumeBackupRequest ¶
type RestoreVolumeBackupRequest struct{ BackupID string }
type RestoreVolumeBackupResult ¶
type RestoreVolumeBackupResult = cloudbackup.RestoreResult
func RestoreVolumeBackup ¶
func RestoreVolumeBackup(ctx context.Context, client *gophercloud.ServiceClient, input RestoreVolumeBackupRequest, options ...RestoreVolumeBackupOption) (*RestoreVolumeBackupResult, error)
type SearchVolumeBackupsRequest ¶
type SearchVolumeBackupsRequest struct{ NameOrID string }
type SearchVolumeBackupsResult ¶
type SearchVolumeBackupsResult = cloudbackup.SearchResult
SearchVolumeBackupsResult separates expression output from raw rows.
func SearchVolumeBackups ¶
func SearchVolumeBackups(ctx context.Context, cinder *gophercloud.ServiceClient, input SearchVolumeBackupsRequest, options ...VolumeBackupSearchOption) (*SearchVolumeBackupsResult, error)
SearchVolumeBackups completes a queryless detailed list before applying exact/glob identity, recursive mapping or a JSON expression. Projection has no invented association with a raw server resource.
type SearchVolumeSnapshotsRequest ¶
type SearchVolumeSnapshotsRequest struct{ NameOrID string }
type SearchVolumeSnapshotsResult ¶
type SearchVolumeSnapshotsResult = cloudsnapshot.SearchResult
SearchVolumeSnapshotsResult also supports arbitrary JSON expressions.
func SearchVolumeSnapshots ¶
func SearchVolumeSnapshots(ctx context.Context, cinder *gophercloud.ServiceClient, input SearchVolumeSnapshotsRequest, options ...VolumeSnapshotSearchOption) (*SearchVolumeSnapshotsResult, error)
SearchVolumeSnapshots completes a queryless detailed list before applying exact/glob identity, recursive mapping or a JSON expression. Projection has no invented association with a raw server resource.
type SearchVolumeTypesRequest ¶
type SearchVolumeTypesRequest struct{ NameOrID string }
type SearchVolumeTypesResult ¶
type SearchVolumeTypesResult struct {
Value json.RawMessage
Types []*resource.RawResource
Pages []*VolumeTypesPage
}
SearchVolumeTypesResult may contain any JSON expression result. Types retains original rows only for ordinary selection, without invented associations.
func SearchVolumeTypes ¶
func SearchVolumeTypes(ctx context.Context, cinder *gophercloud.ServiceClient, input SearchVolumeTypesRequest, options ...VolumeTypeSearchOption) (*SearchVolumeTypesResult, error)
SearchVolumeTypes fully lists and normalizes types before exact/glob identity selection and lazy mapping or JMESPath filters. It adds no server filter query.
type SearchVolumesRequest ¶
type SearchVolumesRequest struct{ NameOrID string }
type SearchVolumesResult ¶
type SearchVolumesResult struct {
Value json.RawMessage
Volumes []*resource.RawResource
Pages []*GetVolumesPage
}
SearchVolumesResult owns the complete normalized result. Value can be any JSON shape. Volumes carries original wire rows only for ordinary selection; an expression never fabricates a source-row association. Pages survive errors.
func SearchVolumes ¶
func SearchVolumes(ctx context.Context, cinder *gophercloud.ServiceClient, input SearchVolumesRequest, options ...VolumeSearchOption) (*SearchVolumesResult, error)
SearchVolumes materializes and normalizes Cinder's complete detail list, then applies exact/glob identity and lazy dictionary or JMESPath filters. All row conversions precede continuation and local filter evaluation.
type Service ¶
type Service struct {
API *blockstorageapi.Service
Volumes *resource.Collection[Volume]
// contains filtered or unexported fields
}
func New ¶
func New(client *gophercloud.ServiceClient) *Service
func (*Service) RawClient ¶
func (s *Service) RawClient() *gophercloud.ServiceClient
type SetVolumeBootableOption ¶
type SetVolumeBootableOption func(*SetVolumeBootableOpts) error
func WithSetVolumeBootable ¶
func WithSetVolumeBootable(value bool) SetVolumeBootableOption
func WithSetVolumeBootableLocation ¶
func WithSetVolumeBootableLocation(value resource.CloudLocation) SetVolumeBootableOption
func WithSetVolumeBootableOptions ¶
func WithSetVolumeBootableOptions(value SetVolumeBootableOpts) SetVolumeBootableOption
type SetVolumeBootableOpts ¶
type SetVolumeBootableOpts struct {
Bootable *bool
Location *resource.CloudLocation
}
SetVolumeBootableOpts owns the flag and complete location. Nil Bootable selects true; explicit false remains false in the action body.
func PrepareSetVolumeBootableOptions ¶
func PrepareSetVolumeBootableOptions(ctx context.Context, options ...SetVolumeBootableOption) (SetVolumeBootableOpts, error)
PrepareSetVolumeBootableOptions runs originals once without service selection.
type SetVolumeBootableRequest ¶
type SetVolumeBootableRequest struct{ NameOrID string }
type SetVolumeBootableResult ¶
type SetVolumeBootableResult struct {
Resolved *GetVolumeResult
VolumeID string
Applied *VolumeMutationPage
}
SetVolumeBootableResult retains exact lookup and opaque action evidence; the workflow performs no refresh, wait, or completion verification.
func SetVolumeBootable ¶
func SetVolumeBootable(ctx context.Context, cinder *gophercloud.ServiceClient, input SetVolumeBootableRequest, options ...SetVolumeBootableOption) (*SetVolumeBootableResult, error)
SetVolumeBootable resolves once through ordinary lookup and sends one opaque action with default true or explicit false. There is no wait or refresh.
type SnapshotMutationWaitOpts ¶
type SnapshotMutationWaitOpts = cloudsnapshot.MutationWaitOptions
type SnapshotWaitTimeoutError ¶
type SnapshotWaitTimeoutError = cloudsnapshot.WaitTimeoutError
SnapshotWaitTimeoutError unwraps context.DeadlineExceeded for SDK wait expiry.
type UpdateVolumeAttributes ¶
type UpdateVolumeAttributes struct {
Name, Description *string
Metadata map[string]string
Fields map[string]json.RawMessage
}
UpdateVolumeAttributes supplies common fields and every pinned Volume Body attribute/wire alias without a builder. Concrete fields override Fields. Metadata nil omits it; a nonnil empty map clears it. Fields represents null. Unknown attributes are ignored; identity and runtime route controls are rejected.
type UpdateVolumeOption ¶
type UpdateVolumeOption func(*UpdateVolumeOpts) error
func WithUpdateVolumeAttributes ¶
func WithUpdateVolumeAttributes(value UpdateVolumeAttributes) UpdateVolumeOption
func WithUpdateVolumeDescription ¶
func WithUpdateVolumeDescription(value string) UpdateVolumeOption
func WithUpdateVolumeFields ¶
func WithUpdateVolumeFields(value map[string]json.RawMessage) UpdateVolumeOption
func WithUpdateVolumeLocation ¶
func WithUpdateVolumeLocation(value resource.CloudLocation) UpdateVolumeOption
func WithUpdateVolumeMetadata ¶
func WithUpdateVolumeMetadata(value map[string]string) UpdateVolumeOption
func WithUpdateVolumeName ¶
func WithUpdateVolumeName(value string) UpdateVolumeOption
func WithUpdateVolumeOptions ¶
func WithUpdateVolumeOptions(value UpdateVolumeOpts) UpdateVolumeOption
type UpdateVolumeOpts ¶
type UpdateVolumeOpts struct {
Attributes UpdateVolumeAttributes
Location *resource.CloudLocation
}
func PrepareUpdateVolumeOptions ¶
func PrepareUpdateVolumeOptions(ctx context.Context, options ...UpdateVolumeOption) (UpdateVolumeOpts, error)
PrepareUpdateVolumeOptions validates and owns kwargs before lookup/selection.
type UpdateVolumeRequest ¶
type UpdateVolumeRequest struct{ NameOrID string }
type UpdateVolumeResult ¶
type UpdateVolumeResult struct {
Resolved *GetVolumeResult
VolumeID string
Applied *VolumeMutationPage
Volume *resource.RawResource
Value json.RawMessage
}
UpdateVolumeResult retains lookup and mutation evidence independently. Volume/Value commit only after a complete owned merge and descriptor view. Applied is nil on a successful local no-op because no PUT was sent.
func UpdateVolume ¶
func UpdateVolume(ctx context.Context, cinder *gophercloud.ServiceClient, input UpdateVolumeRequest, options ...UpdateVolumeOption) (*UpdateVolumeResult, error)
UpdateVolume resolves once, prepares the complete known raw attribute delta, skips an unchanged commit, and merges a partial server response into owned prior/request state. It performs no refresh, wait, or rollback.
type VolumeActionPage ¶
VolumeActionPage retains an actual admitted HTTP response.
type VolumeActionRequest ¶
type VolumeActionRequest struct{ VolumeID string }
VolumeActionRequest uses one explicit ID; it never performs name lookup.
type VolumeActionResult ¶
type VolumeActionResult = cinderaction.Result
VolumeActionResult keeps discovery separate from the opaque action acknowledgement. Completed means Read/Close/source validation succeeded, without a state poll.
func AbortVolumeDetaching ¶
func AbortVolumeDetaching(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest) (*VolumeActionResult, error)
func AttachCinderVolume ¶
func AttachCinderVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, mountpoint string, options ...CinderVolumeAttachOption) (*VolumeActionResult, error)
AttachCinderVolume sends the direct Cinder action, without Nova or state wait.
func BeginVolumeDetaching ¶
func BeginVolumeDetaching(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest) (*VolumeActionResult, error)
func CompleteVolumeExtend ¶
func CompleteVolumeExtend(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeExtendCompletionOption) (*VolumeActionResult, error)
CompleteVolumeExtend defaults error to false and returns acknowledgement only.
func CompleteVolumeMigration ¶
func CompleteVolumeMigration(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, newVolume string, options ...VolumeMigrationCompletionOption) (*VolumeActionResult, error)
func DetachCinderVolume ¶
func DetachCinderVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, attachmentID string, options ...CinderVolumeDetachOption) (*VolumeActionResult, error)
DetachCinderVolume defaults force to false and reports acknowledgement only.
func ExtendVolume ¶
func ExtendVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, newSize int) (*VolumeActionResult, error)
ExtendVolume sends the supplied machine integer, including zero or negative.
func MigrateVolume ¶
func MigrateVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeMigrationOption) (*VolumeActionResult, error)
func ReserveVolume ¶
func ReserveVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest) (*VolumeActionResult, error)
func ResetVolumeStatus ¶
func ResetVolumeStatus(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeStatusResetOption) (*VolumeActionResult, error)
func RetypeVolume ¶
func RetypeVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, newType string, options ...VolumeRetypeOption) (*VolumeActionResult, error)
RetypeVolume takes the literal new type without a type lookup or enum check.
func RevertVolumeToSnapshot ¶
func RevertVolumeToSnapshot(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, snapshotID string) (*VolumeActionResult, error)
RevertVolumeToSnapshot sends a literal snapshot ID after checking support for microversion 3.40. It does not look up the snapshot or poll volume state.
func SetVolumeBootableStatus ¶
func SetVolumeBootableStatus(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, bootable bool) (*VolumeActionResult, error)
SetVolumeBootableStatus uses an explicit ID and required bool; no name lookup.
func SetVolumeImageMetadata ¶
func SetVolumeImageMetadata(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeImageMetadataOption) (*VolumeActionResult, error)
SetVolumeImageMetadata sends one action, including an empty metadata object. It does not fetch, merge locally, refresh a model or wait for backend state.
func SetVolumeReadonly ¶
func SetVolumeReadonly(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeReadonlyOption) (*VolumeActionResult, error)
SetVolumeReadonly defaults to true; WithVolumeReadonly(false) sends false.
func UnmanageVolume ¶
func UnmanageVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest) (*VolumeActionResult, error)
UnmanageVolume acknowledges the SDK null action. Backend data removal and Cinder state completion are not performed or verified by this helper.
func UnreserveVolume ¶
func UnreserveVolume(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest) (*VolumeActionResult, error)
type VolumeAttachDeviceInput ¶
type VolumeAttachDeviceInput interface {
*AttachVolumeObservation | *VolumeInfo | *volumesv2.Volume | *volumesv3.Volume
}
VolumeAttachDeviceInput accepts existing Cinder representations without a caller adapter. It is a closed constraint for GetVolumeAttachDevice.
type VolumeAttachmentInfo ¶
type VolumeAttachmentInfo struct {
resource.Metadata
ID *string `json:"id"`
Device *string `json:"device"`
VolumeID *string `json:"volumeId"`
ServerID *string `json:"serverId"`
Tag *string `json:"tag"`
AttachmentID *string `json:"attachment_id"`
BDMID *string `json:"bdm_uuid"`
DeleteOnTermination *bool `json:"delete_on_termination"`
}
VolumeAttachmentInfo describes Nova's accepted attachment response. Wire names volumeId/serverId belong to Nova; attachment_id and bdm_uuid are optional.
func (*VolumeAttachmentInfo) UnmarshalJSON ¶
func (value *VolumeAttachmentInfo) UnmarshalJSON(data []byte) error
type VolumeBackupExportResponse ¶
type VolumeBackupExportResponse = cloudbackup.ExportResponse
VolumeBackupExportResponse owns opaque accepted body/header/status evidence. The body is not decoded as a BackupRecord, JSON, UTF-8, or base64 data.
type VolumeBackupListOption ¶
type VolumeBackupListOption = cloudsnapshot.ListOption
func WithVolumeBackupListAllowUnknownParams ¶
func WithVolumeBackupListAllowUnknownParams(value bool) VolumeBackupListOption
func WithVolumeBackupListConflictingAttrs ¶
func WithVolumeBackupListConflictingAttrs(value json.RawMessage) VolumeBackupListOption
func WithVolumeBackupListDetailed ¶
func WithVolumeBackupListDetailed(value bool) VolumeBackupListOption
func WithVolumeBackupListExpression ¶
func WithVolumeBackupListExpression(value string) VolumeBackupListOption
func WithVolumeBackupListFilters ¶
func WithVolumeBackupListFilters(value json.RawMessage) VolumeBackupListOption
func WithVolumeBackupListHeaders ¶
func WithVolumeBackupListHeaders(value map[string]string) VolumeBackupListOption
func WithVolumeBackupListLocation ¶
func WithVolumeBackupListLocation(value resource.CloudLocation) VolumeBackupListOption
func WithVolumeBackupListMaxItems ¶
func WithVolumeBackupListMaxItems(value int) VolumeBackupListOption
func WithVolumeBackupListMicroversion ¶
func WithVolumeBackupListMicroversion(value string) VolumeBackupListOption
func WithVolumeBackupListOptions ¶
func WithVolumeBackupListOptions(value VolumeBackupListOpts) VolumeBackupListOption
func WithVolumeBackupListPagination ¶
func WithVolumeBackupListPagination(value bool) VolumeBackupListOption
type VolumeBackupListOpts ¶
type VolumeBackupListOpts = cloudsnapshot.ListOptions
VolumeBackupListOpts owns backup list policy; omission retains source defaults.
func PrepareVolumeBackupListOptions ¶
func PrepareVolumeBackupListOptions(ctx context.Context, options ...VolumeBackupListOption) (VolumeBackupListOpts, error)
PrepareVolumeBackupListOptions captures original callbacks once without service I/O.
type VolumeBackupMutationPage ¶
type VolumeBackupMutationPage = cloudbackup.MutationPage
VolumeBackupMutationPage owns actual mutation or polling body/header/status.
type VolumeBackupSearchOption ¶
type VolumeBackupSearchOption = cloudsnapshot.SearchOption
func WithVolumeBackupSearchExpression ¶
func WithVolumeBackupSearchExpression(value string) VolumeBackupSearchOption
func WithVolumeBackupSearchFilters ¶
func WithVolumeBackupSearchFilters(value json.RawMessage) VolumeBackupSearchOption
func WithVolumeBackupSearchLocation ¶
func WithVolumeBackupSearchLocation(value resource.CloudLocation) VolumeBackupSearchOption
func WithVolumeBackupSearchOptions ¶
func WithVolumeBackupSearchOptions(value VolumeBackupSearchOpts) VolumeBackupSearchOption
type VolumeBackupSearchOpts ¶
type VolumeBackupSearchOpts = cloudsnapshot.SearchOptions
VolumeBackupSearchOpts owns backup search policy; omission retains source defaults.
func PrepareVolumeBackupSearchOptions ¶
func PrepareVolumeBackupSearchOptions(ctx context.Context, options ...VolumeBackupSearchOption) (VolumeBackupSearchOpts, error)
PrepareVolumeBackupSearchOptions captures original callbacks once without service I/O.
type VolumeBackupSelectionError ¶
type VolumeBackupSelectionError = cloudbackup.SelectionError
type VolumeBackupsPage ¶
type VolumeBackupsPage = cloudbackup.Page
VolumeBackupsPage owns an actual admitted backup response.
type VolumeExistsRequest ¶
type VolumeExistsRequest struct{ NameOrID string }
type VolumeExistsResult ¶
type VolumeExistsResult struct {
Exists *bool
Value json.RawMessage
Volume *resource.RawResource
Observed *GetVolumesPage
Pages []*GetVolumesPage
}
VolumeExistsResult distinguishes a completed true/false lookup from failure. Exists is nil on an error. Value/Volume describe an actual found resource; Observed and Pages preserve the member/list responses used by the lookup.
func VolumeExists ¶
func VolumeExists(ctx context.Context, cinder *gophercloud.ServiceClient, input VolumeExistsRequest, options ...VolumeReadOption) (*VolumeExistsResult, error)
VolumeExists uses ordinary exact identity lookup. False means successful absence; ambiguity, transport, schema and cancellation errors keep Exists nil. A nonnil resource is present even when its original body is an empty object.
type VolumeExtendCompletionOption ¶
type VolumeExtendCompletionOption = cinderaction.ExtendCompletionOption
func WithVolumeExtendCompletionError ¶
func WithVolumeExtendCompletionError(value bool) VolumeExtendCompletionOption
func WithVolumeExtendCompletionOptions ¶
func WithVolumeExtendCompletionOptions(value VolumeExtendCompletionOpts) VolumeExtendCompletionOption
type VolumeExtendCompletionOpts ¶
type VolumeExtendCompletionOpts = cinderaction.ExtendCompletionOptions
func PrepareVolumeExtendCompletionOptions ¶
func PrepareVolumeExtendCompletionOptions(ctx context.Context, options ...VolumeExtendCompletionOption) (VolumeExtendCompletionOpts, error)
type VolumeImageMetadataDeleteOption ¶
type VolumeImageMetadataDeleteOption = cinderaction.ImageMetadataDeleteOption
func WithVolumeImageMetadataDeleteAll ¶
func WithVolumeImageMetadataDeleteAll() VolumeImageMetadataDeleteOption
WithVolumeImageMetadataDeleteAll restores the default all-keys intent.
func WithVolumeImageMetadataDeleteKeys ¶
func WithVolumeImageMetadataDeleteKeys(keys ...string) VolumeImageMetadataDeleteOption
WithVolumeImageMetadataDeleteKeys preserves order and duplicates. No keys selects an explicit no-op, including when expanded from a nil slice.
func WithVolumeImageMetadataDeleteOptions ¶
func WithVolumeImageMetadataDeleteOptions(value VolumeImageMetadataDeleteOpts) VolumeImageMetadataDeleteOption
type VolumeImageMetadataDeleteOpts ¶
type VolumeImageMetadataDeleteOpts = cinderaction.ImageMetadataDeleteOptions
func PrepareVolumeImageMetadataDeleteOptions ¶
func PrepareVolumeImageMetadataDeleteOptions(ctx context.Context, options ...VolumeImageMetadataDeleteOption) (VolumeImageMetadataDeleteOpts, error)
type VolumeImageMetadataDeleteResult ¶
type VolumeImageMetadataDeleteResult = cinderaction.ImageMetadataDeleteResult
func DeleteVolumeImageMetadata ¶
func DeleteVolumeImageMetadata(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, options ...VolumeImageMetadataDeleteOption) (*VolumeImageMetadataDeleteResult, error)
DeleteVolumeImageMetadata defaults to reading the current image metadata and deleting its sorted keys. Explicit keys preserve order and duplicates. The operation is a snapshot, stops on first failure and does not roll back.
type VolumeImageMetadataDeletion ¶
type VolumeImageMetadataDeletion = cinderaction.ImageMetadataDeletion
type VolumeImageMetadataOption ¶
type VolumeImageMetadataOption = cinderaction.ImageMetadataOption
func WithVolumeImageMetadata ¶
func WithVolumeImageMetadata(value map[string]string) VolumeImageMetadataOption
WithVolumeImageMetadata replaces the metadata object with string values.
func WithVolumeImageMetadataOptions ¶
func WithVolumeImageMetadataOptions(value VolumeImageMetadataOpts) VolumeImageMetadataOption
WithVolumeImageMetadataOptions replaces the entire owned policy.
func WithVolumeImageMetadataRaw ¶
func WithVolumeImageMetadataRaw(value map[string]json.RawMessage) VolumeImageMetadataOption
WithVolumeImageMetadataRaw replaces the object with owned JSON values.
func WithVolumeImageMetadataValue ¶
func WithVolumeImageMetadataValue(key, value string) VolumeImageMetadataOption
WithVolumeImageMetadataValue adds or replaces one string value.
type VolumeImageMetadataOpts ¶
type VolumeImageMetadataOpts = cinderaction.ImageMetadataOptions
func PrepareVolumeImageMetadataOptions ¶
func PrepareVolumeImageMetadataOptions(ctx context.Context, options ...VolumeImageMetadataOption) (VolumeImageMetadataOpts, error)
type VolumeImageUploadOption ¶
type VolumeImageUploadOption = cinderaction.ImageUploadOption
func WithVolumeImageUploadContainerFormat ¶
func WithVolumeImageUploadContainerFormat(value string) VolumeImageUploadOption
func WithVolumeImageUploadDiskFormat ¶
func WithVolumeImageUploadDiskFormat(value string) VolumeImageUploadOption
func WithVolumeImageUploadForce ¶
func WithVolumeImageUploadForce(value bool) VolumeImageUploadOption
func WithVolumeImageUploadOptions ¶
func WithVolumeImageUploadOptions(value VolumeImageUploadOpts) VolumeImageUploadOption
func WithVolumeImageUploadProtected ¶
func WithVolumeImageUploadProtected(value bool) VolumeImageUploadOption
func WithVolumeImageUploadVisibility ¶
func WithVolumeImageUploadVisibility(value string) VolumeImageUploadOption
type VolumeImageUploadOpts ¶
type VolumeImageUploadOpts = cinderaction.ImageUploadOptions
func PrepareVolumeImageUploadOptions ¶
func PrepareVolumeImageUploadOptions(ctx context.Context, options ...VolumeImageUploadOption) (VolumeImageUploadOpts, error)
type VolumeImageUploadResult ¶
type VolumeImageUploadResult = cinderaction.ImageUploadResult
func UploadVolumeToImage ¶
func UploadVolumeToImage(ctx context.Context, client *gophercloud.ServiceClient, input VolumeActionRequest, imageName string, options ...VolumeImageUploadOption) (*VolumeImageUploadResult, error)
UploadVolumeToImage asks Cinder to export a volume to Glance. Force defaults false; formats are omitted by default. Visibility or Protected presence, including empty/false, requires advertised microversion 3.1 support. The returned Upload JSON can have any shape and does not prove image availability.
type VolumeInfo ¶
type VolumeInfo struct {
resource.Metadata
ID *string `json:"id"`
Name *string `json:"name"`
Status *string `json:"status"`
Description *string `json:"description"`
AvailabilityZone *string `json:"availability_zone"`
VolumeType *string `json:"volume_type"`
VolumeTypeID *string `json:"volume_type_id"`
SnapshotID *string `json:"snapshot_id"`
SourceVolumeID *string `json:"source_volid"`
BackupID *string `json:"backup_id"`
ImageID *string `json:"imageRef"`
GroupID *string `json:"group_id"`
ConsistencyGroupID *string `json:"consistencygroup_id"`
Size *int `json:"size"`
IsBootable *bool `json:"bootable"`
IsEncrypted *bool `json:"encrypted"`
Multiattach *bool `json:"multiattach"`
ConsumesQuota *bool `json:"consumes_quota"`
MetadataFields map[string]json.RawMessage `json:"metadata"`
Attachments []*AttachVolumeRecord `json:"attachments"`
}
VolumeInfo preserves an SDK-owned Cinder volume representation. Nullable canonical fields are distinct from raw response fields in Metadata.Body; metadata values and unknown extensions retain their original JSON precision.
func (*VolumeInfo) UnmarshalJSON ¶
func (value *VolumeInfo) UnmarshalJSON(data []byte) error
UnmarshalJSON reads only exact canonical keys and commits a fully decoded temporary value. Wrong known types never leave a partially changed model.
type VolumeMigrationCompletionOption ¶
type VolumeMigrationCompletionOption = cinderaction.MigrationCompletionOption
func WithVolumeMigrationCompletionError ¶
func WithVolumeMigrationCompletionError(value bool) VolumeMigrationCompletionOption
func WithVolumeMigrationCompletionOptions ¶
func WithVolumeMigrationCompletionOptions(value VolumeMigrationCompletionOpts) VolumeMigrationCompletionOption
type VolumeMigrationCompletionOpts ¶
type VolumeMigrationCompletionOpts = cinderaction.MigrationCompletionOptions
func PrepareVolumeMigrationCompletionOptions ¶
func PrepareVolumeMigrationCompletionOptions(ctx context.Context, options ...VolumeMigrationCompletionOption) (VolumeMigrationCompletionOpts, error)
type VolumeMigrationOption ¶
type VolumeMigrationOption = cinderaction.MigrationOption
func WithVolumeMigrationCluster ¶
func WithVolumeMigrationCluster(value string) VolumeMigrationOption
func WithVolumeMigrationForceHostCopy ¶
func WithVolumeMigrationForceHostCopy(value bool) VolumeMigrationOption
func WithVolumeMigrationHost ¶
func WithVolumeMigrationHost(value string) VolumeMigrationOption
func WithVolumeMigrationLockVolume ¶
func WithVolumeMigrationLockVolume(value bool) VolumeMigrationOption
func WithVolumeMigrationOptions ¶
func WithVolumeMigrationOptions(value VolumeMigrationOpts) VolumeMigrationOption
type VolumeMigrationOpts ¶
type VolumeMigrationOpts = cinderaction.MigrationOptions
func PrepareVolumeMigrationOptions ¶
func PrepareVolumeMigrationOptions(ctx context.Context, options ...VolumeMigrationOption) (VolumeMigrationOpts, error)
type VolumeMutationPage ¶
type VolumeMutationPage struct {
Body json.RawMessage
Header http.Header
StatusCode int
}
VolumeMutationPage owns one actual admitted mutation response. It is an acknowledgement, without a changed/completed flag or inferred cloud effect.
type VolumeReadOption ¶
type VolumeReadOption func(*VolumeReadOpts) error
func WithVolumeReadLocation ¶
func WithVolumeReadLocation(value resource.CloudLocation) VolumeReadOption
func WithVolumeReadOptions ¶
func WithVolumeReadOptions(value VolumeReadOpts) VolumeReadOption
type VolumeReadOpts ¶
type VolumeReadOpts struct{ Location *resource.CloudLocation }
VolumeReadOpts supplies an owned complete location override to ordinary volume reads. Omission uses recorded provider scope without extra auth I/O.
func PrepareVolumeReadOptions ¶
func PrepareVolumeReadOptions(ctx context.Context, options ...VolumeReadOption) (VolumeReadOpts, error)
PrepareVolumeReadOptions executes original callbacks once without selecting a service. Each retained value and original callback slice is copied.
type VolumeReadonlyOption ¶
type VolumeReadonlyOption = cinderaction.ReadonlyOption
func WithVolumeReadonly ¶
func WithVolumeReadonly(value bool) VolumeReadonlyOption
func WithVolumeReadonlyOptions ¶
func WithVolumeReadonlyOptions(value VolumeReadonlyOpts) VolumeReadonlyOption
WithVolumeReadonlyOptions replaces the entire policy with an owned copy.
type VolumeReadonlyOpts ¶
type VolumeReadonlyOpts = cinderaction.ReadonlyOptions
VolumeReadonlyOpts distinguishes omitted true from explicit false.
func PrepareVolumeReadonlyOptions ¶
func PrepareVolumeReadonlyOptions(ctx context.Context, options ...VolumeReadonlyOption) (VolumeReadonlyOpts, error)
PrepareVolumeReadonlyOptions executes original options without HTTP or service selection.
type VolumeRetypeOption ¶
type VolumeRetypeOption = cinderaction.RetypeOption
func WithVolumeRetypeMigrationPolicy ¶
func WithVolumeRetypeMigrationPolicy(value string) VolumeRetypeOption
func WithVolumeRetypeOptions ¶
func WithVolumeRetypeOptions(value VolumeRetypeOpts) VolumeRetypeOption
type VolumeRetypeOpts ¶
type VolumeRetypeOpts = cinderaction.RetypeOptions
func PrepareVolumeRetypeOptions ¶
func PrepareVolumeRetypeOptions(ctx context.Context, options ...VolumeRetypeOption) (VolumeRetypeOpts, error)
type VolumeSearchOption ¶
type VolumeSearchOption func(*VolumeSearchOpts) error
func WithVolumeSearchExpression ¶
func WithVolumeSearchExpression(expression string) VolumeSearchOption
WithVolumeSearchExpression encodes the expression as a JSON string.
func WithVolumeSearchFilters ¶
func WithVolumeSearchFilters(value json.RawMessage) VolumeSearchOption
WithVolumeSearchFilters accepts a raw dictionary or JSON string expression. Explicit null retains unfiltered GetVolume dispatch. Other nonnull falsey values, including {}, select its filtered full-list branch.
func WithVolumeSearchLocation ¶
func WithVolumeSearchLocation(value resource.CloudLocation) VolumeSearchOption
func WithVolumeSearchOptions ¶
func WithVolumeSearchOptions(value VolumeSearchOpts) VolumeSearchOption
type VolumeSearchOpts ¶
type VolumeSearchOpts struct {
Filters *json.RawMessage
Location *resource.CloudLocation
}
VolumeSearchOpts retains omitted filters independently from every explicit JSON value. Filters are consumed only after full list and identifier search. Location replaces the default recorded provider scope with owned cloud facts.
func PrepareVolumeSearchOptions ¶
func PrepareVolumeSearchOptions(ctx context.Context, options ...VolumeSearchOption) (VolumeSearchOpts, error)
PrepareVolumeSearchOptions applies original callbacks once without service I/O, retaining JSON for lazy consumption by the eventual operation.
type VolumeSelectionError ¶
VolumeSelectionError reports len(value)>1 without inventing resource IDs for an arbitrary expression result. It participates in shared ErrAmbiguous checks.
func (*VolumeSelectionError) Error ¶
func (e *VolumeSelectionError) Error() string
func (*VolumeSelectionError) Unwrap ¶
func (e *VolumeSelectionError) Unwrap() error
type VolumeSnapshotListOption ¶
type VolumeSnapshotListOption = cloudsnapshot.ListOption
func WithVolumeSnapshotListAllowUnknownParams ¶
func WithVolumeSnapshotListAllowUnknownParams(value bool) VolumeSnapshotListOption
func WithVolumeSnapshotListConflictingAttrs ¶
func WithVolumeSnapshotListConflictingAttrs(value json.RawMessage) VolumeSnapshotListOption
func WithVolumeSnapshotListDetailed ¶
func WithVolumeSnapshotListDetailed(value bool) VolumeSnapshotListOption
func WithVolumeSnapshotListExpression ¶
func WithVolumeSnapshotListExpression(value string) VolumeSnapshotListOption
func WithVolumeSnapshotListFilters ¶
func WithVolumeSnapshotListFilters(value json.RawMessage) VolumeSnapshotListOption
func WithVolumeSnapshotListHeaders ¶
func WithVolumeSnapshotListHeaders(value map[string]string) VolumeSnapshotListOption
func WithVolumeSnapshotListLocation ¶
func WithVolumeSnapshotListLocation(value resource.CloudLocation) VolumeSnapshotListOption
func WithVolumeSnapshotListMaxItems ¶
func WithVolumeSnapshotListMaxItems(value int) VolumeSnapshotListOption
func WithVolumeSnapshotListMicroversion ¶
func WithVolumeSnapshotListMicroversion(value string) VolumeSnapshotListOption
func WithVolumeSnapshotListOptions ¶
func WithVolumeSnapshotListOptions(value VolumeSnapshotListOpts) VolumeSnapshotListOption
func WithVolumeSnapshotListPagination ¶
func WithVolumeSnapshotListPagination(value bool) VolumeSnapshotListOption
type VolumeSnapshotListOpts ¶
type VolumeSnapshotListOpts = cloudsnapshot.ListOptions
VolumeSnapshotListOpts owns snapshot list policy; omission retains source defaults.
func PrepareVolumeSnapshotListOptions ¶
func PrepareVolumeSnapshotListOptions(ctx context.Context, options ...VolumeSnapshotListOption) (VolumeSnapshotListOpts, error)
PrepareVolumeSnapshotListOptions captures original callbacks once without service I/O.
type VolumeSnapshotMutationPage ¶
type VolumeSnapshotMutationPage = cloudsnapshot.MutationPage
VolumeSnapshotMutationPage owns an actual mutation or polling response.
type VolumeSnapshotReadOption ¶
type VolumeSnapshotReadOption = cloudsnapshot.ReadOption
func WithVolumeSnapshotReadLocation ¶
func WithVolumeSnapshotReadLocation(value resource.CloudLocation) VolumeSnapshotReadOption
func WithVolumeSnapshotReadOptions ¶
func WithVolumeSnapshotReadOptions(value VolumeSnapshotReadOpts) VolumeSnapshotReadOption
type VolumeSnapshotReadOpts ¶
type VolumeSnapshotReadOpts = cloudsnapshot.ReadOptions
VolumeSnapshotReadOpts owns snapshot read policy; omission retains source defaults.
func PrepareVolumeSnapshotReadOptions ¶
func PrepareVolumeSnapshotReadOptions(ctx context.Context, options ...VolumeSnapshotReadOption) (VolumeSnapshotReadOpts, error)
PrepareVolumeSnapshotReadOptions captures original callbacks once without service I/O.
type VolumeSnapshotSearchOption ¶
type VolumeSnapshotSearchOption = cloudsnapshot.SearchOption
func WithVolumeSnapshotSearchExpression ¶
func WithVolumeSnapshotSearchExpression(value string) VolumeSnapshotSearchOption
func WithVolumeSnapshotSearchFilters ¶
func WithVolumeSnapshotSearchFilters(value json.RawMessage) VolumeSnapshotSearchOption
func WithVolumeSnapshotSearchLocation ¶
func WithVolumeSnapshotSearchLocation(value resource.CloudLocation) VolumeSnapshotSearchOption
func WithVolumeSnapshotSearchOptions ¶
func WithVolumeSnapshotSearchOptions(value VolumeSnapshotSearchOpts) VolumeSnapshotSearchOption
type VolumeSnapshotSearchOpts ¶
type VolumeSnapshotSearchOpts = cloudsnapshot.SearchOptions
VolumeSnapshotSearchOpts owns snapshot search policy; omission retains source defaults.
func PrepareVolumeSnapshotSearchOptions ¶
func PrepareVolumeSnapshotSearchOptions(ctx context.Context, options ...VolumeSnapshotSearchOption) (VolumeSnapshotSearchOpts, error)
PrepareVolumeSnapshotSearchOptions captures original callbacks once without service I/O.
type VolumeSnapshotSelectionError ¶
type VolumeSnapshotSelectionError = cloudsnapshot.SelectionError
type VolumeSnapshotsPage ¶
type VolumeSnapshotsPage = cloudsnapshot.Page
VolumeSnapshotsPage keeps the actual admitted HTTP response independently.
type VolumeStatusResetOption ¶
type VolumeStatusResetOption = cinderaction.StatusResetOption
func WithVolumeStatusResetAttachStatus ¶
func WithVolumeStatusResetAttachStatus(value string) VolumeStatusResetOption
func WithVolumeStatusResetMigrationStatus ¶
func WithVolumeStatusResetMigrationStatus(value string) VolumeStatusResetOption
func WithVolumeStatusResetOptions ¶
func WithVolumeStatusResetOptions(value VolumeStatusResetOpts) VolumeStatusResetOption
func WithVolumeStatusResetStatus ¶
func WithVolumeStatusResetStatus(value string) VolumeStatusResetOption
type VolumeStatusResetOpts ¶
type VolumeStatusResetOpts = cinderaction.StatusResetOptions
func PrepareVolumeStatusResetOptions ¶
func PrepareVolumeStatusResetOptions(ctx context.Context, options ...VolumeStatusResetOption) (VolumeStatusResetOpts, error)
type VolumeTypeAccessActionResult ¶
type VolumeTypeAccessActionResult struct {
Resolved *GetVolumeTypeResult
TypeID, ProjectID string
Applied *VolumeTypesPage
}
VolumeTypeAccessActionResult exposes an actual accepted acknowledgement. Applied may survive an error reading or closing the response. It establishes neither a membership change nor completion of the server's operation.
func AddVolumeTypeAccess ¶
func AddVolumeTypeAccess(ctx context.Context, cinder *gophercloud.ServiceClient, input VolumeTypeAccessRequest, options ...VolumeTypeReadOption) (*VolumeTypeAccessActionResult, error)
AddVolumeTypeAccess resolves the type and posts its literal project payload. Applied records the response, without claiming a permission change.
func RemoveVolumeTypeAccess ¶
func RemoveVolumeTypeAccess(ctx context.Context, cinder *gophercloud.ServiceClient, input VolumeTypeAccessRequest, options ...VolumeTypeReadOption) (*VolumeTypeAccessActionResult, error)
RemoveVolumeTypeAccess resolves the type and posts its literal project payload. It performs no implicit verification, refresh or rollback.
type VolumeTypeAccessRequest ¶
type VolumeTypeAccessRequest struct{ NameOrID, ProjectID string }
VolumeTypeAccessRequest sends ProjectID literally, including an empty or nonexistent project ID. The workflow resolves only the volume type.
type VolumeTypeReadOption ¶
type VolumeTypeReadOption func(*VolumeTypeReadOpts) error
func WithVolumeTypeReadLocation ¶
func WithVolumeTypeReadLocation(value resource.CloudLocation) VolumeTypeReadOption
func WithVolumeTypeReadOptions ¶
func WithVolumeTypeReadOptions(value VolumeTypeReadOpts) VolumeTypeReadOption
type VolumeTypeReadOpts ¶
type VolumeTypeReadOpts struct{ Location *resource.CloudLocation }
VolumeTypeReadOpts supplies an owned complete location override to ordinary volume type reads. Omission uses recorded provider scope without extra auth I/O.
func PrepareVolumeTypeReadOptions ¶
func PrepareVolumeTypeReadOptions(ctx context.Context, options ...VolumeTypeReadOption) (VolumeTypeReadOpts, error)
PrepareVolumeTypeReadOptions executes original callbacks once without selecting a service. Each retained value and original callback slice is copied.
type VolumeTypeSearchOption ¶
type VolumeTypeSearchOption func(*VolumeTypeSearchOpts) error
func WithVolumeTypeSearchExpression ¶
func WithVolumeTypeSearchExpression(expression string) VolumeTypeSearchOption
WithVolumeTypeSearchExpression encodes the expression as a JSON string.
func WithVolumeTypeSearchFilters ¶
func WithVolumeTypeSearchFilters(value json.RawMessage) VolumeTypeSearchOption
WithVolumeTypeSearchFilters accepts a raw dictionary or JSON string expression. Explicit null retains unfiltered GetVolumeType dispatch. Other nonnull falsey values, including {}, select its filtered full-list branch.
func WithVolumeTypeSearchLocation ¶
func WithVolumeTypeSearchLocation(value resource.CloudLocation) VolumeTypeSearchOption
func WithVolumeTypeSearchOptions ¶
func WithVolumeTypeSearchOptions(value VolumeTypeSearchOpts) VolumeTypeSearchOption
type VolumeTypeSearchOpts ¶
type VolumeTypeSearchOpts struct {
Filters *json.RawMessage
Location *resource.CloudLocation
}
VolumeTypeSearchOpts retains omitted filters independently from every explicit JSON value. Filters are consumed only after full list and identifier search. Location replaces the default recorded provider scope with owned cloud facts.
func PrepareVolumeTypeSearchOptions ¶
func PrepareVolumeTypeSearchOptions(ctx context.Context, options ...VolumeTypeSearchOption) (VolumeTypeSearchOpts, error)
PrepareVolumeTypeSearchOptions applies original callbacks once without service I/O, retaining JSON for lazy consumption by the eventual operation.
type VolumeTypeSelectionError ¶
func (*VolumeTypeSelectionError) Error ¶
func (e *VolumeTypeSelectionError) Error() string
func (*VolumeTypeSelectionError) Unwrap ¶
func (e *VolumeTypeSelectionError) Unwrap() error
type VolumeTypesPage ¶
type VolumeTypesPage = GetVolumesPage
VolumeTypesPage owns one admitted physical response independently of rows.
Source Files
¶
- add_volume_type_access.go
- attach_volume.go
- attach_volume_model.go
- attach_volume_options.go
- attach_volume_prepare.go
- attach_volume_results.go
- blockstorage.go
- cinder_read_prepare.go
- cinder_volume_attachment.go
- create_volume.go
- create_volume_backup.go
- create_volume_backup_options.go
- create_volume_fields.go
- create_volume_model.go
- create_volume_options.go
- create_volume_prepare.go
- create_volume_results.go
- create_volume_snapshot.go
- create_volume_snapshot_options.go
- create_volume_wait.go
- delete_volume.go
- delete_volume_backup.go
- delete_volume_backup_options.go
- delete_volume_options.go
- delete_volume_prepare.go
- delete_volume_results.go
- delete_volume_snapshot.go
- delete_volume_snapshot_options.go
- delete_volume_wait.go
- detach_volume.go
- detach_volume_options.go
- detach_volume_prepare.go
- detach_volume_results.go
- doc.go
- export_volume_backup.go
- export_volume_backup_record.go
- get_volume.go
- get_volume_backup.go
- get_volume_by_id.go
- get_volume_id.go
- get_volume_limits.go
- get_volume_limits_options.go
- get_volume_snapshot.go
- get_volume_snapshot_by_id.go
- get_volume_type.go
- get_volume_type_access.go
- get_volumes.go
- get_volumes_options.go
- get_volumes_pages.go
- get_volumes_results.go
- get_volumes_select.go
- import_volume_backup.go
- list_volume_backups.go
- list_volume_snapshots.go
- list_volume_types.go
- list_volumes.go
- remove_volume_type_access.go
- reset_volume_backup_status.go
- restore_volume_backup.go
- restore_volume_backup_options.go
- search_volume_backups.go
- search_volume_snapshots.go
- search_volume_types.go
- search_volumes.go
- set_volume_bootable.go
- set_volume_bootable_options.go
- update_volume.go
- update_volume_model.go
- update_volume_options.go
- volume_attachment_device.go
- volume_attachment_wait.go
- volume_backup_list_options.go
- volume_backup_mutation_results.go
- volume_backup_results.go
- volume_backup_search_options.go
- volume_exists.go
- volume_find.go
- volume_flags.go
- volume_id_results.go
- volume_image_metadata.go
- volume_image_upload.go
- volume_materialize.go
- volume_member.go
- volume_migration.go
- volume_mutations_prepare.go
- volume_mutations_results.go
- volume_mutations_transport.go
- volume_read_options.go
- volume_read_prepare.go
- volume_read_results.go
- volume_resize.go
- volume_revert_unmanage.go
- volume_search_options.go
- volume_search_results.go
- volume_search_view.go
- volume_snapshot_list_options.go
- volume_snapshot_mutation_results.go
- volume_snapshot_read_options.go
- volume_snapshot_results.go
- volume_snapshot_search_options.go
- volume_state_actions.go
- volume_type_access_action.go
- volume_type_access_prepare.go
- volume_type_access_results.go
- volume_type_access_transport.go
- volume_type_find.go
- volume_type_member.go
- volume_type_pages.go
- volume_type_prepare.go
- volume_type_read_options.go
- volume_type_results.go
- volume_type_search_options.go
- volume_type_view.go
- volume_types_next.go
- wait.go
Directories
¶
| Path | Synopsis |
|---|---|
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
Package metadata contains owned Cinder metadata results and header options.
|
Package metadata contains owned Cinder metadata results and header options. |
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
Code generated by sdkgen; DO NOT EDIT.
|
Code generated by sdkgen; DO NOT EDIT. |
|
availabilityzones
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
backups
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
limits
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
quotasets
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
schedulerstats
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
services
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
snapshots
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
transfers
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
volumes
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
Code generated by sdkgen; DO NOT EDIT.
|
Code generated by sdkgen; DO NOT EDIT. |
|
attachments
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
availabilityzones
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
backups
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
capabilities
Package capabilities reads Cinder backend capabilities with owned Resource views.
|
Package capabilities reads Cinder backend capabilities with owned Resource views. |
|
clusters
Package clusters implements the pinned openstacksdk block_storage v3 cluster proxy calls over Cinder clusters, a route Gophercloud v2.15.0 does not bind.
|
Package clusters implements the pinned openstacksdk block_storage v3 cluster proxy calls over Cinder clusters, a route Gophercloud v2.15.0 does not bind. |
|
consistencygroups
Package consistencygroups provides owned records for the legacy Cinder v3 API.
|
Package consistencygroups provides owned records for the legacy Cinder v3 API. |
|
consistencygroupsnapshots
Package consistencygroupsnapshots provides legacy Cinder consistency group-snapshot user operations.
|
Package consistencygroupsnapshots provides legacy Cinder consistency group-snapshot user operations. |
|
defaulttypes
Package defaulttypes implements the pinned openstacksdk block_storage v3 default volume type proxy calls over Cinder default-types, a route Gophercloud v2.15.0 does not bind.
|
Package defaulttypes implements the pinned openstacksdk block_storage v3 default volume type proxy calls over Cinder default-types, a route Gophercloud v2.15.0 does not bind. |
|
groups
Package groups provides owned Cinder v3 generic volume-group records.
|
Package groups provides owned Cinder v3 generic volume-group records. |
|
groupsnapshots
Package groupsnapshots provides Cinder generic group-snapshot user operations.
|
Package groupsnapshots provides Cinder generic group-snapshot user operations. |
|
grouptypes
Package grouptypes implements the pinned openstacksdk block_storage v3 group type proxy calls, including the group_specs sub-API, over Cinder group_types, a route Gophercloud v2.15.0 does not bind.
|
Package grouptypes implements the pinned openstacksdk block_storage v3 group type proxy calls, including the group_specs sub-API, over Cinder group_types, a route Gophercloud v2.15.0 does not bind. |
|
internal/cinderowned
Package cinderowned owns the Cinder v3 record workflow shared by the SDK-owned group type, default type and cluster packages and by the owned service actions.
|
Package cinderowned owns the Cinder v3 record workflow shared by the SDK-owned group type, default type and cluster packages and by the owned service actions. |
|
limits
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
manageablevolumes
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
messages
Package messages provides Cinder user-message lookup, listing and deletion.
|
Package messages provides Cinder user-message lookup, listing and deletion. |
|
qos
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
quotasets
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
resourcefilters
Package resourcefilters owns the Cinder v3 allowed-filter catalogue.
|
Package resourcefilters owns the Cinder v3 allowed-filter catalogue. |
|
schedulerstats
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
services
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
snapshots
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
transfers
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
volumes
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |
|
volumetypes
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT.
|
Code generated by sdkgen from Gophercloud v2.15.0; DO NOT EDIT. |