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

URL 형식

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

모든 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’입니다.