객체 스토리지 API는 Kubernetes 커스텀 리소스를 사용하고 Kubernetes 리소스 모델을 기반으로 합니다. API는 객체 스토리지 리소스의 프로비저닝 및 관리에 사용됩니다. 버킷 생성, 읽기, 업데이트, 삭제를 비롯하여 특정 조직의 객체 스토리지 리소스 수명 주기를 관리하는 데 사용됩니다. API는 버킷을 나열하고, 버킷 보관 정책을 설정하고, 버킷의 스토리지 클래스를 설정하는 데도 사용됩니다. 블록 스토리지는 표준 Kubernetes API로 관리됩니다.
MANAGEMENT_API_SERVER_ENDPOINT 변수는 Management API 서버의 엔드포인트입니다.
kubectl proxy 명령어를 사용하여 브라우저에서 또는 curl과 같은 도구로 해당 URL에 액세스하여 Object Storage API의 검색 문서를 가져올 수 있습니다. kubectl proxy 명령어는 로컬 머신에서 Kubernetes API 서버로의 프록시를 엽니다. 명령어가 실행되면 다음 URL에서 문서에 액세스할 수 있습니다.
Google Distributed Cloud (GDC) 에어 갭 객체 스토리지 XML API는 프로그래매틱 방식으로 객체 스토리지 데이터를 관리할 수 있는 RESTful 인터페이스입니다. RESTful API로서 메서드와 범위 정보를 사용하여 실행할 작업을 정의합니다.
메서드 정보DELETE, GET, HEAD, PUT과 같은 표준 HTTP 메서드로 메서드 정보를 지정합니다.
범위 지정 정보 액세스 가능한 엔드포인트 (URI)와 다양한 범위 지정 매개변수를 사용하여 범위 지정 정보를 지정합니다. XML API의 경우 기본 범위 지정 매개변수는 버킷 이름과 객체 이름입니다. HTTP 헤더와 쿼리 문자열 매개변수를 사용하여 작업 범위를 추가로 지정합니다.
Volume Storage API 개요
영구 볼륨을 만들려면 https://kubernetes.io/docs/concepts/storage/persistent-volumes/의 Kubernetes 문서에 설명된 단계를 따르세요. GDC 내 볼륨 스토리지와의 상호작용은 Kubernetes 스토리지 기본 요소를 통해서만 발생합니다. 볼륨 스토리지 드라이버는 컨테이너 스토리지 인터페이스 (CSI) 프로토콜을 구현하고 영구 볼륨의 최종 사용자에게 불투명한 스토리지 시스템에서 볼륨을 프로비저닝하고 오케스트레이션합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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."]]
