GetComponent
Returns an existing component for an Amplify app.
Request Syntax
GET /app/appId
/environment/environmentName
/components/id
HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- appId
-
The unique ID of the Amplify app.
Required: Yes
- environmentName
-
The name of the backend environment that is part of the Amplify app.
Required: Yes
- id
-
The unique ID of the component.
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"appId": "string",
"bindingProperties": {
"string" : {
"bindingProperties": {
"bucket": "string",
"defaultValue": "string",
"field": "string",
"key": "string",
"model": "string",
"predicates": [
{
"and": [
"Predicate"
],
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"or": [
"Predicate"
]
}
],
"slotName": "string",
"userAttribute": "string"
},
"defaultValue": "string",
"type": "string"
}
},
"children": [
{
"children": [
"ComponentChild"
],
"componentType": "string",
"events": {
"string" : {
"action": "string",
"bindingEvent": "string",
"parameters": {
"anchor": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"fields": {
"string" : {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"global": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"id": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"model": "string",
"state": {
"componentName": "string",
"property": "string",
"set": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"target": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"type": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"url": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
}
}
},
"name": "string",
"properties": {
"string" : {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"sourceId": "string"
}
],
"collectionProperties": {
"string" : {
"identifiers": [ "string" ],
"model": "string",
"predicate": {
"and": [
"Predicate"
],
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"or": [
"Predicate"
]
},
"sort": [
{
"direction": "string",
"field": "string"
}
]
}
},
"componentType": "string",
"createdAt": "string",
"environmentName": "string",
"events": {
"string" : {
"action": "string",
"bindingEvent": "string",
"parameters": {
"anchor": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"fields": {
"string" : {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"global": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"id": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"model": "string",
"state": {
"componentName": "string",
"property": "string",
"set": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"target": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"type": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
},
"url": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"bindings": {
"string" : {
"element": "string",
"property": "string"
}
},
"collectionBindingProperties": {
"field": "string",
"property": "string"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
}
}
},
"id": "string",
"modifiedAt": "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"
},
"componentName": "string",
"concat": [
"ComponentProperty"
],
"condition": {
"else": "ComponentProperty",
"field": "string",
"operand": "string",
"operandType": "string",
"operator": "string",
"property": "string",
"then": "ComponentProperty"
},
"configured": boolean,
"defaultValue": "string",
"event": "string",
"importedValue": "string",
"model": "string",
"property": "string",
"type": "string",
"userAttribute": "string",
"value": "string"
}
},
"schemaVersion": "string",
"sourceId": "string",
"tags": {
"string" : "string"
},
"variants": [
{
"overrides": {
"string" : {
"string" : "string"
}
},
"variantValues": {
"string" : "string"
}
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- appId
-
The unique ID of the Amplify app associated with the component.
Type: String
- bindingProperties
-
The information to connect a component's properties to data at runtime. You can't specify
tags
as a valid property forbindingProperties
.Type: String to ComponentBindingPropertiesValue object map
- children
-
A list of the component's
ComponentChild
instances.Type: Array of ComponentChild objects
- collectionProperties
-
The data binding configuration for the component's properties. Use this for a collection component. You can't specify
tags
as a valid property forcollectionProperties
.Type: String to ComponentDataConfiguration object map
- componentType
-
The type of the component. This can be an Amplify custom UI component or another custom component.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
- createdAt
-
The time that the component was created.
Type: Timestamp
- environmentName
-
The name of the backend environment that is a part of the Amplify app.
Type: String
- events
-
Describes the events that can be raised on the component. Use for the workflow feature in Amplify Studio that allows you to bind events and actions to components.
Type: String to ComponentEvent object map
- id
-
The unique ID of the component.
Type: String
- modifiedAt
-
The time that the component was modified.
Type: Timestamp
- name
-
The name of the component.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
- overrides
-
Describes the component's properties that can be overriden in a customized instance of the component. You can't specify
tags
as a valid property foroverrides
.Type: String to string to string map map
- properties
-
Describes the component's properties. You can't specify
tags
as a valid property forproperties
.Type: String to ComponentProperty object map
- schemaVersion
-
The schema version of the component when it was imported.
Type: String
- sourceId
-
The unique ID of the component in its original source system, such as Figma.
Type: String
-
One or more key-value pairs to use when tagging the component.
Type: String to string map
Key Length Constraints: Minimum length of 1. Maximum length of 128.
Key Pattern:
(?!aws:)[a-zA-Z+-=._:/]+
Value Length Constraints: Minimum length of 1. Maximum length of 256.
- variants
-
A list of the component's variants. A variant is a unique style configuration of a main component.
Type: Array of ComponentVariant objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerException
-
An internal error has occurred. Please retry your request.
HTTP Status Code: 500
- InvalidParameterException
-
An invalid or out-of-range value was supplied for the input parameter.
HTTP Status Code: 400
- ResourceNotFoundException
-
The requested resource does not exist, or access was denied.
HTTP Status Code: 404
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: