amazonka-ram-2.0: Amazon Resource Access Manager SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.RAM.GetResourceShareAssociations

Description

Retrieves the resource and principal associations for resource shares that you own.

This operation returns paginated results.

Synopsis

Creating a Request

data GetResourceShareAssociations Source #

See: newGetResourceShareAssociations smart constructor.

Constructors

GetResourceShareAssociations' 

Fields

  • associationStatus :: Maybe ResourceShareAssociationStatus

    Specifies that you want to retrieve only associations with this status.

  • maxResults :: Maybe Natural

    Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

  • nextToken :: Maybe Text

    Specifies that you want to receive the next page of results. Valid only if you received a NextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's NextToken response to request the next page of results.

  • principal :: Maybe Text

    Specifies the ID of the principal whose resource shares you want to retrieve. This can be an Amazon Web Services account ID, an organization ID, an organizational unit ID, or the Amazon Resoure Name (ARN) of an individual IAM user or role.

    You cannot specify this parameter if the association type is RESOURCE.

  • resourceArn :: Maybe Text

    Specifies the Amazon Resoure Name (ARN) of the resource whose resource shares you want to retrieve.

    You cannot specify this parameter if the association type is PRINCIPAL.

  • resourceShareArns :: Maybe [Text]

    Specifies a list of Amazon Resource Names (ARNs) of the resource share whose associations you want to retrieve.

  • associationType :: ResourceShareAssociationType

    Specifies whether you want to retrieve the associations that involve a specified resource or principal.

    • PRINCIPAL – list the principals that are associated with the specified resource share.
    • RESOURCE – list the resources that are associated with the specified resource share.

Instances

Instances details
ToJSON GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

ToHeaders GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

ToPath GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

ToQuery GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

AWSPager GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

AWSRequest GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Generic GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Associated Types

type Rep GetResourceShareAssociations :: Type -> Type #

Read GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Show GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

NFData GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Eq GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Hashable GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

type AWSResponse GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

type Rep GetResourceShareAssociations Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

type Rep GetResourceShareAssociations = D1 ('MetaData "GetResourceShareAssociations" "Amazonka.RAM.GetResourceShareAssociations" "amazonka-ram-2.0-2ZD9k8USaHb58ZVl9MaFYL" 'False) (C1 ('MetaCons "GetResourceShareAssociations'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "associationStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ResourceShareAssociationStatus)) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "principal") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "resourceArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "resourceShareArns") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "associationType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ResourceShareAssociationType)))))

newGetResourceShareAssociations Source #

Create a value of GetResourceShareAssociations 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:associationStatus:GetResourceShareAssociations', getResourceShareAssociations_associationStatus - Specifies that you want to retrieve only associations with this status.

$sel:maxResults:GetResourceShareAssociations', getResourceShareAssociations_maxResults - Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

GetResourceShareAssociations, getResourceShareAssociations_nextToken - Specifies that you want to receive the next page of results. Valid only if you received a NextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's NextToken response to request the next page of results.

$sel:principal:GetResourceShareAssociations', getResourceShareAssociations_principal - Specifies the ID of the principal whose resource shares you want to retrieve. This can be an Amazon Web Services account ID, an organization ID, an organizational unit ID, or the Amazon Resoure Name (ARN) of an individual IAM user or role.

You cannot specify this parameter if the association type is RESOURCE.

$sel:resourceArn:GetResourceShareAssociations', getResourceShareAssociations_resourceArn - Specifies the Amazon Resoure Name (ARN) of the resource whose resource shares you want to retrieve.

You cannot specify this parameter if the association type is PRINCIPAL.

$sel:resourceShareArns:GetResourceShareAssociations', getResourceShareAssociations_resourceShareArns - Specifies a list of Amazon Resource Names (ARNs) of the resource share whose associations you want to retrieve.

GetResourceShareAssociations, getResourceShareAssociations_associationType - Specifies whether you want to retrieve the associations that involve a specified resource or principal.

  • PRINCIPAL – list the principals that are associated with the specified resource share.
  • RESOURCE – list the resources that are associated with the specified resource share.

Request Lenses

getResourceShareAssociations_associationStatus :: Lens' GetResourceShareAssociations (Maybe ResourceShareAssociationStatus) Source #

Specifies that you want to retrieve only associations with this status.

getResourceShareAssociations_maxResults :: Lens' GetResourceShareAssociations (Maybe Natural) Source #

Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

getResourceShareAssociations_nextToken :: Lens' GetResourceShareAssociations (Maybe Text) Source #

Specifies that you want to receive the next page of results. Valid only if you received a NextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's NextToken response to request the next page of results.

getResourceShareAssociations_principal :: Lens' GetResourceShareAssociations (Maybe Text) Source #

Specifies the ID of the principal whose resource shares you want to retrieve. This can be an Amazon Web Services account ID, an organization ID, an organizational unit ID, or the Amazon Resoure Name (ARN) of an individual IAM user or role.

You cannot specify this parameter if the association type is RESOURCE.

getResourceShareAssociations_resourceArn :: Lens' GetResourceShareAssociations (Maybe Text) Source #

Specifies the Amazon Resoure Name (ARN) of the resource whose resource shares you want to retrieve.

You cannot specify this parameter if the association type is PRINCIPAL.

getResourceShareAssociations_resourceShareArns :: Lens' GetResourceShareAssociations (Maybe [Text]) Source #

Specifies a list of Amazon Resource Names (ARNs) of the resource share whose associations you want to retrieve.

getResourceShareAssociations_associationType :: Lens' GetResourceShareAssociations ResourceShareAssociationType Source #

Specifies whether you want to retrieve the associations that involve a specified resource or principal.

  • PRINCIPAL – list the principals that are associated with the specified resource share.
  • RESOURCE – list the resources that are associated with the specified resource share.

Destructuring the Response

data GetResourceShareAssociationsResponse Source #

Constructors

GetResourceShareAssociationsResponse' 

Fields

  • nextToken :: Maybe Text

    If present, this value indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. This indicates that this is the last page of results.

  • resourceShareAssociations :: Maybe [ResourceShareAssociation]

    An array of objects that contain the details about the associations.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Read GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Show GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

NFData GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

Eq GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

type Rep GetResourceShareAssociationsResponse Source # 
Instance details

Defined in Amazonka.RAM.GetResourceShareAssociations

type Rep GetResourceShareAssociationsResponse = D1 ('MetaData "GetResourceShareAssociationsResponse" "Amazonka.RAM.GetResourceShareAssociations" "amazonka-ram-2.0-2ZD9k8USaHb58ZVl9MaFYL" 'False) (C1 ('MetaCons "GetResourceShareAssociationsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "resourceShareAssociations") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ResourceShareAssociation])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newGetResourceShareAssociationsResponse Source #

Create a value of GetResourceShareAssociationsResponse 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:

GetResourceShareAssociations, getResourceShareAssociationsResponse_nextToken - If present, this value indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. This indicates that this is the last page of results.

GetResourceShareAssociationsResponse, getResourceShareAssociationsResponse_resourceShareAssociations - An array of objects that contain the details about the associations.

$sel:httpStatus:GetResourceShareAssociationsResponse', getResourceShareAssociationsResponse_httpStatus - The response's http status code.

Response Lenses

getResourceShareAssociationsResponse_nextToken :: Lens' GetResourceShareAssociationsResponse (Maybe Text) Source #

If present, this value indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. This indicates that this is the last page of results.