Documentation updates for AWS Organizations APIs.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/organizations/organizations-2016-11-28.api.json

@@ -1131,6 +1131,7 @@
         "Email":{"shape":"Email"},
         "Name":{"shape":"AccountName"},
         "Status":{"shape":"AccountStatus"},
+        "State":{"shape":"AccountState"},
         "JoinedMethod":{"shape":"AccountJoinedMethod"},
         "JoinedTimestamp":{"shape":"Timestamp"}
       }
@@ -1193,6 +1194,16 @@
       },
       "exception":true
     },
+    "AccountState":{
+      "type":"string",
+      "enum":[
+        "PENDING_ACTIVATION",
+        "ACTIVE",
+        "SUSPENDED",
+        "PENDING_CLOSURE",
+        "CLOSED"
+      ]
+    },
     "AccountStatus":{
       "type":"string",
       "enum":[

generator/ServiceModels/organizations/organizations-2016-11-28.docs.json

@@ -535,7 +535,7 @@
         {"shape":"UnsupportedAPIEndpointException"},
         {"shape":"PolicyChangesInProgressException"}
       ],
-      "documentation":"<p>Disables an organizational policy type in a root. A policy of a certain type can be attached to entities in a root only if that type is enabled in the root. After you perform this operation, you no longer can attach policies of the specified type to that root or to any organizational unit (OU) or account in that root. You can undo this by using the <a>EnablePolicyType</a> operation.</p> <p>This is an asynchronous request that Amazon Web Services performs in the background. If you disable a policy type for a root, it still appears enabled for the organization if <a href=\"https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html\">all features</a> are enabled for the organization. Amazon Web Services recommends that you first use <a>ListRoots</a> to see the status of policy types for a specified root, and then use this operation.</p> <p>This operation can be called only from the organization's management account or by a member account that is a delegated administrator.</p> <p> To view the status of available policy types in the organization, use <a>DescribeOrganization</a>.</p>"
+      "documentation":"<p>Disables an organizational policy type in a root. A policy of a certain type can be attached to entities in a root only if that type is enabled in the root. After you perform this operation, you no longer can attach policies of the specified type to that root or to any organizational unit (OU) or account in that root. You can undo this by using the <a>EnablePolicyType</a> operation.</p> <p>This is an asynchronous request that Amazon Web Services performs in the background. If you disable a policy type for a root, it still appears enabled for the organization if <a href=\"https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html\">all features</a> are enabled for the organization. Amazon Web Services recommends that you first use <a>ListRoots</a> to see the status of policy types for a specified root, and then use this operation.</p> <p>This operation can be called only from the organization's management account or by a member account that is a delegated administrator.</p> <p> To view the status of available policy types in the organization, use <a>ListRoots</a>.</p>"
     },
     "EnableAWSServiceAccess":{
       "name":"EnableAWSServiceAccess",
@@ -598,7 +598,7 @@
         {"shape":"UnsupportedAPIEndpointException"},
         {"shape":"PolicyChangesInProgressException"}
       ],
-      "documentation":"<p>Enables a policy type in a root. After you enable a policy type in a root, you can attach policies of that type to the root, any organizational unit (OU), or account in that root. You can undo this by using the <a>DisablePolicyType</a> operation.</p> <p>This is an asynchronous request that Amazon Web Services performs in the background. Amazon Web Services recommends that you first use <a>ListRoots</a> to see the status of policy types for a specified root, and then use this operation.</p> <p>This operation can be called only from the organization's management account or by a member account that is a delegated administrator.</p> <p>You can enable a policy type in a root only if that policy type is available in the organization. To view the status of available policy types in the organization, use <a>DescribeOrganization</a>.</p>"
+      "documentation":"<p>Enables a policy type in a root. After you enable a policy type in a root, you can attach policies of that type to the root, any organizational unit (OU), or account in that root. You can undo this by using the <a>DisablePolicyType</a> operation.</p> <p>This is an asynchronous request that Amazon Web Services performs in the background. Amazon Web Services recommends that you first use <a>ListRoots</a> to see the status of policy types for a specified root, and then use this operation.</p> <p>This operation can be called only from the organization's management account or by a member account that is a delegated administrator.</p> <p>You can enable a policy type in a root only if that policy type is available in the organization. To view the status of available policy types in the organization, use <a>ListRoots</a>.</p>"
     },
     "InviteAccountToOrganization":{
       "name":"InviteAccountToOrganization",
@@ -1210,7 +1210,11 @@
         },
         "Status":{
           "shape":"AccountStatus",
-          "documentation":"<p>The status of the account in the organization.</p>"
+          "documentation":"<p>The status of the account in the organization.</p> <important> <p>The <code>Status</code> parameter in the <code>Account</code> object will be retired on September 9, 2026. Although both the account <code>State</code> and account <code>Status</code> parameters are currently available in the Organizations APIs (<code>DescribeAccount</code>, <code>ListAccounts</code>, <code>ListAccountsForParent</code>), we recommend that you update your scripts or other code to use the <code>State</code> parameter instead of <code>Status</code> before September 9, 2026.</p> </important>"
+        },
+        "State":{
+          "shape":"AccountState",
+          "documentation":"<p>Each state represents a specific phase in the account lifecycle. Use this information to manage account access, automate workflows, or trigger actions based on account state changes.</p> <p>For more information about account states and their implications, see <a href=\"https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_account_state.html\">Monitor the state of your Amazon Web Services accounts </a> in the <i>Organizations User Guide</i>.</p>"
         },
         "JoinedMethod":{
           "shape":"AccountJoinedMethod",
@@ -1286,6 +1290,16 @@
       "documentation":"<p>You can't invite an existing account to your organization until you verify that you own the email address associated with the management account. For more information, see <a href=\"https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_create.html#about-email-verification\">Email address verification</a> in the <i>Organizations User Guide</i>.</p>",
       "exception":true
     },
+    "AccountState":{
+      "type":"string",
+      "enum":[
+        "PENDING_ACTIVATION",
+        "ACTIVE",
+        "SUSPENDED",
+        "PENDING_CLOSURE",
+        "CLOSED"
+      ]
+    },
     "AccountStatus":{
       "type":"string",
       "enum":[
@@ -1853,7 +1867,7 @@
       "members":{
         "Account":{
           "shape":"Account",
-          "documentation":"<p>A structure that contains information about the requested account.</p>"
+          "documentation":"<p>A structure that contains information about the requested account.</p> <important> <p>The <code>Status</code> parameter in the API response will be retired on September 9, 2026. Although both the account <code>State</code> and account <code>Status</code> parameters are currently available in the Organizations APIs (<code>DescribeAccount</code>, <code>ListAccounts</code>, <code>ListAccountsForParent</code>), we recommend that you update your scripts or other code to use the <code>State</code> parameter instead of <code>Status</code> before September 9, 2026.</p> </important>"
         }
       }
     },
@@ -2565,7 +2579,7 @@
       "members":{
         "Accounts":{
           "shape":"Accounts",
-          "documentation":"<p>A list of the accounts in the specified root or OU.</p>"
+          "documentation":"<p>A list of the accounts in the specified root or OU.</p> <important> <p>The <code>Status</code> parameter in the API response will be retired on September 9, 2026. Although both the account <code>State</code> and account <code>Status</code> parameters are currently available in the Organizations APIs (<code>DescribeAccount</code>, <code>ListAccounts</code>, <code>ListAccountsForParent</code>), we recommend that you update your scripts or other code to use the <code>State</code> parameter instead of <code>Status</code> before September 9, 2026.</p> </important>"
         },
         "NextToken":{
           "shape":"NextToken",
@@ -2591,7 +2605,7 @@
       "members":{
         "Accounts":{
           "shape":"Accounts",
-          "documentation":"<p>A list of objects in the organization.</p>"
+          "documentation":"<p>A list of objects in the organization.</p> <important> <p>The <code>Status</code> parameter in the API response will be retired on September 9, 2026. Although both the account <code>State</code> and account <code>Status</code> parameters are currently available in the Organizations APIs (<code>DescribeAccount</code>, <code>ListAccounts</code>, <code>ListAccountsForParent</code>), we recommend that you update your scripts or other code to use the <code>State</code> parameter instead of <code>Status</code> before September 9, 2026.</p> </important>"
         },
         "NextToken":{
           "shape":"NextToken",

generator/ServiceModels/organizations/organizations-2016-11-28.normal.json

@@ -40,6 +40,7 @@ public partial class Account
         private AccountJoinedMethod _joinedMethod;
         private DateTime? _joinedTimestamp;
         private string _name;
+        private AccountState _state;
         private AccountStatus _status;
 
         /// <summary>
@@ -174,11 +175,46 @@ internal bool IsSetName()
             return this._name != null;
         }
 
+        /// <summary>
+        /// Gets and sets the property State. 
+        /// <para>
+        /// Each state represents a specific phase in the account lifecycle. Use this information
+        /// to manage account access, automate workflows, or trigger actions based on account
+        /// state changes.
+        /// </para>
+        ///  
+        /// <para>
+        /// For more information about account states and their implications, see <a href="https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_account_state.html">Monitor
+        /// the state of your Amazon Web Services accounts </a> in the <i>Organizations User Guide</i>.
+        /// </para>
+        /// </summary>
+        public AccountState State
+        {
+            get { return this._state; }
+            set { this._state = value; }
+        }
+
+        // Check to see if State property is set
+        internal bool IsSetState()
+        {
+            return this._state != null;
+        }
+
         /// <summary>
         /// Gets and sets the property Status. 
         /// <para>
         /// The status of the account in the organization.
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// The <c>Status</c> parameter in the <c>Account</c> object will be retired on September
+        /// 9, 2026. Although both the account <c>State</c> and account <c>Status</c> parameters
+        /// are currently available in the Organizations APIs (<c>DescribeAccount</c>, <c>ListAccounts</c>,
+        /// <c>ListAccountsForParent</c>), we recommend that you update your scripts or other
+        /// code to use the <c>State</c> parameter instead of <c>Status</c> before September 9,
+        /// 2026.
+        /// </para>
+        ///  </important>
         /// </summary>
         public AccountStatus Status
         {

sdk/src/Services/Organizations/Generated/Model/Account.cs

@@ -41,6 +41,16 @@ public partial class DescribeAccountResponse : AmazonWebServiceResponse
         /// <para>
         /// A structure that contains information about the requested account.
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// The <c>Status</c> parameter in the API response will be retired on September 9, 2026.
+        /// Although both the account <c>State</c> and account <c>Status</c> parameters are currently
+        /// available in the Organizations APIs (<c>DescribeAccount</c>, <c>ListAccounts</c>,
+        /// <c>ListAccountsForParent</c>), we recommend that you update your scripts or other
+        /// code to use the <c>State</c> parameter instead of <c>Status</c> before September 9,
+        /// 2026.
+        /// </para>
+        ///  </important>
         /// </summary>
         public Account Account
         {

sdk/src/Services/Organizations/Generated/Model/DescribeAccountResponse.cs

@@ -53,7 +53,7 @@ namespace Amazon.Organizations.Model
     /// </para>
     ///  
     /// <para>
-    ///  To view the status of available policy types in the organization, use <a>DescribeOrganization</a>.
+    ///  To view the status of available policy types in the organization, use <a>ListRoots</a>.
     /// </para>
     /// </summary>
     public partial class DisablePolicyTypeRequest : AmazonOrganizationsRequest

sdk/src/Services/Organizations/Generated/Model/DisablePolicyTypeRequest.cs

@@ -50,7 +50,7 @@ namespace Amazon.Organizations.Model
     /// <para>
     /// You can enable a policy type in a root only if that policy type is available in the
     /// organization. To view the status of available policy types in the organization, use
-    /// <a>DescribeOrganization</a>.
+    /// <a>ListRoots</a>.
     /// </para>
     /// </summary>
     public partial class EnablePolicyTypeRequest : AmazonOrganizationsRequest

sdk/src/Services/Organizations/Generated/Model/EnablePolicyTypeRequest.cs

@@ -102,6 +102,12 @@ public Account Unmarshall(JsonUnmarshallerContext context)
                     unmarshalledObject.Name = unmarshaller.Unmarshall(context);
                     continue;
                 }
+                if (context.TestExpression("State", targetDepth))
+                {
+                    var unmarshaller = StringUnmarshaller.Instance;
+                    unmarshalledObject.State = unmarshaller.Unmarshall(context);
+                    continue;
+                }
                 if (context.TestExpression("Status", targetDepth))
                 {
                     var unmarshaller = StringUnmarshaller.Instance;

sdk/src/Services/Organizations/Generated/Model/Internal/MarshallTransformations/AccountUnmarshaller.cs

@@ -42,6 +42,16 @@ public partial class ListAccountsForParentResponse : AmazonWebServiceResponse
         /// <para>
         /// A list of the accounts in the specified root or OU.
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// The <c>Status</c> parameter in the API response will be retired on September 9, 2026.
+        /// Although both the account <c>State</c> and account <c>Status</c> parameters are currently
+        /// available in the Organizations APIs (<c>DescribeAccount</c>, <c>ListAccounts</c>,
+        /// <c>ListAccountsForParent</c>), we recommend that you update your scripts or other
+        /// code to use the <c>State</c> parameter instead of <c>Status</c> before September 9,
+        /// 2026.
+        /// </para>
+        ///  </important>
         /// </summary>
         public List<Account> Accounts
         {

sdk/src/Services/Organizations/Generated/Model/ListAccountsForParentResponse.cs

@@ -42,6 +42,16 @@ public partial class ListAccountsResponse : AmazonWebServiceResponse
         /// <para>
         /// A list of objects in the organization.
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// The <c>Status</c> parameter in the API response will be retired on September 9, 2026.
+        /// Although both the account <c>State</c> and account <c>Status</c> parameters are currently
+        /// available in the Organizations APIs (<c>DescribeAccount</c>, <c>ListAccounts</c>,
+        /// <c>ListAccountsForParent</c>), we recommend that you update your scripts or other
+        /// code to use the <c>State</c> parameter instead of <c>Status</c> before September 9,
+        /// 2026.
+        /// </para>
+        ///  </important>
         /// </summary>
         public List<Account> Accounts
         {