Docker DVP(Publisher analytics) API 1.0.0

Docker DVP(Data Verified Publisher) 데이터 API는 Docker Verified Publisher가 자기 네임스페이스의 이미지 풀(pull) 분석 데이터를 조회할 수 있게 해 주는 API예요. 분석 데이터는 원시(raw) 데이터 또는 요약(summary) 형식의 CSV로 받을 수 있어요.

출처: 문서

본문

개요

Docker DVP 데이터 API는 Docker Verified Publishers가 자기 네임스페이스의 이미지 풀 분석 데이터를 조회할 수 있게 해 줘요. 분석 데이터는 원시 데이터로 CSV를 받을 수도 있고, 요약 형식으로 받을 수도 있어요.

요약 데이터

요약 데이터 CSV에서는 아래 나열된 데이터 포인트를 확인할 수 있어요. 요약 데이터는 한 주(월요일~일요일) 또는 한 달(다음 달 1일부터 조회 가능) 단위로 요청할 수 있어요.

요약 데이터는 두 단계로 나뉘어요.

리포지토리 단위: 모든 네임스페이스와 리포지토리의 요약
태그 또는 다이제스트 단위: 모든 네임스페이스, 리포지토리, 레퍼런스(태그 또는 다이제스트)의 요약

요약 데이터 형식에는 다음 데이터 포인트가 포함돼요.

고유 IP 주소 수
태그별 풀 수
다이제스트별 풀 수
버전 확인 수

원시 데이터

원시 데이터 CSV에서 아래 나열된 데이터 포인트를 확인할 수 있어요. 원시 데이터는 한 주 또는 한 달 단위로 요청할 수 있어요. 참고: 각 동작(action)은 한 행(row)으로 표현돼요.

Type (산업)
Host (클라우드 제공자)
Country (지리 정보)
Timestamp
Namespace
Repository
Reference (다이제스트는 항상 포함되고, 태그는 가능할 때 제공돼요)
HTTP 요청 메서드
Action, 다음 중 하나:
- Pull by tag
- Pull by digest
- Version check
User-Agent

Publisher analytics API에 연결하기

Docker Hub 인증

Docker DVP 데이터 API에 접근하려면 JWT Bearer 인증이 필요해요. 이 인증 문서는 Hub API 인증 문서에서 가져온 내용이에요.

Server: https://hub.docker.com/api/publisher/analytics/v1

Operations

GET /: Get namespaces and repos
GET /namespaces: Get user's namespaces
GET /namespaces/{namespace}: Get namespace
GET /namespaces/{namespace}/pulls: Get pull data
GET /namespaces/{namespace}/pulls/exports/years: Get years with data
GET /namespaces/{namespace}/pulls/exports/years/{year}/{timespantype}: Get timespans with data
GET /namespaces/{namespace}/pulls/exports/years/{year}/{timespantype}/{timespan}: Get namespace metadata for timespan
GET /namespaces/{namespace}/pulls/exports/years/{year}/{timespantype}/{timespan}/{dataview}: Get namespace data for timespan
GET /namespaces/{namespace}/repos/{repo}/pulls: Get pull data
GET /repos/pulls: Get pull data for multiple repos
POST /v2/users/2fa-login: Second factor authentication
POST /v2/users/login: Create an authentication token

Docker DVP(Publisher analytics) API 1.0.0