From c9725f95c292a2ced16d302b461e2b6da0bb3a8e Mon Sep 17 00:00:00 2001 From: scaleway-bot Date: Wed, 20 Nov 2024 14:04:36 +0000 Subject: [PATCH] feat: update generated APIs --- ...ance-snapshot-apply-migration-usage.golden | 6 ++--- ...tance-snapshot-plan-migration-usage.golden | 6 ++++- ...stance-volume-apply-migration-usage.golden | 6 ++--- ...nstance-volume-plan-migration-usage.golden | 6 ++++- docs/commands/instance.md | 24 ++++++++++++------- go.mod | 2 +- go.sum | 4 ++-- ...not-be-rebooted-while-not-delivered.golden | 4 ++-- ...nnot-be-started-while-not-delivered.golden | 4 ++-- ...nnot-be-stopped-while-not-delivered.golden | 4 ++-- .../namespaces/instance/v1/instance_cli.go | 16 ++++++++----- 11 files changed, 51 insertions(+), 31 deletions(-) diff --git a/cmd/scw/testdata/test-all-usage-instance-snapshot-apply-migration-usage.golden b/cmd/scw/testdata/test-all-usage-instance-snapshot-apply-migration-usage.golden index 1502731dc6..02b8f6e942 100644 --- a/cmd/scw/testdata/test-all-usage-instance-snapshot-apply-migration-usage.golden +++ b/cmd/scw/testdata/test-all-usage-instance-snapshot-apply-migration-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -To be used, the call to this endpoint must be preceded by a call to the "Plan a migration" endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. +To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. USAGE: scw instance snapshot apply-migration [arg=value ...] ARGS: - snapshot-id The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint. - validation-key A value to be retrieved from a call to the "Plan a migration" endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. + snapshot-id The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. + validation-key A value to be retrieved from a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | fr-par-3 | nl-ams-1 | nl-ams-2 | nl-ams-3 | pl-waw-1 | pl-waw-2 | pl-waw-3) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-instance-snapshot-plan-migration-usage.golden b/cmd/scw/testdata/test-all-usage-instance-snapshot-plan-migration-usage.golden index 444ead35e1..f9f5fb5e33 100644 --- a/cmd/scw/testdata/test-all-usage-instance-snapshot-plan-migration-usage.golden +++ b/cmd/scw/testdata/test-all-usage-instance-snapshot-plan-migration-usage.golden @@ -1,6 +1,10 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Given a volume or snapshot, returns the migration plan for a call to the "Apply a migration plan" endpoint. This plan will include zero or one volume, and zero or more snapshots, which will need to be migrated together. This endpoint does not perform the actual migration itself, the "Apply a migration plan" endpoint must be used. The validation_key value returned by this endpoint must be provided to the call to the "Apply a migration plan" endpoint to confirm that all resources listed in the plan should be migrated. +Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward. +The endpoint returns the resources that should be migrated together: +- the volume and any snapshots created from the volume, if the call was made to plan a volume migration. +- the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration. +The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated. USAGE: scw instance snapshot plan-migration [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-instance-volume-apply-migration-usage.golden b/cmd/scw/testdata/test-all-usage-instance-volume-apply-migration-usage.golden index d4fb882a91..6360428ee5 100644 --- a/cmd/scw/testdata/test-all-usage-instance-volume-apply-migration-usage.golden +++ b/cmd/scw/testdata/test-all-usage-instance-volume-apply-migration-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -To be used, the call to this endpoint must be preceded by a call to the "Plan a migration" endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. +To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. USAGE: scw instance volume apply-migration [arg=value ...] ARGS: - volume-id The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint. - validation-key A value to be retrieved from a call to the "Plan a migration" endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. + volume-id The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. + validation-key A value to be retrieved from a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | fr-par-3 | nl-ams-1 | nl-ams-2 | nl-ams-3 | pl-waw-1 | pl-waw-2 | pl-waw-3) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-instance-volume-plan-migration-usage.golden b/cmd/scw/testdata/test-all-usage-instance-volume-plan-migration-usage.golden index 5b6cca73ae..f0314178a4 100644 --- a/cmd/scw/testdata/test-all-usage-instance-volume-plan-migration-usage.golden +++ b/cmd/scw/testdata/test-all-usage-instance-volume-plan-migration-usage.golden @@ -1,6 +1,10 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Given a volume or snapshot, returns the migration plan for a call to the "Apply a migration plan" endpoint. This plan will include zero or one volume, and zero or more snapshots, which will need to be migrated together. This endpoint does not perform the actual migration itself, the "Apply a migration plan" endpoint must be used. The validation_key value returned by this endpoint must be provided to the call to the "Apply a migration plan" endpoint to confirm that all resources listed in the plan should be migrated. +Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward. +The endpoint returns the resources that should be migrated together: +- the volume and any snapshots created from the volume, if the call was made to plan a volume migration. +- the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration. +The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated. USAGE: scw instance volume plan-migration [arg=value ...] diff --git a/docs/commands/instance.md b/docs/commands/instance.md index 7b61f4e63c..2697de0b47 100644 --- a/docs/commands/instance.md +++ b/docs/commands/instance.md @@ -2422,7 +2422,7 @@ Volumes can be created from snapshots of their own type. ### Migrate a volume and/or snapshots to SBS (Scaleway Block Storage) -To be used, the call to this endpoint must be preceded by a call to the "Plan a migration" endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. +To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. **Usage:** @@ -2435,8 +2435,8 @@ scw instance snapshot apply-migration [arg=value ...] | Name | | Description | |------|---|-------------| -| snapshot-id | | The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint. | -| validation-key | Required | A value to be retrieved from a call to the "Plan a migration" endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. | +| snapshot-id | | The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. | +| validation-key | Required | A value to be retrieved from a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `fr-par-3`, `nl-ams-1`, `nl-ams-2`, `nl-ams-3`, `pl-waw-1`, `pl-waw-2`, `pl-waw-3` | Zone to target. If none is passed will use default zone from the config | @@ -2637,7 +2637,11 @@ scw instance snapshot list zone=fr-par-1 ### Get a volume or snapshot's migration plan -Given a volume or snapshot, returns the migration plan for a call to the "Apply a migration plan" endpoint. This plan will include zero or one volume, and zero or more snapshots, which will need to be migrated together. This endpoint does not perform the actual migration itself, the "Apply a migration plan" endpoint must be used. The validation_key value returned by this endpoint must be provided to the call to the "Apply a migration plan" endpoint to confirm that all resources listed in the plan should be migrated. +Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward. +The endpoint returns the resources that should be migrated together: +- the volume and any snapshots created from the volume, if the call was made to plan a volume migration. +- the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration. +The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated. **Usage:** @@ -2940,7 +2944,7 @@ UUIDs can be found in `/dev/disk/by-id/`. ### Migrate a volume and/or snapshots to SBS (Scaleway Block Storage) -To be used, the call to this endpoint must be preceded by a call to the "Plan a migration" endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. +To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided. **Usage:** @@ -2953,8 +2957,8 @@ scw instance volume apply-migration [arg=value ...] | Name | | Description | |------|---|-------------| -| volume-id | | The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint. | -| validation-key | Required | A value to be retrieved from a call to the "Plan a migration" endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. | +| volume-id | | The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. | +| validation-key | Required | A value to be retrieved from a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated. | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `fr-par-3`, `nl-ams-1`, `nl-ams-2`, `nl-ams-3`, `pl-waw-1`, `pl-waw-2`, `pl-waw-3` | Zone to target. If none is passed will use default zone from the config | @@ -3116,7 +3120,11 @@ scw instance volume list volume-type=b_ssd name=foobar ### Get a volume or snapshot's migration plan -Given a volume or snapshot, returns the migration plan for a call to the "Apply a migration plan" endpoint. This plan will include zero or one volume, and zero or more snapshots, which will need to be migrated together. This endpoint does not perform the actual migration itself, the "Apply a migration plan" endpoint must be used. The validation_key value returned by this endpoint must be provided to the call to the "Apply a migration plan" endpoint to confirm that all resources listed in the plan should be migrated. +Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward. +The endpoint returns the resources that should be migrated together: +- the volume and any snapshots created from the volume, if the call was made to plan a volume migration. +- the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration. +The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated. **Usage:** diff --git a/go.mod b/go.mod index 3d1a11ce87..a3c779c2a6 100644 --- a/go.mod +++ b/go.mod @@ -26,7 +26,7 @@ require ( github.com/mattn/go-isatty v0.0.20 github.com/moby/buildkit v0.13.2 github.com/opencontainers/go-digest v1.0.0 - github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241118091633-210045c18c91 + github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241119141129-13bda013da82 github.com/skratchdot/open-golang v0.0.0-20200116055534-eef842397966 github.com/spf13/cobra v1.8.1 github.com/spf13/pflag v1.0.5 diff --git a/go.sum b/go.sum index d18c7ff64f..12ee492f5e 100644 --- a/go.sum +++ b/go.sum @@ -466,8 +466,8 @@ github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUz github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06 h1:OkMGxebDjyw0ULyrTYWeN0UNCCkmCWfjPnIA2W6oviI= github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06/go.mod h1:+ePHsJ1keEjQtpvf9HHw0f4ZeJ0TLRsxhunSI2hYJSs= -github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241118091633-210045c18c91 h1:b/m0VHa03JOPC3xbrhUFxvsmB1SDiNa+CJ5y0BUD8SY= -github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241118091633-210045c18c91/go.mod h1:kAoejOVBg1E/aVAR6IwKWEmbLCEg2IXklzPAkxzAaXA= +github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241119141129-13bda013da82 h1:tBZUY8LrNFm9a4l6vUx04PpJfFcS9+3Ofnr5DUJdPCo= +github.com/scaleway/scaleway-sdk-go v1.0.0-beta.30.0.20241119141129-13bda013da82/go.mod h1:kAoejOVBg1E/aVAR6IwKWEmbLCEg2IXklzPAkxzAaXA= github.com/sclevine/spec v1.4.0 h1:z/Q9idDcay5m5irkZ28M7PtQM4aOISzOpj4bUPkDee8= github.com/sclevine/spec v1.4.0/go.mod h1:LvpgJaFyvQzRvc1kaDs0bulYwzC70PbiYjC4QnFHkOM= github.com/secure-systems-lab/go-securesystemslib v0.8.0 h1:mr5An6X45Kb2nddcFlbmfHkLguCE9laoZCUzEEpIZXA= diff --git a/internal/namespaces/baremetal/v1/testdata/test-reboot-server-errors-error-cannot-be-rebooted-while-not-delivered.golden b/internal/namespaces/baremetal/v1/testdata/test-reboot-server-errors-error-cannot-be-rebooted-while-not-delivered.golden index 3398eef8b0..053a4f9a8d 100644 --- a/internal/namespaces/baremetal/v1/testdata/test-reboot-server-errors-error-cannot-be-rebooted-while-not-delivered.golden +++ b/internal/namespaces/baremetal/v1/testdata/test-reboot-server-errors-error-cannot-be-rebooted-while-not-delivered.golden @@ -3,8 +3,8 @@ Server not found πŸŸ₯πŸŸ₯πŸŸ₯ JSON STDERR πŸŸ₯πŸŸ₯πŸŸ₯ { - "message": "server not found", + "message": "Server not found", "error": { - "message": "server not found" + "message": "Server not found" } } diff --git a/internal/namespaces/baremetal/v1/testdata/test-start-server-errors-error-cannot-be-started-while-not-delivered.golden b/internal/namespaces/baremetal/v1/testdata/test-start-server-errors-error-cannot-be-started-while-not-delivered.golden index 6d325ebcac..659ddd56aa 100644 --- a/internal/namespaces/baremetal/v1/testdata/test-start-server-errors-error-cannot-be-started-while-not-delivered.golden +++ b/internal/namespaces/baremetal/v1/testdata/test-start-server-errors-error-cannot-be-started-while-not-delivered.golden @@ -3,8 +3,8 @@ Server is not delivered πŸŸ₯πŸŸ₯πŸŸ₯ JSON STDERR πŸŸ₯πŸŸ₯πŸŸ₯ { - "message": "server is not delivered", + "message": "Server is not delivered", "error": { - "message": "server is not delivered" + "message": "Server is not delivered" } } diff --git a/internal/namespaces/baremetal/v1/testdata/test-stop-server-errors-error-cannot-be-stopped-while-not-delivered.golden b/internal/namespaces/baremetal/v1/testdata/test-stop-server-errors-error-cannot-be-stopped-while-not-delivered.golden index 6d325ebcac..659ddd56aa 100644 --- a/internal/namespaces/baremetal/v1/testdata/test-stop-server-errors-error-cannot-be-stopped-while-not-delivered.golden +++ b/internal/namespaces/baremetal/v1/testdata/test-stop-server-errors-error-cannot-be-stopped-while-not-delivered.golden @@ -3,8 +3,8 @@ Server is not delivered πŸŸ₯πŸŸ₯πŸŸ₯ JSON STDERR πŸŸ₯πŸŸ₯πŸŸ₯ { - "message": "server is not delivered", + "message": "Server is not delivered", "error": { - "message": "server is not delivered" + "message": "Server is not delivered" } } diff --git a/internal/namespaces/instance/v1/instance_cli.go b/internal/namespaces/instance/v1/instance_cli.go index c131ebe457..1e4f66bbf8 100644 --- a/internal/namespaces/instance/v1/instance_cli.go +++ b/internal/namespaces/instance/v1/instance_cli.go @@ -3861,8 +3861,12 @@ func instancePrivateNicDelete() *core.Command { func instanceVolumePlanMigration() *core.Command { return &core.Command{ - Short: `Get a volume or snapshot's migration plan`, - Long: `Given a volume or snapshot, returns the migration plan for a call to the "Apply a migration plan" endpoint. This plan will include zero or one volume, and zero or more snapshots, which will need to be migrated together. This endpoint does not perform the actual migration itself, the "Apply a migration plan" endpoint must be used. The validation_key value returned by this endpoint must be provided to the call to the "Apply a migration plan" endpoint to confirm that all resources listed in the plan should be migrated.`, + Short: `Get a volume or snapshot's migration plan`, + Long: `Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward. +The endpoint returns the resources that should be migrated together: +- the volume and any snapshots created from the volume, if the call was made to plan a volume migration. +- the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration. +The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated.`, Namespace: "instance", Resource: "volume", Verb: "plan-migration", @@ -3899,7 +3903,7 @@ func instanceVolumePlanMigration() *core.Command { func instanceVolumeApplyMigration() *core.Command { return &core.Command{ Short: `Migrate a volume and/or snapshots to SBS (Scaleway Block Storage)`, - Long: `To be used, the call to this endpoint must be preceded by a call to the "Plan a migration" endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided.`, + Long: `To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided.`, Namespace: "instance", Resource: "volume", Verb: "apply-migration", @@ -3908,21 +3912,21 @@ func instanceVolumeApplyMigration() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "volume-id", - Short: `The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint.`, + Short: `The volume to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint.`, Required: false, Deprecated: false, Positional: false, }, { Name: "snapshot-id", - Short: `The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the "Plan a migration" endpoint.`, + Short: `The snapshot to migrate, along with potentially other resources, according to the migration plan generated with a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint.`, Required: false, Deprecated: false, Positional: false, }, { Name: "validation-key", - Short: `A value to be retrieved from a call to the "Plan a migration" endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated.`, + Short: `A value to be retrieved from a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint, to confirm that the volume and/or snapshots specified in said plan should be migrated.`, Required: true, Deprecated: false, Positional: false,