docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

ENGDOCS-2325 (#21500) 

## Description
We received Hotjar feedback that the new DCP pricing email caused
confusion about Docker Hub usage, storage, pulls. To clarify:
- I updated the usage definition to define usage as 1. Pulls 2. Storage
- I updated the Rate limiting section to clarify that rate limiting only
applies to pulls (confirmed with @sheltongraves)

## Related issues or tickets
ENGDOCS-2325

## Reviews
- [ ] Technical review
- [ ] Editorial review
This commit is contained in:
Sarah Sanders 2024-11-26 07:57:41 -08:00 committed by GitHub
parent adab458ae6
commit 3b4c9ae6dd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 25 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
content/manuals/docker-hub/download-rate-limit.md
View File

@ -14,8 +14,9 @@ manage your and your organization's usage effectively.
## Usage ## Usage
Usage refers to the amount of data transferred from Docker Hub and the amount of Usage refers to both:
data stored on Docker Hub. - Pulls: The amount of data transferred from Docker Hub
- Storage: The amount of data stored on Docker Hub
### Fair use ### Fair use
@ -27,23 +28,35 @@ exhibiting excessive data and storage consumption.
### View Docker Hub usage ### View Docker Hub usage
You can download a CSV file of your or your organization's Docker Hub usage. To 1. Sign in to [Docker Hub](https://hub.docker.com).
download the file:
If you want to download usage for all members of an organization, you must
sign in to an account that is an owner for that organization. Otherwise,
you can only view your own personal usage.
2. In Docker Hub, select **Usage** from the top-level navigation menu.
3. In the drop-down, select whether you want to view your personal or organization data.
4. The usage page displays **Pulls** and **Storage** usage.
5. Select a usage type and use the available filters to view usage.
### Download Docker Hub usage
You can download a CSV file of your or your organization's Docker Hub usage. To download the file:
1. Sign in to [Docker Hub](https://hub.docker.com). 1. Sign in to [Docker Hub](https://hub.docker.com).
If you want to download usage for all members of an organization, you must If you want to download usage for all members of an organization, you must
sign in to an account that is an owner for that organization. Otherwise, sign in to an account that is an owner for that organization. Otherwise,
you can only view your own usage. you can only view your own personal usage.
2. In Docker Hub, navigate to the [**Usage** page](https://hub.docker.com/usage). 2. In Docker Hub, select **Usage** from the top-level navigation menu.
3. In the drop-down, select whether to download your personal data or 3. In the drop-down, select whether you want to view your personal or organization data.
data for an organization. 4. Optional. Use the **Filter by privacy** drop-down to select **Public** or **Private** pulls.
4. In **From** and **To**, select a date range for the data. 5. Use the **From** and **To** filters to select a date range for the data.
5. Select **Send report to email** to have Docker email you a link to the data 6. Select **Send report to email** to have Docker email you a link to the data
file. Note that email processing time may vary. file. Note that email processing time may vary.
The file contains the following comma separated values. The file contains the following comma separated values:
| CSV column | Definition | Usage guidance | | CSV column | Definition | Usage guidance |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@ -125,9 +138,7 @@ If the user is part of multiple organizations under the company, the pull is att
## Rate limit ## Rate limit
A user's rate limit is equal to the highest entitlement of their personal Rate limits apply to pull usage. A user's rate limit is equal to the highest entitlement of their personal account or any organization they belong to. To take advantage of this, you must sign in to [Docker Hub](https://hub.docker.com/) as an authenticated user. For
account or any organization they belong to. To take advantage of this, you must
sign in to [Docker Hub](https://hub.docker.com/) as an authenticated user. For
more information, see [How do I authenticate pull more information, see [How do I authenticate pull
requests](#how-do-i-authenticate-pull-requests). Unauthenticated (anonymous) requests](#how-do-i-authenticate-pull-requests). Unauthenticated (anonymous)
users will have the limits enforced via IP. users will have the limits enforced via IP.