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

모든 계정 나열

05/23/2026

PDF

GET /accounts

컬렉션에서 일치하는 모든 리소스를 JSON 배열로 반환합니다. 요청에 개별 필드가 지정된 경우, items JSON 배열에는 지정된 순서대로 각 일치하는 리소스에 대해 요청된 필드가 포함됩니다.

매개변수

이름	유형	에서	필수 요소입니다	설명
포함	문자열	쿼리	거짓	컬렉션 목록을 표시할 때 어떤 필드를 반환해야 하는지 지정합니다. URL 예: "include=id", "include=id,name" OpenAPI 예: "id"
제한	문자열	쿼리	거짓	컬렉션 목록을 표시할 때 반환할 최대 리소스 수를 나타냅니다. URL 예: "limit=2" OpenAPI 예: "2"
필터	문자열	쿼리	거짓	컬렉션 목록을 표시할 때 리소스를 반환하기 위해 어떤 필드를 일치시켜야 하는지를 나타냅니다. 지원되는 연산자는 다음과 같습니다. eq - 같음 lt/gt - 미만/초과 lte/gte - 이하/이상 URL 예: "filter=field%20eq%20%27value%27" OpenAPI 예: "field eq 'value'"
주문	문자열	쿼리	거짓	컬렉션을 나열할 때 리소스의 정렬 순서를 나타냅니다. URL 예시: "orderBy=name", "orderBy=name%20desc" OpenAPI 예: "name desc"
건너뛰기	문자열	쿼리	거짓	컬렉션 목록을 작성할 때 건너뛸 리소스의 수를 나타냅니다. URL 예: "skip=1" OpenAPI 예제: "1"
카운트	문자열	쿼리	거짓	메타데이터 개체에서 총 리소스 수를 반환해야 하는지 여부를 나타냅니다. URL 예: "count=true" OpenAPI 예: "true"
계속		쿼리	거짓	목록 표시를 재개할 토큰을 나타냅니다. URL 예시: "continue=" OpenAPI 예시: ""</continue>

이름

유형

에서

필수 요소입니다

설명

포함

문자열

쿼리

거짓

컬렉션 목록을 표시할 때 어떤 필드를 반환해야 하는지 지정합니다.

URL 예: "include=id", "include=id,name"

OpenAPI 예: "id"

제한

문자열

쿼리

거짓

컬렉션 목록을 표시할 때 반환할 최대 리소스 수를 나타냅니다.

URL 예: "limit=2"

OpenAPI 예: "2"

필터

문자열

쿼리

거짓

컬렉션 목록을 표시할 때 리소스를 반환하기 위해 어떤 필드를 일치시켜야 하는지를 나타냅니다.

지원되는 연산자는 다음과 같습니다.

eq - 같음
lt/gt - 미만/초과
lte/gte - 이하/이상

URL 예: "filter=field%20eq%20%27value%27"

OpenAPI 예: "field eq 'value'"

주문

문자열

쿼리

거짓

컬렉션을 나열할 때 리소스의 정렬 순서를 나타냅니다.

URL 예시: "orderBy=name", "orderBy=name%20desc"

OpenAPI 예: "name desc"

건너뛰기

문자열

쿼리

거짓

컬렉션 목록을 작성할 때 건너뛸 리소스의 수를 나타냅니다.

URL 예: "skip=1"

OpenAPI 예제: "1"

카운트

문자열

쿼리

거짓

메타데이터 개체에서 총 리소스 수를 반환해야 하는지 여부를 나타냅니다.

URL 예: "count=true"

OpenAPI 예: "true"

계속

쿼리

거짓

목록 표시를 재개할 토큰을 나타냅니다.

URL 예시: "continue="

OpenAPI 예시: ""</continue>

응답

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.

이름	유형	필수 요소입니다	설명
항목	array[다음 중 하나: "account_1.0_get_response_body", array[]]	참
메타데이터	"type_astra_메타데이터_목록"	참

이름

유형

필수 요소입니다

설명

항목

array[다음 중 하나: "account_1.0_get_response_body", array[]]

참

메타데이터

"type_astra_메타데이터_목록"

참

응답 예

{
  "type": "application/astra-accounts",
  "version": "1.0",
  "items": [
    {
      "type": "application/astra-account",
      "version": "1.0",
      "id": "70796606-79ba-480b-966c-e4c600fbf622",
      "name": "fraught-pines",
      "state": "active",
      "isEnabled": "true",
      "enabledTimestamp": "2020-08-06T12:24:52.256624Z",
      "metadata": {
        "labels": [],
        "creationTimestamp": "2020-08-06T12:24:52.256624Z",
        "modificationTimestamp": "2020-08-06T12:24:52.256624Z",
        "createdBy": "1723a17e-9fd1-4636-86e1-2ec9e04bce51"
      }
    },
    {
      "type": "application/astra-account",
      "version": "1.0",
      "id": "7976114d-35ec-48a7-ba31-22d8e94a8bb2",
      "name": "sad-dino",
      "state": "active",
      "isEnabled": "true",
      "enabledTimestamp": "2020-08-06T12:24:52.256624Z",
      "metadata": {
        "labels": [],
        "creationTimestamp": "2020-08-06T12:24:52.256624Z",
        "modificationTimestamp": "2020-08-06T12:24:52.256624Z",
        "createdBy": "1723a17e-9fd1-4636-86e1-2ec9e04bce51"
      }
    }
  ],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

응답

Status: 401, Unauthorized

이름	유형	필수 요소입니다
유형	문자열	참
제목	문자열	참
세부 정보	문자열	참
상태	문자열	참
correlationID	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

응답 예

{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

응답

Status: 400, Bad request

이름	유형	필수 요소입니다	설명
유형	문자열	참
제목	문자열	참
세부 정보	문자열	참
상태	문자열	참
correlationID	문자열	거짓
invalidParams	배열["invalidParams"]	거짓	유효하지 않은 쿼리 매개변수 목록

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

invalidParams

배열["invalidParams"]

거짓

유효하지 않은 쿼리 매개변수 목록

응답 예

{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

응답

Status: 403, Forbidden

이름	유형	필수 요소입니다
유형	문자열	참
제목	문자열	참
세부 정보	문자열	참
상태	문자열	참
correlationID	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

응답 예

{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

오류

Status: 404, Not found

이름	유형	필수 요소입니다
유형	문자열	참
제목	문자열	참
세부 정보	문자열	참
상태	문자열	참
correlationID	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

예시 오류 응답

{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

정의

정의를 참조하세요

postalAddress

주소를 지정하는 JSON 문자열 모음을 포함하는 JSON 객체입니다. 이 키가 존재하지 않으면 주소가 제공되지 않았음을 나타냅니다. 이 키가 존재하면 포함된 6개의 JSON 문자열이 모두 표시됩니다. 아무것도 제공하지 않으면 문자열은 비어 있습니다.

이름	유형	필수 요소입니다	설명
addressCountry	문자열	참	ISO 3166 Alpha-2에 명시된 대로 우편 주소와 관련된 국가명 또는 국가 코드를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 2 최대 길이: 2
addressLocality	문자열	참	우편 주소와 관련된 지역(예: 도시) 정보를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63
addressRegion	문자열	참	우편 주소와 관련된 지역(예: 주)을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63
postalCode	문자열	참	우편 주소와 연결된 우편번호를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 31
streetAddress1	문자열	참	우편 주소와 연결된 도로명 주소를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63
streetAddress2	문자열	거짓	선택적 부가 주소 정보, 우편 사서함 등을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63

이름

유형

필수 요소입니다

설명

addressCountry

문자열

참

ISO 3166 Alpha-2에 명시된 대로 우편 주소와 관련된 국가명 또는 국가 코드를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 2
최대 길이: 2

addressLocality

문자열

참

우편 주소와 관련된 지역(예: 도시) 정보를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63

addressRegion

문자열

참

우편 주소와 관련된 지역(예: 주)을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63

postalCode

문자열

참

우편 주소와 연결된 우편번호를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 31

streetAddress1

문자열

참

우편 주소와 연결된 도로명 주소를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63

streetAddress2

문자열

거짓

선택적 부가 주소 정보, 우편 사서함 등을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63

accountContact

계정 활성화 시 소유자 사용자를 생성하기 위한 사용자 연락처 정보가 포함된 JSON 객체입니다.

이름	유형	필수 요소입니다	설명
firstName	문자열	참	사용자가 지정한 긴 형식의 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63 이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.
lastName	문자열	참	사용자가 지정한 긴 형식의 성을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63 이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.
companyName	문자열	거짓	사용자와 연결된 회사 이름을 포함하는 JSON 문자열입니다. 이 키가 존재하지 않으면 회사 이름이 제공되지 않았음을 나타냅니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63 이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.
이메일	문자열	참	사용자가 지정한 이메일 주소가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63
전화	문자열	거짓	사용자의 전화번호가 포함된 JSON 문자열입니다. 이 키가 존재하지 않으면 전화번호가 제공되지 않았음을 나타냅니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 31
postalAddress	"postalAddress"	참	주소를 지정하는 JSON 문자열 모음을 포함하는 JSON 객체입니다. 이 키가 존재하지 않으면 주소가 제공되지 않았음을 나타냅니다. 이 키가 존재하면 포함된 6개의 JSON 문자열이 모두 표시됩니다. 아무것도 제공하지 않으면 문자열은 비어 있습니다.

이름

유형

필수 요소입니다

설명

firstName

문자열

참

사용자가 지정한 긴 형식의 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63
이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.

lastName

문자열

참

사용자가 지정한 긴 형식의 성을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63
이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.

companyName

문자열

거짓

사용자와 연결된 회사 이름을 포함하는 JSON 문자열입니다. 이 키가 존재하지 않으면 회사 이름이 제공되지 않았음을 나타냅니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63
이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.

이메일

문자열

참

사용자가 지정한 이메일 주소가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63

전화

문자열

거짓

사용자의 전화번호가 포함된 JSON 문자열입니다. 이 키가 존재하지 않으면 전화번호가 제공되지 않았음을 나타냅니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 31

postalAddress

"postalAddress"

참

type_astra_label

이름	유형	필수 요소입니다	설명
이름	문자열	참
값	문자열	참

이름

유형

필수 요소입니다

설명

이름

문자열

참

값

문자열

참

type_astra_메타데이터_업데이트

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

이름	유형	필수 요소입니다
라벨	배열["type_astra_label"]	거짓
CreationTimestamp 를 클릭합니다	문자열	거짓
modificationTimestamp	문자열	거짓
생성 시	문자열	거짓
modifiedBy	문자열	거짓

이름

유형

필수 요소입니다

설명

라벨

배열["type_astra_label"]

거짓

CreationTimestamp 를 클릭합니다

문자열

거짓

modificationTimestamp

문자열

거짓

생성 시

문자열

거짓

modifiedBy

문자열

거짓

account_1.0_get_response_body

이름	유형	필수 요소입니다	설명
유형	문자열	참	리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다. "application/astra-account"
버전	문자열	참	리소스 버전입니다. 정의된 값은 다음과 같습니다. "1.0"
ID입니다	문자열	참	리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다. UUIDv4 스키마를 준수합니다.
이름	문자열	참	계정 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. 최소 길이: 1 최대 길이: 63 이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.
상태	문자열	참	계정의 운영 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. "pending" - 계정 아래의 사용자 및 역할 리소스에 대해서만 변경이 가능합니다(기본값) "active" - 해당 계정의 모든 리소스를 변경할 수 있습니다. "deletePending" - 사용자는 로그인할 수 없으며, 데이터 보호 작업이 일시 중단되고 요금이 더 이상 발생하지 않습니다.
isEnabled	문자열	참	계정 활성화 여부를 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. "false" - 사용자는 이 계정을 사용할 수 없습니다. "true" - 사용자는 이 계정을 사용할 수 있습니다.
enabledTimestamp	문자열	거짓	계정이 마지막으로 활성화된 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 계정이 한 번도 활성화된 적이 없는 경우 이 필드는 없습니다. 정의된 값은 다음과 같습니다. ISO-8601 날짜/시간 스키마를 준수합니다.
accountContact	"accountContact"	거짓	계정 활성화 시 소유자 사용자를 생성하기 위한 사용자 연락처 정보가 포함된 JSON 객체입니다.
메타데이터	"type_astra_메타데이터_업데이트"	참	리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다. Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

이름

유형

필수 요소입니다

설명

유형

문자열

참

리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다.

"application/astra-account"

버전

문자열

참

리소스 버전입니다. 정의된 값은 다음과 같습니다.

"1.0"

ID입니다

문자열

참

리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다.

UUIDv4 스키마를 준수합니다.

이름

문자열

참

계정 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

최소 길이: 1
최대 길이: 63
이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.

상태

문자열

참

계정의 운영 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

"pending" - 계정 아래의 사용자 및 역할 리소스에 대해서만 변경이 가능합니다(기본값)
"active" - 해당 계정의 모든 리소스를 변경할 수 있습니다.
"deletePending" - 사용자는 로그인할 수 없으며, 데이터 보호 작업이 일시 중단되고 요금이 더 이상 발생하지 않습니다.

isEnabled

문자열

참

계정 활성화 여부를 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

"false" - 사용자는 이 계정을 사용할 수 없습니다.
"true" - 사용자는 이 계정을 사용할 수 있습니다.

enabledTimestamp

문자열

거짓

계정이 마지막으로 활성화된 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 계정이 한 번도 활성화된 적이 없는 경우 이 필드는 없습니다. 정의된 값은 다음과 같습니다.

ISO-8601 날짜/시간 스키마를 준수합니다.

accountContact

"accountContact"

거짓

계정 활성화 시 소유자 사용자를 생성하기 위한 사용자 연락처 정보가 포함된 JSON 객체입니다.

메타데이터

"type_astra_메타데이터_업데이트"

참

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

type_astra_메타데이터_목록

이름	유형	필수 요소입니다
계속	문자열	거짓
카운트	숫자	거짓
라벨	배열["type_astra_label"]	거짓
CreationTimestamp 를 클릭합니다	문자열	거짓
modificationTimestamp	문자열	거짓
생성 시	문자열	거짓
modifiedBy	문자열	거짓

이름

유형

필수 요소입니다

설명

계속

문자열

거짓

카운트

숫자

거짓

라벨

배열["type_astra_label"]

거짓

CreationTimestamp 를 클릭합니다

문자열

거짓

modificationTimestamp

문자열

거짓

생성 시

문자열

거짓

modifiedBy

문자열

거짓

invalidParams

이름	유형	필수 요소입니다	설명
이름	문자열	참	잘못된 쿼리 매개변수의 이름
이유	문자열	참	쿼리 매개변수가 유효하지 않은 이유

이름

유형

필수 요소입니다

설명

이름

문자열

참

잘못된 쿼리 매개변수의 이름

이유

문자열

참

쿼리 매개변수가 유효하지 않은 이유

모든 계정 나열

Creating your file...

매개변수

응답

응답

응답

응답

오류

정의