AWS code-library documentation change
Summary
Added PowerShell V5 examples for ListCertificates operation
Security assessment
Examples for listing certificates aid in inventory management (security hygiene) but do not address a specific security issue.
Diff
diff --git a/code-library/latest/ug/acm_example_acm_ListCertificates_section.md b/code-library/latest/ug/acm_example_acm_ListCertificates_section.md index 2f8bc6d97..da4bf70fd 100644 --- a//code-library/latest/ug/acm_example_acm_ListCertificates_section.md +++ b//code-library/latest/ug/acm_example_acm_ListCertificates_section.md @@ -345,0 +346,47 @@ PowerShell +**Tools for PowerShell V5** + + +**Example 1: Retrieves a list of all your certificate ARNs and the domain name for each. The cmdlet will automatically paginate to retrieve all the ARNs. To manually control pagination, use the -MaxItem parameter to control how many certificate ARNs are returned for each service call and the -NextToken parameter to indicate the starting point for each call.** + + + Get-ACMCertificateList + + +**Output:** + + + CertificateArn DomainName + -------------- ---------- + arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com + +**Example 2: Retrieves a list of all your certificate ARNs where the certificate status matches on the supplied states.** + + + Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED" + + +**Example 3: This example returns a list of all certificates in the us-east-1 region that have a key type of RSA_2048, and an extended key usage, or purpose, of CODE_SIGNING. You can find the values for these filtering parameters in the ListCertificates Filters API reference topic: https://docs.aws.amazon.com/acm/latest/APIReference/API_Filters.html.** + + + Get-ACMCertificateList -Region us-east-1 -Includes_KeyType RSA_2048 -Includes_ExtendedKeyUsage CODE_SIGNING + + +**Output:** + + + CertificateArn DomainName + -------------- ---------- + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-d7c0-48c1-af8d-2133d8f30zzz *.route53docs.com + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-98a5-443d-a734-800430c80zzz nerdzizm.net + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-2be6-4376-8fa7-bad559525zzz + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-e7ca-44c5-803e-24d9f2f36zzz + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-1241-4b71-80b1-090305a62zzz + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-8709-4568-8c64-f94617c99zzz + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-a8fa-4a61-98cf-e08ccc0eezzz + arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-fa47-40fe-a714-2d277d3eezzz *.route53docs.com + + * For API details, see [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference) in _AWS Tools for PowerShell Cmdlet Reference (V5)_. + + + +