amazonka-redshift-2.0: Amazon Redshift 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.Redshift.DescribeDataSharesForConsumer

Description

Returns a list of datashares where the account identifier being called is a consumer account identifier.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeDataSharesForConsumer Source #

See: newDescribeDataSharesForConsumer smart constructor.

Constructors

DescribeDataSharesForConsumer' 

Fields

  • consumerArn :: Maybe Text

    The Amazon Resource Name (ARN) of the consumer that returns in the list of datashares.

  • marker :: Maybe Text

    An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

  • maxRecords :: Maybe Int

    The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

  • status :: Maybe DataShareStatusForConsumer

    An identifier giving the status of a datashare in the consumer cluster. If this field is specified, Amazon Redshift returns the list of datashares that have the specified status.

Instances

Instances details
ToHeaders DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

ToPath DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

ToQuery DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

AWSPager DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

AWSRequest DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Generic DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Associated Types

type Rep DescribeDataSharesForConsumer :: Type -> Type #

Read DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Show DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

NFData DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Eq DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Hashable DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

type AWSResponse DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

type Rep DescribeDataSharesForConsumer Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

type Rep DescribeDataSharesForConsumer = D1 ('MetaData "DescribeDataSharesForConsumer" "Amazonka.Redshift.DescribeDataSharesForConsumer" "amazonka-redshift-2.0-4tocKxBWIuj2GdXa6djdUl" 'False) (C1 ('MetaCons "DescribeDataSharesForConsumer'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "consumerArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "marker") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "maxRecords") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DataShareStatusForConsumer)))))

newDescribeDataSharesForConsumer :: DescribeDataSharesForConsumer Source #

Create a value of DescribeDataSharesForConsumer 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:consumerArn:DescribeDataSharesForConsumer', describeDataSharesForConsumer_consumerArn - The Amazon Resource Name (ARN) of the consumer that returns in the list of datashares.

DescribeDataSharesForConsumer, describeDataSharesForConsumer_marker - An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

$sel:maxRecords:DescribeDataSharesForConsumer', describeDataSharesForConsumer_maxRecords - The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

DescribeDataSharesForConsumer, describeDataSharesForConsumer_status - An identifier giving the status of a datashare in the consumer cluster. If this field is specified, Amazon Redshift returns the list of datashares that have the specified status.

Request Lenses

describeDataSharesForConsumer_consumerArn :: Lens' DescribeDataSharesForConsumer (Maybe Text) Source #

The Amazon Resource Name (ARN) of the consumer that returns in the list of datashares.

describeDataSharesForConsumer_marker :: Lens' DescribeDataSharesForConsumer (Maybe Text) Source #

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

describeDataSharesForConsumer_maxRecords :: Lens' DescribeDataSharesForConsumer (Maybe Int) Source #

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

describeDataSharesForConsumer_status :: Lens' DescribeDataSharesForConsumer (Maybe DataShareStatusForConsumer) Source #

An identifier giving the status of a datashare in the consumer cluster. If this field is specified, Amazon Redshift returns the list of datashares that have the specified status.

Destructuring the Response

data DescribeDataSharesForConsumerResponse Source #

Constructors

DescribeDataSharesForConsumerResponse' 

Fields

  • dataShares :: Maybe [DataShare]

    Shows the results of datashares available for consumers.

  • marker :: Maybe Text

    An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Read DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Show DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

NFData DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

Eq DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

type Rep DescribeDataSharesForConsumerResponse Source # 
Instance details

Defined in Amazonka.Redshift.DescribeDataSharesForConsumer

type Rep DescribeDataSharesForConsumerResponse = D1 ('MetaData "DescribeDataSharesForConsumerResponse" "Amazonka.Redshift.DescribeDataSharesForConsumer" "amazonka-redshift-2.0-4tocKxBWIuj2GdXa6djdUl" 'False) (C1 ('MetaCons "DescribeDataSharesForConsumerResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "dataShares") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [DataShare])) :*: (S1 ('MetaSel ('Just "marker") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeDataSharesForConsumerResponse Source #

Create a value of DescribeDataSharesForConsumerResponse 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:dataShares:DescribeDataSharesForConsumerResponse', describeDataSharesForConsumerResponse_dataShares - Shows the results of datashares available for consumers.

DescribeDataSharesForConsumer, describeDataSharesForConsumerResponse_marker - An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

$sel:httpStatus:DescribeDataSharesForConsumerResponse', describeDataSharesForConsumerResponse_httpStatus - The response's http status code.

Response Lenses

describeDataSharesForConsumerResponse_marker :: Lens' DescribeDataSharesForConsumerResponse (Maybe Text) Source #

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDataSharesForConsumer request exceed the value specified in MaxRecords, Amazon Web Services returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.