update comments

illumio · Aug 6, 2024 · e860ee3 · e860ee3
1 parent a3de1e2
commit e860ee3
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 7 deletions.
diff --git a/api/schema/aws_account_resource.go b/api/schema/aws_account_resource.go
@@ -68,7 +68,7 @@ var (
 				},
 				"role_arn": StringResourceAttributeWithMode{
 					StringAttribute: resource_schema.StringAttribute{
-						Description: "Provider AWS role ARN.",
+						Description: "ARN of the AWS role to be assumed by CloudSecure to manage this account.",
 						Required:    true,
 					},
 					attributeWithMode: attributeWithMode{
@@ -77,16 +77,16 @@ var (
 				},
 				"management_account_id": StringResourceAttributeWithMode{
 					StringAttribute: resource_schema.StringAttribute{
-						Description: "Management account ID.",
-						Optional:    true,
+						MarkdownDescription: "AWS organization management account ID. If specified, `organization_id` must also be specified.",
+						Optional:            true,
 					},
 					attributeWithMode: attributeWithMode{
 						Mode: WriteOnlyOnceAttributeMode,
 					},
 				},
 				"organization_id": StringResourceAttributeWithMode{
 					StringAttribute: resource_schema.StringAttribute{
-						Description: "AWS organization ID.",
+						Description: "AWS organization ID. If specified, the whole AWS organization is onboarded instead of just the AWS account. If specified, `management_account_id` must also be specified.",
 						Optional:    true,
 					},
 					attributeWithMode: attributeWithMode{

diff --git a/docs/resources/aws_account.md b/docs/resources/aws_account.md
@@ -32,14 +32,14 @@ resource "illumio-cloudsecure_aws_account" "example" {
 - `account_id` (String) AWS account ID.
 - `account_type` (String) AWS account type.
 - `name` (String) Display name.
-- `role_arn` (String) Provider AWS role ARN.
+- `role_arn` (String) ARN of the AWS role to be assumed by CloudSecure to manage this account.
 - `service_account_id` (String) AWS service account ID.
 
 ### Optional
 
-- `management_account_id` (String) Management account ID.
+- `management_account_id` (String) AWS organization management account ID. If specified, `organization_id` must also be specified.
 - `mode` (String) Access mode.
-- `organization_id` (String) AWS organization ID.
+- `organization_id` (String) AWS organization ID. If specified, the whole AWS organization is onboarded instead of just the AWS account. If specified, `management_account_id` must also be specified.
 
 ### Read-Only