Table of Contents
A low-level client representing Schemas:
import boto3
client = boto3.client('schemas')
These are the available methods:
Check if an operation can be paginated.
Creates a discoverer.
See also: AWS API Documentation
Request Syntax
response = client.create_discoverer(
Description='string',
SourceArn='string',
Tags={
'string': 'string'
}
)
[REQUIRED]
The ARN of the event bus.
Tags associated with the resource.
dict
Response Syntax
{
'Description': 'string',
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
Description (string) --
The description of the discoverer.
DiscovererArn (string) --
The ARN of the discoverer.
DiscovererId (string) --
The ID of the discoverer.
SourceArn (string) --
The ARN of the event bus.
State (string) --
The state of the discoverer.
Tags (dict) --
Tags associated with the resource.
Creates a registry.
See also: AWS API Documentation
Request Syntax
response = client.create_registry(
Description='string',
RegistryName='string',
Tags={
'string': 'string'
}
)
Tags to associate with the registry.
dict
Response Syntax
{
'Description': 'string',
'RegistryArn': 'string',
'RegistryName': 'string',
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
Description (string) --
The description of the registry.
RegistryArn (string) --
The ARN of the registry.
RegistryName (string) --
The name of the registry.
Tags (dict) --
Tags associated with the registry.
Creates a schema definition.
See also: AWS API Documentation
Request Syntax
response = client.create_schema(
Content='string',
Description='string',
RegistryName='string',
SchemaName='string',
Tags={
'string': 'string'
},
Type='OpenApi3'
)
Tags associated with the schema.
dict
Response Syntax
{
'Description': 'string',
'LastModified': datetime(2015, 1, 1),
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersion': 'string',
'Tags': {
'string': 'string'
},
'Type': 'string',
'VersionCreatedDate': datetime(2015, 1, 1)
}
Response Structure
(dict) --
Description (string) --
The description of the schema.
LastModified (datetime) --
The date and time that schema was modified.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
SchemaVersion (string) --
The version number of the schema
Tags (dict) --
Key-value pairs associated with a resource.
Type (string) --
The type of the schema.
VersionCreatedDate (datetime) --
The date the schema version was created.
Deletes a discoverer.
See also: AWS API Documentation
Request Syntax
response = client.delete_discoverer(
DiscovererId='string'
)
Deletes a Registry.
See also: AWS API Documentation
Request Syntax
response = client.delete_registry(
RegistryName='string'
)
Delete a schema definition.
See also: AWS API Documentation
Request Syntax
response = client.delete_schema(
RegistryName='string',
SchemaName='string'
)
None
Delete the schema version definition
See also: AWS API Documentation
Request Syntax
response = client.delete_schema_version(
RegistryName='string',
SchemaName='string',
SchemaVersion='string'
)
None
Describe the code binding URI.
See also: AWS API Documentation
Request Syntax
response = client.describe_code_binding(
Language='string',
RegistryName='string',
SchemaName='string',
SchemaVersion='string'
)
dict
Response Syntax
{
'CreationDate': datetime(2015, 1, 1),
'LastModified': datetime(2015, 1, 1),
'SchemaVersion': 'string',
'Status': 'CREATE_IN_PROGRESS'|'CREATE_COMPLETE'|'CREATE_FAILED'
}
Response Structure
(dict) --
CreationDate (datetime) --
The time and date that the code binding was created.
LastModified (datetime) --
The date and time that code bindings were modified.
SchemaVersion (string) --
The version number of the schema.
Status (string) --
The current status of code binding generation.
Describes the discoverer.
See also: AWS API Documentation
Request Syntax
response = client.describe_discoverer(
DiscovererId='string'
)
{
'Description': 'string',
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
}
Response Structure
The description of the discoverer.
The ARN of the discoverer.
The ID of the discoverer.
The ARN of the event bus.
The state of the discoverer.
Tags associated with the resource.
Describes the registry.
See also: AWS API Documentation
Request Syntax
response = client.describe_registry(
RegistryName='string'
)
{
'Description': 'string',
'RegistryArn': 'string',
'RegistryName': 'string',
'Tags': {
'string': 'string'
}
}
Response Structure
The description of the registry.
The ARN of the registry.
The name of the registry.
Tags associated with the registry.
Retrieve the schema definition.
See also: AWS API Documentation
Request Syntax
response = client.describe_schema(
RegistryName='string',
SchemaName='string',
SchemaVersion='string'
)
dict
Response Syntax
{
'Content': 'string',
'Description': 'string',
'LastModified': datetime(2015, 1, 1),
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersion': 'string',
'Tags': {
'string': 'string'
},
'Type': 'string',
'VersionCreatedDate': datetime(2015, 1, 1)
}
Response Structure
(dict) --
Content (string) --
Description (string) --
The description of the schema.
LastModified (datetime) --
The date and time that schema was modified.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
SchemaVersion (string) --
The version number of the schema
Tags (dict) --
Tags associated with the resource.
Type (string) --
The type of the schema.
VersionCreatedDate (datetime) --
The date the schema version was created.
Generate a presigned url given a client, its method, and arguments
The presigned url
Get the code binding source URI.
See also: AWS API Documentation
Request Syntax
response = client.get_code_binding_source(
Language='string',
RegistryName='string',
SchemaName='string',
SchemaVersion='string'
)
dict
Response Syntax
{
'Body': StreamingBody()
}
Response Structure
Get the discovered schema that was generated based on sampled events.
See also: AWS API Documentation
Request Syntax
response = client.get_discovered_schema(
Events=[
'string',
],
Type='OpenApi3'
)
[REQUIRED]
An array of strings that
[REQUIRED]
The type of event.
dict
Response Syntax
{
'Content': 'string'
}
Response Structure
Create a paginator for an operation.
Returns an object that can wait for some condition.
List the discoverers.
See also: AWS API Documentation
Request Syntax
response = client.list_discoverers(
DiscovererIdPrefix='string',
Limit=123,
NextToken='string',
SourceArnPrefix='string'
)
dict
Response Syntax
{
'Discoverers': [
{
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Discoverers (list) --
An array of DiscovererSummary information.
(dict) --
DiscovererArn (string) --
The ARN of the discoverer.
DiscovererId (string) --
The ID of the discoverer.
SourceArn (string) --
The ARN of the event bus.
State (string) --
Tags (dict) --
Tags associated with the resource.
NextToken (string) --
The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.
List the registries.
See also: AWS API Documentation
Request Syntax
response = client.list_registries(
Limit=123,
NextToken='string',
RegistryNamePrefix='string',
Scope='string'
)
dict
Response Syntax
{
'NextToken': 'string',
'Registries': [
{
'RegistryArn': 'string',
'RegistryName': 'string',
'Tags': {
'string': 'string'
}
},
]
}
Response Structure
(dict) --
NextToken (string) --
The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.
Registries (list) --
An array of registry summaries.
(dict) --
RegistryArn (string) --
The ARN of the registry.
RegistryName (string) --
The name of the registry.
Tags (dict) --
Tags associated with the registry.
Provides a list of the schema versions and related information.
See also: AWS API Documentation
Request Syntax
response = client.list_schema_versions(
Limit=123,
NextToken='string',
RegistryName='string',
SchemaName='string'
)
dict
Response Syntax
{
'NextToken': 'string',
'SchemaVersions': [
{
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersion': 'string'
},
]
}
Response Structure
(dict) --
NextToken (string) --
The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.
SchemaVersions (list) --
An array of schema version summaries.
(dict) --
SchemaArn (string) --
The ARN of the schema version.
SchemaName (string) --
The name of the schema.
SchemaVersion (string) --
The version number of the schema.
List the schemas.
See also: AWS API Documentation
Request Syntax
response = client.list_schemas(
Limit=123,
NextToken='string',
RegistryName='string',
SchemaNamePrefix='string'
)
dict
Response Syntax
{
'NextToken': 'string',
'Schemas': [
{
'LastModified': datetime(2015, 1, 1),
'SchemaArn': 'string',
'SchemaName': 'string',
'Tags': {
'string': 'string'
},
'VersionCount': 123
},
]
}
Response Structure
(dict) --
NextToken (string) --
The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.
Schemas (list) --
An array of schema summaries.
(dict) --
A summary of schema details.
LastModified (datetime) --
The date and time that schema was modified.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
Tags (dict) --
Tags associated with the schema.
VersionCount (integer) --
The number of versions available for the schema.
Get tags for resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceArn='string'
)
{
'Tags': {
'string': 'string'
}
}
Response Structure
Key-value pairs associated with a resource.
See also: AWS API Documentation
Request Syntax
response = client.lock_service_linked_role(
RoleArn='string',
Timeout=123
)
dict
Response Syntax
{
'CanBeDeleted': True|False,
'ReasonOfFailure': 'string',
'RelatedResources': [
{
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
},
]
}
Response Structure
(dict) --
CanBeDeleted (boolean) --
ReasonOfFailure (string) --
RelatedResources (list) --
(dict) --
DiscovererArn (string) --
The ARN of the discoverer.
DiscovererId (string) --
The ID of the discoverer.
SourceArn (string) --
The ARN of the event bus.
State (string) --
Tags (dict) --
Tags associated with the resource.
Put code binding URI
See also: AWS API Documentation
Request Syntax
response = client.put_code_binding(
Language='string',
RegistryName='string',
SchemaName='string',
SchemaVersion='string'
)
dict
Response Syntax
{
'CreationDate': datetime(2015, 1, 1),
'LastModified': datetime(2015, 1, 1),
'SchemaVersion': 'string',
'Status': 'CREATE_IN_PROGRESS'|'CREATE_COMPLETE'|'CREATE_FAILED'
}
Response Structure
(dict) --
CreationDate (datetime) --
The time and date that the code binding was created.
LastModified (datetime) --
The date and time that code bindings were modified.
SchemaVersion (string) --
The version number of the schema.
Status (string) --
The current status of code binding generation.
Search the schemas
See also: AWS API Documentation
Request Syntax
response = client.search_schemas(
Keywords='string',
Limit=123,
NextToken='string',
RegistryName='string'
)
dict
Response Syntax
{
'NextToken': 'string',
'Schemas': [
{
'RegistryName': 'string',
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersions': [
{
'CreatedDate': datetime(2015, 1, 1),
'SchemaVersion': 'string'
},
]
},
]
}
Response Structure
(dict) --
NextToken (string) --
The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.
Schemas (list) --
An array of SearchSchemaSummary information.
(dict) --
RegistryName (string) --
The name of the registry.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
SchemaVersions (list) --
An array of schema version summaries.
(dict) --
CreatedDate (datetime) --
SchemaVersion (string) --
The version number of the schema
Starts the discoverer
See also: AWS API Documentation
Request Syntax
response = client.start_discoverer(
DiscovererId='string'
)
{
'DiscovererId': 'string',
'State': 'STARTED'|'STOPPED'
}
Response Structure
The ID of the discoverer.
The state of the discoverer.
Stops the discoverer
See also: AWS API Documentation
Request Syntax
response = client.stop_discoverer(
DiscovererId='string'
)
{
'DiscovererId': 'string',
'State': 'STARTED'|'STOPPED'
}
Response Structure
The ID of the discoverer.
The state of the discoverer.
Add tags to a resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceArn='string',
Tags={
'string': 'string'
}
)
[REQUIRED]
Key-value pairs associated with a resource.
None
See also: AWS API Documentation
Request Syntax
response = client.unlock_service_linked_role(
RoleArn='string'
)
{}
Response Structure
Removes tags from a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceArn='string',
TagKeys=[
'string',
]
)
[REQUIRED]
None
Updates the discoverer
See also: AWS API Documentation
Request Syntax
response = client.update_discoverer(
Description='string',
DiscovererId='string'
)
dict
Response Syntax
{
'Description': 'string',
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
Description (string) --
The description of the discoverer.
DiscovererArn (string) --
The ARN of the discoverer.
DiscovererId (string) --
The ID of the discoverer.
SourceArn (string) --
The ARN of the event bus.
State (string) --
The state of the discoverer.
Tags (dict) --
Tags associated with the resource.
Updates a registry.
See also: AWS API Documentation
Request Syntax
response = client.update_registry(
Description='string',
RegistryName='string'
)
dict
Response Syntax
{
'Description': 'string',
'RegistryArn': 'string',
'RegistryName': 'string',
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
Description (string) --
The description of the registry.
RegistryArn (string) --
The ARN of the registry.
RegistryName (string) --
The name of the registry.
Tags (dict) --
Tags associated with the registry.
Updates the schema definition
See also: AWS API Documentation
Request Syntax
response = client.update_schema(
ClientTokenId='string',
Content='string',
Description='string',
RegistryName='string',
SchemaName='string',
Type='OpenApi3'
)
The ID of the client token.
This field is autopopulated if not provided.
dict
Response Syntax
{
'Description': 'string',
'LastModified': datetime(2015, 1, 1),
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersion': 'string',
'Tags': {
'string': 'string'
},
'Type': 'string',
'VersionCreatedDate': datetime(2015, 1, 1)
}
Response Structure
(dict) --
Description (string) --
The description of the schema.
LastModified (datetime) --
The date and time that schema was modified.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
SchemaVersion (string) --
The version number of the schema
Tags (dict) --
Key-value pairs associated with a resource.
Type (string) --
The type of the schema.
VersionCreatedDate (datetime) --
The date the schema version was created.
The available paginators are:
paginator = client.get_paginator('list_discoverers')
Creates an iterator that will paginate through responses from Schemas.Client.list_discoverers().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DiscovererIdPrefix='string',
SourceArnPrefix='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'Discoverers': [
{
'DiscovererArn': 'string',
'DiscovererId': 'string',
'SourceArn': 'string',
'State': 'STARTED'|'STOPPED',
'Tags': {
'string': 'string'
}
},
],
}
Response Structure
(dict) --
Discoverers (list) --
An array of DiscovererSummary information.
(dict) --
DiscovererArn (string) --
The ARN of the discoverer.
DiscovererId (string) --
The ID of the discoverer.
SourceArn (string) --
The ARN of the event bus.
State (string) --
Tags (dict) --
Tags associated with the resource.
paginator = client.get_paginator('list_registries')
Creates an iterator that will paginate through responses from Schemas.Client.list_registries().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
RegistryNamePrefix='string',
Scope='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'Registries': [
{
'RegistryArn': 'string',
'RegistryName': 'string',
'Tags': {
'string': 'string'
}
},
]
}
Response Structure
(dict) --
Registries (list) --
An array of registry summaries.
(dict) --
RegistryArn (string) --
The ARN of the registry.
RegistryName (string) --
The name of the registry.
Tags (dict) --
Tags associated with the registry.
paginator = client.get_paginator('list_schema_versions')
Creates an iterator that will paginate through responses from Schemas.Client.list_schema_versions().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
RegistryName='string',
SchemaName='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'SchemaVersions': [
{
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersion': 'string'
},
]
}
Response Structure
(dict) --
SchemaVersions (list) --
An array of schema version summaries.
(dict) --
SchemaArn (string) --
The ARN of the schema version.
SchemaName (string) --
The name of the schema.
SchemaVersion (string) --
The version number of the schema.
paginator = client.get_paginator('list_schemas')
Creates an iterator that will paginate through responses from Schemas.Client.list_schemas().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
RegistryName='string',
SchemaNamePrefix='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'Schemas': [
{
'LastModified': datetime(2015, 1, 1),
'SchemaArn': 'string',
'SchemaName': 'string',
'Tags': {
'string': 'string'
},
'VersionCount': 123
},
]
}
Response Structure
(dict) --
Schemas (list) --
An array of schema summaries.
(dict) --
A summary of schema details.
LastModified (datetime) --
The date and time that schema was modified.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
Tags (dict) --
Tags associated with the schema.
VersionCount (integer) --
The number of versions available for the schema.
paginator = client.get_paginator('search_schemas')
Creates an iterator that will paginate through responses from Schemas.Client.search_schemas().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
Keywords='string',
RegistryName='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'Schemas': [
{
'RegistryName': 'string',
'SchemaArn': 'string',
'SchemaName': 'string',
'SchemaVersions': [
{
'CreatedDate': datetime(2015, 1, 1),
'SchemaVersion': 'string'
},
]
},
]
}
Response Structure
(dict) --
Schemas (list) --
An array of SearchSchemaSummary information.
(dict) --
RegistryName (string) --
The name of the registry.
SchemaArn (string) --
The ARN of the schema.
SchemaName (string) --
The name of the schema.
SchemaVersions (list) --
An array of schema version summaries.
(dict) --
CreatedDate (datetime) --
SchemaVersion (string) --
The version number of the schema
The available waiters are:
waiter = client.get_waiter('code_binding_exists')
Polls Schemas.Client.describe_code_binding() every 2 seconds until a successful state is reached. An error is returned after 30 failed checks.
See also: AWS API Documentation
Request Syntax
waiter.wait(
Language='string',
RegistryName='string',
SchemaName='string',
SchemaVersion='string',
WaiterConfig={
'Delay': 123,
'MaxAttempts': 123
}
)
A dictionary that provides parameters to control waiting behavior.
The amount of time in seconds to wait between attempts. Default: 2
The maximum number of attempts to be made. Default: 30
None