list_segment_references

CloudWatchEvidently.Client.list_segment_references(**kwargs)

Use this operation to find which experiments or launches are using a specified segment.

See also: AWS API Documentation

Request Syntax

response = client.list_segment_references(
    maxResults=123,
    nextToken='string',
    segment='string',
    type='EXPERIMENT'|'LAUNCH'
)
Parameters
  • maxResults (integer) -- The maximum number of results to include in the response. If you omit this, the default of 50 is used.
  • nextToken (string) -- The token to use when requesting the next set of results. You received this token from a previous ListSegmentReferences operation.
  • segment (string) --

    [REQUIRED]

    The ARN of the segment that you want to view information for.

  • type (string) --

    [REQUIRED]

    Specifies whether to return information about launches or experiments that use this segment.

Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'referencedBy': [
        {
            'arn': 'string',
            'endTime': 'string',
            'lastUpdatedOn': 'string',
            'name': 'string',
            'startTime': 'string',
            'status': 'string',
            'type': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      The token to use in a subsequent ListSegmentReferences operation to return the next set of results.

    • referencedBy (list) --

      An array of structures, where each structure contains information about one experiment or launch that uses this segment.

      • (dict) --

        A structure that contains information about one experiment or launch that uses the specified segment.

        • arn (string) --

          The ARN of the experiment or launch.

        • endTime (string) --

          The day and time that this experiment or launch ended.

        • lastUpdatedOn (string) --

          The day and time that this experiment or launch was most recently updated.

        • name (string) --

          The name of the experiment or launch.

        • startTime (string) --

          The day and time that this experiment or launch started.

        • status (string) --

          The status of the experiment or launch.

        • type (string) --

          Specifies whether the resource that this structure contains information about is an experiment or a launch.

Exceptions

  • CloudWatchEvidently.Client.exceptions.ThrottlingException
  • CloudWatchEvidently.Client.exceptions.ValidationException
  • CloudWatchEvidently.Client.exceptions.ResourceNotFoundException
  • CloudWatchEvidently.Client.exceptions.AccessDeniedException