From e14e0a04d9cb5585c3283c54cb4fb12cd18e8db8 Mon Sep 17 00:00:00 2001
From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com>
Date: Thu, 19 Oct 2023 13:22:20 +0000
Subject: [PATCH] s3_object - remove docs for create/delete bucket. (#1800)
 (#1812)

[PR #1800/0156ebc1 backport][stable-6] s3_object - remove docs for create/delete bucket.

This is a backport of PR #1800 as merged into main (0156ebc).
SUMMARY
We dropped support for creating/deleting buckets through s3_object.
ISSUE TYPE

Docs Pull Request

COMPONENT NAME
s3_object
ADDITIONAL INFORMATION

Reviewed-by: Mark Chappell
---
 changelogs/fragments/1799-s3_object-bucket.yml |  2 ++
 plugins/modules/s3_object.py                   | 18 ------------------
 2 files changed, 2 insertions(+), 18 deletions(-)
 create mode 100644 changelogs/fragments/1799-s3_object-bucket.yml

diff --git a/changelogs/fragments/1799-s3_object-bucket.yml b/changelogs/fragments/1799-s3_object-bucket.yml
new file mode 100644
index 00000000000..cd905b66200
--- /dev/null
+++ b/changelogs/fragments/1799-s3_object-bucket.yml
@@ -0,0 +1,2 @@
+trivial:
+- s3_object - Remove examples for creating/deleting buckets - support removed in 6.0.0.
diff --git a/plugins/modules/s3_object.py b/plugins/modules/s3_object.py
index 84f2c0c7b5c..b7ab78e46f3 100644
--- a/plugins/modules/s3_object.py
+++ b/plugins/modules/s3_object.py
@@ -330,24 +330,6 @@
     marker: /my/desired/0023.txt
     max_keys: 472
 
-- name: Create an empty bucket
-  amazon.aws.s3_object:
-    bucket: mybucket
-    mode: create
-    permission: public-read
-
-- name: Create a bucket with key as directory, in the EU region
-  amazon.aws.s3_object:
-    bucket: mybucket
-    object: /my/directory/path
-    mode: create
-    region: eu-west-1
-
-- name: Delete a bucket and all contents
-  amazon.aws.s3_object:
-    bucket: mybucket
-    mode: delete
-
 - name: GET an object but don't download if the file checksums match. New in 2.0
   amazon.aws.s3_object:
     bucket: mybucket