aws_clouddirectory
Amazon Cloud Directory
Amazon Cloud Directory is a component of the AWS Directory Service that simplifies the development and management of cloud-scale web, mobile, and IoT applications.
This guide describes the Cloud Directory operations that you can call programmatically and includes detailed information on data types and errors. For information about Cloud Directory features, see AWS Directory Service and the Amazon Cloud Directory Developer Guide.Summary
Functions
-
add_facet_to_object(Client, Input)
Adds a new
Facet
to an object. - add_facet_to_object(Client, Input0, Options0)
-
apply_schema(Client, Input)
Copies the input published schema, at the specified version, into the
Directory
with the same name and version as that of the published schema. - apply_schema(Client, Input0, Options0)
-
attach_object(Client, Input)
Attaches an existing object to another object.
- attach_object(Client, Input0, Options0)
-
attach_policy(Client, Input)
Attaches a policy object to a regular object.
- attach_policy(Client, Input0, Options0)
-
attach_to_index(Client, Input)
Attaches the specified object to the specified index.
- attach_to_index(Client, Input0, Options0)
-
attach_typed_link(Client, Input)
Attaches a typed link to a specified source and target object.
- attach_typed_link(Client, Input0, Options0)
-
batch_read(Client, Input)
Performs all the read operations in a batch.
- batch_read(Client, Input0, Options0)
-
batch_write(Client, Input)
Performs all the write operations in a batch.
- batch_write(Client, Input0, Options0)
-
create_directory(Client, Input)
Creates a
Directory
by copying the published schema into the directory. - create_directory(Client, Input0, Options0)
-
create_facet(Client, Input)
Creates a new
Facet
in a schema. - create_facet(Client, Input0, Options0)
-
create_index(Client, Input)
Creates an index object.
- create_index(Client, Input0, Options0)
-
create_object(Client, Input)
Creates an object in a
Directory
. - create_object(Client, Input0, Options0)
-
create_schema(Client, Input)
Creates a new schema in a development state.
- create_schema(Client, Input0, Options0)
-
create_typed_link_facet(Client, Input)
Creates a
TypedLinkFacet
. - create_typed_link_facet(Client, Input0, Options0)
-
delete_directory(Client, Input)
Deletes a directory.
- delete_directory(Client, Input0, Options0)
-
delete_facet(Client, Input)
Deletes a given
Facet
. - delete_facet(Client, Input0, Options0)
-
delete_object(Client, Input)
Deletes an object and its associated attributes.
- delete_object(Client, Input0, Options0)
-
delete_schema(Client, Input)
Deletes a given schema.
- delete_schema(Client, Input0, Options0)
-
delete_typed_link_facet(Client, Input)
Deletes a
TypedLinkFacet
. - delete_typed_link_facet(Client, Input0, Options0)
-
detach_from_index(Client, Input)
Detaches the specified object from the specified index.
- detach_from_index(Client, Input0, Options0)
-
detach_object(Client, Input)
Detaches a given object from the parent object.
- detach_object(Client, Input0, Options0)
-
detach_policy(Client, Input)
Detaches a policy from an object.
- detach_policy(Client, Input0, Options0)
-
detach_typed_link(Client, Input)
Detaches a typed link from a specified source and target object.
- detach_typed_link(Client, Input0, Options0)
-
disable_directory(Client, Input)
Disables the specified directory.
- disable_directory(Client, Input0, Options0)
-
enable_directory(Client, Input)
Enables the specified directory.
- enable_directory(Client, Input0, Options0)
-
get_applied_schema_version(Client, Input)
Returns current applied schema version ARN, including the minor version in use.
- get_applied_schema_version(Client, Input0, Options0)
-
get_directory(Client, Input)
Retrieves metadata about a directory.
- get_directory(Client, Input0, Options0)
-
get_facet(Client, Input)
Gets details of the
Facet
, such as facet name, attributes,Rule
s, orObjectType
. - get_facet(Client, Input0, Options0)
-
get_link_attributes(Client, Input)
Retrieves attributes that are associated with a typed link.
- get_link_attributes(Client, Input0, Options0)
-
get_object_attributes(Client, Input)
Retrieves attributes within a facet that are associated with an object.
- get_object_attributes(Client, Input0, Options0)
-
get_object_information(Client, Input)
Retrieves metadata about an object.
- get_object_information(Client, Input0, Options0)
-
get_schema_as_json(Client, Input)
Retrieves a JSON representation of the schema.
- get_schema_as_json(Client, Input0, Options0)
-
get_typed_link_facet_information(Client, Input)
Returns the identity attribute order for a specific
TypedLinkFacet
. - get_typed_link_facet_information(Client, Input0, Options0)
-
list_applied_schema_arns(Client, Input)
Lists schema major versions applied to a directory.
- list_applied_schema_arns(Client, Input0, Options0)
-
list_attached_indices(Client, Input)
Lists indices attached to the specified object.
- list_attached_indices(Client, Input0, Options0)
-
list_development_schema_arns(Client, Input)
Retrieves each Amazon Resource Name (ARN) of schemas in the development state.
- list_development_schema_arns(Client, Input0, Options0)
-
list_directories(Client, Input)
Lists directories created within an account.
- list_directories(Client, Input0, Options0)
-
list_facet_attributes(Client, Input)
Retrieves attributes attached to the facet.
- list_facet_attributes(Client, Input0, Options0)
-
list_facet_names(Client, Input)
Retrieves the names of facets that exist in a schema.
- list_facet_names(Client, Input0, Options0)
-
list_incoming_typed_links(Client, Input)
Returns a paginated list of all the incoming
TypedLinkSpecifier
information for an object. - list_incoming_typed_links(Client, Input0, Options0)
-
list_index(Client, Input)
Lists objects attached to the specified index.
- list_index(Client, Input0, Options0)
-
list_managed_schema_arns(Client, Input)
Lists the major version families of each managed schema.
- list_managed_schema_arns(Client, Input0, Options0)
-
list_object_attributes(Client, Input)
Lists all attributes that are associated with an object.
- list_object_attributes(Client, Input0, Options0)
-
list_object_children(Client, Input)
Returns a paginated list of child objects that are associated with a given object.
- list_object_children(Client, Input0, Options0)
-
list_object_parent_paths(Client, Input)
Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects.
- list_object_parent_paths(Client, Input0, Options0)
-
list_object_parents(Client, Input)
Lists parent objects that are associated with a given object in pagination fashion.
- list_object_parents(Client, Input0, Options0)
-
list_object_policies(Client, Input)
Returns policies attached to an object in pagination fashion.
- list_object_policies(Client, Input0, Options0)
-
list_outgoing_typed_links(Client, Input)
Returns a paginated list of all the outgoing
TypedLinkSpecifier
information for an object. - list_outgoing_typed_links(Client, Input0, Options0)
-
list_policy_attachments(Client, Input)
Returns all of the
ObjectIdentifiers
to which a given policy is attached. - list_policy_attachments(Client, Input0, Options0)
-
list_published_schema_arns(Client, Input)
Lists the major version families of each published schema.
- list_published_schema_arns(Client, Input0, Options0)
-
list_tags_for_resource(Client, Input)
Returns tags for a resource.
- list_tags_for_resource(Client, Input0, Options0)
-
list_typed_link_facet_attributes(Client, Input)
Returns a paginated list of all attribute definitions for a particular
TypedLinkFacet
. - list_typed_link_facet_attributes(Client, Input0, Options0)
-
list_typed_link_facet_names(Client, Input)
Returns a paginated list of
TypedLink
facet names for a particular schema. - list_typed_link_facet_names(Client, Input0, Options0)
-
lookup_policy(Client, Input)
Lists all policies from the root of the
Directory
to the object specified. - lookup_policy(Client, Input0, Options0)
-
publish_schema(Client, Input)
Publishes a development schema with a major version and a recommended minor version.
- publish_schema(Client, Input0, Options0)
-
put_schema_from_json(Client, Input)
Allows a schema to be updated using JSON upload.
- put_schema_from_json(Client, Input0, Options0)
-
remove_facet_from_object(Client, Input)
Removes the specified facet from the specified object.
- remove_facet_from_object(Client, Input0, Options0)
-
tag_resource(Client, Input)
An API operation for adding tags to a resource.
- tag_resource(Client, Input0, Options0)
-
untag_resource(Client, Input)
An API operation for removing tags from a resource.
- untag_resource(Client, Input0, Options0)
-
update_facet(Client, Input)
Does the following:.
- update_facet(Client, Input0, Options0)
-
update_link_attributes(Client, Input)
Updates a given typed link’s attributes.
- update_link_attributes(Client, Input0, Options0)
-
update_object_attributes(Client, Input)
Updates a given object's attributes.
- update_object_attributes(Client, Input0, Options0)
-
update_schema(Client, Input)
Updates the schema name with a new name.
- update_schema(Client, Input0, Options0)
-
update_typed_link_facet(Client, Input)
Updates a
TypedLinkFacet
. - update_typed_link_facet(Client, Input0, Options0)
-
upgrade_applied_schema(Client, Input)
Upgrades a single directory in-place using the
PublishedSchemaArn
with schema updates found inMinorVersion
. - upgrade_applied_schema(Client, Input0, Options0)
-
upgrade_published_schema(Client, Input)
Upgrades a published schema under a new minor version revision using the current contents of
DevelopmentSchemaArn
. - upgrade_published_schema(Client, Input0, Options0)
Functions
add_facet_to_object(Client, Input)
Adds a new Facet
to an object.
add_facet_to_object(Client, Input0, Options0)
apply_schema(Client, Input)
Copies the input published schema, at the specified version, into the
Directory
with the same name and version as that of the published
schema.
apply_schema(Client, Input0, Options0)
attach_object(Client, Input)
Attaches an existing object to another object.
An object can be accessed in two ways:
Using the path
Using
ObjectIdentifier
attach_object(Client, Input0, Options0)
attach_policy(Client, Input)
Attaches a policy object to a regular object.
An object can have a limited number of attached policies.attach_policy(Client, Input0, Options0)
attach_to_index(Client, Input)
Attaches the specified object to the specified index.
attach_to_index(Client, Input0, Options0)
attach_typed_link(Client, Input)
Attaches a typed link to a specified source and target object.
For more information, see Typed Links.attach_typed_link(Client, Input0, Options0)
batch_read(Client, Input)
Performs all the read operations in a batch.
batch_read(Client, Input0, Options0)
batch_write(Client, Input)
Performs all the write operations in a batch.
Either all the operations succeed or none.batch_write(Client, Input0, Options0)
create_directory(Client, Input)
Creates a Directory
by copying the published schema into the
directory.
A directory cannot be created without a schema.
You can also quickly create a directory using a managed schema, called theQuickStartSchema
. For more information, see Managed Schema in the Amazon
Cloud Directory Developer Guide.
create_directory(Client, Input0, Options0)
create_facet(Client, Input)
Creates a new Facet
in a schema.
create_facet(Client, Input0, Options0)
create_index(Client, Input)
Creates an index object.
See Indexing and search for more information.create_index(Client, Input0, Options0)
create_object(Client, Input)
Creates an object in a Directory
.
LinkName
is specified. An object is simply a collection of Facet
attributes. You can also use this API call to create a policy object, if
the facet from which you create the object is a policy facet.
create_object(Client, Input0, Options0)
create_schema(Client, Input)
Creates a new schema in a development state.
A schema can exist in three phases:
Development: This is a mutable phase of the schema. All new schemas are in the development phase. Once the schema is finalized, it can be published.
Published: Published schemas are immutable and have a version associated with them.
Applied: Applied schemas are mutable in a way that allows you to add new schema facets. You can also add new, nonrequired attributes to existing schema facets. You can apply only published schemas to directories.
create_schema(Client, Input0, Options0)
create_typed_link_facet(Client, Input)
Creates a TypedLinkFacet
.
create_typed_link_facet(Client, Input0, Options0)
delete_directory(Client, Input)
Deletes a directory.
Only disabled directories can be deleted. A deleted directory cannot be undone. Exercise extreme caution when deleting directories.delete_directory(Client, Input0, Options0)
delete_facet(Client, Input)
Deletes a given Facet
.
Rule
s that are associated with the facet will be
deleted. Only development schema facets are allowed deletion.
delete_facet(Client, Input0, Options0)
delete_object(Client, Input)
Deletes an object and its associated attributes.
Only objects with no children and no parents can be deleted. The maximum number of attributes that can be deleted during an object deletion is 30. For more information, see Amazon Cloud Directory Limits.delete_object(Client, Input0, Options0)
delete_schema(Client, Input)
Deletes a given schema.
Schemas in a development and published state can only be deleted.delete_schema(Client, Input0, Options0)
delete_typed_link_facet(Client, Input)
Deletes a TypedLinkFacet
.
delete_typed_link_facet(Client, Input0, Options0)
detach_from_index(Client, Input)
Detaches the specified object from the specified index.
detach_from_index(Client, Input0, Options0)
detach_object(Client, Input)
Detaches a given object from the parent object.
The object that is to be detached from the parent is specified by the link name.detach_object(Client, Input0, Options0)
detach_policy(Client, Input)
Detaches a policy from an object.
detach_policy(Client, Input0, Options0)
detach_typed_link(Client, Input)
Detaches a typed link from a specified source and target object.
For more information, see Typed Links.detach_typed_link(Client, Input0, Options0)
disable_directory(Client, Input)
Disables the specified directory.
Disabled directories cannot be read or written to. Only enabled directories can be disabled. Disabled directories may be reenabled.disable_directory(Client, Input0, Options0)
enable_directory(Client, Input)
Enables the specified directory.
Only disabled directories can be enabled. Once enabled, the directory can then be read and written to.enable_directory(Client, Input0, Options0)
get_applied_schema_version(Client, Input)
Returns current applied schema version ARN, including the minor version in use.
get_applied_schema_version(Client, Input0, Options0)
get_directory(Client, Input)
Retrieves metadata about a directory.
get_directory(Client, Input0, Options0)
get_facet(Client, Input)
Gets details of the Facet
, such as facet name, attributes, Rule
s,
or ObjectType
.
get_facet(Client, Input0, Options0)
get_link_attributes(Client, Input)
Retrieves attributes that are associated with a typed link.
get_link_attributes(Client, Input0, Options0)
get_object_attributes(Client, Input)
Retrieves attributes within a facet that are associated with an object.
get_object_attributes(Client, Input0, Options0)
get_object_information(Client, Input)
Retrieves metadata about an object.
get_object_information(Client, Input0, Options0)
get_schema_as_json(Client, Input)
Retrieves a JSON representation of the schema.
See JSON Schema Format for more information.get_schema_as_json(Client, Input0, Options0)
get_typed_link_facet_information(Client, Input)
Returns the identity attribute order for a specific TypedLinkFacet
.
get_typed_link_facet_information(Client, Input0, Options0)
list_applied_schema_arns(Client, Input)
Lists schema major versions applied to a directory.
IfSchemaArn
is provided, lists the minor version.
list_applied_schema_arns(Client, Input0, Options0)
list_attached_indices(Client, Input)
Lists indices attached to the specified object.
list_attached_indices(Client, Input0, Options0)
list_development_schema_arns(Client, Input)
Retrieves each Amazon Resource Name (ARN) of schemas in the development state.
list_development_schema_arns(Client, Input0, Options0)
list_directories(Client, Input)
Lists directories created within an account.
list_directories(Client, Input0, Options0)
list_facet_attributes(Client, Input)
Retrieves attributes attached to the facet.
list_facet_attributes(Client, Input0, Options0)
list_facet_names(Client, Input)
Retrieves the names of facets that exist in a schema.
list_facet_names(Client, Input0, Options0)
list_incoming_typed_links(Client, Input)
Returns a paginated list of all the incoming TypedLinkSpecifier
information for an object.
list_incoming_typed_links(Client, Input0, Options0)
list_index(Client, Input)
Lists objects attached to the specified index.
list_index(Client, Input0, Options0)
list_managed_schema_arns(Client, Input)
Lists the major version families of each managed schema.
If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.list_managed_schema_arns(Client, Input0, Options0)
list_object_attributes(Client, Input)
Lists all attributes that are associated with an object.
list_object_attributes(Client, Input0, Options0)
list_object_children(Client, Input)
Returns a paginated list of child objects that are associated with a given object.
list_object_children(Client, Input0, Options0)
list_object_parent_paths(Client, Input)
Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects.
For more information about objects, see Directory Structure.
Use this API to evaluate all parents for an object. The call returns all objects from the root of the directory up to the requested object. The API returns the number of paths based on user-definedMaxResults
, in case
there are multiple paths to the parent. The order of the paths and nodes
returned is consistent among multiple API calls unless the objects are
deleted or moved. Paths not leading to the directory root are ignored from
the target object.
list_object_parent_paths(Client, Input0, Options0)
list_object_parents(Client, Input)
Lists parent objects that are associated with a given object in pagination fashion.
list_object_parents(Client, Input0, Options0)
list_object_policies(Client, Input)
Returns policies attached to an object in pagination fashion.
list_object_policies(Client, Input0, Options0)
list_outgoing_typed_links(Client, Input)
Returns a paginated list of all the outgoing TypedLinkSpecifier
information for an object.
list_outgoing_typed_links(Client, Input0, Options0)
list_policy_attachments(Client, Input)
Returns all of the ObjectIdentifiers
to which a given policy is
attached.
list_policy_attachments(Client, Input0, Options0)
list_published_schema_arns(Client, Input)
Lists the major version families of each published schema.
If a major version ARN is provided asSchemaArn
, the minor version
revisions in that family are listed instead.
list_published_schema_arns(Client, Input0, Options0)
list_tags_for_resource(Client, Input)
Returns tags for a resource.
Tagging is currently supported only for directories with a limit of 50 tags per directory. All 50 tags are returned for a given directory with this API call.list_tags_for_resource(Client, Input0, Options0)
list_typed_link_facet_attributes(Client, Input)
Returns a paginated list of all attribute definitions for a
particular TypedLinkFacet
.
list_typed_link_facet_attributes(Client, Input0, Options0)
list_typed_link_facet_names(Client, Input)
Returns a paginated list of TypedLink
facet names for a particular
schema.
list_typed_link_facet_names(Client, Input0, Options0)
lookup_policy(Client, Input)
Lists all policies from the root of the Directory
to the object
specified.
ObjectIdentifier
for such objects. If policies are present,
it returns ObjectIdentifier
, policyId
, and policyType
. Paths that
don't lead to the root from the target object are ignored. For more
information, see Policies.
lookup_policy(Client, Input0, Options0)
publish_schema(Client, Input)
Publishes a development schema with a major version and a recommended minor version.
publish_schema(Client, Input0, Options0)
put_schema_from_json(Client, Input)
Allows a schema to be updated using JSON upload.
Only available for development schemas. See JSON Schema Format for more information.put_schema_from_json(Client, Input0, Options0)
remove_facet_from_object(Client, Input)
Removes the specified facet from the specified object.
remove_facet_from_object(Client, Input0, Options0)
tag_resource(Client, Input)
An API operation for adding tags to a resource.
tag_resource(Client, Input0, Options0)
untag_resource(Client, Input)
An API operation for removing tags from a resource.
untag_resource(Client, Input0, Options0)
update_facet(Client, Input)
Does the following:
Adds new
Attributes
,Rules
, orObjectTypes
.Updates existing
Attributes
,Rules
, orObjectTypes
.Deletes existing
Attributes
,Rules
, orObjectTypes
.
update_facet(Client, Input0, Options0)
update_link_attributes(Client, Input)
Updates a given typed link’s attributes.
Attributes to be updated must not contribute to the typed link’s identity, as defined by itsIdentityAttributeOrder
.
update_link_attributes(Client, Input0, Options0)
update_object_attributes(Client, Input)
Updates a given object's attributes.
update_object_attributes(Client, Input0, Options0)
update_schema(Client, Input)
Updates the schema name with a new name.
Only development schema names can be updated.update_schema(Client, Input0, Options0)
update_typed_link_facet(Client, Input)
Updates a TypedLinkFacet
.
update_typed_link_facet(Client, Input0, Options0)
upgrade_applied_schema(Client, Input)
Upgrades a single directory in-place using the PublishedSchemaArn
with schema updates found in MinorVersion
.
upgrade_applied_schema(Client, Input0, Options0)
upgrade_published_schema(Client, Input)
Upgrades a published schema under a new minor version revision using
the current contents of DevelopmentSchemaArn
.