이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.
URL 형식
기여자
REST API를 통해 리소스 인스턴스 또는 컬렉션에 액세스하는 데 사용되는 URL의 일반 구조는 여러 값으로 구성됩니다. 이 구조체는 기본 개체 모델 및 시스템 설계를 반영합니다.
root로 계정을 지정합니다
모든 REST 끝점에 대한 리소스 경로의 루트는 Astra 계정입니다. 따라서 URL의 모든 경로는 로 시작합니다 /account/{account_id}
위치 account_id
계정에 대한 고유한 UUIDv4 값입니다. 내부 구조 모든 리소스 액세스가 특정 계정을 기반으로 하는 설계를 반영합니다.
끝점 리소스 범주입니다
Astra 리소스 끝점은 세 가지 범주로 나뉩니다.
-
코어 (
/core
) -
관리형 애플리케이션 (
/k8s
) -
토폴로지 (
/topology
)
을 참조하십시오 "리소스" 를 참조하십시오.
카테고리 버전
세 가지 리소스 범주 각각에는 액세스한 리소스의 버전을 제어하는 전역 버전이 있습니다. 규칙 및 정의에 따라 리소스 범주의 새로운 주 버전(예: 에서)으로 이동합니다 /v1
를 선택합니다 /v2
)는 API의 변경 사항을 깨는 방법을 소개합니다.
리소스 인스턴스 또는 컬렉션입니다
리소스 인스턴스 또는 컬렉션 액세스 여부에 따라 경로에서 리소스 형식과 식별자의 조합을 사용할 수 있습니다.
예
-
리소스 경로입니다
위에서 설명한 구조를 기반으로 엔드포인트에 대한 일반적인 경로는 다음과 같습니다.
/accounts/{account_id}/core/v1/users
. -
URL을 완료합니다
해당 끝점의 전체 URL은 다음과 같습니다.
https://astra.netapp.io/accounts/{account_id}/core/v1/users
.