Skip to main content
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

URL 형식

기여자
PDF

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.