Schemas

Client

class Schemas.Client

A low-level client representing Schemas:

client = session.create_client('schemas')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
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").
Returns
True if the operation can be paginated, False otherwise.
create_discoverer(**kwargs)

Creates a discoverer.

See also: AWS API Documentation

Request Syntax

response = client.create_discoverer(
    Description='string',
    SourceArn='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • Description (string) -- A description for the discoverer.
  • SourceArn (string) --

    [REQUIRED]

    The ARN of the event bus.

  • Tags (dict) --

    Tags associated with the resource.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'Description': 'string',
    'DiscovererArn': 'string',
    'DiscovererId': 'string',
    'SourceArn': 'string',
    'State': 'STARTED'|'STOPPED',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    201 response

    • 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.

      • (string) --
        • (string) --

Exceptions

create_registry(**kwargs)

Creates a registry.

See also: AWS API Documentation

Request Syntax

response = client.create_registry(
    Description='string',
    RegistryName='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • Description (string) -- A description of the registry to be created.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • Tags (dict) --

    Tags to associate with the registry.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'Description': 'string',
    'RegistryArn': 'string',
    'RegistryName': 'string',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    201 response

    • 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.

      • (string) --
        • (string) --

Exceptions

create_schema(**kwargs)

Creates a schema definition.

Note

Inactive schemas will be deleted after two years.

See also: AWS API Documentation

Request Syntax

response = client.create_schema(
    Content='string',
    Description='string',
    RegistryName='string',
    SchemaName='string',
    Tags={
        'string': 'string'
    },
    Type='OpenApi3'
)
Parameters
  • Content (string) --

    [REQUIRED]

    The source of the schema definition.

  • Description (string) -- A description of the schema.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • Tags (dict) --

    Tags associated with the schema.

    • (string) --
      • (string) --
  • Type (string) --

    [REQUIRED]

    The type of schema.

Return type

dict

Returns

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) --

    201 response

    • 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.

      • (string) --
        • (string) --
    • Type (string) --

      The type of the schema.

    • VersionCreatedDate (datetime) --

      The date the schema version was created.

Exceptions

delete_discoverer(**kwargs)

Deletes a discoverer.

See also: AWS API Documentation

Request Syntax

response = client.delete_discoverer(
    DiscovererId='string'
)
Parameters
DiscovererId (string) --

[REQUIRED]

The ID of the discoverer.

Returns
None

Exceptions

delete_registry(**kwargs)

Deletes a Registry.

See also: AWS API Documentation

Request Syntax

response = client.delete_registry(
    RegistryName='string'
)
Parameters
RegistryName (string) --

[REQUIRED]

The name of the registry.

Returns
None

Exceptions

delete_resource_policy(**kwargs)

Delete the resource-based policy attached to the specified registry.

See also: AWS API Documentation

Request Syntax

response = client.delete_resource_policy(
    RegistryName='string'
)
Parameters
RegistryName (string) -- The name of the registry.
Returns
None

Exceptions

delete_schema(**kwargs)

Delete a schema definition.

See also: AWS API Documentation

Request Syntax

response = client.delete_schema(
    RegistryName='string',
    SchemaName='string'
)
Parameters
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

Returns

None

Exceptions

delete_schema_version(**kwargs)

Delete the schema version definition

See also: AWS API Documentation

Request Syntax

response = client.delete_schema_version(
    RegistryName='string',
    SchemaName='string',
    SchemaVersion='string'
)
Parameters
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- [REQUIRED] The version number of the schema
Returns

None

Exceptions

describe_code_binding(**kwargs)

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'
)
Parameters
  • Language (string) --

    [REQUIRED]

    The language of the code binding.

  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- Specifying this limits the results to only this schema version.
Return type

dict

Returns

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) --

    200 response

    • 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.

Exceptions

describe_discoverer(**kwargs)

Describes the discoverer.

See also: AWS API Documentation

Request Syntax

response = client.describe_discoverer(
    DiscovererId='string'
)
Parameters
DiscovererId (string) --

[REQUIRED]

The ID of the discoverer.

Return type
dict
Returns
Response Syntax
{
    'Description': 'string',
    'DiscovererArn': 'string',
    'DiscovererId': 'string',
    'SourceArn': 'string',
    'State': 'STARTED'|'STOPPED',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    200 response

    • 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.

      • (string) --
        • (string) --

Exceptions

describe_registry(**kwargs)

Describes the registry.

See also: AWS API Documentation

Request Syntax

response = client.describe_registry(
    RegistryName='string'
)
Parameters
RegistryName (string) --

[REQUIRED]

The name of the registry.

Return type
dict
Returns
Response Syntax
{
    'Description': 'string',
    'RegistryArn': 'string',
    'RegistryName': 'string',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    200 response

    • 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.

      • (string) --
        • (string) --

Exceptions

describe_schema(**kwargs)

Retrieve the schema definition.

See also: AWS API Documentation

Request Syntax

response = client.describe_schema(
    RegistryName='string',
    SchemaName='string',
    SchemaVersion='string'
)
Parameters
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- Specifying this limits the results to only this schema version.
Return type

dict

Returns

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) --

    200 response

    • Content (string) --

      The source of the schema definition.

    • 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.

      • (string) --
        • (string) --
    • Type (string) --

      The type of the schema.

    • VersionCreatedDate (datetime) --

      The date the schema version was created.

Exceptions

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_code_binding_source(**kwargs)

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'
)
Parameters
  • Language (string) --

    [REQUIRED]

    The language of the code binding.

  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- Specifying this limits the results to only this schema version.
Return type

dict

Returns

Response Syntax

{
    'Body': StreamingBody()
}

Response Structure

Exceptions

get_discovered_schema(**kwargs)

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'
)
Parameters
  • Events (list) --

    [REQUIRED]

    An array of strings where each string is a JSON event. These are the events that were used to generate the schema. The array includes a single type of event and has a maximum size of 10 events.

    • (string) --
  • Type (string) --

    [REQUIRED]

    The type of event.

Return type

dict

Returns

Response Syntax

{
    'Content': 'string'
}

Response Structure

  • (dict) --

    200 response

    • Content (string) --

      The source of the schema definition.

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
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").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_resource_policy(**kwargs)

Retrieves the resource-based policy attached to a given registry.

See also: AWS API Documentation

Request Syntax

response = client.get_resource_policy(
    RegistryName='string'
)
Parameters
RegistryName (string) -- The name of the registry.
Return type
dict
Returns
Response Syntax
{
    'Policy': 'string',
    'RevisionId': 'string'
}

Response Structure

  • (dict) --

    Get Resource-Based Policy Response

    • Policy (string) --

      The resource-based policy.

    • RevisionId (string) --

      The revision ID.

Exceptions

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_discoverers(**kwargs)

List the discoverers.

See also: AWS API Documentation

Request Syntax

response = client.list_discoverers(
    DiscovererIdPrefix='string',
    Limit=123,
    NextToken='string',
    SourceArnPrefix='string'
)
Parameters
  • DiscovererIdPrefix (string) -- Specifying this limits the results to only those discoverer IDs that start with the specified prefix.
  • Limit (integer) --
  • 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.
  • SourceArnPrefix (string) -- Specifying this limits the results to only those ARNs that start with the specified prefix.
Return type

dict

Returns

Response Syntax

{
    'Discoverers': [
        {
            'DiscovererArn': 'string',
            'DiscovererId': 'string',
            'SourceArn': 'string',
            'State': 'STARTED'|'STOPPED',
            'Tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    200 response

    • 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) --

          The state of the discoverer.

        • Tags (dict) --

          Tags associated with the resource.

          • (string) --
            • (string) --
    • 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.

Exceptions

list_registries(**kwargs)

List the registries.

See also: AWS API Documentation

Request Syntax

response = client.list_registries(
    Limit=123,
    NextToken='string',
    RegistryNamePrefix='string',
    Scope='string'
)
Parameters
  • Limit (integer) --
  • 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.
  • RegistryNamePrefix (string) -- Specifying this limits the results to only those registry names that start with the specified prefix.
  • Scope (string) -- Can be set to Local or AWS to limit responses to your custom registries, or the ones provided by AWS.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'Registries': [
        {
            'RegistryArn': 'string',
            'RegistryName': 'string',
            'Tags': {
                'string': 'string'
            }
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

          • (string) --
            • (string) --

Exceptions

list_schema_versions(**kwargs)

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'
)
Parameters
  • Limit (integer) --
  • 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.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'SchemaVersions': [
        {
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'SchemaVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

Exceptions

list_schemas(**kwargs)

List the schemas.

See also: AWS API Documentation

Request Syntax

response = client.list_schemas(
    Limit=123,
    NextToken='string',
    RegistryName='string',
    SchemaNamePrefix='string'
)
Parameters
  • Limit (integer) --
  • 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.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaNamePrefix (string) -- Specifying this limits the results to only those schema names that start with the specified prefix.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'Schemas': [
        {
            'LastModified': datetime(2015, 1, 1),
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'Tags': {
                'string': 'string'
            },
            'VersionCount': 123
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

          • (string) --
            • (string) --
        • VersionCount (integer) --

          The number of versions available for the schema.

Exceptions

list_tags_for_resource(**kwargs)

Get tags for resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    ResourceArn='string'
)
Parameters
ResourceArn (string) --

[REQUIRED]

The ARN of the resource.

Return type
dict
Returns
Response Syntax
{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    200 response

    • Tags (dict) --

      Key-value pairs associated with a resource.

      • (string) --
        • (string) --

Exceptions

put_code_binding(**kwargs)

Put code binding URI

See also: AWS API Documentation

Request Syntax

response = client.put_code_binding(
    Language='string',
    RegistryName='string',
    SchemaName='string',
    SchemaVersion='string'
)
Parameters
  • Language (string) --

    [REQUIRED]

    The language of the code binding.

  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- Specifying this limits the results to only this schema version.
Return type

dict

Returns

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) --

    202 response

    • 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.

Exceptions

put_resource_policy(**kwargs)

The name of the policy.

See also: AWS API Documentation

Request Syntax

response = client.put_resource_policy(
    Policy='string',
    RegistryName='string',
    RevisionId='string'
)
Parameters
  • Policy (string) --

    [REQUIRED]

    The resource-based policy.

  • RegistryName (string) -- The name of the registry.
  • RevisionId (string) -- The revision ID of the policy.
Return type

dict

Returns

Response Syntax

{
    'Policy': 'string',
    'RevisionId': 'string'
}

Response Structure

  • (dict) --

    200 response

    • Policy (string) --

      The resource-based policy.

    • RevisionId (string) --

      The revision ID of the policy.

Exceptions

search_schemas(**kwargs)

Search the schemas

See also: AWS API Documentation

Request Syntax

response = client.search_schemas(
    Keywords='string',
    Limit=123,
    NextToken='string',
    RegistryName='string'
)
Parameters
  • Keywords (string) --

    [REQUIRED]

    Specifying this limits the results to only schemas that include the provided keywords.

  • Limit (integer) --
  • 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.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'Schemas': [
        {
            'RegistryName': 'string',
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'SchemaVersions': [
                {
                    'CreatedDate': datetime(2015, 1, 1),
                    'SchemaVersion': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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) --

              The date the schema version was created.

            • SchemaVersion (string) --

              The version number of the schema

Exceptions

start_discoverer(**kwargs)

Starts the discoverer

See also: AWS API Documentation

Request Syntax

response = client.start_discoverer(
    DiscovererId='string'
)
Parameters
DiscovererId (string) --

[REQUIRED]

The ID of the discoverer.

Return type
dict
Returns
Response Syntax
{
    'DiscovererId': 'string',
    'State': 'STARTED'|'STOPPED'
}

Response Structure

  • (dict) --

    200 response

    • DiscovererId (string) --

      The ID of the discoverer.

    • State (string) --

      The state of the discoverer.

Exceptions

stop_discoverer(**kwargs)

Stops the discoverer

See also: AWS API Documentation

Request Syntax

response = client.stop_discoverer(
    DiscovererId='string'
)
Parameters
DiscovererId (string) --

[REQUIRED]

The ID of the discoverer.

Return type
dict
Returns
Response Syntax
{
    'DiscovererId': 'string',
    'State': 'STARTED'|'STOPPED'
}

Response Structure

  • (dict) --

    200 response

    • DiscovererId (string) --

      The ID of the discoverer.

    • State (string) --

      The state of the discoverer.

Exceptions

tag_resource(**kwargs)

Add tags to a resource.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    ResourceArn='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The ARN of the resource.

  • Tags (dict) --

    [REQUIRED]

    Tags associated with the resource.

    • (string) --
      • (string) --
Returns

None

Exceptions

untag_resource(**kwargs)

Removes tags from a resource.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    ResourceArn='string',
    TagKeys=[
        'string',
    ]
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The ARN of the resource.

  • TagKeys (list) --

    [REQUIRED]

    Keys of key-value pairs.

    • (string) --
Returns

None

Exceptions

update_discoverer(**kwargs)

Updates the discoverer

See also: AWS API Documentation

Request Syntax

response = client.update_discoverer(
    Description='string',
    DiscovererId='string'
)
Parameters
  • Description (string) -- The description of the discoverer to update.
  • DiscovererId (string) --

    [REQUIRED]

    The ID of the discoverer.

Return type

dict

Returns

Response Syntax

{
    'Description': 'string',
    'DiscovererArn': 'string',
    'DiscovererId': 'string',
    'SourceArn': 'string',
    'State': 'STARTED'|'STOPPED',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    200 response

    • 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.

      • (string) --
        • (string) --

Exceptions

update_registry(**kwargs)

Updates a registry.

See also: AWS API Documentation

Request Syntax

response = client.update_registry(
    Description='string',
    RegistryName='string'
)
Parameters
  • Description (string) -- The description of the registry to update.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

Return type

dict

Returns

Response Syntax

{
    'Description': 'string',
    'RegistryArn': 'string',
    'RegistryName': 'string',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    200 response

    • 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.

      • (string) --
        • (string) --

Exceptions

update_schema(**kwargs)

Updates the schema definition

Note

Inactive schemas will be deleted after two years.

See also: AWS API Documentation

Request Syntax

response = client.update_schema(
    ClientTokenId='string',
    Content='string',
    Description='string',
    RegistryName='string',
    SchemaName='string',
    Type='OpenApi3'
)
Parameters
  • ClientTokenId (string) --

    The ID of the client token.

    This field is autopopulated if not provided.

  • Content (string) -- The source of the schema definition.
  • Description (string) -- The description of the schema.
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • Type (string) -- The schema type for the events schema.
Return type

dict

Returns

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) --

    200 response

    • 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.

      • (string) --
        • (string) --
    • Type (string) --

      The type of the schema.

    • VersionCreatedDate (datetime) --

      The date the schema version was created.

Exceptions

Client 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:

class Schemas.Client.exceptions.BadRequestException

Example

try:
  ...
except client.exceptions.BadRequestException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.ConflictException

Example

try:
  ...
except client.exceptions.ConflictException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.ForbiddenException

Example

try:
  ...
except client.exceptions.ForbiddenException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.GoneException

Example

try:
  ...
except client.exceptions.GoneException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.InternalServerErrorException

Example

try:
  ...
except client.exceptions.InternalServerErrorException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.NotFoundException

Example

try:
  ...
except client.exceptions.NotFoundException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.PreconditionFailedException

Example

try:
  ...
except client.exceptions.PreconditionFailedException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.ServiceUnavailableException

Example

try:
  ...
except client.exceptions.ServiceUnavailableException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.TooManyRequestsException

Example

try:
  ...
except client.exceptions.TooManyRequestsException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.
class Schemas.Client.exceptions.UnauthorizedException

Example

try:
  ...
except client.exceptions.UnauthorizedException 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

{
    'Code': 'string',
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    • Code (string) --

      The error code.

    • Message (string) --

      The message string of the error output.

    • 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.

Paginators

The available paginators are:

class Schemas.Paginator.ListDiscoverers
paginator = client.get_paginator('list_discoverers')
paginate(**kwargs)

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'
    }
)
Parameters
  • DiscovererIdPrefix (string) -- Specifying this limits the results to only those discoverer IDs that start with the specified prefix.
  • SourceArnPrefix (string) -- Specifying this limits the results to only those ARNs that start with the specified prefix.
  • 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.

Return type

dict

Returns

Response Syntax

{
    'Discoverers': [
        {
            'DiscovererArn': 'string',
            'DiscovererId': 'string',
            'SourceArn': 'string',
            'State': 'STARTED'|'STOPPED',
            'Tags': {
                'string': 'string'
            }
        },
    ],

}

Response Structure

  • (dict) --

    200 response

    • 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) --

          The state of the discoverer.

        • Tags (dict) --

          Tags associated with the resource.

          • (string) --
            • (string) --

class Schemas.Paginator.ListRegistries
paginator = client.get_paginator('list_registries')
paginate(**kwargs)

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'
    }
)
Parameters
  • RegistryNamePrefix (string) -- Specifying this limits the results to only those registry names that start with the specified prefix.
  • Scope (string) -- Can be set to Local or AWS to limit responses to your custom registries, or the ones provided by AWS.
  • 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.

Return type

dict

Returns

Response Syntax

{
    'Registries': [
        {
            'RegistryArn': 'string',
            'RegistryName': 'string',
            'Tags': {
                'string': 'string'
            }
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

          • (string) --
            • (string) --

class Schemas.Paginator.ListSchemaVersions
paginator = client.get_paginator('list_schema_versions')
paginate(**kwargs)

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'
    }
)
Parameters
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • 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.

Return type

dict

Returns

Response Syntax

{
    'SchemaVersions': [
        {
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'SchemaVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

class Schemas.Paginator.ListSchemas
paginator = client.get_paginator('list_schemas')
paginate(**kwargs)

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'
    }
)
Parameters
  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaNamePrefix (string) -- Specifying this limits the results to only those schema names that start with the specified prefix.
  • 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.

Return type

dict

Returns

Response Syntax

{
    'Schemas': [
        {
            'LastModified': datetime(2015, 1, 1),
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'Tags': {
                'string': 'string'
            },
            'VersionCount': 123
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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.

          • (string) --
            • (string) --
        • VersionCount (integer) --

          The number of versions available for the schema.

class Schemas.Paginator.SearchSchemas
paginator = client.get_paginator('search_schemas')
paginate(**kwargs)

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'
    }
)
Parameters
  • Keywords (string) --

    [REQUIRED]

    Specifying this limits the results to only schemas that include the provided keywords.

  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • 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.

Return type

dict

Returns

Response Syntax

{
    'Schemas': [
        {
            'RegistryName': 'string',
            'SchemaArn': 'string',
            'SchemaName': 'string',
            'SchemaVersions': [
                {
                    'CreatedDate': datetime(2015, 1, 1),
                    'SchemaVersion': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    200 response

    • 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) --

              The date the schema version was created.

            • SchemaVersion (string) --

              The version number of the schema

Waiters

The available waiters are:

class Schemas.Waiter.CodeBindingExists
waiter = client.get_waiter('code_binding_exists')
wait(**kwargs)

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
    }
)
Parameters
  • Language (string) --

    [REQUIRED]

    The language of the code binding.

  • RegistryName (string) --

    [REQUIRED]

    The name of the registry.

  • SchemaName (string) --

    [REQUIRED]

    The name of the schema.

  • SchemaVersion (string) -- Specifying this limits the results to only this schema version.
  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 2

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 30

Returns

None