정책 나열

정책 나열 (List policies)

GET /orgs/{org_name}/governance/policies — 조직의 정책에 대한 얕은 요약을 한 번에 한 페이지씩 반환해요. 규칙 세트는 포함되지 않으며, 전체 객체를 가져오려면 GetPolicy를 사용해요.

출처: 문서

본문

API 버전 1 — List policies · GET /orgs/{org_name}/governance/policies

조직의 정책에 대한 얕은 요약을 한 번에 한 페이지씩 반환해요. 규칙 세트는 포함되지 않으며, 전체 객체를 가져오려면 GetPolicy를 사용해요.

결과는 불투명 커서로 페이지가 나뉘어요. page_size를 전달해 페이지 크기를 제한하고, 남은 정책이 더 있으면 응답에 다음 요청에서 page_token으로 전달할 next_page_token(null이 아님)이 포함돼요. next_page_token이 null이 될 때까지 반복해요. 토큰을 불투명하게 취급하고 파싱하거나 구성하지 마세요.

연결 및 접근 (Connection and access)

API 연결 및 인증 안내

https://hub.docker.com/v2

다음 대안 중 하나를 사용해요. 한 대안 안의 요구 사항은 함께 적용돼요.

bearerAuth

파라미터

org_name

path · 필수 — Docker Hub 조직 이름. 유형: string

{
  "type": "string"
}

page_size

query — 반환할 최대 정책 수. 생략하거나 0이면 기본 100. 서버는 100을 초과하는 값을 100으로 제한해요. 유형: integer

{
  "default": 100,
  "minimum": 0,
  "type": "integer"
}

page_token

query — 이전 응답의 next_page_token에서 온 불투명 커서. 첫 페이지를 가져오려면 생략해요. 유형: string

{
  "type": "string"
}

요청 및 응답

Media type: application/json

응답 200

data 아래에 정책 요약 배열을, 마지막 페이지에서는 null인 next_page_token을 담는 객체. 규칙 세트는 포함되지 않으며, 전체 정책을 가져오려면 GetPolicy를 사용해요.

유형: object · data(필수) — 유형: array, 스키마: PolicySummary

{
  "items": {
    "$ref": "#/components/schemas/PolicySummary"
  },
  "type": "array"
}

next_page_token(필수) — 유형: string | null — 다음 페이지의 불투명 커서, 마지막 페이지에서는 null.

{
  "description": "The opaque cursor for the next page, or `null` on the last page.\n",
  "example": "AQpteyJQSy...8ifQ",
  "type": [
    "string",
    "null"
  ]
}

{
  "properties": {
    "data": {
      "items": {
        "$ref": "#/components/schemas/PolicySummary"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "The opaque cursor for the next page, or `null` on the last page.\n",
      "example": "AQpteyJQSy...8ifQ",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "data",
    "next_page_token"
  ],
  "type": "object"
}

{
  "data": [
    {
      "created_at": "2026-04-22T00:00:00Z",
      "id": "pol_06evsmp24r1pg71cm8500546pkbn",
      "name": "Security Research — hardened",
      "org": "my-org",
      "scope": {
        "teams": [
          "d290f1ee-6c54-4b01-90e6-d701748f0851"
        ]
      },
      "type": "allowlist_v0",
      "updated_at": "2026-04-22T00:00:00Z"
    }
  ],
  "next_page_token": "AQpteyJQSy...8ifQ"
}

응답 400

Bad request · 스키마: Error

{
  "error": {
    "code": "invalid_argument",
    "message": "name is required"
  }
}

응답 401

Missing or invalid credentials · 스키마: Error

{
  "error": {
    "code": "unauthenticated",
    "message": "unauthenticated"
  }
}

응답 403

호출자가 이 조직에 대한 필수 권한이 없거나, 조직이 governance를 사용할 자격이 없음. 스키마: Error

{
  "error": {
    "code": "permission_denied",
    "message": "permission denied"
  }
}

응답 404

Not found · 스키마: Error

{
  "error": {
    "code": "not_found",
    "message": "policy not found"
  }
}

응답 500

Internal server error · 스키마: Error

{
  "error": {
    "code": "internal",
    "message": "internal error"
  }
}

참조 스키마

#/components/schemas/PolicySummary

요청 예시

curl \
  --request GET \
  --header "Authorization: Bearer ***" \
  --header 'Accept: application/json' \
  'https://hub.docker.com/v2/orgs//governance/policies'