Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Object Storage utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressources Kubernetes. Les API sont utilisées pour le provisionnement et l'administration des ressources de stockage d'objets. Elles permettent de gérer le cycle de vie des ressources de stockage d'objets dans une organisation donnée, y compris la création, la lecture, la mise à jour et la suppression de buckets. Les API sont également utilisées pour lister les buckets, définir les règles de conservation des buckets et définir la classe de stockage des buckets. Le stockage de blocs est géré avec les API Kubernetes standards.
Point de terminaison du service et document de découverte
Les API KRM Storage sont fournies dans trois packages en fonction du déploiement zonal ou global.
Les points de terminaison de l'API Storage zonale et globale sont les suivants :
La variable MANAGEMENT_API_SERVER_ENDPOINT est le point de terminaison du serveur de l'API Management.
À l'aide de la commande kubectl proxy, vous pouvez accéder à cette URL dans votre navigateur ou avec un outil tel que curl pour obtenir le document de découverte de l'API Object Storage. La commande kubectl proxy ouvre un proxy vers le serveur d'API Kubernetes sur votre machine locale. Une fois cette commande exécutée, vous pouvez accéder au document aux URL suivantes :
L'API XML Object Storage Google Distributed Cloud (GDC) air-gapped est une interface RESTful qui vous permet de gérer les données de stockage d'objets de manière programmatique. En tant qu'API RESTful, elle s'appuie sur des informations de méthode et de portée pour définir les opérations à effectuer :
Informations sur la méthode Vous spécifiez les informations sur la méthode à l'aide de méthodes HTTP standards, telles que DELETE, GET, HEAD et PUT.
Informations sur le champ d'application. Vous spécifiez les informations sur le champ d'application avec un point de terminaison (URI) accessible et divers paramètres de champ d'application. Pour l'API XML, les principaux paramètres de portée sont les noms de bucket et d'objet. Élargissez le champ d'application de vos opérations en utilisant des en-têtes HTTP et des paramètres de chaîne de requête.
Présentation de l'API Volume Storage
Pour créer des volumes persistants, suivez la procédure décrite dans la documentation Kubernetes à l'adresse https://kubernetes.io/docs/concepts/storage/persistent-volumes/. L'interaction avec le stockage de volumes dans GDC se fait entièrement par le biais des primitives de stockage Kubernetes. Le pilote Volume Storage implémente le protocole CSI (Container Storage Interface) et provisionne et orchestre les volumes dans le système de stockage, de manière opaque pour l'utilisateur final du volume persistant.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eObject Storage APIs utilize Kubernetes custom resources for provisioning and managing object storage, including bucket creation, reading, updating, deletion, retention policies, and storage class settings.\u003c/p\u003e\n"],["\u003cp\u003eThe Storage KRM APIs are available in three packages based on zonal or global deployment, with specific API endpoints provided for each scenario.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Distributed Cloud air-gapped Object Storage XML API, a RESTful interface, uses HTTP methods and scoping parameters like bucket and object names for managing data programmatically.\u003c/p\u003e\n"],["\u003cp\u003eVolume storage in GDC is managed using standard Kubernetes APIs and persistent volume creation, and employs the Container Storage Interface (CSI) protocol, with a single supported storage class: standard-rwo.\u003c/p\u003e\n"]]],[],null,["# Storage API overview\n\nThe Object Storage API uses Kubernetes custom resources and relies on the Kubernetes Resource Model. The APIs are used for the provisioning and administration of object storage resources. They are used to manage the lifecycle of object storage resources in a given organization, including creating, reading, updating, and deleting buckets. The APIs are also used for listing buckets, setting bucket retention policies, and setting the storage class of buckets. Block storage is managed with standard Kubernetes APIs.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe Storage KRM APIs are provided in three packages depending on zonal deployment or\nglobal deployment.\n\nThe API endpoints for the zonal and global Storage APIs are the following,\nrespectively:\n\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/object.gdc.goog/v1`\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/object.global.gdc.goog/v1`\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/storage.global.gdc.goog/v1`\n\nThe \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e variable is the\nendpoint of the Management API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or with a tool such as `curl` to get the discovery document for the Object Storage API. The `kubectl proxy` command opens a proxy to the Kubernetes API server on your local machine. After that command is running, you can access the document at\nthe following URLs:\n\n- `http://127.0.0.1:8001/apis/object.gdc.goog/v1`\n- `http://127.0.0.1:8001/apis/object.global.gdc.goog/v1`\n- `http://127.0.0.1:8001/apis/storage.global.gdc.goog/v1`\n\nS3 REST API overview\n--------------------\n\nThe Google Distributed Cloud (GDC) air-gapped Object Storage XML API is a RESTful interface that lets you manage object storage data in a programmatic way. As a RESTful API, it relies on method and scoping information to define the operations to perform:\n\n- **Method information** . You specify the method information with standard HTTP methods, such as `DELETE`, `GET`, `HEAD`, and `PUT`.\n- **Scoping information**. You specify the scoping information with an accessible endpoint (URI) and various scoping parameters. For the XML API, the primary scoping parameters are the bucket and object names. Further scope your operations by using HTTP headers and query string parameters.\n\nVolume Storage API overview\n---------------------------\n\nTo create persistent volumes, follow the steps outlined by the Kubernetes documentation at \u003chttps://kubernetes.io/docs/concepts/storage/persistent-volumes/\u003e. Interaction with Volume Storage within GDC occurs entirely through Kubernetes storage primitives. The Volume Storage driver implements the Container Storage Interface (CSI) protocol and provisions and orchestrates the volumes in the storage system, opaque to the end user of the persistent volume.\n\nGDC supports a single storage class of type *standard-rwo* . See \u003chttps://kubernetes.io/docs/concepts/storage/storage-classes/\u003e for more information on storage classes."]]