SupplyChain / Client / list_instances

list_instances#

SupplyChain.Client.list_instances(**kwargs)#

List all the AWS Supply Chain instances in a paginated way.

Request Syntax

response = client.list_instances(
    nextToken='string',
    maxResults=123,
    instanceNameFilter=[
        'string',
    ],
    instanceStateFilter=[
        'Initializing'|'Active'|'CreateFailed'|'DeleteFailed'|'Deleting'|'Deleted',
    ]
)

Parameters:

nextToken (string) – The pagination token to fetch the next page of instances.
maxResults (integer) – Specify the maximum number of instances to fetch in this paginated request.
instanceNameFilter (list) –
The filter to ListInstances based on their names.
- (string) –
instanceStateFilter (list) –
The filter to ListInstances based on their state.
- (string) –

Return type:

dict

Returns:

Response Syntax

{
    'instances': [
        {
            'instanceId': 'string',
            'awsAccountId': 'string',
            'state': 'Initializing'|'Active'|'CreateFailed'|'DeleteFailed'|'Deleting'|'Deleted',
            'webAppDnsDomain': 'string',
            'createdTime': datetime(2015, 1, 1),
            'lastModifiedTime': datetime(2015, 1, 1),
            'instanceName': 'string',
            'instanceDescription': 'string',
            'kmsKeyArn': 'string',
            'versionNumber': 123.0
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –

The response parameters for ListInstances.
- instances (list) –
  
  The list of instances resource data details.
  - (dict) –
    
    The details of the instance.
    - instanceId (string) –
      
      The Amazon Web Services Supply Chain instance identifier.
    - awsAccountId (string) –
      
      The Amazon Web Services account ID that owns the instance.
    - state (string) –
      
      The state of the instance.
    - webAppDnsDomain (string) –
      
      The WebApp DNS domain name of the instance.
    - createdTime (datetime) –
      
      The instance creation timestamp.
    - lastModifiedTime (datetime) –
      
      The instance last modified timestamp.
    - instanceName (string) –
      
      The Amazon Web Services Supply Chain instance name.
    - instanceDescription (string) –
      
      The Amazon Web Services Supply Chain instance description.
    - kmsKeyArn (string) –
      
      The ARN (Amazon Resource Name) of the Key Management Service (KMS) key you optionally provided for encryption. If you did not provide anything here, AWS Supply Chain uses the Amazon Web Services owned KMS key and nothing is returned.
    - versionNumber (float) –
      
      The version number of the instance.
- nextToken (string) –
  
  The pagination token to fetch the next page of instances.

Exceptions

SupplyChain.Client.exceptions.ServiceQuotaExceededException
SupplyChain.Client.exceptions.ThrottlingException
SupplyChain.Client.exceptions.ResourceNotFoundException
SupplyChain.Client.exceptions.AccessDeniedException
SupplyChain.Client.exceptions.ValidationException
SupplyChain.Client.exceptions.InternalServerException
SupplyChain.Client.exceptions.ConflictException