From 3b4c9ae6dde8bb0e641ab58e0e3de3a7f1397fa1 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Tue, 26 Nov 2024 07:57:41 -0800 Subject: [PATCH] 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 --- .../manuals/docker-hub/download-rate-limit.md | 39 ++++++++++++------- 1 file changed, 25 insertions(+), 14 deletions(-) diff --git a/content/manuals/docker-hub/download-rate-limit.md b/content/manuals/docker-hub/download-rate-limit.md index da01d742a3..41672c674e 100644 --- a/content/manuals/docker-hub/download-rate-limit.md +++ b/content/manuals/docker-hub/download-rate-limit.md @@ -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.