Integrating vStorage API
To view the vStorage API integration guide, you can follow these steps on the vStorage Portal:
Log in to https://vstorage.console.vngcloud.vn.
Select the Integration menu.
Choose the vStorage API icon.
In the Authorization section, you need to provide the necessary information to configure your vStorage API, including:
Enter the Client ID: A unique character string used by the Service API to identify the application, also used to build the authorization URL displayed to users. You can create and manage the Client ID through the vIAM system. The Client ID will be automatically generated when you create a new Service Account. Refer to the details at [Initialize a Service Account](Link to the relevant documentation).
Enter the corresponding Client Secret for the entered Client ID. The Client ID and Client Secret pair are created and managed through the vIAM system. You can click Click here to manage your Client ID to navigate to the vIAM system and access the Service Account management screens. Refer to the details at [Initialize a Service Account](Link to the relevant documentation).
After completing the authorization configuration, select Authentication to go to the Configuration screen. You can always return here to change your permission information, then select Authentication again to update the S3 Rest API list with your new settings.
Experience vStorage API directly on the vStorage Portal:
To experience using the vStorage API, you need at least one Client ID and Client Secret (this information is obtained from the Service Account). To create a Service Account, refer to [Initialize a Service Account](Link to the relevant documentation). You can use this Service Account to create (or delete) multiple containers. A container acts as a storage unit (similar to a directory), and within each container, customers can upload, get, and delete multiple corresponding objects (objects here can be understood as a file or a subfolder in the container).
Basic procedure: Authenticate -> Create Project -> Create Container -> Upload Object
We provide you with a quick operation interface with the vStorage API. After integrating as instructed in [Integrate vStorage API](Link to the relevant documentation), continue following these steps:
Select Try it out.
Enter the input for each API.
Select Execute.
Check the returned result.
Below is an example of the four basic vStorage APIs that you can experience:
1. Create a project
Prerequisite:
Postpaid user
Result:
The project is initialized with properties:
Project type: Gold class.
Region: HCM01.
![](https://docs.vngcloud.vn/~gitbook/image?url=https%3A%2F%2F1985221522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F7rE7M1L7GYcwQzNGd0aB%252Fuploads%252FvsOd884yvfWrRLqvEKrU%252Fimage.png%3Falt%3Dmedia%26token%3Dd8690b3c-3451-4e70-b2d0-fddc0e3f8fb9&width=768&dpr=4&quality=100&sign=42605834&sv=1)
2. Create a container
The following API is used to initialize a container within a project.
![](https://docs.vngcloud.vn/~gitbook/image?url=https%3A%2F%2F1985221522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F7rE7M1L7GYcwQzNGd0aB%252Fuploads%252FCtIDM6Zy1heqww2qhk2x%252Fimage.png%3Falt%3Dmedia%26token%3Dc7ee3951-b107-4ad9-a757-aef0f85d92b8&width=768&dpr=4&quality=100&sign=b815a12d&sv=1)
3. Delete a container
The following API is used to delete a container within a project.
![](https://docs.vngcloud.vn/~gitbook/image?url=https%3A%2F%2F1985221522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F7rE7M1L7GYcwQzNGd0aB%252Fuploads%252Fe2CSf29MStxdQb8Q3V3C%252Fimage.png%3Falt%3Dmedia%26token%3Df70a606b-9ddb-4593-9724-d6ba4a6a8b7e&width=768&dpr=4&quality=100&sign=b6c66bc2&sv=1)
4. Delete an object
The following API is used to delete an object within a container.
![](https://docs.vngcloud.vn/~gitbook/image?url=https%3A%2F%2F1985221522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F7rE7M1L7GYcwQzNGd0aB%252Fuploads%252FxreDW2M308xmtsTG2hYX%252Fimage.png%3Falt%3Dmedia%26token%3D4423b546-8c7c-4265-b165-1a7e5f60403a&width=768&dpr=4&quality=100&sign=7f5442ff&sv=1)
In addition to the quick usage on the vStorage Portal, you can use the vStorage API on personal devices following the instructions in [Use vStorage API](Link to the relevant documentation).
Last updated