libZSservicesZSamazonka-ecsZSamazonka-ecs
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.ECS.ListAccountSettings

Description

Lists the account settings for a specified principal.

This operation returns paginated results.

Synopsis

Creating a Request

data ListAccountSettings Source #

See: newListAccountSettings smart constructor.

Constructors

ListAccountSettings' 

Fields

  • value :: Maybe Text

    The value of the account settings with which to filter results. You must also specify an account setting name to use this parameter.

  • nextToken :: Maybe Text

    The nextToken value returned from a ListAccountSettings request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

    This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

  • name :: Maybe SettingName

    The name of the account setting you want to list the settings for.

  • principalArn :: Maybe Text

    The ARN of the principal, which can be an IAM user, IAM role, or the root user. If this field is omitted, the account settings are listed only for the authenticated user.

    Federated users assume the account setting of the root user and can't have explicit account settings set for them.

  • effectiveSettings :: Maybe Bool

    Specifies whether to return the effective settings. If true, the account settings for the root user or the default setting for the principalArn are returned. If false, the account settings for the principalArn are returned if they are set. Otherwise, no account settings are returned.

  • maxResults :: Maybe Int

    The maximum number of account setting results returned by ListAccountSettings in paginated output. When this parameter is used, ListAccountSettings only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAccountSettings request with the returned nextToken value. This value can be between 1 and 10. If this parameter is not used, then ListAccountSettings returns up to 10 results and a nextToken value if applicable.

Instances

Instances details
Eq ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Read ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Show ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Generic ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Associated Types

type Rep ListAccountSettings :: Type -> Type #

NFData ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Methods

rnf :: ListAccountSettings -> () #

Hashable ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

ToJSON ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

AWSPager ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

AWSRequest ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Associated Types

type AWSResponse ListAccountSettings #

ToHeaders ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

ToPath ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

ToQuery ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

type Rep ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

type Rep ListAccountSettings = D1 ('MetaData "ListAccountSettings" "Amazonka.ECS.ListAccountSettings" "libZSservicesZSamazonka-ecsZSamazonka-ecs" 'False) (C1 ('MetaCons "ListAccountSettings'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "value") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SettingName)))) :*: (S1 ('MetaSel ('Just "principalArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "effectiveSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int))))))
type AWSResponse ListAccountSettings Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

newListAccountSettings :: ListAccountSettings Source #

Create a value of ListAccountSettings with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:value:ListAccountSettings', listAccountSettings_value - The value of the account settings with which to filter results. You must also specify an account setting name to use this parameter.

$sel:nextToken:ListAccountSettings', listAccountSettings_nextToken - The nextToken value returned from a ListAccountSettings request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

$sel:name:ListAccountSettings', listAccountSettings_name - The name of the account setting you want to list the settings for.

$sel:principalArn:ListAccountSettings', listAccountSettings_principalArn - The ARN of the principal, which can be an IAM user, IAM role, or the root user. If this field is omitted, the account settings are listed only for the authenticated user.

Federated users assume the account setting of the root user and can't have explicit account settings set for them.

$sel:effectiveSettings:ListAccountSettings', listAccountSettings_effectiveSettings - Specifies whether to return the effective settings. If true, the account settings for the root user or the default setting for the principalArn are returned. If false, the account settings for the principalArn are returned if they are set. Otherwise, no account settings are returned.

$sel:maxResults:ListAccountSettings', listAccountSettings_maxResults - The maximum number of account setting results returned by ListAccountSettings in paginated output. When this parameter is used, ListAccountSettings only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAccountSettings request with the returned nextToken value. This value can be between 1 and 10. If this parameter is not used, then ListAccountSettings returns up to 10 results and a nextToken value if applicable.

Request Lenses

listAccountSettings_value :: Lens' ListAccountSettings (Maybe Text) Source #

The value of the account settings with which to filter results. You must also specify an account setting name to use this parameter.

listAccountSettings_nextToken :: Lens' ListAccountSettings (Maybe Text) Source #

The nextToken value returned from a ListAccountSettings request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

listAccountSettings_name :: Lens' ListAccountSettings (Maybe SettingName) Source #

The name of the account setting you want to list the settings for.

listAccountSettings_principalArn :: Lens' ListAccountSettings (Maybe Text) Source #

The ARN of the principal, which can be an IAM user, IAM role, or the root user. If this field is omitted, the account settings are listed only for the authenticated user.

Federated users assume the account setting of the root user and can't have explicit account settings set for them.

listAccountSettings_effectiveSettings :: Lens' ListAccountSettings (Maybe Bool) Source #

Specifies whether to return the effective settings. If true, the account settings for the root user or the default setting for the principalArn are returned. If false, the account settings for the principalArn are returned if they are set. Otherwise, no account settings are returned.

listAccountSettings_maxResults :: Lens' ListAccountSettings (Maybe Int) Source #

The maximum number of account setting results returned by ListAccountSettings in paginated output. When this parameter is used, ListAccountSettings only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAccountSettings request with the returned nextToken value. This value can be between 1 and 10. If this parameter is not used, then ListAccountSettings returns up to 10 results and a nextToken value if applicable.

Destructuring the Response

data ListAccountSettingsResponse Source #

See: newListAccountSettingsResponse smart constructor.

Constructors

ListAccountSettingsResponse' 

Fields

  • settings :: Maybe [Setting]

    The account settings for the resource.

  • nextToken :: Maybe Text

    The nextToken value to include in a future ListAccountSettings request. When the results of a ListAccountSettings request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Read ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Show ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Generic ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

Associated Types

type Rep ListAccountSettingsResponse :: Type -> Type #

NFData ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

type Rep ListAccountSettingsResponse Source # 
Instance details

Defined in Amazonka.ECS.ListAccountSettings

type Rep ListAccountSettingsResponse = D1 ('MetaData "ListAccountSettingsResponse" "Amazonka.ECS.ListAccountSettings" "libZSservicesZSamazonka-ecsZSamazonka-ecs" 'False) (C1 ('MetaCons "ListAccountSettingsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "settings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Setting])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListAccountSettingsResponse Source #

Create a value of ListAccountSettingsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:settings:ListAccountSettingsResponse', listAccountSettingsResponse_settings - The account settings for the resource.

$sel:nextToken:ListAccountSettings', listAccountSettingsResponse_nextToken - The nextToken value to include in a future ListAccountSettings request. When the results of a ListAccountSettings request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

$sel:httpStatus:ListAccountSettingsResponse', listAccountSettingsResponse_httpStatus - The response's http status code.

Response Lenses

listAccountSettingsResponse_nextToken :: Lens' ListAccountSettingsResponse (Maybe Text) Source #

The nextToken value to include in a future ListAccountSettings request. When the results of a ListAccountSettings request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.