AWS systems-manager documentation change
Summary
Removed all code examples for ListDocuments API across Java, JavaScript, and Python SDKs including implementation details and usage instructions
Security assessment
The change removes non-security-related code examples without any mention of vulnerabilities, security patches, or weaknesses. This appears to be general documentation cleanup with no security implications.
Diff
diff --git a/systems-manager/latest/userguide/service_code_examples.md b/systems-manager/latest/userguide/service_code_examples.md index ec94635aa..acb861c22 100644 --- a//systems-manager/latest/userguide/service_code_examples.md +++ b//systems-manager/latest/userguide/service_code_examples.md @@ -17,180 +16,0 @@ For a complete list of AWS SDK developer guides and code examples, see [Using th -**Get started** - -The following code examples show how to get started using Systems Manager. - -Java - - -**SDK for Java 2.x** - - -###### Note - -There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ssm#code-examples). - - - import software.amazon.awssdk.regions.Region; - import software.amazon.awssdk.services.ssm.SsmClient; - import software.amazon.awssdk.services.ssm.model.DocumentFilter; - import software.amazon.awssdk.services.ssm.model.ListDocumentsRequest; - import software.amazon.awssdk.services.ssm.model.ListDocumentsResponse; - - public class HelloSSM { - - public static void main(String[] args) { - final String usage = """ - - Usage: - <awsAccount> - - Where: - awsAccount - Your AWS Account number. - """; - - if (args.length != 1) { - System.out.println(usage); - System.exit(1); - } - - String awsAccount = args[0] ; - Region region = Region.US_EAST_1; - SsmClient ssmClient = SsmClient.builder() - .region(region) - .build(); - - listDocuments(ssmClient, awsAccount); - } - - /* - This code automatically fetches the next set of results using the `nextToken` and - stops once the desired maxResults (20 in this case) have been reached. - */ - public static void listDocuments(SsmClient ssmClient, String awsAccount) { - String nextToken = null; - int totalDocumentsReturned = 0; - int maxResults = 20; - do { - ListDocumentsRequest request = ListDocumentsRequest.builder() - .documentFilterList( - DocumentFilter.builder() - .key("Owner") - .value(awsAccount) - .build() - ) - .maxResults(maxResults) - .nextToken(nextToken) - .build(); - - ListDocumentsResponse response = ssmClient.listDocuments(request); - response.documentIdentifiers().forEach(identifier -> System.out.println("Document Name: " + identifier.name())); - nextToken = response.nextToken(); - totalDocumentsReturned += response.documentIdentifiers().size(); - } while (nextToken != null && totalDocumentsReturned < maxResults); - } - } - - - - * For API details, see [ListDocuments](https://docs.aws.amazon.com/goto/SdkForJavaV2/ssm-2014-11-06/ListDocuments) in _AWS SDK for Java 2.x API Reference_. - - - - -JavaScript - - -**SDK for JavaScript (v3)** - - -###### Note - -There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/ssm#code-examples). - - - import { paginateListDocuments, SSMClient } from "@aws-sdk/client-ssm"; - - // Call ListDocuments and display the result. - export const main = async () => { - const client = new SSMClient(); - const listDocumentsPaginated = []; - console.log( - "Hello, AWS Systems Manager! Let's list some of your documents:\n", - ); - try { - // The paginate function is a wrapper around the base command. - const paginator = paginateListDocuments({ client }, { MaxResults: 5 }); - for await (const page of paginator) { - listDocumentsPaginated.push(...page.DocumentIdentifiers); - } - } catch (caught) { - console.error(`There was a problem saying hello: ${caught.message}`); - throw caught; - } - - for (const { Name, DocumentFormat, CreatedDate } of listDocumentsPaginated) { - console.log(`${Name} - ${DocumentFormat} - ${CreatedDate}`); - } - }; - - // Call function if run directly. - import { fileURLToPath } from "node:url"; - if (process.argv[1] === fileURLToPath(import.meta.url)) { - main(); - } - - - - * For API details, see [ListDocuments](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/ListDocumentsCommand) in _AWS SDK for JavaScript API Reference_. - - - - -Python - - -**SDK for Python (Boto3)** - - -###### Note - -There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/ssm#code-examples). - - - import boto3 - from botocore.exceptions import ClientError - - - def hello_systems_manager(ssm_client): - """ - Use the AWS SDK for Python (Boto3) to create an AWS Systems Manager - client and list the first 5 documents in your account. - This example uses the default settings specified in your shared credentials - and config files. - - :param ssm_client: A Boto3 AWS Systems Manager Client object. This object wraps - the low-level AWS Systems Manager service API. - """ - print("Hello, AWS Systems Manager! Let's list some of your documents:\n") - - paginator = ssm_client.get_paginator("list_documents") - page_iterator = paginator.paginate(PaginationConfig={"MaxItems": 5}) - for page in page_iterator: - for document in page["DocumentIdentifiers"]: - print(f" {document['Name']}") - - - if __name__ == "__main__": - try: - hello_systems_manager(boto3.client("ssm")) - except ClientError as err: - print("Hello systems manager had an error.") - print(err.response["Error"]["Code"]) - print(err.response["Error"]["Message"]) - - - - * For API details, see [ListDocuments](https://docs.aws.amazon.com/goto/boto3/ssm-2014-11-06/ListDocuments) in _AWS SDK for Python (Boto3) API Reference_. - - - -