Table of Contents
AmplifyUIBuilder.
Client
¶A low-level client representing AWS Amplify UI Builder
The Amplify UI Builder API provides a programmatic interface for creating and configuring user interface (UI) component libraries and themes for use in your Amplify applications. You can then connect these UI components to an application’s backend Amazon Web Services resources.
You can also use the Amplify Studio visual designer to create UI components and model data for an app. For more information, see Introduction in the Amplify Docs .
The Amplify Framework is a comprehensive set of SDKs, libraries, tools, and documentation for client app development. For more information, see the Amplify Framework . For more information about deploying an Amplify application to Amazon Web Services, see the Amplify Console User Guide .
client = session.create_client('amplifyuibuilder')
These are the available methods:
can_paginate
(operation_name)¶Check if an operation can be paginated.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
True
if the operation can be paginated,
False
otherwise.
create_component
(**kwargs)¶Creates a new component for an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.create_component(
appId='string',
clientToken='string',
componentToCreate={
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'tags': {
'string': 'string'
},
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
},
environmentName='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app to associate with the component.
clientToken (string) –
The unique client token.
This field is autopopulated if not provided.
componentToCreate (dict) –
[REQUIRED]
Represents the configuration of the component to create.
bindingProperties (dict) – [REQUIRED]
The data binding information for the component’s properties.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
A list of child components that are instances of the main component.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) – [REQUIRED]
The type of the child component.
name (string) – [REQUIRED]
The name of the child component.
properties (dict) – [REQUIRED]
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) – [REQUIRED]
The name of the component to retrieve a value from.
property (string) – [REQUIRED]
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The data binding configuration for customizing a component’s properties. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) – [REQUIRED]
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) – [REQUIRED]
The direction of the sort, either ascending or descending.
field (string) – [REQUIRED]
The field to perform the sort on.
componentType (string) – [REQUIRED]
The component type. This can be an Amplify custom UI component or another custom component.
name (string) – [REQUIRED]
The name of the component
overrides (dict) – [REQUIRED]
Describes the component properties that can be overriden to customize an instance of the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) – [REQUIRED]
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) – [REQUIRED]
The name of the component to retrieve a value from.
property (string) – [REQUIRED]
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
tags (dict) –
One or more key-value pairs to use when tagging the component data.
(string) –
(string) –
variants (list) – [REQUIRED]
A list of the unique variants of this component.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
dict
Response Syntax
{
'entity': {
'appId': 'string',
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'tags': {
'string': 'string'
},
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
}
}
Response Structure
(dict) –
entity (dict) –
Describes the configuration of the new component.
appId (string) –
The unique ID of the Amplify app associated with the component.
bindingProperties (dict) –
The information to connect a component’s properties to data at runtime.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
A list of the component’s ComponentChild
instances.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) –
The type of the child component.
name (string) –
The name of the child component.
properties (dict) –
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The data binding configuration for the component’s properties. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) –
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) –
The direction of the sort, either ascending or descending.
field (string) –
The field to perform the sort on.
componentType (string) –
The type of the component. This can be an Amplify custom UI component or another custom component.
createdAt (datetime) –
The time that the component was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
modifiedAt (datetime) –
The time that the component was modified.
name (string) –
The name of the component.
overrides (dict) –
Describes the component’s properties that can be overriden in a customized instance of the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) –
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
tags (dict) –
One or more key-value pairs to use when tagging the component.
(string) –
(string) –
variants (list) –
A list of the component’s variants. A variant is a unique style configuration of a main component.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
Exceptions
create_theme
(**kwargs)¶Creates a theme to apply to the components in an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.create_theme(
appId='string',
clientToken='string',
environmentName='string',
themeToCreate={
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'tags': {
'string': 'string'
},
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
}
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app associated with the theme.
clientToken (string) –
The unique client token.
This field is autopopulated if not provided.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
themeToCreate (dict) –
[REQUIRED]
Represents the configuration of the theme to create.
name (string) – [REQUIRED]
The name of the theme.
overrides (list) –
Describes the properties that can be overriden to customize an instance of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
tags (dict) –
One or more key-value pairs to use when tagging the theme data.
(string) –
(string) –
values (list) – [REQUIRED]
A list of key-value pairs that defines the properties of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
dict
Response Syntax
{
'entity': {
'appId': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'tags': {
'string': 'string'
},
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
}
}
Response Structure
(dict) –
entity (dict) –
Describes the configuration of the new theme.
appId (string) –
The unique ID for the Amplify app associated with the theme.
createdAt (datetime) –
The time that the theme was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The ID for the theme.
modifiedAt (datetime) –
The time that the theme was modified.
name (string) –
The name of the theme.
overrides (list) –
Describes the properties that can be overriden to customize a theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
tags (dict) –
One or more key-value pairs to use when tagging the theme.
(string) –
(string) –
values (list) –
A list of key-value pairs that defines the properties of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
Exceptions
delete_component
(**kwargs)¶Deletes a component from an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.delete_component(
appId='string',
environmentName='string',
id='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app associated with the component to delete.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID of the component to delete.
None
Exceptions
delete_theme
(**kwargs)¶Deletes a theme from an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.delete_theme(
appId='string',
environmentName='string',
id='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app associated with the theme to delete.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID of the theme to delete.
None
Exceptions
exchange_code_for_token
(**kwargs)¶Exchanges an access code for a token.
See also: AWS API Documentation
Request Syntax
response = client.exchange_code_for_token(
provider='figma',
request={
'code': 'string',
'redirectUri': 'string'
}
)
provider (string) –
[REQUIRED]
The third-party provider for the token. The only valid value is figma
.
request (dict) –
[REQUIRED]
Describes the configuration of the request.
code (string) – [REQUIRED]
The access code to send in the request.
redirectUri (string) – [REQUIRED]
The location of the application that will receive the access code.
dict
Response Syntax
{
'accessToken': 'string',
'expiresIn': 123,
'refreshToken': 'string'
}
Response Structure
(dict) –
accessToken (string) –
The access token.
expiresIn (integer) –
The date and time when the new access token expires.
refreshToken (string) –
The token to use to refresh a previously issued access token that might have expired.
Exceptions
export_components
(**kwargs)¶Exports component configurations to code that is ready to integrate into an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.export_components(
appId='string',
environmentName='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app to export components to.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'tags': {
'string': 'string'
},
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
},
]
}
Response Structure
(dict) –
entities (list) –
Represents the configuration of the exported components.
(dict) –
Contains the configuration settings for a user interface (UI) element for an Amplify app. A component is configured as a primary, stand-alone UI element. Use ComponentChild
to configure an instance of a Component
. A ComponentChild
instance inherits the configuration of the main Component
.
appId (string) –
The unique ID of the Amplify app associated with the component.
bindingProperties (dict) –
The information to connect a component’s properties to data at runtime.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
A list of the component’s ComponentChild
instances.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) –
The type of the child component.
name (string) –
The name of the child component.
properties (dict) –
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The data binding configuration for the component’s properties. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) –
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) –
The direction of the sort, either ascending or descending.
field (string) –
The field to perform the sort on.
componentType (string) –
The type of the component. This can be an Amplify custom UI component or another custom component.
createdAt (datetime) –
The time that the component was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
modifiedAt (datetime) –
The time that the component was modified.
name (string) –
The name of the component.
overrides (dict) –
Describes the component’s properties that can be overriden in a customized instance of the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) –
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
tags (dict) –
One or more key-value pairs to use when tagging the component.
(string) –
(string) –
variants (list) –
A list of the component’s variants. A variant is a unique style configuration of a main component.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
Exceptions
export_themes
(**kwargs)¶Exports theme configurations to code that is ready to integrate into an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.export_themes(
appId='string',
environmentName='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app to export the themes to.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is part of the Amplify app.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'tags': {
'string': 'string'
},
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
},
]
}
Response Structure
(dict) –
entities (list) –
Represents the configuration of the exported themes.
(dict) –
A theme is a collection of style settings that apply globally to the components associated with an Amplify application.
appId (string) –
The unique ID for the Amplify app associated with the theme.
createdAt (datetime) –
The time that the theme was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The ID for the theme.
modifiedAt (datetime) –
The time that the theme was modified.
name (string) –
The name of the theme.
overrides (list) –
Describes the properties that can be overriden to customize a theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
tags (dict) –
One or more key-value pairs to use when tagging the theme.
(string) –
(string) –
values (list) –
A list of key-value pairs that defines the properties of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
Exceptions
get_component
(**kwargs)¶Returns an existing component for an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.get_component(
appId='string',
environmentName='string',
id='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID of the component.
dict
Response Syntax
{
'component': {
'appId': 'string',
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'tags': {
'string': 'string'
},
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
}
}
Response Structure
(dict) –
component (dict) –
Represents the configuration settings for the component.
appId (string) –
The unique ID of the Amplify app associated with the component.
bindingProperties (dict) –
The information to connect a component’s properties to data at runtime.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
A list of the component’s ComponentChild
instances.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) –
The type of the child component.
name (string) –
The name of the child component.
properties (dict) –
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The data binding configuration for the component’s properties. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) –
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) –
The direction of the sort, either ascending or descending.
field (string) –
The field to perform the sort on.
componentType (string) –
The type of the component. This can be an Amplify custom UI component or another custom component.
createdAt (datetime) –
The time that the component was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
modifiedAt (datetime) –
The time that the component was modified.
name (string) –
The name of the component.
overrides (dict) –
Describes the component’s properties that can be overriden in a customized instance of the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) –
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
tags (dict) –
One or more key-value pairs to use when tagging the component.
(string) –
(string) –
variants (list) –
A list of the component’s variants. A variant is a unique style configuration of a main component.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
Exceptions
get_paginator
(operation_name)¶Create a paginator for an operation.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
OperationNotPageableError – Raised if the operation is not
pageable. You can use the client.can_paginate
method to
check if an operation is pageable.
L{botocore.paginate.Paginator}
A paginator object.
get_theme
(**kwargs)¶Returns an existing theme for an Amplify app.
See also: AWS API Documentation
Request Syntax
response = client.get_theme(
appId='string',
environmentName='string',
id='string'
)
appId (string) –
[REQUIRED]
The unique ID of the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID for the theme.
dict
Response Syntax
{
'theme': {
'appId': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'tags': {
'string': 'string'
},
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
}
}
Response Structure
(dict) –
theme (dict) –
Represents the configuration settings for the theme.
appId (string) –
The unique ID for the Amplify app associated with the theme.
createdAt (datetime) –
The time that the theme was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The ID for the theme.
modifiedAt (datetime) –
The time that the theme was modified.
name (string) –
The name of the theme.
overrides (list) –
Describes the properties that can be overriden to customize a theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
tags (dict) –
One or more key-value pairs to use when tagging the theme.
(string) –
(string) –
values (list) –
A list of key-value pairs that defines the properties of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
Exceptions
get_waiter
(waiter_name)¶Returns an object that can wait for some condition.
waiter_name (str) – The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
The specified waiter object.
botocore.waiter.Waiter
list_components
(**kwargs)¶Retrieves a list of components for a specified Amplify app and backend environment.
See also: AWS API Documentation
Request Syntax
response = client.list_components(
appId='string',
environmentName='string',
maxResults=123,
nextToken='string'
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
maxResults (integer) – The maximum number of components to retrieve.
nextToken (string) – The token to request the next page of results.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'componentType': 'string',
'environmentName': 'string',
'id': 'string',
'name': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
entities (list) –
The list of components for the Amplify app.
(dict) –
Contains a summary of a component. This is a read-only data type that is returned by ListComponents
.
appId (string) –
The unique ID of the Amplify app associated with the component.
componentType (string) –
The component type.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
name (string) –
The name of the component.
nextToken (string) –
The pagination token that’s included if more results are available.
Exceptions
list_themes
(**kwargs)¶Retrieves a list of themes for a specified Amplify app and backend environment.
See also: AWS API Documentation
Request Syntax
response = client.list_themes(
appId='string',
environmentName='string',
maxResults=123,
nextToken='string'
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
maxResults (integer) – The maximum number of theme results to return in the response.
nextToken (string) – The token to request the next page of results.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'environmentName': 'string',
'id': 'string',
'name': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
entities (list) –
The list of themes for the Amplify app.
(dict) –
Describes the basic information about a theme.
appId (string) –
The unique ID for the app associated with the theme summary.
environmentName (string) –
The name of the backend environment that is part of the Amplify app.
id (string) –
The ID of the theme.
name (string) –
The name of the theme.
nextToken (string) –
The pagination token that’s returned if more results are available.
Exceptions
refresh_token
(**kwargs)¶Refreshes a previously issued access token that might have expired.
See also: AWS API Documentation
Request Syntax
response = client.refresh_token(
provider='figma',
refreshTokenBody={
'token': 'string'
}
)
provider (string) –
[REQUIRED]
The third-party provider for the token. The only valid value is figma
.
refreshTokenBody (dict) –
[REQUIRED]
Information about the refresh token request.
token (string) – [REQUIRED]
The token to use to refresh a previously issued access token that might have expired.
dict
Response Syntax
{
'accessToken': 'string',
'expiresIn': 123
}
Response Structure
(dict) –
accessToken (string) –
The access token.
expiresIn (integer) –
The date and time when the new access token expires.
Exceptions
update_component
(**kwargs)¶Updates an existing component.
See also: AWS API Documentation
Request Syntax
response = client.update_component(
appId='string',
clientToken='string',
environmentName='string',
id='string',
updatedComponent={
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'id': 'string',
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
}
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
clientToken (string) –
The unique client token.
This field is autopopulated if not provided.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID for the component.
updatedComponent (dict) –
[REQUIRED]
The configuration of the updated component.
bindingProperties (dict) –
The data binding information for the component’s properties.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
The components that are instances of the main component.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) – [REQUIRED]
The type of the child component.
name (string) – [REQUIRED]
The name of the child component.
properties (dict) – [REQUIRED]
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) – [REQUIRED]
The name of the component to retrieve a value from.
property (string) – [REQUIRED]
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The configuration for binding a component’s properties to a data model. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) – [REQUIRED]
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) – [REQUIRED]
The direction of the sort, either ascending or descending.
field (string) – [REQUIRED]
The field to perform the sort on.
componentType (string) –
The type of the component. This can be an Amplify custom UI component or another custom component.
id (string) –
The unique ID of the component to update.
name (string) –
The name of the component to update.
overrides (dict) –
Describes the properties that can be overriden to customize the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) –
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) – [REQUIRED]
The name of the component to retrieve a value from.
property (string) – [REQUIRED]
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) – [REQUIRED]
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
variants (list) –
A list of the unique variants of the main component being updated.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
dict
Response Syntax
{
'entity': {
'appId': 'string',
'bindingProperties': {
'string': {
'bindingProperties': {
'bucket': 'string',
'defaultValue': 'string',
'field': 'string',
'key': 'string',
'model': 'string',
'predicates': [
{
'and': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': {'... recursive ...'}
},
],
'userAttribute': 'string'
},
'defaultValue': 'string',
'type': 'string'
}
},
'children': [
{
'children': {'... recursive ...'},
'componentType': 'string',
'name': 'string',
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
}
},
],
'collectionProperties': {
'string': {
'identifiers': [
'string',
],
'model': 'string',
'predicate': {
'and': [
{'... recursive ...'},
],
'field': 'string',
'operand': 'string',
'operator': 'string',
'or': [
{'... recursive ...'},
]
},
'sort': [
{
'direction': 'ASC'|'DESC',
'field': 'string'
},
]
}
},
'componentType': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': {
'string': {
'string': 'string'
}
},
'properties': {
'string': {
'bindingProperties': {
'field': 'string',
'property': 'string'
},
'bindings': {
'string': {
'element': 'string',
'property': 'string'
}
},
'collectionBindingProperties': {
'field': 'string',
'property': 'string'
},
'concat': [
{'... recursive ...'},
],
'condition': {
'else': {'... recursive ...'},
'field': 'string',
'operand': 'string',
'operator': 'string',
'property': 'string',
'then': {'... recursive ...'}
},
'configured': True|False,
'defaultValue': 'string',
'event': 'string',
'importedValue': 'string',
'model': 'string',
'type': 'string',
'userAttribute': 'string',
'value': 'string'
}
},
'sourceId': 'string',
'tags': {
'string': 'string'
},
'variants': [
{
'overrides': {
'string': {
'string': 'string'
}
},
'variantValues': {
'string': 'string'
}
},
]
}
}
Response Structure
(dict) –
entity (dict) –
Describes the configuration of the updated component.
appId (string) –
The unique ID of the Amplify app associated with the component.
bindingProperties (dict) –
The information to connect a component’s properties to data at runtime.
(string) –
(dict) –
Represents the data binding configuration for a component at runtime. You can use ComponentBindingPropertiesValue
to add exposed properties to a component to allow different values to be entered when a component is reused in different places in an app.
bindingProperties (dict) –
Describes the properties to customize with data at runtime.
bucket (string) –
An Amazon S3 bucket.
defaultValue (string) –
The default value to assign to the property.
field (string) –
The field to bind the data to.
key (string) –
The storage key for an Amazon S3 bucket.
model (string) –
An Amplify DataStore model.
predicates (list) –
A list of predicates for binding a component’s properties to data.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
userAttribute (string) –
An authenticated user attribute.
defaultValue (string) –
The default value of the property.
type (string) –
The property type.
children (list) –
A list of the component’s ComponentChild
instances.
(dict) –
A nested UI configuration within a parent Component
.
children (list) –
The list of ComponentChild
instances for this component.
componentType (string) –
The type of the child component.
name (string) –
The name of the child component.
properties (dict) –
Describes the properties of the child component.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
collectionProperties (dict) –
The data binding configuration for the component’s properties. Use this for a collection component.
(string) –
(dict) –
Describes the configuration for binding a component’s properties to data.
identifiers (list) –
A list of IDs to use to bind data to a component. Use this property to bind specifically chosen data, rather than data retrieved from a query.
(string) –
model (string) –
The name of the data model to use to bind data to a component.
predicate (dict) –
Represents the conditional logic to use when binding data to a component. Use this property to retrieve only a subset of the data in a collection.
and (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
field (string) –
The field to query.
operand (string) –
The value to use when performing the evaluation.
operator (string) –
The operator to use to perform the evaluation.
or (list) –
A list of predicates to combine logically.
(dict) –
Stores information for generating Amplify DataStore queries. Use a Predicate
to retrieve a subset of the data in a collection.
sort (list) –
Describes how to sort the component’s properties.
(dict) –
Describes how to sort the data that you bind to a component.
direction (string) –
The direction of the sort, either ascending or descending.
field (string) –
The field to perform the sort on.
componentType (string) –
The type of the component. This can be an Amplify custom UI component or another custom component.
createdAt (datetime) –
The time that the component was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
modifiedAt (datetime) –
The time that the component was modified.
name (string) –
The name of the component.
overrides (dict) –
Describes the component’s properties that can be overriden in a customized instance of the component.
(string) –
(dict) –
(string) –
(string) –
properties (dict) –
Describes the component’s properties.
(string) –
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
bindingProperties (dict) –
The information to bind the component property to data at runtime.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
bindings (dict) –
The information to bind the component property to form data.
(string) –
(dict) –
Describes how to bind a component property to form data.
element (string) –
The name of the component to retrieve a value from.
property (string) –
The property to retrieve a value from.
collectionBindingProperties (dict) –
The information to bind the component property to data at runtime. Use this for collection components.
field (string) –
The data field to bind the property to.
property (string) –
The component property to bind to the data field.
concat (list) –
A list of component properties to concatenate to create the value to assign to this component property.
(dict) –
Describes the configuration for all of a component’s properties. Use ComponentProperty
to specify the values to render or bind by default.
condition (dict) –
The conditional expression to use to assign a value to the component property..
else (dict) –
The value to assign to the property if the condition is not met.
field (string) –
The name of a field. Specify this when the property is a data model.
operand (string) –
The value of the property to evaluate.
operator (string) –
The operator to use to perform the evaluation, such as eq
to represent equals.
property (string) –
The name of the conditional property.
then (dict) –
The value to assign to the property if the condition is met.
configured (boolean) –
Specifies whether the user configured the property in Amplify Studio after importing it.
defaultValue (string) –
The default value to assign to the component property.
event (string) –
An event that occurs in your app. Use this for workflow data binding.
importedValue (string) –
The default value assigned to property when the component is imported into an app.
model (string) –
The data model to use to assign a value to the component property.
type (string) –
The component type.
userAttribute (string) –
An authenticated user attribute to use to assign a value to the component property.
value (string) –
The value to assign to the component property.
sourceId (string) –
The unique ID of the component in its original source system, such as Figma.
tags (dict) –
One or more key-value pairs to use when tagging the component.
(string) –
(string) –
variants (list) –
A list of the component’s variants. A variant is a unique style configuration of a main component.
(dict) –
Describes the style configuration of a unique variation of a main component.
overrides (dict) –
The properties of the component variant that can be overriden when customizing an instance of the component.
(string) –
(dict) –
(string) –
(string) –
variantValues (dict) –
The combination of variants that comprise this variant.
(string) –
(string) –
Exceptions
update_theme
(**kwargs)¶Updates an existing theme.
See also: AWS API Documentation
Request Syntax
response = client.update_theme(
appId='string',
clientToken='string',
environmentName='string',
id='string',
updatedTheme={
'id': 'string',
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
}
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
clientToken (string) –
The unique client token.
This field is autopopulated if not provided.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is part of the Amplify app.
id (string) –
[REQUIRED]
The unique ID for the theme.
updatedTheme (dict) –
[REQUIRED]
The configuration of the updated theme.
id (string) –
The unique ID of the theme to update.
name (string) –
The name of the theme to update.
overrides (list) –
Describes the properties that can be overriden to customize the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
values (list) – [REQUIRED]
A list of key-value pairs that define the theme’s properties.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
dict
Response Syntax
{
'entity': {
'appId': 'string',
'createdAt': datetime(2015, 1, 1),
'environmentName': 'string',
'id': 'string',
'modifiedAt': datetime(2015, 1, 1),
'name': 'string',
'overrides': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
],
'tags': {
'string': 'string'
},
'values': [
{
'key': 'string',
'value': {
'children': {'... recursive ...'},
'value': 'string'
}
},
]
}
}
Response Structure
(dict) –
entity (dict) –
Describes the configuration of the updated theme.
appId (string) –
The unique ID for the Amplify app associated with the theme.
createdAt (datetime) –
The time that the theme was created.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The ID for the theme.
modifiedAt (datetime) –
The time that the theme was modified.
name (string) –
The name of the theme.
overrides (list) –
Describes the properties that can be overriden to customize a theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
tags (dict) –
One or more key-value pairs to use when tagging the theme.
(string) –
(string) –
values (list) –
A list of key-value pairs that defines the properties of the theme.
(dict) –
A key-value pair that defines a property of a theme.
key (string) –
The name of the property.
value (dict) –
The value of the property.
children (list) –
A list of key-value pairs that define the theme’s properties.
value (string) –
The value of a theme property.
Exceptions
Client exceptions are available on a client instance via the exceptions
property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.
The available client exceptions are:
AmplifyUIBuilder.Client.exceptions.InvalidParameterException
AmplifyUIBuilder.Client.exceptions.ResourceConflictException
AmplifyUIBuilder.Client.exceptions.ResourceNotFoundException
AmplifyUIBuilder.Client.exceptions.ServiceQuotaExceededException
AmplifyUIBuilder.Client.exceptions.
InternalServerException
¶An internal error has occurred. Please retry your request.
Example
try:
...
except client.exceptions.InternalServerException as e:
print(e.response)
response
¶The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An internal error has occurred. Please retry your request.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
AmplifyUIBuilder.Client.exceptions.
InvalidParameterException
¶An invalid or out-of-range value was supplied for the input parameter.
Example
try:
...
except client.exceptions.InvalidParameterException as e:
print(e.response)
response
¶The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An invalid or out-of-range value was supplied for the input parameter.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
AmplifyUIBuilder.Client.exceptions.
ResourceConflictException
¶The resource specified in the request conflicts with an existing resource.
Example
try:
...
except client.exceptions.ResourceConflictException as e:
print(e.response)
response
¶The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The resource specified in the request conflicts with an existing resource.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
AmplifyUIBuilder.Client.exceptions.
ResourceNotFoundException
¶The requested resource does not exist, or access was denied.
Example
try:
...
except client.exceptions.ResourceNotFoundException as e:
print(e.response)
response
¶The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The requested resource does not exist, or access was denied.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
AmplifyUIBuilder.Client.exceptions.
ServiceQuotaExceededException
¶You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account.
Example
try:
...
except client.exceptions.ServiceQuotaExceededException as e:
print(e.response)
response
¶The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your Amazon Web Services account.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The available paginators are:
AmplifyUIBuilder.Paginator.
ListComponents
¶paginator = client.get_paginator('list_components')
paginate
(**kwargs)¶Creates an iterator that will paginate through responses from AmplifyUIBuilder.Client.list_components()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
appId='string',
environmentName='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'componentType': 'string',
'environmentName': 'string',
'id': 'string',
'name': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
entities (list) –
The list of components for the Amplify app.
(dict) –
Contains a summary of a component. This is a read-only data type that is returned by ListComponents
.
appId (string) –
The unique ID of the Amplify app associated with the component.
componentType (string) –
The component type.
environmentName (string) –
The name of the backend environment that is a part of the Amplify app.
id (string) –
The unique ID of the component.
name (string) –
The name of the component.
NextToken (string) –
A token to resume pagination.
AmplifyUIBuilder.Paginator.
ListThemes
¶paginator = client.get_paginator('list_themes')
paginate
(**kwargs)¶Creates an iterator that will paginate through responses from AmplifyUIBuilder.Client.list_themes()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
appId='string',
environmentName='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
appId (string) –
[REQUIRED]
The unique ID for the Amplify app.
environmentName (string) –
[REQUIRED]
The name of the backend environment that is a part of the Amplify app.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'entities': [
{
'appId': 'string',
'environmentName': 'string',
'id': 'string',
'name': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
entities (list) –
The list of themes for the Amplify app.
(dict) –
Describes the basic information about a theme.
appId (string) –
The unique ID for the app associated with the theme summary.
environmentName (string) –
The name of the backend environment that is part of the Amplify app.
id (string) –
The ID of the theme.
name (string) –
The name of the theme.
NextToken (string) –
A token to resume pagination.