amazonka-servicecatalog-2.0: Amazon Service Catalog 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.ServiceCatalog.DescribePortfolioShares

Description

Returns a summary of each of the portfolio shares that were created for the specified portfolio.

You can use this API to determine which accounts or organizational nodes this portfolio have been shared, whether the recipient entity has imported the share, and whether TagOptions are included with the share.

The PortfolioId and Type parameters are both required.

Synopsis

Creating a Request

data DescribePortfolioShares Source #

See: newDescribePortfolioShares smart constructor.

Constructors

DescribePortfolioShares' 

Fields

  • pageSize :: Maybe Natural

    The maximum number of items to return with this call.

  • pageToken :: Maybe Text

    The page token for the next set of results. To retrieve the first set of results, use null.

  • portfolioId :: Text

    The unique identifier of the portfolio for which shares will be retrieved.

  • type' :: DescribePortfolioShareType

    The type of portfolio share to summarize. This field acts as a filter on the type of portfolio share, which can be one of the following:

    1. ACCOUNT - Represents an external account to account share.
    2. ORGANIZATION - Represents a share to an organization. This share is available to every account in the organization.
    3. ORGANIZATIONAL_UNIT - Represents a share to an organizational unit.
    4. ORGANIZATION_MEMBER_ACCOUNT - Represents a share to an account in the organization.

Instances

Instances details
ToJSON DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

ToHeaders DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

ToPath DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

ToQuery DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

AWSRequest DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Generic DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Associated Types

type Rep DescribePortfolioShares :: Type -> Type #

Read DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Show DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

NFData DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Methods

rnf :: DescribePortfolioShares -> () #

Eq DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Hashable DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

type AWSResponse DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

type Rep DescribePortfolioShares Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

type Rep DescribePortfolioShares = D1 ('MetaData "DescribePortfolioShares" "Amazonka.ServiceCatalog.DescribePortfolioShares" "amazonka-servicecatalog-2.0-HQc7wwDA1XY4nlo6issXoI" 'False) (C1 ('MetaCons "DescribePortfolioShares'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "pageSize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "pageToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "portfolioId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "type'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 DescribePortfolioShareType))))

newDescribePortfolioShares Source #

Create a value of DescribePortfolioShares 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:pageSize:DescribePortfolioShares', describePortfolioShares_pageSize - The maximum number of items to return with this call.

$sel:pageToken:DescribePortfolioShares', describePortfolioShares_pageToken - The page token for the next set of results. To retrieve the first set of results, use null.

DescribePortfolioShares, describePortfolioShares_portfolioId - The unique identifier of the portfolio for which shares will be retrieved.

DescribePortfolioShares, describePortfolioShares_type - The type of portfolio share to summarize. This field acts as a filter on the type of portfolio share, which can be one of the following:

  1. ACCOUNT - Represents an external account to account share.
  2. ORGANIZATION - Represents a share to an organization. This share is available to every account in the organization.
  3. ORGANIZATIONAL_UNIT - Represents a share to an organizational unit.
  4. ORGANIZATION_MEMBER_ACCOUNT - Represents a share to an account in the organization.

Request Lenses

describePortfolioShares_pageSize :: Lens' DescribePortfolioShares (Maybe Natural) Source #

The maximum number of items to return with this call.

describePortfolioShares_pageToken :: Lens' DescribePortfolioShares (Maybe Text) Source #

The page token for the next set of results. To retrieve the first set of results, use null.

describePortfolioShares_portfolioId :: Lens' DescribePortfolioShares Text Source #

The unique identifier of the portfolio for which shares will be retrieved.

describePortfolioShares_type :: Lens' DescribePortfolioShares DescribePortfolioShareType Source #

The type of portfolio share to summarize. This field acts as a filter on the type of portfolio share, which can be one of the following:

  1. ACCOUNT - Represents an external account to account share.
  2. ORGANIZATION - Represents a share to an organization. This share is available to every account in the organization.
  3. ORGANIZATIONAL_UNIT - Represents a share to an organizational unit.
  4. ORGANIZATION_MEMBER_ACCOUNT - Represents a share to an account in the organization.

Destructuring the Response

data DescribePortfolioSharesResponse Source #

See: newDescribePortfolioSharesResponse smart constructor.

Constructors

DescribePortfolioSharesResponse' 

Fields

Instances

Instances details
Generic DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Associated Types

type Rep DescribePortfolioSharesResponse :: Type -> Type #

Read DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Show DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

NFData DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

Eq DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

type Rep DescribePortfolioSharesResponse Source # 
Instance details

Defined in Amazonka.ServiceCatalog.DescribePortfolioShares

type Rep DescribePortfolioSharesResponse = D1 ('MetaData "DescribePortfolioSharesResponse" "Amazonka.ServiceCatalog.DescribePortfolioShares" "amazonka-servicecatalog-2.0-HQc7wwDA1XY4nlo6issXoI" 'False) (C1 ('MetaCons "DescribePortfolioSharesResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextPageToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "portfolioShareDetails") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [PortfolioShareDetail])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribePortfolioSharesResponse Source #

Create a value of DescribePortfolioSharesResponse 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:nextPageToken:DescribePortfolioSharesResponse', describePortfolioSharesResponse_nextPageToken - The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

$sel:portfolioShareDetails:DescribePortfolioSharesResponse', describePortfolioSharesResponse_portfolioShareDetails - Summaries about each of the portfolio shares.

$sel:httpStatus:DescribePortfolioSharesResponse', describePortfolioSharesResponse_httpStatus - The response's http status code.

Response Lenses

describePortfolioSharesResponse_nextPageToken :: Lens' DescribePortfolioSharesResponse (Maybe Text) Source #

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.