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

View File

@ -14,8 +14,9 @@ manage your and your organization's usage effectively.
## Usage
Usage refers to the amount of data transferred from Docker Hub and the amount of
data stored on Docker Hub.
Usage refers to both:
- Pulls: The amount of data transferred from Docker Hub
- Storage: The amount of data stored on Docker Hub
### Fair use
@ -27,23 +28,35 @@ exhibiting excessive data and storage consumption.
### View 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).
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).
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 usage.
you can only view your own personal usage.
2. In Docker Hub, navigate to the [**Usage** page](https://hub.docker.com/usage).
3. In the drop-down, select whether to download your personal data or
data for an organization.
4. In **From** and **To**, select a date range for the data.
5. Select **Send report to email** to have Docker email you a link to the data
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. Optional. Use the **Filter by privacy** drop-down to select **Public** or **Private** pulls.
5. Use the **From** and **To** filters to select a date range for 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.
The file contains the following comma separated values.
The file contains the following comma separated values:
| 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
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
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
more information, see [How do I authenticate pull
requests](#how-do-i-authenticate-pull-requests). Unauthenticated (anonymous)
users will have the limits enforced via IP.