Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Object Storage usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes. Las APIs se usan para el aprovisionamiento y la administración de recursos de almacenamiento de objetos. Se usan para administrar el ciclo de vida de los recursos de almacenamiento de objetos en una organización determinada, lo que incluye la creación, lectura, actualización y eliminación de buckets. Las APIs también se usan para enumerar buckets, establecer políticas de retención de bucket y configurar la clase de almacenamiento de los buckets. El almacenamiento en bloque se administra con las APIs estándar de Kubernetes.
Extremo de servicio y documento de descubrimiento
Las APIs de KRM de Storage se proporcionan en tres paquetes según la implementación zonal o global.
Los extremos de API para las APIs de Storage zonales y globales son los siguientes, respectivamente:
La variable MANAGEMENT_API_SERVER_ENDPOINT es el extremo del servidor de la API de Management.
Con el comando kubectl proxy, puedes acceder a esa URL en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API de Object Storage. El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Después de ejecutar ese comando, puedes acceder al documento en las siguientes URLs:
La API de Object Storage XML aislada de Google Distributed Cloud (GDC) es una interfaz RESTful que te permite administrar datos de Object Storage de forma programática. Como API de RESTful, se basa en información de alcance y métodos para definir las operaciones que se deben realizar:
Información del método Puedes especificar la información del método con métodos HTTP estándar, como DELETE, GET, HEAD y PUT.
Información sobre el alcance. Puedes especificar la información del alcance con un extremo accesible (URI) y varios parámetros de alcance. En el caso de la API de XML, los parámetros de alcance principales son los nombres del bucket y del objeto. Acota aún más el alcance de tus operaciones con encabezados HTTP y parámetros de cadena de consulta.
Descripción general de la API de Volume Storage
Para crear volúmenes persistentes, sigue los pasos que se describen en la documentación de Kubernetes en https://kubernetes.io/docs/concepts/storage/persistent-volumes/. La interacción con el almacenamiento de volúmenes dentro de GDC se produce por completo a través de primitivas de almacenamiento de Kubernetes. El controlador de almacenamiento de volúmenes implementa el protocolo de Container Storage Interface (CSI) y aprovisiona y organiza los volúmenes en el sistema de almacenamiento, que es opaco para el usuario final del volumen persistente.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]