GitHub Actions 캐시

REST API를 사용하여 GitHub Actions의 리포지토리에 대한 캐시와 상호 작용합니다.

GitHub Actions의 캐시 정보

REST API를 사용하여 GitHub Actions에서 리포지토리에 대한 캐시를 쿼리하고 관리할 수 있습니다. GitHub CLI 확장을 설치하여 명령줄에서 캐시를 관리할 수도 있습니다. 자세한 내용은 "워크플로 속도를 높이기 위한 종속성 캐싱.

Get GitHub Actions cache usage for an enterprise

Gets the total GitHub Actions cache usage for an enterprise. The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

"Get GitHub Actions cache usage for an enterprise"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`enterprise`string필수 The slug version of the enterprise name. You can also substitute this value with the enterprise id.

"Get GitHub Actions cache usage for an enterprise"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Get GitHub Actions cache usage for an enterprise"에 대한 코드 샘플

get/enterprises/{enterprise}/actions/cache/usage

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/cache/usage

Response

Status: 200

{
  "total_active_caches_size_in_bytes": 3344284,
  "total_active_caches_count": 5
}

Get GitHub Actions cache usage policy for an enterprise

Gets the GitHub Actions cache usage policy for an enterprise. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

"Get GitHub Actions cache usage policy for an enterprise"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`enterprise`string필수 The slug version of the enterprise name. You can also substitute this value with the enterprise id.

"Get GitHub Actions cache usage policy for an enterprise"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Get GitHub Actions cache usage policy for an enterprise"에 대한 코드 샘플

get/enterprises/{enterprise}/actions/cache/usage-policy

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/cache/usage-policy

Response

Status: 200

{
  "repo_cache_size_limit_in_gb": 10,
  "max_repo_cache_size_limit_in_gb": 15
}

Set GitHub Actions cache usage policy for an enterprise

Sets the GitHub Actions cache usage policy for an enterprise. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

"Set GitHub Actions cache usage policy for an enterprise"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`enterprise`string필수 The slug version of the enterprise name. You can also substitute this value with the enterprise id.
본문 매개 변수
속성, 형식, Description
`repo_cache_size_limit_in_gb`integer For repositories in an enterprise, the default size limit for the sum of all caches in a repository, in gigabytes.
`max_repo_cache_size_limit_in_gb`integer For repositories in an enterprise, the maximum value that can be set as the limit for the sum of all caches in a repository, in gigabytes.

"Set GitHub Actions cache usage policy for an enterprise"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`204`	No Content

"Set GitHub Actions cache usage policy for an enterprise"에 대한 코드 샘플

patch/enterprises/{enterprise}/actions/cache/usage-policy

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/cache/usage-policy \
  -d '{"repo_cache_size_limit_in_gb":10,"max_repo_cache_size_limit_in_gb":15}'

Response

Status: 204

Get GitHub Actions cache usage for an organization

에서 작동 GitHub Apps

Gets the total GitHub Actions cache usage for an organization. The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated. You must authenticate using an access token with the read:org scope to use this endpoint. GitHub Apps must have the organization_admistration:read permission to use this endpoint.

"Get GitHub Actions cache usage for an organization"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`org`string필수 The organization name. The name is not case sensitive.

"Get GitHub Actions cache usage for an organization"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Get GitHub Actions cache usage for an organization"에 대한 코드 샘플

get/orgs/{org}/actions/cache/usage

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/orgs/ORG/actions/cache/usage

Response

Status: 200

{
  "total_active_caches_size_in_bytes": 3344284,
  "total_active_caches_count": 5
}

List repositories with GitHub Actions cache usage for an organization

에서 작동 GitHub Apps

Lists repositories and their GitHub Actions cache usage for an organization. The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated. You must authenticate using an access token with the read:org scope to use this endpoint. GitHub Apps must have the organization_admistration:read permission to use this endpoint.

"List repositories with GitHub Actions cache usage for an organization"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`org`string필수 The organization name. The name is not case sensitive.
쿼리 매개 변수
속성, 형식, Description
`per_page`integer The number of results per page (max 100). 기본값: `30`
`page`integer Page number of the results to fetch. 기본값: `1`

"List repositories with GitHub Actions cache usage for an organization"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"List repositories with GitHub Actions cache usage for an organization"에 대한 코드 샘플

get/orgs/{org}/actions/cache/usage-by-repository

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/orgs/ORG/actions/cache/usage-by-repository

Response

Status: 200

{
  "total_count": 2,
  "repository_cache_usages": [
    {
      "full_name": "octo-org/Hello-World",
      "active_caches_size_in_bytes": 2322142,
      "active_caches_count": 3
    },
    {
      "full_name": "octo-org/server",
      "active_caches_size_in_bytes": 1022142,
      "active_caches_count": 2
    }
  ]
}

Get GitHub Actions cache usage for a repository

에서 작동 GitHub Apps

Gets GitHub Actions cache usage for a repository. The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated. Anyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the repo scope. GitHub Apps must have the actions:read permission to use this endpoint.

"Get GitHub Actions cache usage for a repository"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.

"Get GitHub Actions cache usage for a repository"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Get GitHub Actions cache usage for a repository"에 대한 코드 샘플

get/repos/{owner}/{repo}/actions/cache/usage

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/cache/usage

Response

Status: 200

{
  "full_name": "octo-org/Hello-World",
  "active_caches_size_in_bytes": 2322142,
  "active_caches_count": 3
}

Get GitHub Actions cache usage policy for a repository

에서 작동 GitHub Apps

Gets GitHub Actions cache usage policy for a repository. You must authenticate using an access token with the repo scope to use this endpoint. GitHub Apps must have the actions:read permission to use this endpoint.

"Get GitHub Actions cache usage policy for a repository"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.

"Get GitHub Actions cache usage policy for a repository"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Get GitHub Actions cache usage policy for a repository"에 대한 코드 샘플

get/repos/{owner}/{repo}/actions/cache/usage-policy

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/cache/usage-policy

Response

Status: 200

{
  "repo_cache_size_limit_in_gb": 14
}

Set GitHub Actions cache usage policy for a repository

에서 작동 GitHub Apps

Sets GitHub Actions cache usage policy for a repository. You must authenticate using an access token with the repo scope to use this endpoint. GitHub Apps must have the actions:write permission to use this endpoint.

"Set GitHub Actions cache usage policy for a repository"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.
본문 매개 변수
속성, 형식, Description
`repo_cache_size_limit_in_gb`integer필수 The size limit for the sum of all caches, in gigabytes.

"Set GitHub Actions cache usage policy for a repository"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`204`	No Content

"Set GitHub Actions cache usage policy for a repository"에 대한 코드 샘플

patch/repos/{owner}/{repo}/actions/cache/usage-policy

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/cache/usage-policy \
  -d '{"repo_cache_size_limit_in_gb":14}'

Response

Status: 204

List GitHub Actions caches for a repository

에서 작동 GitHub Apps

Lists the GitHub Actions caches for a repository. You must authenticate using an access token with the repo scope to use this endpoint. GitHub Apps must have the actions:read permission to use this endpoint.

"List GitHub Actions caches for a repository"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.
쿼리 매개 변수
속성, 형식, Description
`per_page`integer The number of results per page (max 100). 기본값: `30`
`page`integer Page number of the results to fetch. 기본값: `1`
`ref`string The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/<branch name>`. To reference a pull request use `refs/pull/<number>/merge`.
`key`string An explicit key or prefix for identifying the cache
`sort`string The property to sort the results by. `created_at` means when the cache was created. `last_accessed_at` means when the cache was last accessed. `size_in_bytes` is the size of the cache in bytes. 기본값: `last_accessed_at` 다음 중 하나일 수 있습니다.: `created_at`, `last_accessed_at`, `size_in_bytes`
`direction`string The direction to sort the results by. 기본값: `desc` 다음 중 하나일 수 있습니다.: `asc`, `desc`

"List GitHub Actions caches for a repository"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"List GitHub Actions caches for a repository"에 대한 코드 샘플

get/repos/{owner}/{repo}/actions/caches

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/caches

Response

Status: 200

{
  "total_count": 1,
  "actions_caches": [
    {
      "id": 505,
      "ref": "refs/heads/main",
      "key": "Linux-node-958aff96db2d75d67787d1e634ae70b659de937b",
      "version": "73885106f58cc52a7df9ec4d4a5622a5614813162cb516c759a30af6bf56e6f0",
      "last_accessed_at": "2019-01-24T22:45:36.000Z",
      "created_at": "2019-01-24T22:45:36.000Z",
      "size_in_bytes": 1024
    }
  ]
}

Delete GitHub Actions caches for a repository (using a cache key)

에서 작동 GitHub Apps

Deletes one or more GitHub Actions caches for a repository, using a complete cache key. By default, all caches that match the provided key are deleted, but you can optionally provide a Git ref to restrict deletions to caches that match both the provided key and the Git ref.

You must authenticate using an access token with the repo scope to use this endpoint.

GitHub Apps must have the actions:write permission to use this endpoint.

"Delete GitHub Actions caches for a repository (using a cache key)"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.
쿼리 매개 변수
속성, 형식, Description
`key`string필수 A key for identifying the cache.
`ref`string The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/<branch name>`. To reference a pull request use `refs/pull/<number>/merge`.

"Delete GitHub Actions caches for a repository (using a cache key)"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`200`	OK

"Delete GitHub Actions caches for a repository (using a cache key)"에 대한 코드 샘플

delete/repos/{owner}/{repo}/actions/caches

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/caches?key=Linux-node-958aff96db2d75d67787d1e634ae70b659de937b

Response

Status: 200

{
  "total_count": 1,
  "actions_caches": [
    {
      "id": 505,
      "ref": "refs/heads/main",
      "key": "Linux-node-958aff96db2d75d67787d1e634ae70b659de937b",
      "version": "73885106f58cc52a7df9ec4d4a5622a5614813162cb516c759a30af6bf56e6f0",
      "last_accessed_at": "2019-01-24T22:45:36.000Z",
      "created_at": "2019-01-24T22:45:36.000Z",
      "size_in_bytes": 1024
    }
  ]
}

Delete a GitHub Actions cache for a repository (using a cache ID)

에서 작동 GitHub Apps

Deletes a GitHub Actions cache for a repository, using a cache ID.

You must authenticate using an access token with the repo scope to use this endpoint.

GitHub Apps must have the actions:write permission to use this endpoint.

"Delete a GitHub Actions cache for a repository (using a cache ID)"에 대한 매개 변수

헤더
속성, 형식, Description
`accept`string Setting to `application/vnd.github+json` is recommended.
경로 매개 변수
속성, 형식, Description
`owner`string필수 The account owner of the repository. The name is not case sensitive.
`repo`string필수 The name of the repository. The name is not case sensitive.
`cache_id`integer필수 The unique identifier of the GitHub Actions cache.

"Delete a GitHub Actions cache for a repository (using a cache ID)"에 대한 HTTP 응답 상태 코드

상태 코드	Description
`204`	No Content

"Delete a GitHub Actions cache for a repository (using a cache ID)"에 대한 코드 샘플

delete/repos/{owner}/{repo}/actions/caches/{cache_id}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/actions/caches/CACHE_ID

Response

Status: 204