Merge pull request #3322 from pettibon/acm-examples

justindho · web-flow · commit 23fd6cddd834 · 2022-05-17T13:55:21.000-06:00
Updating update-certificate-options.rst
diff --git a/awscli/examples/acm/add-tags-to-certificate.rst b/awscli/examples/acm/add-tags-to-certificate.rst
@@ -2,6 +2,6 @@
 
 The following ``add-tags-to-certificate`` command adds two tags to the specified certificate. Use a space to separate multiple tags::
 
-  aws acm add-tags-to-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website
+  aws acm add-tags-to-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website
 
 
diff --git a/awscli/examples/acm/delete-certificate.rst b/awscli/examples/acm/delete-certificate.rst
@@ -2,4 +2,4 @@
 
 The following ``delete-certificate`` command deletes the certificate with the specified ARN::
 
-  aws acm delete-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
+  aws acm delete-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012
diff --git a/awscli/examples/acm/describe-certificate.rst b/awscli/examples/acm/describe-certificate.rst
@@ -2,13 +2,13 @@
 
 The following ``describe-certificate`` command retrieves all of the fields for the certificate with the specified ARN::
 
-  aws acm describe-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
+  aws acm describe-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012
  
 Output similar to the following is displayed::
 
   {
     "Certificate": {
-      "CertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012", 
+      "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", 
       "CreatedAt": 1446835267.0, 
       "DomainName": "www.example.com", 
       "DomainValidationOptions": [
diff --git a/awscli/examples/acm/export-certificate.rst b/awscli/examples/acm/export-certificate.rst
@@ -0,0 +1,9 @@
+**To export a private certificate issued by a private CA.**
+
+The following ``export-certificate`` command exports a private certificate, certificate chain, and private key to your display::
+
+  aws acm export-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --passphrase file://path-to-passphrase-file
+
+To export the certificate, chain, and private key to a local file, use the following command::
+
+  aws acm export-certificate --certificate-arn arn:aws:acm:region:sccount:certificate/12345678-1234-1234-1234-123456789012 --passphrase file://path-to-passphrase-file > c:\temp\export.txt
diff --git a/awscli/examples/acm/get-certificate.rst b/awscli/examples/acm/get-certificate.rst
@@ -2,7 +2,7 @@
 
 The following ``get-certificate`` command retrieves the certificate for the specified ARN and the certificate chain::
 
-  aws acm get-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
+  aws acm get-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012
 
 Output similar to the following is displayed::
 
diff --git a/awscli/examples/acm/import-certificate.rst b/awscli/examples/acm/import-certificate.rst
@@ -0,0 +1,5 @@
+**To import a certificate into ACM.**
+
+The following ``import-certificate`` command imports a certificate into ACM. Replace the file names with your own::
+
+  aws acm import-certificate --certificate file://Certificate.pem --certificate-chain file://CertificateChain.pem --private-key file://PrivateKey.pem
diff --git a/awscli/examples/acm/list-certificates.rst b/awscli/examples/acm/list-certificates.rst
@@ -9,11 +9,11 @@ The preceding command produces output similar to the following::
   {
       "CertificateSummaryList": [
           {
-              "CertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012", 
+              "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", 
               "DomainName": "www.example.com"
           }, 
           {
-              "CertificateArn": "arn:aws:acm:us-east-1:493619779192:certificate/87654321-4321-4321-4321-210987654321", 
+              "CertificateArn": "arn:aws:acm:region:account:certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", 
               "DomainName": "www.example.net"
           }
       ]
@@ -27,13 +27,13 @@ Two certificate ARNs and a ``NextToken`` value will be displayed::
 
   "CertificateSummaryList": [
     {
-      "CertificateArn": "arn:aws:acm:us-east-1:123456789012: \
+      "CertificateArn": "arn:aws:acm:region:account: \
               certificate/12345678-1234-1234-1234-123456789012", 
       "DomainName": "www.example.com"
     }, 
     {
-      "CertificateArn": "arn:aws:acm:us-east-1:123456789012: \
-              certificate/87654321-4321-4321-4321-210987654321", 
+      "CertificateArn": "arn:aws:acm:region:account: \
+               certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", 
       "DomainName": "www.example.net"
     }
     ], 
diff --git a/awscli/examples/acm/list-tags-for-certificate.rst b/awscli/examples/acm/list-tags-for-certificate.rst
@@ -2,7 +2,7 @@
 
 The following ``list-tags-for-certificate`` command lists the tags applied to a certificate in your account::
 
-  aws acm list-tags-for-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
+  aws acm list-tags-for-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012
 
 The preceding command produces output similar to the following::
 
diff --git a/awscli/examples/acm/remove-tags-from-certificate.rst b/awscli/examples/acm/remove-tags-from-certificate.rst
@@ -2,6 +2,6 @@
 
 The following ``remove-tags-from-certificate`` command removes two tags from the specified certificate. Use a space to separate multiple tags::
 
-  aws acm remove-tags-from-certificate --certificate-arn arn:aws:acm:us-east-1:1234567890122:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website
+  aws acm remove-tags-from-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website
 
 
diff --git a/awscli/examples/acm/resend-validation-email.rst b/awscli/examples/acm/resend-validation-email.rst
@@ -2,4 +2,4 @@
 
 The following ``resend-validation-email`` command tells the Amazon certificate authority to send validation email to the appropriate addresses::
 
-  aws acm resend-validation-email --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 --domain www.example.com --validation-domain example.com
+  aws acm resend-validation-email --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --domain www.example.com --validation-domain example.com

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,6 @@`
`2`	`2`
`3`	`3`	The following ``add-tags-to-certificate`` command adds two tags to the specified certificate. Use a space to separate multiple tags::
`4`	`4`
`5`		`- aws acm add-tags-to-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website`
	`5`	`+ aws acm add-tags-to-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website`
`6`	`6`
`7`	`7`
Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,4 @@`
`2`	`2`
`3`	`3`	The following ``delete-certificate`` command deletes the certificate with the specified ARN::
`4`	`4`
`5`		`- aws acm delete-certificate --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012`
	`5`	`+ aws acm delete-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012`
Original file line number	Diff line number	Diff line change
`@@ -9,11 +9,11 @@ The preceding command produces output similar to the following::`
`9`	`9`	`{`
`10`	`10`	`"CertificateSummaryList": [`
`11`	`11`	`{`
`12`		`- "CertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012",`
	`12`	`+ "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012",`
`13`	`13`	`"DomainName": "www.example.com"`
`14`	`14`	`},`
`15`	`15`	`{`
`16`		`- "CertificateArn": "arn:aws:acm:us-east-1:493619779192:certificate/87654321-4321-4321-4321-210987654321",`
	`16`	`+ "CertificateArn": "arn:aws:acm:region:account:certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",`
`17`	`17`	`"DomainName": "www.example.net"`
`18`	`18`	`}`
`19`	`19`	`]`
@@ -27,13 +27,13 @@ Two certificate ARNs and a ``NextToken`` value will be displayed::
`27`	`27`
`28`	`28`	`"CertificateSummaryList": [`
`29`	`29`	`{`
`30`		`- "CertificateArn": "arn:aws:acm:us-east-1:123456789012: \`
	`30`	`+ "CertificateArn": "arn:aws:acm:region:account: \`
`31`	`31`	`certificate/12345678-1234-1234-1234-123456789012",`
`32`	`32`	`"DomainName": "www.example.com"`
`33`	`33`	`},`
`34`	`34`	`{`
`35`		`- "CertificateArn": "arn:aws:acm:us-east-1:123456789012: \`
`36`		`- certificate/87654321-4321-4321-4321-210987654321",`
	`35`	`+ "CertificateArn": "arn:aws:acm:region:account: \`
	`36`	`+ certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",`
`37`	`37`	`"DomainName": "www.example.net"`
`38`	`38`	`}`
`39`	`39`	`],`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,6 @@`
`2`	`2`
`3`	`3`	The following ``remove-tags-from-certificate`` command removes two tags from the specified certificate. Use a space to separate multiple tags::
`4`	`4`
`5`		`- aws acm remove-tags-from-certificate --certificate-arn arn:aws:acm:us-east-1:1234567890122:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website`
	`5`	`+ aws acm remove-tags-from-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website`
`6`	`6`
`7`	`7`
Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,4 @@`
`2`	`2`
`3`	`3`	The following ``resend-validation-email`` command tells the Amazon certificate authority to send validation email to the appropriate addresses::
`4`	`4`
`5`		`- aws acm resend-validation-email --certificate-arn arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 --domain www.example.com --validation-domain example.com`
	`5`	`+ aws acm resend-validation-email --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --domain www.example.com --validation-domain example.com`