diff --git a/pages/file-storage/api-cli/index.mdx b/pages/file-storage/api-cli/index.mdx new file mode 100644 index 0000000000..892eb1d997 --- /dev/null +++ b/pages/file-storage/api-cli/index.mdx @@ -0,0 +1,4 @@ +--- +title: File Storage - API/CLI documentation +description: File Storage - API/CLI documentation +--- \ No newline at end of file diff --git a/pages/file-storage/api-cli/use-file-storage-cli.mdx b/pages/file-storage/api-cli/use-file-storage-cli.mdx new file mode 100644 index 0000000000..e17ecf2170 --- /dev/null +++ b/pages/file-storage/api-cli/use-file-storage-cli.mdx @@ -0,0 +1,85 @@ +--- +title: Using File Storage with the Scaleway CLI +description: This page lists basic commands to use Scaleway File Storage using the Scaleway Command Line Interface (CLI) +tags: cli command line interface terminal file storage system +dates: + validation: 2026-01-29 + posted: 2026-01-29 +--- +import Requirements from '@macros/iam/requirements.mdx' + +This page contains basic commands to manage your file systems using the Scaleway CLI. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- [Installed and configured](/scaleway-cli/quickstart/) the Scaleway CLI + +## Creating a file system + +The following command allows you to create a file system: + +```bash +scw file filesystem create name= size= +``` + +## Listing your file systems + +The following command allows you to list file systems present in your Organization: + +```bash +scw file filesystem list +``` + +## Getting details on a file system + +The following command allows you to get information about a given file system: + +```bash +scw file filesystem get +``` + +## Updating a file system + +The following command allows you to modify the settings of a file system: + +```bash +scw file filesystem update +``` + +## Attaching a file system to an Instance + + +Attaching a file system to an Instance must be done using the Instances CLI. Refer to the [dedicated documentation](https://cli.scaleway.com/instance/#attach-a-filesystem-volume-to-an-instance) for more information. + + +The following command allows you to attach a file system to an Instance: + +```bash +scw instance server attach-filesystem server-id= filesystem-id= +``` + +Once your file system is attached to the desired Instance, you must mount it from within the Instance to use it. Refer to the [dedicated documentation](/file-storage/how-to/mount-file-system/) for more information. + +## Detaching a file system from an Instance + + +Detaching a file system from an Instance must be done using the Instances CLI. Refer to the [dedicated documentation](https://cli.scaleway.com/instance/#detach-a-filesystem-volume-from-an-instance) for more information. + + +The following command allows you to detach a file system from an Instance: + +```bash +scw instance server detach-filesystem server-id= filesystem-id= +``` + +## Deleting a file system + +The following command allows you to delete a given file system: + +```bash +scw file filesystem delete +``` + +For comprehensive information on the different CLI commands to interact with Scaleway File Storage (including the different arguments for each command), refer to the [dedicated Scaleway CLI documentation](https://cli.scaleway.com/file/). \ No newline at end of file diff --git a/pages/file-storage/menu.ts b/pages/file-storage/menu.ts index 60670a5029..0f4ae716e6 100644 --- a/pages/file-storage/menu.ts +++ b/pages/file-storage/menu.ts @@ -50,6 +50,16 @@ export const fileStorageMenu = { label: 'How to', slug: 'how-to', }, + { + items: [ + { + label:'Using File Storage with the Scaleway CLI', + slug:'use-file-storage-cli' + }, + ], + label:'API/CLI', + slug:'api-cli' + }, { items: [ { diff --git a/pages/scaleway-cli/quickstart.mdx b/pages/scaleway-cli/quickstart.mdx index 223502b197..cfd23c2580 100644 --- a/pages/scaleway-cli/quickstart.mdx +++ b/pages/scaleway-cli/quickstart.mdx @@ -9,7 +9,9 @@ dates: import Requirements from '@macros/iam/requirements.mdx' -The Scaleway command line interface (CLI) is a tool that allows you to pilot your Scaleway infrastructure and resources directly from your terminal. This page explains how to install and configure the CLI on your local machine. +The Scaleway Command Line Interface (CLI) is a tool that allows you to pilot your Scaleway infrastructure and resources directly from your terminal. It is built upon the Scaleway API, and provides a readable and user-friendly interface to interact with Scaleway products programmatically. + +This page explains how to install and configure the CLI on your local machine. Refer to the [Scaleway CLI repository](https://github.com/scaleway/scaleway-cli?tab=readme-ov-file#reference-documentation) for more information on the different commands.