A low-level client representing Amazon CloudDirectory
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 .
client = session.create_client('clouddirectory')
These are the available methods:
Adds a new Facet to an object. An object can have more than one facet applied on it.
See also: AWS API Documentation
Request Syntax
response = client.add_facet_to_object(
DirectoryArn='string',
SchemaFacet={
'SchemaArn': 'string',
'FacetName': 'string'
},
ObjectAttributeList=[
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
ObjectReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
SchemaFacet (dict) –
[REQUIRED]
Identifiers for the facet that you are adding to the object. See SchemaFacet for details.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectAttributeList (list) –
Attributes on the facet that you are adding to the object.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) – [REQUIRED]
The key of the attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Value (dict) – [REQUIRED]
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectReference (dict) –
[REQUIRED]
A reference to the object you are adding the specified facet to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Copies the input published schema, at the specified version, into the Directory with the same name and version as that of the published schema.
See also: AWS API Documentation
Request Syntax
response = client.apply_schema(
PublishedSchemaArn='string',
DirectoryArn='string'
)
PublishedSchemaArn (string) –
[REQUIRED]
Published schema Amazon Resource Name (ARN) that needs to be copied. For more information, see arns .
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory into which the schema is copied. For more information, see arns .
dict
Response Syntax
{
'AppliedSchemaArn': 'string',
'DirectoryArn': 'string'
}
Response Structure
(dict) –
AppliedSchemaArn (string) –
The applied schema ARN that is associated with the copied schema in the Directory . You can use this ARN to describe the schema information applied on this directory. For more information, see arns .
DirectoryArn (string) –
The ARN that is associated with the Directory . For more information, see arns .
Exceptions
Attaches an existing object to another object. An object can be accessed in two ways:
Using the path
Using ObjectIdentifier
See also: AWS API Documentation
Request Syntax
response = client.attach_object(
DirectoryArn='string',
ParentReference={
'Selector': 'string'
},
ChildReference={
'Selector': 'string'
},
LinkName='string'
)
DirectoryArn (string) –
[REQUIRED]
Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns .
ParentReference (dict) –
[REQUIRED]
The parent object reference.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ChildReference (dict) –
[REQUIRED]
The child object reference to be attached to the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) –
[REQUIRED]
The link name with which the child object is attached to the parent.
dict
Response Syntax
{
'AttachedObjectIdentifier': 'string'
}
Response Structure
(dict) –
AttachedObjectIdentifier (string) –
The attached ObjectIdentifier
, which is the child ObjectIdentifier
.
Exceptions
Attaches a policy object to a regular object. An object can have a limited number of attached policies.
See also: AWS API Documentation
Request Syntax
response = client.attach_policy(
DirectoryArn='string',
PolicyReference={
'Selector': 'string'
},
ObjectReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns .
PolicyReference (dict) –
[REQUIRED]
The reference that is associated with the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object to which the policy will be attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Attaches the specified object to the specified index.
See also: AWS API Documentation
Request Syntax
response = client.attach_to_index(
DirectoryArn='string',
IndexReference={
'Selector': 'string'
},
TargetReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where the object and index exist.
IndexReference (dict) –
[REQUIRED]
A reference to the index that you are attaching the object to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetReference (dict) –
[REQUIRED]
A reference to the object that you are attaching to the index.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{
'AttachedObjectIdentifier': 'string'
}
Response Structure
(dict) –
AttachedObjectIdentifier (string) –
The ObjectIdentifier
of the object that was attached to the index.
Exceptions
Attaches a typed link to a specified source and target object. For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.attach_typed_link(
DirectoryArn='string',
SourceObjectReference={
'Selector': 'string'
},
TargetObjectReference={
'Selector': 'string'
},
TypedLinkFacet={
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
Attributes=[
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to attach the typed link.
SourceObjectReference (dict) –
[REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
[REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TypedLinkFacet (dict) –
[REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
Attributes (list) –
[REQUIRED]
A set of attributes that are associated with the typed link.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
dict
Response Syntax
{
'TypedLinkSpecifier': {
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
}
Response Structure
(dict) –
TypedLinkSpecifier (dict) –
Returns a typed link specifier as output.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
Exceptions
Performs all the read operations in a batch.
See also: AWS API Documentation
Request Syntax
response = client.batch_read(
DirectoryArn='string',
Operations=[
{
'ListObjectAttributes': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123,
'FacetFilter': {
'SchemaArn': 'string',
'FacetName': 'string'
}
},
'ListObjectChildren': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListAttachedIndices': {
'TargetReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListObjectParentPaths': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'GetObjectInformation': {
'ObjectReference': {
'Selector': 'string'
}
},
'GetObjectAttributes': {
'ObjectReference': {
'Selector': 'string'
},
'SchemaFacet': {
'SchemaArn': 'string',
'FacetName': 'string'
},
'AttributeNames': [
'string',
]
},
'ListObjectParents': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListObjectPolicies': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListPolicyAttachments': {
'PolicyReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'LookupPolicy': {
'ObjectReference': {
'Selector': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListIndex': {
'RangesOnIndexedValues': [
{
'AttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
'IndexReference': {
'Selector': 'string'
},
'MaxResults': 123,
'NextToken': 'string'
},
'ListOutgoingTypedLinks': {
'ObjectReference': {
'Selector': 'string'
},
'FilterAttributeRanges': [
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
'FilterTypedLink': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'ListIncomingTypedLinks': {
'ObjectReference': {
'Selector': 'string'
},
'FilterAttributeRanges': [
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
'FilterTypedLink': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'NextToken': 'string',
'MaxResults': 123
},
'GetLinkAttributes': {
'TypedLinkSpecifier': {
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
'AttributeNames': [
'string',
]
}
},
],
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory . For more information, see arns .
Operations (list) –
[REQUIRED]
A list of operations that are part of the batch.
(dict) –
Represents the output of a BatchRead
operation.
ListObjectAttributes (dict) –
Lists all attributes that are associated with an object.
ObjectReference (dict) – [REQUIRED]
Reference of the object whose attributes need to be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of items to be retrieved in a single call. This is an approximate number.
FacetFilter (dict) –
Used to filter the list of object attributes that are associated with a certain facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ListObjectChildren (dict) –
Returns a paginated list of child objects that are associated with a given object.
ObjectReference (dict) – [REQUIRED]
Reference of the object for which child objects are being listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
Maximum number of items to be retrieved in a single call. This is an approximate number.
ListAttachedIndices (dict) –
Lists indices attached to an object.
TargetReference (dict) – [REQUIRED]
A reference to the object that has indices attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
ListObjectParentPaths (dict) –
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 .
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
GetObjectInformation (dict) –
Retrieves metadata about an object.
ObjectReference (dict) – [REQUIRED]
A reference to the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
GetObjectAttributes (dict) –
Retrieves attributes within a facet that are associated with an object.
ObjectReference (dict) – [REQUIRED]
Reference that identifies the object whose attributes will be retrieved.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
SchemaFacet (dict) – [REQUIRED]
Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
AttributeNames (list) – [REQUIRED]
List of attribute names whose values will be retrieved.
(string) –
ListObjectParents (dict) –
Lists parent objects that are associated with a given object in pagination fashion.
ObjectReference (dict) – [REQUIRED]
The reference that identifies an object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of items to be retrieved in a single call. This is an approximate number.
ListObjectPolicies (dict) –
Returns policies attached to an object in pagination fashion.
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
ListPolicyAttachments (dict) –
Returns all of the ObjectIdentifiers
to which a given policy is attached.
PolicyReference (dict) – [REQUIRED]
The reference that identifies the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
LookupPolicy (dict) –
Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don’t have the policies attached, it returns the 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 .
ObjectReference (dict) – [REQUIRED]
Reference that identifies the object whose policies will be looked up.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
ListIndex (dict) –
Lists objects attached to the specified index.
RangesOnIndexedValues (list) –
Specifies the ranges of indexed values that you want to query.
(dict) –
A range of attributes.
AttributeKey (dict) –
The key of the attribute that the attribute range covers.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Range (dict) –
The range of attribute values being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IndexReference (dict) – [REQUIRED]
The reference to the index to list.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
MaxResults (integer) –
The maximum number of results to retrieve.
NextToken (string) –
The pagination token.
ListOutgoingTypedLinks (dict) –
Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
ListIncomingTypedLinks (dict) –
Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
NextToken (string) –
The pagination token.
MaxResults (integer) –
The maximum number of results to retrieve.
GetLinkAttributes (dict) –
Retrieves attributes that are associated with a typed link.
TypedLinkSpecifier (dict) – [REQUIRED]
Allows a typed link specifier to be accepted as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
AttributeNames (list) – [REQUIRED]
A list of attribute names whose values will be retrieved.
(string) –
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
dict
Response Syntax
{
'Responses': [
{
'SuccessfulResponse': {
'ListObjectAttributes': {
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'NextToken': 'string'
},
'ListObjectChildren': {
'Children': {
'string': 'string'
},
'NextToken': 'string'
},
'GetObjectInformation': {
'SchemaFacets': [
{
'SchemaArn': 'string',
'FacetName': 'string'
},
],
'ObjectIdentifier': 'string'
},
'GetObjectAttributes': {
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
'ListAttachedIndices': {
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
'NextToken': 'string'
},
'ListObjectParentPaths': {
'PathToObjectIdentifiersList': [
{
'Path': 'string',
'ObjectIdentifiers': [
'string',
]
},
],
'NextToken': 'string'
},
'ListObjectPolicies': {
'AttachedPolicyIds': [
'string',
],
'NextToken': 'string'
},
'ListPolicyAttachments': {
'ObjectIdentifiers': [
'string',
],
'NextToken': 'string'
},
'LookupPolicy': {
'PolicyToPathList': [
{
'Path': 'string',
'Policies': [
{
'PolicyId': 'string',
'ObjectIdentifier': 'string',
'PolicyType': 'string'
},
]
},
],
'NextToken': 'string'
},
'ListIndex': {
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
'NextToken': 'string'
},
'ListOutgoingTypedLinks': {
'TypedLinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
'NextToken': 'string'
},
'ListIncomingTypedLinks': {
'LinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
'NextToken': 'string'
},
'GetLinkAttributes': {
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
'ListObjectParents': {
'ParentLinks': [
{
'ObjectIdentifier': 'string',
'LinkName': 'string'
},
],
'NextToken': 'string'
}
},
'ExceptionResponse': {
'Type': 'ValidationException'|'InvalidArnException'|'ResourceNotFoundException'|'InvalidNextTokenException'|'AccessDeniedException'|'NotNodeException'|'FacetValidationException'|'CannotListParentOfRootException'|'NotIndexException'|'NotPolicyException'|'DirectoryNotEnabledException'|'LimitExceededException'|'InternalServiceException',
'Message': 'string'
}
},
]
}
Response Structure
(dict) –
Responses (list) –
A list of all the responses for each batch read.
(dict) –
Represents the output of a BatchRead
response operation.
SuccessfulResponse (dict) –
Identifies which operation in a batch has succeeded.
ListObjectAttributes (dict) –
Lists all attributes that are associated with an object.
Attributes (list) –
The attributes map that is associated with the object. AttributeArn
is the key; attribute value is the value.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
ListObjectChildren (dict) –
Returns a paginated list of child objects that are associated with a given object.
Children (dict) –
The children structure, which is a map with the key as the LinkName
and ObjectIdentifier
as the value.
(string) –
(string) –
NextToken (string) –
The pagination token.
GetObjectInformation (dict) –
Retrieves metadata about an object.
SchemaFacets (list) –
The facets attached to the specified object.
(dict) –
A facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectIdentifier (string) –
The ObjectIdentifier
of the specified object.
GetObjectAttributes (dict) –
Retrieves attributes within a facet that are associated with an object.
Attributes (list) –
The attribute values that are associated with an object.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ListAttachedIndices (dict) –
Lists indices attached to an object.
IndexAttachments (list) –
The indices attached to the specified object.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
NextToken (string) –
The pagination token.
ListObjectParentPaths (dict) –
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 .
PathToObjectIdentifiersList (list) –
Returns the path to the ObjectIdentifiers
that are associated with the directory.
(dict) –
Returns the path to the ObjectIdentifiers
that is associated with the directory.
Path (string) –
The path that is used to identify the object starting from directory root.
ObjectIdentifiers (list) –
Lists ObjectIdentifiers
starting from directory root to the object in the request.
(string) –
NextToken (string) –
The pagination token.
ListObjectPolicies (dict) –
Returns policies attached to an object in pagination fashion.
AttachedPolicyIds (list) –
A list of policy ObjectIdentifiers
, that are attached to the object.
(string) –
NextToken (string) –
The pagination token.
ListPolicyAttachments (dict) –
Returns all of the ObjectIdentifiers
to which a given policy is attached.
ObjectIdentifiers (list) –
A list of ObjectIdentifiers
to which the policy is attached.
(string) –
NextToken (string) –
The pagination token.
LookupPolicy (dict) –
Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don’t have the policies attached, it returns the 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 .
PolicyToPathList (list) –
Provides list of path to policies. Policies contain PolicyId
, ObjectIdentifier
, and PolicyType
. For more information, see Policies .
(dict) –
Used when a regular object exists in a Directory and you want to find all of the policies that are associated with that object and the parent to that object.
Path (string) –
The path that is referenced from the root.
Policies (list) –
List of policy objects.
(dict) –
Contains the PolicyType
, PolicyId
, and the ObjectIdentifier
to which it is attached. For more information, see Policies .
PolicyId (string) –
The ID of PolicyAttachment
.
ObjectIdentifier (string) –
The ObjectIdentifier
that is associated with PolicyAttachment
.
PolicyType (string) –
The type of policy that can be associated with PolicyAttachment
.
NextToken (string) –
The pagination token.
ListIndex (dict) –
Lists objects attached to the specified index.
IndexAttachments (list) –
The objects and indexed values attached to the index.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
NextToken (string) –
The pagination token.
ListOutgoingTypedLinks (dict) –
Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
TypedLinkSpecifiers (list) –
Returns a typed link specifier as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
ListIncomingTypedLinks (dict) –
Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
LinkSpecifiers (list) –
Returns one or more typed link specifiers as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
GetLinkAttributes (dict) –
The list of attributes to retrieve from the typed link.
Attributes (list) –
The attributes that are associated with the typed link.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ListObjectParents (dict) –
The list of parent objects to retrieve.
ParentLinks (list) –
Returns a list of parent reference and LinkName Tuples.
(dict) –
A pair of ObjectIdentifier and LinkName.
ObjectIdentifier (string) –
The ID that is associated with the object.
LinkName (string) –
The name of the link between the parent and the child object.
NextToken (string) –
The pagination token.
ExceptionResponse (dict) –
Identifies which operation in a batch has failed.
Type (string) –
A type of exception, such as InvalidArnException
.
Message (string) –
An exception message that is associated with the failure.
Exceptions
Performs all the write operations in a batch. Either all the operations succeed or none.
See also: AWS API Documentation
Request Syntax
response = client.batch_write(
DirectoryArn='string',
Operations=[
{
'CreateObject': {
'SchemaFacet': [
{
'SchemaArn': 'string',
'FacetName': 'string'
},
],
'ObjectAttributeList': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ParentReference': {
'Selector': 'string'
},
'LinkName': 'string',
'BatchReferenceName': 'string'
},
'AttachObject': {
'ParentReference': {
'Selector': 'string'
},
'ChildReference': {
'Selector': 'string'
},
'LinkName': 'string'
},
'DetachObject': {
'ParentReference': {
'Selector': 'string'
},
'LinkName': 'string',
'BatchReferenceName': 'string'
},
'UpdateObjectAttributes': {
'ObjectReference': {
'Selector': 'string'
},
'AttributeUpdates': [
{
'ObjectAttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'ObjectAttributeAction': {
'ObjectAttributeActionType': 'CREATE_OR_UPDATE'|'DELETE',
'ObjectAttributeUpdateValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
]
},
'DeleteObject': {
'ObjectReference': {
'Selector': 'string'
}
},
'AddFacetToObject': {
'SchemaFacet': {
'SchemaArn': 'string',
'FacetName': 'string'
},
'ObjectAttributeList': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectReference': {
'Selector': 'string'
}
},
'RemoveFacetFromObject': {
'SchemaFacet': {
'SchemaArn': 'string',
'FacetName': 'string'
},
'ObjectReference': {
'Selector': 'string'
}
},
'AttachPolicy': {
'PolicyReference': {
'Selector': 'string'
},
'ObjectReference': {
'Selector': 'string'
}
},
'DetachPolicy': {
'PolicyReference': {
'Selector': 'string'
},
'ObjectReference': {
'Selector': 'string'
}
},
'CreateIndex': {
'OrderedIndexedAttributeList': [
{
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
],
'IsUnique': True|False,
'ParentReference': {
'Selector': 'string'
},
'LinkName': 'string',
'BatchReferenceName': 'string'
},
'AttachToIndex': {
'IndexReference': {
'Selector': 'string'
},
'TargetReference': {
'Selector': 'string'
}
},
'DetachFromIndex': {
'IndexReference': {
'Selector': 'string'
},
'TargetReference': {
'Selector': 'string'
}
},
'AttachTypedLink': {
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'Attributes': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
'DetachTypedLink': {
'TypedLinkSpecifier': {
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
},
'UpdateLinkAttributes': {
'TypedLinkSpecifier': {
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
'AttributeUpdates': [
{
'AttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'AttributeAction': {
'AttributeActionType': 'CREATE_OR_UPDATE'|'DELETE',
'AttributeUpdateValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
]
}
},
]
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory . For more information, see arns .
Operations (list) –
[REQUIRED]
A list of operations that are part of the batch.
(dict) –
Represents the output of a BatchWrite
operation.
CreateObject (dict) –
Creates an object.
SchemaFacet (list) – [REQUIRED]
A list of FacetArns
that will be associated with the object. For more information, see arns .
(dict) –
A facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectAttributeList (list) – [REQUIRED]
An attribute map, which contains an attribute ARN as the key and attribute value as the map value.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) – [REQUIRED]
The key of the attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Value (dict) – [REQUIRED]
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ParentReference (dict) –
If specified, the parent reference to which this object will be attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) –
The name of the link.
BatchReferenceName (string) –
The batch reference name. See Transaction Support for more information.
AttachObject (dict) –
Attaches an object to a Directory .
ParentReference (dict) – [REQUIRED]
The parent object reference.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ChildReference (dict) – [REQUIRED]
The child object reference that is to be attached to the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) – [REQUIRED]
The name of the link.
DetachObject (dict) –
Detaches an object from a Directory .
ParentReference (dict) – [REQUIRED]
Parent reference from which the object with the specified link name is detached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) – [REQUIRED]
The name of the link.
BatchReferenceName (string) –
The batch reference name. See Transaction Support for more information.
UpdateObjectAttributes (dict) –
Updates a given object’s attributes.
ObjectReference (dict) – [REQUIRED]
Reference that identifies the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
AttributeUpdates (list) – [REQUIRED]
Attributes update structure.
(dict) –
Structure that contains attribute update information.
ObjectAttributeKey (dict) –
The key of the attribute being updated.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
ObjectAttributeAction (dict) –
The action to perform as part of the attribute update.
ObjectAttributeActionType (string) –
A type that can be either Update
or Delete
.
ObjectAttributeUpdateValue (dict) –
The value that you want to update to.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
DeleteObject (dict) –
Deletes an object in a Directory .
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
AddFacetToObject (dict) –
A batch operation that adds a facet to an object.
SchemaFacet (dict) – [REQUIRED]
Represents the facet being added to the object.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectAttributeList (list) – [REQUIRED]
The attributes to set on the object.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) – [REQUIRED]
The key of the attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Value (dict) – [REQUIRED]
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectReference (dict) – [REQUIRED]
A reference to the object being mutated.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
RemoveFacetFromObject (dict) –
A batch operation that removes a facet from an object.
SchemaFacet (dict) – [REQUIRED]
The facet to remove from the object.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectReference (dict) – [REQUIRED]
A reference to the object whose facet will be removed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
AttachPolicy (dict) –
Attaches a policy object to a regular object. An object can have a limited number of attached policies.
PolicyReference (dict) – [REQUIRED]
The reference that is associated with the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ObjectReference (dict) – [REQUIRED]
The reference that identifies the object to which the policy will be attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
DetachPolicy (dict) –
Detaches a policy from a Directory .
PolicyReference (dict) – [REQUIRED]
Reference that identifies the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ObjectReference (dict) – [REQUIRED]
Reference that identifies the object whose policy object will be detached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
CreateIndex (dict) –
Creates an index object. See Indexing and search for more information.
OrderedIndexedAttributeList (list) – [REQUIRED]
Specifies the attributes that should be indexed on. Currently only a single attribute is supported.
(dict) –
A unique identifier for an attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
IsUnique (boolean) – [REQUIRED]
Indicates whether the attribute that is being indexed has unique values or not.
ParentReference (dict) –
A reference to the parent object that contains the index object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) –
The name of the link between the parent object and the index object.
BatchReferenceName (string) –
The batch reference name. See Transaction Support for more information.
AttachToIndex (dict) –
Attaches the specified object to the specified index.
IndexReference (dict) – [REQUIRED]
A reference to the index that you are attaching the object to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetReference (dict) – [REQUIRED]
A reference to the object that you are attaching to the index.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
DetachFromIndex (dict) –
Detaches the specified object from the specified index.
IndexReference (dict) – [REQUIRED]
A reference to the index object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetReference (dict) – [REQUIRED]
A reference to the object being detached from the index.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
AttachTypedLink (dict) –
Attaches a typed link to a specified source and target object. For more information, see Typed Links .
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
Attributes (list) – [REQUIRED]
A set of attributes that are associated with the typed link.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
DetachTypedLink (dict) –
Detaches a typed link from a specified source and target object. For more information, see Typed Links .
TypedLinkSpecifier (dict) – [REQUIRED]
Used to accept a typed link specifier as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
UpdateLinkAttributes (dict) –
Updates a given object’s attributes.
TypedLinkSpecifier (dict) – [REQUIRED]
Allows a typed link specifier to be accepted as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
AttributeUpdates (list) – [REQUIRED]
The attributes update structure.
(dict) –
Structure that contains attribute update information.
AttributeKey (dict) –
The key of the attribute being updated.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
AttributeAction (dict) –
The action to perform as part of the attribute update.
AttributeActionType (string) –
A type that can be either UPDATE_OR_CREATE
or DELETE
.
AttributeUpdateValue (dict) –
The value that you want to update to.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
dict
Response Syntax
{
'Responses': [
{
'CreateObject': {
'ObjectIdentifier': 'string'
},
'AttachObject': {
'attachedObjectIdentifier': 'string'
},
'DetachObject': {
'detachedObjectIdentifier': 'string'
},
'UpdateObjectAttributes': {
'ObjectIdentifier': 'string'
},
'DeleteObject': {},
'AddFacetToObject': {},
'RemoveFacetFromObject': {},
'AttachPolicy': {},
'DetachPolicy': {},
'CreateIndex': {
'ObjectIdentifier': 'string'
},
'AttachToIndex': {
'AttachedObjectIdentifier': 'string'
},
'DetachFromIndex': {
'DetachedObjectIdentifier': 'string'
},
'AttachTypedLink': {
'TypedLinkSpecifier': {
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
},
'DetachTypedLink': {},
'UpdateLinkAttributes': {}
},
]
}
Response Structure
(dict) –
Responses (list) –
A list of all the responses for each batch write.
(dict) –
Represents the output of a BatchWrite
response operation.
CreateObject (dict) –
Creates an object in a Directory .
ObjectIdentifier (string) –
The ID that is associated with the object.
AttachObject (dict) –
Attaches an object to a Directory .
attachedObjectIdentifier (string) –
The ObjectIdentifier
of the object that has been attached.
DetachObject (dict) –
Detaches an object from a Directory .
detachedObjectIdentifier (string) –
The ObjectIdentifier
of the detached object.
UpdateObjectAttributes (dict) –
Updates a given object’s attributes.
ObjectIdentifier (string) –
ID that is associated with the object.
DeleteObject (dict) –
Deletes an object in a Directory .
AddFacetToObject (dict) –
The result of an add facet to object batch operation.
RemoveFacetFromObject (dict) –
The result of a batch remove facet from object operation.
AttachPolicy (dict) –
Attaches a policy object to a regular object. An object can have a limited number of attached policies.
DetachPolicy (dict) –
Detaches a policy from a Directory .
CreateIndex (dict) –
Creates an index object. See Indexing and search for more information.
ObjectIdentifier (string) –
The ObjectIdentifier
of the index created by this operation.
AttachToIndex (dict) –
Attaches the specified object to the specified index.
AttachedObjectIdentifier (string) –
The ObjectIdentifier
of the object that was attached to the index.
DetachFromIndex (dict) –
Detaches the specified object from the specified index.
DetachedObjectIdentifier (string) –
The ObjectIdentifier
of the object that was detached from the index.
AttachTypedLink (dict) –
Attaches a typed link to a specified source and target object. For more information, see Typed Links .
TypedLinkSpecifier (dict) –
Returns a typed link specifier as output.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
DetachTypedLink (dict) –
Detaches a typed link from a specified source and target object. For more information, see Typed Links .
UpdateLinkAttributes (dict) –
Represents the output of a BatchWrite
response operation.
Exceptions
Check if an operation can be paginated.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
True
if the operation can be paginated,
False
otherwise.
Closes underlying endpoint connections.
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 the QuickStartSchema
. For more information, see Managed Schema in the Amazon Cloud Directory Developer Guide .
See also: AWS API Documentation
Request Syntax
response = client.create_directory(
Name='string',
SchemaArn='string'
)
Name (string) –
[REQUIRED]
The name of the Directory . Should be unique per account, per region.
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the published schema that will be copied into the data Directory . For more information, see arns .
dict
Response Syntax
{
'DirectoryArn': 'string',
'Name': 'string',
'ObjectIdentifier': 'string',
'AppliedSchemaArn': 'string'
}
Response Structure
(dict) –
DirectoryArn (string) –
The ARN that is associated with the Directory . For more information, see arns .
Name (string) –
The name of the Directory .
ObjectIdentifier (string) –
The root object node of the created directory.
AppliedSchemaArn (string) –
The ARN of the published schema in the Directory . Once a published schema is copied into the directory, it has its own ARN, which is referred to applied schema ARN. For more information, see arns .
Exceptions
Creates a new Facet in a schema. Facet creation is allowed only in development or applied schemas.
See also: AWS API Documentation
Request Syntax
response = client.create_facet(
SchemaArn='string',
Name='string',
Attributes=[
{
'Name': 'string',
'AttributeDefinition': {
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
}
},
'AttributeReference': {
'TargetFacetName': 'string',
'TargetAttributeName': 'string'
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
ObjectType='NODE'|'LEAF_NODE'|'POLICY'|'INDEX',
FacetStyle='STATIC'|'DYNAMIC'
)
SchemaArn (string) –
[REQUIRED]
The schema ARN in which the new Facet will be created. For more information, see arns .
Name (string) –
[REQUIRED]
The name of the Facet , which is unique for a given schema.
Attributes (list) –
The attributes that are associated with the Facet .
(dict) –
An attribute that is associated with the Facet .
Name (string) – [REQUIRED]
The name of the facet attribute.
AttributeDefinition (dict) –
A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.
Type (string) – [REQUIRED]
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
AttributeReference (dict) –
An attribute reference that is associated with the attribute. See Attribute References for more information.
TargetFacetName (string) – [REQUIRED]
The target facet name that is associated with the facet reference. See Attribute References for more information.
TargetAttributeName (string) – [REQUIRED]
The target attribute name that is associated with the facet reference. See Attribute References for more information.
RequiredBehavior (string) –
The required behavior of the FacetAttribute
.
ObjectType (string) –
Specifies whether a given object created from this facet is of type node, leaf node, policy or index.
Node: Can have multiple children but one parent.
Leaf node: Cannot have children but can have multiple parents.
Policy: Allows you to store a policy document and policy type. For more information, see Policies .
Index: Can be created with the Index API.
FacetStyle (string) – There are two different styles that you can define on any given facet, Static
and Dynamic
. For static facets, all attributes must be defined in the schema. For dynamic facets, attributes can be defined during data plane operations.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Creates an index object. See Indexing and search for more information.
See also: AWS API Documentation
Request Syntax
response = client.create_index(
DirectoryArn='string',
OrderedIndexedAttributeList=[
{
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
],
IsUnique=True|False,
ParentReference={
'Selector': 'string'
},
LinkName='string'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory where the index should be created.
OrderedIndexedAttributeList (list) –
[REQUIRED]
Specifies the attributes that should be indexed on. Currently only a single attribute is supported.
(dict) –
A unique identifier for an attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
IsUnique (boolean) –
[REQUIRED]
Indicates whether the attribute that is being indexed has unique values or not.
ParentReference (dict) –
A reference to the parent object that contains the index object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) – The name of the link between the parent object and the index object.
dict
Response Syntax
{
'ObjectIdentifier': 'string'
}
Response Structure
(dict) –
ObjectIdentifier (string) –
The ObjectIdentifier
of the index created by this operation.
Exceptions
Creates an object in a Directory . Additionally attaches the object to a parent, if a parent reference and 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.
See also: AWS API Documentation
Request Syntax
response = client.create_object(
DirectoryArn='string',
SchemaFacets=[
{
'SchemaArn': 'string',
'FacetName': 'string'
},
],
ObjectAttributeList=[
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
ParentReference={
'Selector': 'string'
},
LinkName='string'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory in which the object will be created. For more information, see arns .
SchemaFacets (list) –
[REQUIRED]
A list of schema facets to be associated with the object. Do not provide minor version components. See SchemaFacet for details.
(dict) –
A facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectAttributeList (list) –
The attribute map whose attribute ARN contains the key and attribute value as the map value.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) – [REQUIRED]
The key of the attribute.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Value (dict) – [REQUIRED]
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ParentReference (dict) –
If specified, the parent reference to which this object will be attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) – The name of link that is used to attach this object to a parent.
dict
Response Syntax
{
'ObjectIdentifier': 'string'
}
Response Structure
(dict) –
ObjectIdentifier (string) –
The identifier that is associated with the object.
Exceptions
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.
See also: AWS API Documentation
Request Syntax
response = client.create_schema(
Name='string'
)
Name (string) –
[REQUIRED]
The name that is associated with the schema. This is unique to each account and in each region.
dict
Response Syntax
{
'SchemaArn': 'string'
}
Response Structure
(dict) –
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Exceptions
Creates a TypedLinkFacet . For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.create_typed_link_facet(
SchemaArn='string',
Facet={
'Name': 'string',
'Attributes': [
{
'Name': 'string',
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
'IdentityAttributeOrder': [
'string',
]
}
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Facet (dict) –
[REQUIRED]
Facet structure that is associated with the typed link facet.
Name (string) – [REQUIRED]
The unique name of the typed link facet.
Attributes (list) – [REQUIRED]
A set of key-value pairs associated with the typed link. Typed link attributes are used when you have data values that are related to the link itself, and not to one of the two objects being linked. Identity attributes also serve to distinguish the link from others of the same type between the same objects.
(dict) –
A typed link attribute definition.
Name (string) – [REQUIRED]
The unique name of the typed link attribute.
Type (string) – [REQUIRED]
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules that are attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
RequiredBehavior (string) – [REQUIRED]
The required behavior of the TypedLinkAttributeDefinition
.
IdentityAttributeOrder (list) – [REQUIRED]
The set of attributes that distinguish links made from this facet from each other, in the order of significance. Listing typed links can filter on the values of these attributes. See ListOutgoingTypedLinks and ListIncomingTypedLinks for details.
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes a directory. Only disabled directories can be deleted. A deleted directory cannot be undone. Exercise extreme caution when deleting directories.
See also: AWS API Documentation
Request Syntax
response = client.delete_directory(
DirectoryArn='string'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory to delete.
dict
Response Syntax
{
'DirectoryArn': 'string'
}
Response Structure
(dict) –
DirectoryArn (string) –
The ARN of the deleted directory.
Exceptions
Deletes a given Facet . All attributes and Rule s that are associated with the facet will be deleted. Only development schema facets are allowed deletion.
See also: AWS API Documentation
Request Syntax
response = client.delete_facet(
SchemaArn='string',
Name='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Facet . For more information, see arns .
Name (string) –
[REQUIRED]
The name of the facet to delete.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
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 .
See also: AWS API Documentation
Request Syntax
response = client.delete_object(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
A reference that identifies the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes a given schema. Schemas in a development and published state can only be deleted.
See also: AWS API Documentation
Request Syntax
response = client.delete_schema(
SchemaArn='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the development schema. For more information, see arns .
dict
Response Syntax
{
'SchemaArn': 'string'
}
Response Structure
(dict) –
SchemaArn (string) –
The input ARN that is returned as part of the response. For more information, see arns .
Exceptions
Deletes a TypedLinkFacet . For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.delete_typed_link_facet(
SchemaArn='string',
Name='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Name (string) –
[REQUIRED]
The unique name of the typed link facet.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Detaches the specified object from the specified index.
See also: AWS API Documentation
Request Syntax
response = client.detach_from_index(
DirectoryArn='string',
IndexReference={
'Selector': 'string'
},
TargetReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory the index and object exist in.
IndexReference (dict) –
[REQUIRED]
A reference to the index object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetReference (dict) –
[REQUIRED]
A reference to the object being detached from the index.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{
'DetachedObjectIdentifier': 'string'
}
Response Structure
(dict) –
DetachedObjectIdentifier (string) –
The ObjectIdentifier
of the object that was detached from the index.
Exceptions
Detaches a given object from the parent object. The object that is to be detached from the parent is specified by the link name.
See also: AWS API Documentation
Request Syntax
response = client.detach_object(
DirectoryArn='string',
ParentReference={
'Selector': 'string'
},
LinkName='string'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns .
ParentReference (dict) –
[REQUIRED]
The parent reference from which the object with the specified link name is detached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
LinkName (string) –
[REQUIRED]
The link name associated with the object that needs to be detached.
dict
Response Syntax
{
'DetachedObjectIdentifier': 'string'
}
Response Structure
(dict) –
DetachedObjectIdentifier (string) –
The ObjectIdentifier
that was detached from the object.
Exceptions
Detaches a policy from an object.
See also: AWS API Documentation
Request Syntax
response = client.detach_policy(
DirectoryArn='string',
PolicyReference={
'Selector': 'string'
},
ObjectReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns .
PolicyReference (dict) –
[REQUIRED]
Reference that identifies the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose policy object will be detached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Detaches a typed link from a specified source and target object. For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.detach_typed_link(
DirectoryArn='string',
TypedLinkSpecifier={
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to detach the typed link.
TypedLinkSpecifier (dict) –
[REQUIRED]
Used to accept a typed link specifier as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
None
Exceptions
Disables the specified directory. Disabled directories cannot be read or written to. Only enabled directories can be disabled. Disabled directories may be reenabled.
See also: AWS API Documentation
Request Syntax
response = client.disable_directory(
DirectoryArn='string'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory to disable.
dict
Response Syntax
{
'DirectoryArn': 'string'
}
Response Structure
(dict) –
DirectoryArn (string) –
The ARN of the directory that has been disabled.
Exceptions
Enables the specified directory. Only disabled directories can be enabled. Once enabled, the directory can then be read and written to.
See also: AWS API Documentation
Request Syntax
response = client.enable_directory(
DirectoryArn='string'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory to enable.
dict
Response Syntax
{
'DirectoryArn': 'string'
}
Response Structure
(dict) –
DirectoryArn (string) –
The ARN of the enabled directory.
Exceptions
Returns current applied schema version ARN, including the minor version in use.
See also: AWS API Documentation
Request Syntax
response = client.get_applied_schema_version(
SchemaArn='string'
)
SchemaArn (string) –
[REQUIRED]
The ARN of the applied schema.
dict
Response Syntax
{
'AppliedSchemaArn': 'string'
}
Response Structure
(dict) –
AppliedSchemaArn (string) –
Current applied schema ARN, including the minor version in use if one was provided.
Exceptions
Retrieves metadata about a directory.
See also: AWS API Documentation
Request Syntax
response = client.get_directory(
DirectoryArn='string'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory.
dict
Response Syntax
{
'Directory': {
'Name': 'string',
'DirectoryArn': 'string',
'State': 'ENABLED'|'DISABLED'|'DELETED',
'CreationDateTime': datetime(2015, 1, 1)
}
}
Response Structure
(dict) –
Directory (dict) –
Metadata about the directory.
Name (string) –
The name of the directory.
DirectoryArn (string) –
The Amazon Resource Name (ARN) that is associated with the directory. For more information, see arns .
State (string) –
The state of the directory. Can be either Enabled
, Disabled
, or Deleted
.
CreationDateTime (datetime) –
The date and time when the directory was created.
Exceptions
Gets details of the Facet , such as facet name, attributes, Rule s, or ObjectType
. You can call this on all kinds of schema facets – published, development, or applied.
See also: AWS API Documentation
Request Syntax
response = client.get_facet(
SchemaArn='string',
Name='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Facet . For more information, see arns .
Name (string) –
[REQUIRED]
The name of the facet to retrieve.
dict
Response Syntax
{
'Facet': {
'Name': 'string',
'ObjectType': 'NODE'|'LEAF_NODE'|'POLICY'|'INDEX',
'FacetStyle': 'STATIC'|'DYNAMIC'
}
}
Response Structure
(dict) –
Facet (dict) –
The Facet structure that is associated with the facet.
Name (string) –
The name of the Facet .
ObjectType (string) –
The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.
FacetStyle (string) –
There are two different styles that you can define on any given facet, Static
and Dynamic
. For static facets, all attributes must be defined in the schema. For dynamic facets, attributes can be defined during data plane operations.
Exceptions
Retrieves attributes that are associated with a typed link.
See also: AWS API Documentation
Request Syntax
response = client.get_link_attributes(
DirectoryArn='string',
TypedLinkSpecifier={
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
AttributeNames=[
'string',
],
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the typed link resides. For more information, see arns or Typed Links .
TypedLinkSpecifier (dict) –
[REQUIRED]
Allows a typed link specifier to be accepted as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
AttributeNames (list) –
[REQUIRED]
A list of attribute names whose values will be retrieved.
(string) –
ConsistencyLevel (string) – The consistency level at which to retrieve the attributes on a typed link.
dict
Response Syntax
{
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
Response Structure
(dict) –
Attributes (list) –
The attributes that are associated with the typed link.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
Exceptions
Retrieves attributes within a facet that are associated with an object.
See also: AWS API Documentation
Request Syntax
response = client.get_object_attributes(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
SchemaFacet={
'SchemaArn': 'string',
'FacetName': 'string'
},
AttributeNames=[
'string',
]
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides.
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose attributes will be retrieved.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – The consistency level at which to retrieve the attributes on an object.
SchemaFacet (dict) –
[REQUIRED]
Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
AttributeNames (list) –
[REQUIRED]
List of attribute names whose values will be retrieved.
(string) –
dict
Response Syntax
{
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
}
Response Structure
(dict) –
Attributes (list) –
The attributes that are associated with the object.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
Exceptions
Retrieves metadata about an object.
See also: AWS API Documentation
Request Syntax
response = client.get_object_information(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory being retrieved.
ObjectReference (dict) –
[REQUIRED]
A reference to the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – The consistency level at which to retrieve the object information.
dict
Response Syntax
{
'SchemaFacets': [
{
'SchemaArn': 'string',
'FacetName': 'string'
},
],
'ObjectIdentifier': 'string'
}
Response Structure
(dict) –
SchemaFacets (list) –
The facets attached to the specified object. Although the response does not include minor version information, the most recently applied minor version of each Facet is in effect. See GetAppliedSchemaVersion for details.
(dict) –
A facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectIdentifier (string) –
The ObjectIdentifier
of the specified object.
Exceptions
Create a paginator for an operation.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
OperationNotPageableError – Raised if the operation is not
pageable. You can use the client.can_paginate
method to
check if an operation is pageable.
L{botocore.paginate.Paginator}
A paginator object.
Retrieves a JSON representation of the schema. See JSON Schema Format for more information.
See also: AWS API Documentation
Request Syntax
response = client.get_schema_as_json(
SchemaArn='string'
)
SchemaArn (string) –
[REQUIRED]
The ARN of the schema to retrieve.
dict
Response Syntax
{
'Name': 'string',
'Document': 'string'
}
Response Structure
(dict) –
Name (string) –
The name of the retrieved schema.
Document (string) –
The JSON representation of the schema document.
Exceptions
Returns the identity attribute order for a specific TypedLinkFacet . For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.get_typed_link_facet_information(
SchemaArn='string',
Name='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Name (string) –
[REQUIRED]
The unique name of the typed link facet.
dict
Response Syntax
{
'IdentityAttributeOrder': [
'string',
]
}
Response Structure
(dict) –
IdentityAttributeOrder (list) –
The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed Links .
(string) –
Exceptions
Returns an object that can wait for some condition.
waiter_name (str) – The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
The specified waiter object.
botocore.waiter.Waiter
Lists schema major versions applied to a directory. If SchemaArn
is provided, lists the minor version.
See also: AWS API Documentation
Request Syntax
response = client.list_applied_schema_arns(
DirectoryArn='string',
SchemaArn='string',
NextToken='string',
MaxResults=123
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory you are listing.
SchemaArn (string) – The response for ListAppliedSchemaArns
when this parameter is used will list all minor version ARNs for a major version.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of schemas that are applied to the directory.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists indices attached to the specified object.
See also: AWS API Documentation
Request Syntax
response = client.list_attached_indices(
DirectoryArn='string',
TargetReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory.
TargetReference (dict) –
[REQUIRED]
A reference to the object that has indices attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
ConsistencyLevel (string) – The consistency level to use for this operation.
dict
Response Syntax
{
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
IndexAttachments (list) –
The indices attached to the specified object.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
NextToken (string) –
The pagination token.
Exceptions
Retrieves each Amazon Resource Name (ARN) of schemas in the development state.
See also: AWS API Documentation
Request Syntax
response = client.list_development_schema_arns(
NextToken='string',
MaxResults=123
)
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of retrieved development schemas.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists directories created within an account.
See also: AWS API Documentation
Request Syntax
response = client.list_directories(
NextToken='string',
MaxResults=123,
state='ENABLED'|'DISABLED'|'DELETED'
)
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
state (string) – The state of the directories in the list. Can be either Enabled, Disabled, or Deleted.
dict
Response Syntax
{
'Directories': [
{
'Name': 'string',
'DirectoryArn': 'string',
'State': 'ENABLED'|'DISABLED'|'DELETED',
'CreationDateTime': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
Directories (list) –
Lists all directories that are associated with your account in pagination fashion.
(dict) –
Directory structure that includes the directory name and directory ARN.
Name (string) –
The name of the directory.
DirectoryArn (string) –
The Amazon Resource Name (ARN) that is associated with the directory. For more information, see arns .
State (string) –
The state of the directory. Can be either Enabled
, Disabled
, or Deleted
.
CreationDateTime (datetime) –
The date and time when the directory was created.
NextToken (string) –
The pagination token.
Exceptions
Retrieves attributes attached to the facet.
See also: AWS API Documentation
Request Syntax
response = client.list_facet_attributes(
SchemaArn='string',
Name='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) –
[REQUIRED]
The ARN of the schema where the facet resides.
Name (string) –
[REQUIRED]
The name of the facet whose attributes will be retrieved.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'Attributes': [
{
'Name': 'string',
'AttributeDefinition': {
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
}
},
'AttributeReference': {
'TargetFacetName': 'string',
'TargetAttributeName': 'string'
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
Attributes (list) –
The attributes attached to the facet.
(dict) –
An attribute that is associated with the Facet .
Name (string) –
The name of the facet attribute.
AttributeDefinition (dict) –
A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.
Type (string) –
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
AttributeReference (dict) –
An attribute reference that is associated with the attribute. See Attribute References for more information.
TargetFacetName (string) –
The target facet name that is associated with the facet reference. See Attribute References for more information.
TargetAttributeName (string) –
The target attribute name that is associated with the facet reference. See Attribute References for more information.
RequiredBehavior (string) –
The required behavior of the FacetAttribute
.
NextToken (string) –
The pagination token.
Exceptions
Retrieves the names of facets that exist in a schema.
See also: AWS API Documentation
Request Syntax
response = client.list_facet_names(
SchemaArn='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) to retrieve facet names from.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'FacetNames': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
FacetNames (list) –
The names of facets that exist within the schema.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.list_incoming_typed_links(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
FilterAttributeRanges=[
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
FilterTypedLink={
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to list the typed links.
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
ConsistencyLevel (string) – The consistency level to execute the request at.
dict
Response Syntax
{
'LinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
LinkSpecifiers (list) –
Returns one or more typed link specifiers as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
Exceptions
Lists objects attached to the specified index.
See also: AWS API Documentation
Request Syntax
response = client.list_index(
DirectoryArn='string',
RangesOnIndexedValues=[
{
'AttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
IndexReference={
'Selector': 'string'
},
MaxResults=123,
NextToken='string',
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory that the index exists in.
RangesOnIndexedValues (list) –
Specifies the ranges of indexed values that you want to query.
(dict) –
A range of attributes.
AttributeKey (dict) –
The key of the attribute that the attribute range covers.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Range (dict) –
The range of attribute values being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IndexReference (dict) –
[REQUIRED]
The reference to the index to list.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
MaxResults (integer) – The maximum number of objects in a single page to retrieve from the index during a request. For more information, see Amazon Cloud Directory Limits .
NextToken (string) – The pagination token.
ConsistencyLevel (string) – The consistency level to execute the request at.
dict
Response Syntax
{
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
IndexAttachments (list) –
The objects and indexed values attached to the index.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
NextToken (string) –
The pagination token.
Exceptions
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.
See also: AWS API Documentation
Request Syntax
response = client.list_managed_schema_arns(
SchemaArn='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) – The response for ListManagedSchemaArns. When this parameter is used, all minor version ARNs for a major version are listed.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs for all AWS managed schemas.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists all attributes that are associated with an object.
See also: AWS API Documentation
Request Syntax
response = client.list_object_attributes(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
FacetFilter={
'SchemaArn': 'string',
'FacetName': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
FacetFilter (dict) –
Used to filter the list of object attributes that are associated with a certain facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
dict
Response Syntax
{
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
Attributes (list) –
Attributes map that is associated with the object. AttributeArn
is the key, and attribute value is the value.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
Exceptions
Returns a paginated list of child objects that are associated with a given object.
See also: AWS API Documentation
Request Syntax
response = client.list_object_children(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object for which child objects are being listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
dict
Response Syntax
{
'Children': {
'string': 'string'
},
'NextToken': 'string'
}
Response Structure
(dict) –
Children (dict) –
Children structure, which is a map with key as the LinkName
and ObjectIdentifier
as the value.
(string) –
(string) –
NextToken (string) –
The pagination token.
Exceptions
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-defined MaxResults
, 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.
See also: AWS API Documentation
Request Syntax
response = client.list_object_parent_paths(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory to which the parent path applies.
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object whose parent paths are listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
dict
Response Syntax
{
'PathToObjectIdentifiersList': [
{
'Path': 'string',
'ObjectIdentifiers': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
PathToObjectIdentifiersList (list) –
Returns the path to the ObjectIdentifiers
that are associated with the directory.
(dict) –
Returns the path to the ObjectIdentifiers
that is associated with the directory.
Path (string) –
The path that is used to identify the object starting from directory root.
ObjectIdentifiers (list) –
Lists ObjectIdentifiers
starting from directory root to the object in the request.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists parent objects that are associated with a given object in pagination fashion.
See also: AWS API Documentation
Request Syntax
response = client.list_object_parents(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
IncludeAllLinksToEachParent=True|False
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object for which parent objects are being listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
IncludeAllLinksToEachParent (boolean) – When set to True, returns all ListObjectParentsResponse$ParentLinks . There could be multiple links between a parent-child pair.
dict
Response Syntax
{
'Parents': {
'string': 'string'
},
'NextToken': 'string',
'ParentLinks': [
{
'ObjectIdentifier': 'string',
'LinkName': 'string'
},
]
}
Response Structure
(dict) –
Parents (dict) –
The parent structure, which is a map with key as the ObjectIdentifier
and LinkName as the value.
(string) –
(string) –
NextToken (string) –
The pagination token.
ParentLinks (list) –
Returns a list of parent reference and LinkName Tuples.
(dict) –
A pair of ObjectIdentifier and LinkName.
ObjectIdentifier (string) –
The ID that is associated with the object.
LinkName (string) –
The name of the link between the parent and the child object.
Exceptions
Returns policies attached to an object in pagination fashion.
See also: AWS API Documentation
Request Syntax
response = client.list_object_policies(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object for which policies will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
dict
Response Syntax
{
'AttachedPolicyIds': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
AttachedPolicyIds (list) –
A list of policy ObjectIdentifiers
, that are attached to the object.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.list_outgoing_typed_links(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
FilterAttributeRanges=[
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
FilterTypedLink={
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to list the typed links.
ObjectReference (dict) –
[REQUIRED]
A reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
ConsistencyLevel (string) – The consistency level to execute the request at.
dict
Response Syntax
{
'TypedLinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
TypedLinkSpecifiers (list) –
Returns a typed link specifier as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
NextToken (string) –
The pagination token.
Exceptions
Returns all of the ObjectIdentifiers
to which a given policy is attached.
See also: AWS API Documentation
Request Syntax
response = client.list_policy_attachments(
DirectoryArn='string',
PolicyReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123,
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns .
PolicyReference (dict) –
[REQUIRED]
The reference that identifies the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
dict
Response Syntax
{
'ObjectIdentifiers': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
ObjectIdentifiers (list) –
A list of ObjectIdentifiers
to which the policy is attached.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists the major version families of each published schema. If a major version ARN is provided as SchemaArn
, the minor version revisions in that family are listed instead.
See also: AWS API Documentation
Request Syntax
response = client.list_published_schema_arns(
SchemaArn='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) – The response for ListPublishedSchemaArns
when this parameter is used will list all minor version ARNs for a major version.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of published schemas.
(string) –
NextToken (string) –
The pagination token.
Exceptions
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.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceArn='string',
NextToken='string',
MaxResults=123
)
ResourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.
NextToken (string) – The pagination token. This is for future use. Currently pagination is not supported for tagging.
MaxResults (integer) – The MaxResults
parameter sets the maximum number of results returned in a single page. This is for future use and is not supported currently.
dict
Response Syntax
{
'Tags': [
{
'Key': 'string',
'Value': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
Tags (list) –
A list of tag key value pairs that are associated with the response.
(dict) –
The tag structure that contains a tag key and value.
Key (string) –
The key that is associated with the tag.
Value (string) –
The value that is associated with the tag.
NextToken (string) –
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
Exceptions
Returns a paginated list of all attribute definitions for a particular TypedLinkFacet . For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.list_typed_link_facet_attributes(
SchemaArn='string',
Name='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Name (string) –
[REQUIRED]
The unique name of the typed link facet.
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'Attributes': [
{
'Name': 'string',
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
Attributes (list) –
An ordered set of attributes associate with the typed link.
(dict) –
A typed link attribute definition.
Name (string) –
The unique name of the typed link attribute.
Type (string) –
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules that are attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
RequiredBehavior (string) –
The required behavior of the TypedLinkAttributeDefinition
.
NextToken (string) –
The pagination token.
Exceptions
Returns a paginated list of TypedLink
facet names for a particular schema. For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.list_typed_link_facet_names(
SchemaArn='string',
NextToken='string',
MaxResults=123
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
NextToken (string) – The pagination token.
MaxResults (integer) – The maximum number of results to retrieve.
dict
Response Syntax
{
'FacetNames': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) –
FacetNames (list) –
The names of typed link facets that exist within the schema.
(string) –
NextToken (string) –
The pagination token.
Exceptions
Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don’t have the policies attached, it returns the 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 .
See also: AWS API Documentation
Request Syntax
response = client.lookup_policy(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
NextToken='string',
MaxResults=123
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory . For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose policies will be looked up.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
NextToken (string) – The token to request the next page of results.
MaxResults (integer) – The maximum number of items to be retrieved in a single call. This is an approximate number.
dict
Response Syntax
{
'PolicyToPathList': [
{
'Path': 'string',
'Policies': [
{
'PolicyId': 'string',
'ObjectIdentifier': 'string',
'PolicyType': 'string'
},
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
PolicyToPathList (list) –
Provides list of path to policies. Policies contain PolicyId
, ObjectIdentifier
, and PolicyType
. For more information, see Policies .
(dict) –
Used when a regular object exists in a Directory and you want to find all of the policies that are associated with that object and the parent to that object.
Path (string) –
The path that is referenced from the root.
Policies (list) –
List of policy objects.
(dict) –
Contains the PolicyType
, PolicyId
, and the ObjectIdentifier
to which it is attached. For more information, see Policies .
PolicyId (string) –
The ID of PolicyAttachment
.
ObjectIdentifier (string) –
The ObjectIdentifier
that is associated with PolicyAttachment
.
PolicyType (string) –
The type of policy that can be associated with PolicyAttachment
.
NextToken (string) –
The pagination token.
Exceptions
Publishes a development schema with a major version and a recommended minor version.
See also: AWS API Documentation
Request Syntax
response = client.publish_schema(
DevelopmentSchemaArn='string',
Version='string',
MinorVersion='string',
Name='string'
)
DevelopmentSchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the development schema. For more information, see arns .
Version (string) –
[REQUIRED]
The major version under which the schema will be published. Schemas have both a major and minor version associated with them.
MinorVersion (string) – The minor version under which the schema will be published. This parameter is recommended. Schemas have both a major and minor version associated with them.
Name (string) – The new name under which the schema will be published. If this is not provided, the development schema is considered.
dict
Response Syntax
{
'PublishedSchemaArn': 'string'
}
Response Structure
(dict) –
PublishedSchemaArn (string) –
The ARN that is associated with the published schema. For more information, see arns .
Exceptions
Allows a schema to be updated using JSON upload. Only available for development schemas. See JSON Schema Format for more information.
See also: AWS API Documentation
Request Syntax
response = client.put_schema_from_json(
SchemaArn='string',
Document='string'
)
SchemaArn (string) –
[REQUIRED]
The ARN of the schema to update.
Document (string) –
[REQUIRED]
The replacement JSON schema.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) –
Arn (string) –
The ARN of the schema to update.
Exceptions
Removes the specified facet from the specified object.
See also: AWS API Documentation
Request Syntax
response = client.remove_facet_from_object(
DirectoryArn='string',
SchemaFacet={
'SchemaArn': 'string',
'FacetName': 'string'
},
ObjectReference={
'Selector': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory in which the object resides.
SchemaFacet (dict) –
[REQUIRED]
The facet to remove. See SchemaFacet for details.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
ObjectReference (dict) –
[REQUIRED]
A reference to the object to remove the facet from.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
An API operation for adding tags to a resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceArn='string',
Tags=[
{
'Key': 'string',
'Value': 'string'
},
]
)
ResourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.
Tags (list) –
[REQUIRED]
A list of tag key-value pairs.
(dict) –
The tag structure that contains a tag key and value.
Key (string) –
The key that is associated with the tag.
Value (string) –
The value that is associated with the tag.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
An API operation for removing tags from a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceArn='string',
TagKeys=[
'string',
]
)
ResourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.
TagKeys (list) –
[REQUIRED]
Keys of the tag that need to be removed from the resource.
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Does the following:
Adds new Attributes
, Rules
, or ObjectTypes
.
Updates existing Attributes
, Rules
, or ObjectTypes
.
Deletes existing Attributes
, Rules
, or ObjectTypes
.
See also: AWS API Documentation
Request Syntax
response = client.update_facet(
SchemaArn='string',
Name='string',
AttributeUpdates=[
{
'Attribute': {
'Name': 'string',
'AttributeDefinition': {
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
}
},
'AttributeReference': {
'TargetFacetName': 'string',
'TargetAttributeName': 'string'
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
'Action': 'CREATE_OR_UPDATE'|'DELETE'
},
],
ObjectType='NODE'|'LEAF_NODE'|'POLICY'|'INDEX'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Facet . For more information, see arns .
Name (string) –
[REQUIRED]
The name of the facet.
AttributeUpdates (list) –
List of attributes that need to be updated in a given schema Facet . Each attribute is followed by AttributeAction
, which specifies the type of update operation to perform.
(dict) –
A structure that contains information used to update an attribute.
Attribute (dict) –
The attribute to update.
Name (string) – [REQUIRED]
The name of the facet attribute.
AttributeDefinition (dict) –
A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.
Type (string) – [REQUIRED]
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
AttributeReference (dict) –
An attribute reference that is associated with the attribute. See Attribute References for more information.
TargetFacetName (string) – [REQUIRED]
The target facet name that is associated with the facet reference. See Attribute References for more information.
TargetAttributeName (string) – [REQUIRED]
The target attribute name that is associated with the facet reference. See Attribute References for more information.
RequiredBehavior (string) –
The required behavior of the FacetAttribute
.
Action (string) –
The action to perform when updating the attribute.
ObjectType (string) – The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Updates a given typed link’s attributes. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder
.
See also: AWS API Documentation
Request Syntax
response = client.update_link_attributes(
DirectoryArn='string',
TypedLinkSpecifier={
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
AttributeUpdates=[
{
'AttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'AttributeAction': {
'AttributeActionType': 'CREATE_OR_UPDATE'|'DELETE',
'AttributeUpdateValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
]
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the updated typed link resides. For more information, see arns or Typed Links .
TypedLinkSpecifier (dict) –
[REQUIRED]
Allows a typed link specifier to be accepted as input.
TypedLinkFacet (dict) – [REQUIRED]
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
SourceObjectReference (dict) – [REQUIRED]
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) – [REQUIRED]
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) – [REQUIRED]
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) – [REQUIRED]
The attribute name of the typed link.
Value (dict) – [REQUIRED]
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
AttributeUpdates (list) –
[REQUIRED]
The attributes update structure.
(dict) –
Structure that contains attribute update information.
AttributeKey (dict) –
The key of the attribute being updated.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
AttributeAction (dict) –
The action to perform as part of the attribute update.
AttributeActionType (string) –
A type that can be either UPDATE_OR_CREATE
or DELETE
.
AttributeUpdateValue (dict) –
The value that you want to update to.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Updates a given object’s attributes.
See also: AWS API Documentation
Request Syntax
response = client.update_object_attributes(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
AttributeUpdates=[
{
'ObjectAttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'ObjectAttributeAction': {
'ObjectAttributeActionType': 'CREATE_OR_UPDATE'|'DELETE',
'ObjectAttributeUpdateValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
]
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
AttributeUpdates (list) –
[REQUIRED]
The attributes update structure.
(dict) –
Structure that contains attribute update information.
ObjectAttributeKey (dict) –
The key of the attribute being updated.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
ObjectAttributeAction (dict) –
The action to perform as part of the attribute update.
ObjectAttributeActionType (string) –
A type that can be either Update
or Delete
.
ObjectAttributeUpdateValue (dict) –
The value that you want to update to.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
dict
Response Syntax
{
'ObjectIdentifier': 'string'
}
Response Structure
(dict) –
ObjectIdentifier (string) –
The ObjectIdentifier
of the updated object.
Exceptions
Updates the schema name with a new name. Only development schema names can be updated.
See also: AWS API Documentation
Request Syntax
response = client.update_schema(
SchemaArn='string',
Name='string'
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the development schema. For more information, see arns .
Name (string) –
[REQUIRED]
The name of the schema.
dict
Response Syntax
{
'SchemaArn': 'string'
}
Response Structure
(dict) –
SchemaArn (string) –
The ARN that is associated with the updated schema. For more information, see arns .
Exceptions
Updates a TypedLinkFacet . For more information, see Typed Links .
See also: AWS API Documentation
Request Syntax
response = client.update_typed_link_facet(
SchemaArn='string',
Name='string',
AttributeUpdates=[
{
'Attribute': {
'Name': 'string',
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
'Action': 'CREATE_OR_UPDATE'|'DELETE'
},
],
IdentityAttributeOrder=[
'string',
]
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Name (string) –
[REQUIRED]
The unique name of the typed link facet.
AttributeUpdates (list) –
[REQUIRED]
Attributes update structure.
(dict) –
A typed link facet attribute update.
Attribute (dict) – [REQUIRED]
The attribute to update.
Name (string) – [REQUIRED]
The unique name of the typed link attribute.
Type (string) – [REQUIRED]
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules that are attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
RequiredBehavior (string) – [REQUIRED]
The required behavior of the TypedLinkAttributeDefinition
.
Action (string) – [REQUIRED]
The action to perform when updating the attribute.
IdentityAttributeOrder (list) –
[REQUIRED]
The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to a typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed Links .
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Upgrades a single directory in-place using the PublishedSchemaArn
with schema updates found in MinorVersion
. Backwards-compatible minor version upgrades are instantaneously available for readers on all objects in the directory. Note: This is a synchronous API call and upgrades only one schema on a given directory per call. To upgrade multiple directories from one schema, you would need to call this API on each directory.
See also: AWS API Documentation
Request Syntax
response = client.upgrade_applied_schema(
PublishedSchemaArn='string',
DirectoryArn='string',
DryRun=True|False
)
PublishedSchemaArn (string) –
[REQUIRED]
The revision of the published schema to upgrade the directory to.
DirectoryArn (string) –
[REQUIRED]
The ARN for the directory to which the upgraded schema will be applied.
DryRun (boolean) – Used for testing whether the major version schemas are backward compatible or not. If schema compatibility fails, an exception would be thrown else the call would succeed but no changes will be saved. This parameter is optional.
dict
Response Syntax
{
'UpgradedSchemaArn': 'string',
'DirectoryArn': 'string'
}
Response Structure
(dict) –
UpgradedSchemaArn (string) –
The ARN of the upgraded schema that is returned as part of the response.
DirectoryArn (string) –
The ARN of the directory that is returned as part of the response.
Exceptions
Upgrades a published schema under a new minor version revision using the current contents of DevelopmentSchemaArn
.
See also: AWS API Documentation
Request Syntax
response = client.upgrade_published_schema(
DevelopmentSchemaArn='string',
PublishedSchemaArn='string',
MinorVersion='string',
DryRun=True|False
)
DevelopmentSchemaArn (string) –
[REQUIRED]
The ARN of the development schema with the changes used for the upgrade.
PublishedSchemaArn (string) –
[REQUIRED]
The ARN of the published schema to be upgraded.
MinorVersion (string) –
[REQUIRED]
Identifies the minor version of the published schema that will be created. This parameter is NOT optional.
DryRun (boolean) – Used for testing whether the Development schema provided is backwards compatible, or not, with the publish schema provided by the user to be upgraded. If schema compatibility fails, an exception would be thrown else the call would succeed. This parameter is optional and defaults to false.
dict
Response Syntax
{
'UpgradedSchemaArn': 'string'
}
Response Structure
(dict) –
UpgradedSchemaArn (string) –
The ARN of the upgraded schema that is returned as part of the response.
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:
CloudDirectory.Client.exceptions.CannotListParentOfRootException
CloudDirectory.Client.exceptions.DirectoryAlreadyExistsException
CloudDirectory.Client.exceptions.DirectoryNotDisabledException
CloudDirectory.Client.exceptions.DirectoryNotEnabledException
CloudDirectory.Client.exceptions.FacetAlreadyExistsException
CloudDirectory.Client.exceptions.IncompatibleSchemaException
CloudDirectory.Client.exceptions.IndexedAttributeMissingException
CloudDirectory.Client.exceptions.InvalidFacetUpdateException
CloudDirectory.Client.exceptions.InvalidTaggingRequestException
CloudDirectory.Client.exceptions.LinkNameAlreadyInUseException
CloudDirectory.Client.exceptions.ObjectAlreadyDetachedException
CloudDirectory.Client.exceptions.SchemaAlreadyExistsException
CloudDirectory.Client.exceptions.SchemaAlreadyPublishedException
CloudDirectory.Client.exceptions.StillContainsLinksException
CloudDirectory.Client.exceptions.UnsupportedIndexTypeException
Access denied or directory not found. Either you don’t have permissions for this directory or the directory does not exist. Try calling ListDirectories and check your permissions.
Example
try:
...
except client.exceptions.AccessDeniedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Access denied or directory not found. Either you don’t have permissions for this directory or the directory does not exist. Try calling ListDirectories and check your permissions.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
A BatchWrite
exception has occurred.
Example
try:
...
except client.exceptions.BatchWriteException as e:
print(e.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
{
'Index': 123,
'Type': 'InternalServiceException'|'ValidationException'|'InvalidArnException'|'LinkNameAlreadyInUseException'|'StillContainsLinksException'|'FacetValidationException'|'ObjectNotDetachedException'|'ResourceNotFoundException'|'AccessDeniedException'|'InvalidAttachmentException'|'NotIndexException'|'NotNodeException'|'IndexedAttributeMissingException'|'ObjectAlreadyDetachedException'|'NotPolicyException'|'DirectoryNotEnabledException'|'LimitExceededException'|'UnsupportedIndexTypeException',
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
A BatchWrite
exception has occurred.
Index (integer) –
Type (string) –
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Cannot list the parents of a Directory root.
Example
try:
...
except client.exceptions.CannotListParentOfRootException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Cannot list the parents of a Directory root.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that a Directory could not be created due to a naming conflict. Choose a different name and try again.
Example
try:
...
except client.exceptions.DirectoryAlreadyExistsException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that a Directory could not be created due to a naming conflict. Choose a different name and try again.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
A directory that has been deleted and to which access has been attempted. Note: The requested resource will eventually cease to exist.
Example
try:
...
except client.exceptions.DirectoryDeletedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
A directory that has been deleted and to which access has been attempted. Note: The requested resource will eventually cease to exist.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
An operation can only operate on a disabled directory.
Example
try:
...
except client.exceptions.DirectoryNotDisabledException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An operation can only operate on a disabled directory.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Operations are only permitted on enabled directories.
Example
try:
...
except client.exceptions.DirectoryNotEnabledException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Operations are only permitted on enabled directories.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
A facet with the same name already exists.
Example
try:
...
except client.exceptions.FacetAlreadyExistsException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
A facet with the same name already exists.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Occurs when deleting a facet that contains an attribute that is a target to an attribute reference in a different facet.
Example
try:
...
except client.exceptions.FacetInUseException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Occurs when deleting a facet that contains an attribute that is a target to an attribute reference in a different facet.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The specified Facet could not be found.
Example
try:
...
except client.exceptions.FacetNotFoundException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The specified Facet could not be found.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The Facet that you provided was not well formed or could not be validated with the schema.
Example
try:
...
except client.exceptions.FacetValidationException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The Facet that you provided was not well formed or could not be validated with the schema.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates a failure occurred while performing a check for backward compatibility between the specified schema and the schema that is currently applied to the directory.
Example
try:
...
except client.exceptions.IncompatibleSchemaException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates a failure occurred while performing a check for backward compatibility between the specified schema and the schema that is currently applied to the directory.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
An object has been attempted to be attached to an object that does not have the appropriate attribute value.
Example
try:
...
except client.exceptions.IndexedAttributeMissingException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An object has been attempted to be attached to an object that does not have the appropriate attribute value.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates a problem that must be resolved by Amazon Web Services. This might be a transient error in which case you can retry your request until it succeeds. Otherwise, go to the AWS Service Health Dashboard site to see if there are any operational issues with the service.
Example
try:
...
except client.exceptions.InternalServiceException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates a problem that must be resolved by Amazon Web Services. This might be a transient error in which case you can retry your request until it succeeds. Otherwise, go to the AWS Service Health Dashboard site to see if there are any operational issues with the service.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the provided ARN value is not valid.
Example
try:
...
except client.exceptions.InvalidArnException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the provided ARN value is not valid.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that an attempt to make an attachment was invalid. For example, attaching two nodes with a link type that is not applicable to the nodes or attempting to apply a schema to a directory a second time.
Example
try:
...
except client.exceptions.InvalidAttachmentException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that an attempt to make an attachment was invalid. For example, attaching two nodes with a link type that is not applicable to the nodes or attempting to apply a schema to a directory a second time.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
An attempt to modify a Facet resulted in an invalid schema exception.
Example
try:
...
except client.exceptions.InvalidFacetUpdateException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An attempt to modify a Facet resulted in an invalid schema exception.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the NextToken
value is not valid.
Example
try:
...
except client.exceptions.InvalidNextTokenException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the NextToken
value is not valid.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Occurs when any of the rule parameter keys or values are invalid.
Example
try:
...
except client.exceptions.InvalidRuleException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Occurs when any of the rule parameter keys or values are invalid.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the provided SchemaDoc
value is not valid.
Example
try:
...
except client.exceptions.InvalidSchemaDocException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the provided SchemaDoc
value is not valid.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Can occur for multiple reasons such as when you tag a resource that doesn’t exist or if you specify a higher number of tags for a resource than the allowed limit. Allowed limit is 50 tags per resource.
Example
try:
...
except client.exceptions.InvalidTaggingRequestException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Can occur for multiple reasons such as when you tag a resource that doesn’t exist or if you specify a higher number of tags for a resource than the allowed limit. Allowed limit is 50 tags per resource.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that limits are exceeded. See Limits for more information.
Example
try:
...
except client.exceptions.LimitExceededException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that limits are exceeded. See Limits for more information.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that a link could not be created due to a naming conflict. Choose a different name and then try again.
Example
try:
...
except client.exceptions.LinkNameAlreadyInUseException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that a link could not be created due to a naming conflict. Choose a different name and then try again.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the requested operation can only operate on index objects.
Example
try:
...
except client.exceptions.NotIndexException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the requested operation can only operate on index objects.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Occurs when any invalid operations are performed on an object that is not a node, such as calling ListObjectChildren
for a leaf node object.
Example
try:
...
except client.exceptions.NotNodeException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Occurs when any invalid operations are performed on an object that is not a node, such as calling ListObjectChildren
for a leaf node object.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the requested operation can only operate on policy objects.
Example
try:
...
except client.exceptions.NotPolicyException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the requested operation can only operate on policy objects.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the object is not attached to the index.
Example
try:
...
except client.exceptions.ObjectAlreadyDetachedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the object is not attached to the index.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the requested operation cannot be completed because the object has not been detached from the tree.
Example
try:
...
except client.exceptions.ObjectNotDetachedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the requested operation cannot be completed because the object has not been detached from the tree.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The specified resource could not be found.
Example
try:
...
except client.exceptions.ResourceNotFoundException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The specified resource could not be found.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Occurs when a conflict with a previous successful write is detected. For example, if a write operation occurs on an object and then an attempt is made to read the object using “SERIALIZABLE” consistency, this exception may result. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.
Example
try:
...
except client.exceptions.RetryableConflictException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Occurs when a conflict with a previous successful write is detected. For example, if a write operation occurs on an object and then an attempt is made to read the object using “SERIALIZABLE” consistency, this exception may result. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that a schema could not be created due to a naming conflict. Please select a different name and then try again.
Example
try:
...
except client.exceptions.SchemaAlreadyExistsException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that a schema could not be created due to a naming conflict. Please select a different name and then try again.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that a schema is already published.
Example
try:
...
except client.exceptions.SchemaAlreadyPublishedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that a schema is already published.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The object could not be deleted because links still exist. Remove the links and then try the operation again.
Example
try:
...
except client.exceptions.StillContainsLinksException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The object could not be deleted because links still exist. Remove the links and then try the operation again.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that the requested index type is not supported.
Example
try:
...
except client.exceptions.UnsupportedIndexTypeException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that the requested index type is not supported.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Indicates that your request is malformed in some manner. See the exception message.
Example
try:
...
except client.exceptions.ValidationException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'Message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Indicates that your request is malformed in some manner. See the exception message.
Message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The available paginators are:
paginator = client.get_paginator('list_applied_schema_arns')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_applied_schema_arns()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
SchemaArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory you are listing.
SchemaArn (string) – The response for ListAppliedSchemaArns
when this parameter is used will list all minor version ARNs for a major version.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of schemas that are applied to the directory.
(string) –
paginator = client.get_paginator('list_attached_indices')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_attached_indices()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
TargetReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory.
TargetReference (dict) –
[REQUIRED]
A reference to the object that has indices attached.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – The consistency level to use for this operation.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
}
Response Structure
(dict) –
IndexAttachments (list) –
The indices attached to the specified object.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
paginator = client.get_paginator('list_development_schema_arns')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_development_schema_arns()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of retrieved development schemas.
(string) –
paginator = client.get_paginator('list_directories')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_directories()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
state='ENABLED'|'DISABLED'|'DELETED',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
state (string) – The state of the directories in the list. Can be either Enabled, Disabled, or Deleted.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Directories': [
{
'Name': 'string',
'DirectoryArn': 'string',
'State': 'ENABLED'|'DISABLED'|'DELETED',
'CreationDateTime': datetime(2015, 1, 1)
},
],
}
Response Structure
(dict) –
Directories (list) –
Lists all directories that are associated with your account in pagination fashion.
(dict) –
Directory structure that includes the directory name and directory ARN.
Name (string) –
The name of the directory.
DirectoryArn (string) –
The Amazon Resource Name (ARN) that is associated with the directory. For more information, see arns .
State (string) –
The state of the directory. Can be either Enabled
, Disabled
, or Deleted
.
CreationDateTime (datetime) –
The date and time when the directory was created.
paginator = client.get_paginator('list_facet_attributes')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_facet_attributes()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
Name='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) –
[REQUIRED]
The ARN of the schema where the facet resides.
Name (string) –
[REQUIRED]
The name of the facet whose attributes will be retrieved.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Attributes': [
{
'Name': 'string',
'AttributeDefinition': {
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
}
},
'AttributeReference': {
'TargetFacetName': 'string',
'TargetAttributeName': 'string'
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
}
Response Structure
(dict) –
Attributes (list) –
The attributes attached to the facet.
(dict) –
An attribute that is associated with the Facet .
Name (string) –
The name of the facet attribute.
AttributeDefinition (dict) –
A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.
Type (string) –
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
AttributeReference (dict) –
An attribute reference that is associated with the attribute. See Attribute References for more information.
TargetFacetName (string) –
The target facet name that is associated with the facet reference. See Attribute References for more information.
TargetAttributeName (string) –
The target attribute name that is associated with the facet reference. See Attribute References for more information.
RequiredBehavior (string) –
The required behavior of the FacetAttribute
.
paginator = client.get_paginator('list_facet_names')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_facet_names()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) to retrieve facet names from.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'FacetNames': [
'string',
],
}
Response Structure
(dict) –
FacetNames (list) –
The names of facets that exist within the schema.
(string) –
paginator = client.get_paginator('list_incoming_typed_links')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_incoming_typed_links()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
FilterAttributeRanges=[
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
FilterTypedLink={
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to list the typed links.
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
ConsistencyLevel (string) – The consistency level to execute the request at.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'LinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
}
Response Structure
(dict) –
LinkSpecifiers (list) –
Returns one or more typed link specifiers as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
paginator = client.get_paginator('list_index')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_index()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
RangesOnIndexedValues=[
{
'AttributeKey': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
IndexReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory that the index exists in.
RangesOnIndexedValues (list) –
Specifies the ranges of indexed values that you want to query.
(dict) –
A range of attributes.
AttributeKey (dict) –
The key of the attribute that the attribute range covers.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) – [REQUIRED]
The name of the facet that the attribute exists within.
Name (string) – [REQUIRED]
The name of the attribute.
Range (dict) –
The range of attribute values being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IndexReference (dict) –
[REQUIRED]
The reference to the index to list.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – The consistency level to execute the request at.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'IndexAttachments': [
{
'IndexedAttributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
'ObjectIdentifier': 'string'
},
],
}
Response Structure
(dict) –
IndexAttachments (list) –
The objects and indexed values attached to the index.
(dict) –
Represents an index and an attached object.
IndexedAttributes (list) –
The indexed attribute values.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
ObjectIdentifier (string) –
In response to ListIndex , the ObjectIdentifier
of the object attached to the index. In response to ListAttachedIndices , the ObjectIdentifier
of the index attached to the object. This field will always contain the ObjectIdentifier
of the object on the opposite side of the attachment specified in the query.
paginator = client.get_paginator('list_managed_schema_arns')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_managed_schema_arns()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) – The response for ListManagedSchemaArns. When this parameter is used, all minor version ARNs for a major version are listed.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs for all AWS managed schemas.
(string) –
paginator = client.get_paginator('list_object_attributes')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_object_attributes()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
FacetFilter={
'SchemaArn': 'string',
'FacetName': 'string'
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
FacetFilter (dict) –
Used to filter the list of object attributes that are associated with a certain facet.
SchemaArn (string) –
The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.
FacetName (string) –
The name of the facet. If this value is set, SchemaArn must also be set.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Attributes': [
{
'Key': {
'SchemaArn': 'string',
'FacetName': 'string',
'Name': 'string'
},
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
],
}
Response Structure
(dict) –
Attributes (list) –
Attributes map that is associated with the object. AttributeArn
is the key, and attribute value is the value.
(dict) –
The combination of an attribute key and an attribute value.
Key (dict) –
The key of the attribute.
SchemaArn (string) –
The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.
FacetName (string) –
The name of the facet that the attribute exists within.
Name (string) –
The name of the attribute.
Value (dict) –
The value of the attribute.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
paginator = client.get_paginator('list_object_parent_paths')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_object_parent_paths()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The ARN of the directory to which the parent path applies.
ObjectReference (dict) –
[REQUIRED]
The reference that identifies the object whose parent paths are listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'PathToObjectIdentifiersList': [
{
'Path': 'string',
'ObjectIdentifiers': [
'string',
]
},
],
}
Response Structure
(dict) –
PathToObjectIdentifiersList (list) –
Returns the path to the ObjectIdentifiers
that are associated with the directory.
(dict) –
Returns the path to the ObjectIdentifiers
that is associated with the directory.
Path (string) –
The path that is used to identify the object starting from directory root.
ObjectIdentifiers (list) –
Lists ObjectIdentifiers
starting from directory root to the object in the request.
(string) –
paginator = client.get_paginator('list_object_policies')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_object_policies()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object for which policies will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'AttachedPolicyIds': [
'string',
],
}
Response Structure
(dict) –
AttachedPolicyIds (list) –
A list of policy ObjectIdentifiers
, that are attached to the object.
(string) –
paginator = client.get_paginator('list_outgoing_typed_links')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_outgoing_typed_links()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
FilterAttributeRanges=[
{
'AttributeName': 'string',
'Range': {
'StartMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'StartValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'EndMode': 'FIRST'|'LAST'|'LAST_BEFORE_MISSING_VALUES'|'INCLUSIVE'|'EXCLUSIVE',
'EndValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
}
},
],
FilterTypedLink={
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the directory where you want to list the typed links.
ObjectReference (dict) –
[REQUIRED]
A reference that identifies the object whose attributes will be listed.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
FilterAttributeRanges (list) –
Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.
(dict) –
Identifies the range of attributes that are used by a specified filter.
AttributeName (string) –
The unique name of the typed link attribute.
Range (dict) – [REQUIRED]
The range of attribute values that are being selected.
StartMode (string) – [REQUIRED]
The inclusive or exclusive range start.
StartValue (dict) –
The value to start the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
EndMode (string) – [REQUIRED]
The inclusive or exclusive range end.
EndValue (dict) –
The attribute value to terminate the range at.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
FilterTypedLink (dict) –
Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.
SchemaArn (string) – [REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) – [REQUIRED]
The unique name of the typed link facet.
ConsistencyLevel (string) – The consistency level to execute the request at.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'TypedLinkSpecifiers': [
{
'TypedLinkFacet': {
'SchemaArn': 'string',
'TypedLinkName': 'string'
},
'SourceObjectReference': {
'Selector': 'string'
},
'TargetObjectReference': {
'Selector': 'string'
},
'IdentityAttributeValues': [
{
'AttributeName': 'string',
'Value': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
}
},
]
},
],
}
Response Structure
(dict) –
TypedLinkSpecifiers (list) –
Returns a typed link specifier as output.
(dict) –
Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.
TypedLinkFacet (dict) –
Identifies the typed link facet that is associated with the typed link.
SchemaArn (string) –
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
TypedLinkName (string) –
The unique name of the typed link facet.
SourceObjectReference (dict) –
Identifies the source object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
TargetObjectReference (dict) –
Identifies the target object that the typed link will attach to.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
IdentityAttributeValues (list) –
Identifies the attribute value to update.
(dict) –
Identifies the attribute name and value for a typed link.
AttributeName (string) –
The attribute name of the typed link.
Value (dict) –
The value for the typed link.
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
paginator = client.get_paginator('list_policy_attachments')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_policy_attachments()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
PolicyReference={
'Selector': 'string'
},
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns .
PolicyReference (dict) –
[REQUIRED]
The reference that identifies the policy object.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
ConsistencyLevel (string) – Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'ObjectIdentifiers': [
'string',
],
}
Response Structure
(dict) –
ObjectIdentifiers (list) –
A list of ObjectIdentifiers
to which the policy is attached.
(string) –
paginator = client.get_paginator('list_published_schema_arns')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_published_schema_arns()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) – The response for ListPublishedSchemaArns
when this parameter is used will list all minor version ARNs for a major version.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'SchemaArns': [
'string',
],
}
Response Structure
(dict) –
SchemaArns (list) –
The ARNs of published schemas.
(string) –
paginator = client.get_paginator('list_tags_for_resource')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_tags_for_resource()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
ResourceArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
ResourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Tags': [
{
'Key': 'string',
'Value': 'string'
},
],
}
Response Structure
(dict) –
Tags (list) –
A list of tag key value pairs that are associated with the response.
(dict) –
The tag structure that contains a tag key and value.
Key (string) –
The key that is associated with the tag.
Value (string) –
The value that is associated with the tag.
paginator = client.get_paginator('list_typed_link_facet_attributes')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_typed_link_facet_attributes()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
Name='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
Name (string) –
[REQUIRED]
The unique name of the typed link facet.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Attributes': [
{
'Name': 'string',
'Type': 'STRING'|'BINARY'|'BOOLEAN'|'NUMBER'|'DATETIME'|'VARIANT',
'DefaultValue': {
'StringValue': 'string',
'BinaryValue': b'bytes',
'BooleanValue': True|False,
'NumberValue': 'string',
'DatetimeValue': datetime(2015, 1, 1)
},
'IsImmutable': True|False,
'Rules': {
'string': {
'Type': 'BINARY_LENGTH'|'NUMBER_COMPARISON'|'STRING_FROM_SET'|'STRING_LENGTH',
'Parameters': {
'string': 'string'
}
}
},
'RequiredBehavior': 'REQUIRED_ALWAYS'|'NOT_REQUIRED'
},
],
}
Response Structure
(dict) –
Attributes (list) –
An ordered set of attributes associate with the typed link.
(dict) –
A typed link attribute definition.
Name (string) –
The unique name of the typed link attribute.
Type (string) –
The type of the attribute.
DefaultValue (dict) –
The default value of the attribute (if configured).
StringValue (string) –
A string data value.
BinaryValue (bytes) –
A binary data value.
BooleanValue (boolean) –
A Boolean data value.
NumberValue (string) –
A number data value.
DatetimeValue (datetime) –
A date and time value.
IsImmutable (boolean) –
Whether the attribute is mutable or not.
Rules (dict) –
Validation rules that are attached to the attribute definition.
(string) –
(dict) –
Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.
Type (string) –
The type of attribute validation rule.
Parameters (dict) –
The minimum and maximum parameters that are associated with the rule.
(string) –
(string) –
RequiredBehavior (string) –
The required behavior of the TypedLinkAttributeDefinition
.
paginator = client.get_paginator('list_typed_link_facet_names')
Creates an iterator that will paginate through responses from CloudDirectory.Client.list_typed_link_facet_names()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
SchemaArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
SchemaArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns .
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'FacetNames': [
'string',
],
}
Response Structure
(dict) –
FacetNames (list) –
The names of typed link facets that exist within the schema.
(string) –
paginator = client.get_paginator('lookup_policy')
Creates an iterator that will paginate through responses from CloudDirectory.Client.lookup_policy()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DirectoryArn='string',
ObjectReference={
'Selector': 'string'
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
DirectoryArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory . For more information, see arns .
ObjectReference (dict) –
[REQUIRED]
Reference that identifies the object whose policies will be looked up.
Selector (string) –
A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects . You can identify an object in one of the following ways:
$ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier. To identify an object with ObjectIdentifier, the ObjectIdentifier must be wrapped in double quotes.
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'PolicyToPathList': [
{
'Path': 'string',
'Policies': [
{
'PolicyId': 'string',
'ObjectIdentifier': 'string',
'PolicyType': 'string'
},
]
},
],
}
Response Structure
(dict) –
PolicyToPathList (list) –
Provides list of path to policies. Policies contain PolicyId
, ObjectIdentifier
, and PolicyType
. For more information, see Policies .
(dict) –
Used when a regular object exists in a Directory and you want to find all of the policies that are associated with that object and the parent to that object.
Path (string) –
The path that is referenced from the root.
Policies (list) –
List of policy objects.
(dict) –
Contains the PolicyType
, PolicyId
, and the ObjectIdentifier
to which it is attached. For more information, see Policies .
PolicyId (string) –
The ID of PolicyAttachment
.
ObjectIdentifier (string) –
The ObjectIdentifier
that is associated with PolicyAttachment
.
PolicyType (string) –
The type of policy that can be associated with PolicyAttachment
.