Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Almacenamiento de objetos
La API de Object Storage incluye secciones sobre el modelo de recursos de Kubernetes (KRM) y la API de REST de S3. El almacenamiento en bloque se administra con la API de almacenamiento estándar de Kubernetes (https://kubernetes.io/docs/concepts/storage/).
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 aprovisionar y administrar recursos de almacenamiento de objetos. Se usan para administrar el ciclo de vida de los recursos de almacenamiento de objetos en la organización, incluida la creación, lectura, actualización y eliminación de buckets. Las APIs también se usan para enumerar y establecer políticas de retención, y para configurar la clase de almacenamiento de los buckets y el control de acceso a nivel del bucket.
Extremo de servicio y documento de descubrimiento
La siguiente URL es el extremo de API para las APIs de Object Storage:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.gdc.goog/v1, donde MANAGEMENT_API_SERVER_ENDPOINT es el extremo de API de tu 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 que se ejecute ese comando, accede al documento en la siguiente URL: http://127.0.0.1:8001/apis/object.gdc.goog/v1.
Descripción general de la API de REST de S3
El almacenamiento definido por software
proporciona la API de Object Storage compatible con la API de Amazon S3. La API de XML de Object Storage del dispositivo aislado 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 la información del método y del alcance 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.
Almacenamiento en bloque
Descripción general de la API de Volume Storage
La interacción con el almacenamiento dentro de GDC se produce por completo con las primitivas de almacenamiento de Kubernetes. Para crear volúmenes persistentes, sigue la documentación (https://kubernetes.io/docs/concepts/storage/persistent-volumes/) de Kubernetes.
A continuación, se muestra un ejemplo de un reclamo de 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\u003eThe Object Storage API, which includes KRM and S3 REST API sections, manages the lifecycle of object storage resources, using Kubernetes custom resources for provisioning and administration.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for Object Storage is located at \u003ccode\u003ehttps://ADMIN_CLUSTER_KUBERNETES_API_ENDPOINT/apis/object.gdc.goog/v1alpha1\u003c/code\u003e, which can be accessed through \u003ccode\u003ekubectl proxy\u003c/code\u003e to view the discovery document.\u003c/p\u003e\n"],["\u003cp\u003eThe S3 REST API enables programmatic management of object storage data, utilizing HTTP methods (DELETE, GET, HEAD, PUT) and scoping parameters like bucket and object names.\u003c/p\u003e\n"],["\u003cp\u003eBlock storage in GDC is managed through standard Kubernetes storage APIs and supports a single storage class, \u003cem\u003estandard-rwo\u003c/em\u003e, as demonstrated by the example persistent volume claim provided.\u003c/p\u003e\n"]]],[],null,["# Storage API overview\n\n| **Important:** To access the URLs on this page, you must connect to the internet. The URLs are provided for use when you have such access.\n\nObject storage\n--------------\n\nThe Object Storage API includes Kubernetes Resource Model (KRM) and S3 REST API sections. Block storage is managed with standard Kubernetes storage API (\u003chttps://kubernetes.io/docs/concepts/storage/\u003e).\n\nThe Object Storage API uses Kubernetes custom resources and relies on the Kubernetes Resource Model. The APIs are used for provisioning and administration of object storage resources. They are used to manage the lifecycle of object storage resources in the organization, including creating, reading, updating, and deleting buckets. The APIs are also used for listing, setting retention policies, and setting the storage class of buckets and bucket-level access control.\n\n### Service endpoint and discovery document\n\nThe following URL is the API endpoint for the Object Storage APIs:\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/object.gdc.goog/v1` where \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the API endpoint of your Management API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or\nwith a tool such as `curl` to get the discovery document for the Object Storage\nAPI. The `kubectl proxy` command opens up a proxy to the Kubernetes API server\non your local machine. After that command is running, access the document at the\nfollowing URL: `http://127.0.0.1:8001/apis/object.gdc.goog/v1`.\n\n### S3 REST API overview\n\nSoftware-defined storage provides the Object Storage API compatible with the Amazon S3 API. The Google Distributed Cloud (GDC) air-gapped appliance Object Storage XML API is a RESTful interface that lets you to manage object storage data in a programmatic way. As a RESTful API, it relies on method information and scoping information to define the operations to perform:\n\n\u003cbr /\u003e\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\nBlock storage\n-------------\n\n### Volume storage API overview\n\nInteraction with storage within GDC occurs entirely using the Kubernetes storage primitives. To create persistent volumes, follow the documentation (\u003chttps://kubernetes.io/docs/concepts/storage/persistent-volumes/\u003e) by Kubernetes.\n\nHere is an example of a persistent volume claim: \n\n apiVersion: v1\n kind: PersistentVolumeClaim\n metadata:\n name: my_volume\n spec:\n accessModes:\n - ReadWriteOnce\n volumeMode: Filesystem\n resources:\n requests:\n storage: 1Gi\n storageClassName: standard-rwo"]]
