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

URL 형식

기여자
PDF

REST API를 통해 리소스 인스턴스 또는 컬렉션에 액세스하는 데 사용되는 URL의 일반 구조는 여러 값으로 구성됩니다. 이 구조체는 기본 개체 모델 및 시스템 설계를 반영합니다.

root로 계정을 지정합니다

모든 REST 끝점에 대한 리소스 경로의 루트는 Astra 계정입니다. 따라서 URL의 모든 경로는 "/account/{account_id}"로 시작합니다. 여기서 "account_id"는 계정에 대한 고유한 UUIDv4 값입니다. 내부 구조 모든 리소스 액세스가 특정 계정을 기반으로 하는 설계를 반영합니다.

끝점 리소스 범주입니다

Astra 리소스 끝점은 세 가지 범주로 나뉩니다.

  • 코어('/코어')

  • 관리 애플리케이션("/k8s")

  • 토폴로지('/topology')

을 참조하십시오 "리소스" 를 참조하십시오.

카테고리 버전

세 가지 리소스 범주 각각에는 액세스한 리소스의 버전을 제어하는 전역 버전이 있습니다. 규칙과 정의에 따라 새로운 주요 버전의 리소스 범주(예: /v1 에서 / v2)로 이동하면 API의 변경 내용이 깨질 수 있습니다.

리소스 인스턴스 또는 컬렉션입니다

리소스 인스턴스 또는 컬렉션 액세스 여부에 따라 경로에서 리소스 형식과 식별자의 조합을 사용할 수 있습니다.

예

  • 리소스 경로입니다

    위에 제시된 구조를 바탕으로 엔드포인트에 대한 일반적인 경로는 "/accounts/{account_id}/core/v1/users"입니다.

  • URL을 완료합니다

    해당 끝점의 전체 URL은 다음과 같습니다. https://astra.netapp.io/accounts/{account_id}/core/v1/users.