/*
 * Copyright 2010-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 * 
 *  http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

/*
 * Do not modify this file. This file is generated from the iam-2010-05-08.normal.json service model.
 */
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;

using Amazon.Runtime;
using Amazon.Runtime.Internal;

namespace Amazon.IdentityManagement.Model
{
    /// <summary>
    /// Container for the parameters to the SetSecurityTokenServicePreferences operation.
    /// Sets the specified version of the global endpoint token as the token version used
    /// for the AWS account.
    /// 
    ///  
    /// <para>
    /// By default, AWS Security Token Service (STS) is available as a global service, and
    /// all STS requests go to a single endpoint at <code>https://sts.amazonaws.com</code>.
    /// AWS recommends using Regional STS endpoints to reduce latency, build in redundancy,
    /// and increase session token availability. For information about Regional endpoints
    /// for STS, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region">AWS
    /// Regions and Endpoints</a> in the <i>AWS General Reference</i>.
    /// </para>
    ///  
    /// <para>
    /// If you make an STS call to the global endpoint, the resulting session tokens might
    /// be valid in some Regions but not others. It depends on the version that is set in
    /// this operation. Version 1 tokens are valid only in AWS Regions that are available
    /// by default. These tokens do not work in manually enabled Regions, such as Asia Pacific
    /// (Hong Kong). Version 2 tokens are valid in all Regions. However, version 2 tokens
    /// are longer and might affect systems where you temporarily store tokens. For information,
    /// see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html">Activating
    /// and Deactivating STS in an AWS Region</a> in the <i>IAM User Guide</i>.
    /// </para>
    ///  
    /// <para>
    /// To view the current session token version, see the <code>GlobalEndpointTokenVersion</code>
    /// entry in the response of the <a>GetAccountSummary</a> operation.
    /// </para>
    /// </summary>
    public partial class SetSecurityTokenServicePreferencesRequest : AmazonIdentityManagementServiceRequest
    {
        private GlobalEndpointTokenVersion _globalEndpointTokenVersion;

        /// <summary>
        /// Gets and sets the property GlobalEndpointTokenVersion. 
        /// <para>
        /// The version of the global endpoint token. Version 1 tokens are valid only in AWS Regions
        /// that are available by default. These tokens do not work in manually enabled Regions,
        /// such as Asia Pacific (Hong Kong). Version 2 tokens are valid in all Regions. However,
        /// version 2 tokens are longer and might affect systems where you temporarily store tokens.
        /// </para>
        ///  
        /// <para>
        /// For information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html">Activating
        /// and Deactivating STS in an AWS Region</a> in the <i>IAM User Guide</i>.
        /// </para>
        /// </summary>
        [AWSProperty(Required=true)]
        public GlobalEndpointTokenVersion GlobalEndpointTokenVersion
        {
            get { return this._globalEndpointTokenVersion; }
            set { this._globalEndpointTokenVersion = value; }
        }

        // Check to see if GlobalEndpointTokenVersion property is set
        internal bool IsSetGlobalEndpointTokenVersion()
        {
            return this._globalEndpointTokenVersion != null;
        }

    }
}