AWS code-library documentation change
Summary
Removed 'Get started' section containing Java, JavaScript, and Python code examples for listing SSM documents
Security assessment
The change removes general code examples demonstrating how to list SSM documents. There is no evidence of security vulnerability remediation, security incident reference, or security feature documentation. The removed content appears to be routine API usage examples without security implications.
Diff
diff --git a/code-library/latest/ug/ssm_code_examples.md b/code-library/latest/ug/ssm_code_examples.md index d85e0ce57..ca686ad4f 100644 --- a//code-library/latest/ug/ssm_code_examples.md +++ b//code-library/latest/ug/ssm_code_examples.md @@ -28,180 +27,0 @@ _Actions_ are code excerpts from larger programs and must be run in context. Whi -**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_. - - - -