2017/07/25 - Amazon CloudDirectory - 2 updated api methods
Changes Cloud Directory adds support for additional batch operations.
{'Operations': {'GetObjectInformation': {'ObjectReference': {'Selector': 'string'}},
'ListAttachedIndices': {'MaxResults': 'integer',
'NextToken': 'string',
'TargetReference': {'Selector': 'string'}},
'ListIncomingTypedLinks': {'FilterAttributeRanges': [{'AttributeName': 'string',
'Range': {'EndMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'EndValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'},
'StartMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'StartValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}}],
'FilterTypedLink': {'SchemaArn': 'string',
'TypedLinkName': 'string'},
'MaxResults': 'integer',
'NextToken': 'string',
'ObjectReference': {'Selector': 'string'}},
'ListIndex': {'IndexReference': {'Selector': 'string'},
'MaxResults': 'integer',
'NextToken': 'string',
'RangesOnIndexedValues': [{'AttributeKey': {'FacetName': 'string',
'Name': 'string',
'SchemaArn': 'string'},
'Range': {'EndMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'EndValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'},
'StartMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'StartValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}}]},
'ListObjectParentPaths': {'MaxResults': 'integer',
'NextToken': 'string',
'ObjectReference': {'Selector': 'string'}},
'ListObjectPolicies': {'MaxResults': 'integer',
'NextToken': 'string',
'ObjectReference': {'Selector': 'string'}},
'ListOutgoingTypedLinks': {'FilterAttributeRanges': [{'AttributeName': 'string',
'Range': {'EndMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'EndValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'},
'StartMode': 'FIRST '
'| '
'LAST '
'| '
'LAST_BEFORE_MISSING_VALUES '
'| '
'INCLUSIVE '
'| '
'EXCLUSIVE',
'StartValue': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}}],
'FilterTypedLink': {'SchemaArn': 'string',
'TypedLinkName': 'string'},
'MaxResults': 'integer',
'NextToken': 'string',
'ObjectReference': {'Selector': 'string'}},
'ListPolicyAttachments': {'MaxResults': 'integer',
'NextToken': 'string',
'PolicyReference': {'Selector': 'string'}},
'LookupPolicy': {'MaxResults': 'integer',
'NextToken': 'string',
'ObjectReference': {'Selector': 'string'}}}}
Response {'Responses': {'ExceptionResponse': {'Type': {'CannotListParentOfRootException',
'DirectoryNotEnabledException',
'FacetValidationException',
'InternalServiceException',
'LimitExceededException',
'NotIndexException',
'NotPolicyException'}},
'SuccessfulResponse': {'GetObjectInformation': {'ObjectIdentifier': 'string',
'SchemaFacets': [{'FacetName': 'string',
'SchemaArn': 'string'}]},
'ListAttachedIndices': {'IndexAttachments': [{'IndexedAttributes': [{'Key': {'FacetName': 'string',
'Name': 'string',
'SchemaArn': 'string'},
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'ObjectIdentifier': 'string'}],
'NextToken': 'string'},
'ListIncomingTypedLinks': {'LinkSpecifiers': [{'IdentityAttributeValues': [{'AttributeName': 'string',
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'SourceObjectReference': {'Selector': 'string'},
'TargetObjectReference': {'Selector': 'string'},
'TypedLinkFacet': {'SchemaArn': 'string',
'TypedLinkName': 'string'}}],
'NextToken': 'string'},
'ListIndex': {'IndexAttachments': [{'IndexedAttributes': [{'Key': {'FacetName': 'string',
'Name': 'string',
'SchemaArn': 'string'},
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'ObjectIdentifier': 'string'}],
'NextToken': 'string'},
'ListObjectParentPaths': {'NextToken': 'string',
'PathToObjectIdentifiersList': [{'ObjectIdentifiers': ['string'],
'Path': 'string'}]},
'ListObjectPolicies': {'AttachedPolicyIds': ['string'],
'NextToken': 'string'},
'ListOutgoingTypedLinks': {'NextToken': 'string',
'TypedLinkSpecifiers': [{'IdentityAttributeValues': [{'AttributeName': 'string',
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'SourceObjectReference': {'Selector': 'string'},
'TargetObjectReference': {'Selector': 'string'},
'TypedLinkFacet': {'SchemaArn': 'string',
'TypedLinkName': 'string'}}]},
'ListPolicyAttachments': {'NextToken': 'string',
'ObjectIdentifiers': ['string']},
'LookupPolicy': {'NextToken': 'string',
'PolicyToPathList': [{'Path': 'string',
'Policies': [{'ObjectIdentifier': 'string',
'PolicyId': 'string',
'PolicyType': 'string'}]}]}}}}
Performs all the read operations in a batch.
See also: AWS API Documentation
Request Syntax
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'
}
},
'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
}
},
],
ConsistencyLevel='SERIALIZABLE'|'EVENTUAL'
)
string
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.
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 Accessing 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
/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.
FacetName (string) --
The name of the facet.
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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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 link.
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 Accessing 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
/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 link.
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 Accessing 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
/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.
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'
},
'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'
}
},
'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.
FacetName (string) --
The name of the facet.
ObjectIdentifier (string) --
The ObjectIdentifier of the specified object.
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) --
The ObjectIdentifier of the object attached to the index.
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) --
The ObjectIdentifier of the object attached to the index.
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 link.
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 Accessing 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
/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 Accessing 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
/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 link.
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 Accessing 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
/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 Accessing 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
/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.
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.
{'Operations': {'AttachPolicy': {'ObjectReference': {'Selector': 'string'},
'PolicyReference': {'Selector': 'string'}},
'AttachToIndex': {'IndexReference': {'Selector': 'string'},
'TargetReference': {'Selector': 'string'}},
'AttachTypedLink': {'Attributes': [{'AttributeName': 'string',
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'SourceObjectReference': {'Selector': 'string'},
'TargetObjectReference': {'Selector': 'string'},
'TypedLinkFacet': {'SchemaArn': 'string',
'TypedLinkName': 'string'}},
'CreateIndex': {'BatchReferenceName': 'string',
'IsUnique': 'boolean',
'LinkName': 'string',
'OrderedIndexedAttributeList': [{'FacetName': 'string',
'Name': 'string',
'SchemaArn': 'string'}],
'ParentReference': {'Selector': 'string'}},
'DetachFromIndex': {'IndexReference': {'Selector': 'string'},
'TargetReference': {'Selector': 'string'}},
'DetachTypedLink': {'TypedLinkSpecifier': {'IdentityAttributeValues': [{'AttributeName': 'string',
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'SourceObjectReference': {'Selector': 'string'},
'TargetObjectReference': {'Selector': 'string'},
'TypedLinkFacet': {'SchemaArn': 'string',
'TypedLinkName': 'string'}}}}}
Response {'Responses': {'AttachPolicy': {},
'AttachToIndex': {'AttachedObjectIdentifier': 'string'},
'AttachTypedLink': {'TypedLinkSpecifier': {'IdentityAttributeValues': [{'AttributeName': 'string',
'Value': {'BinaryValue': 'blob',
'BooleanValue': 'boolean',
'DatetimeValue': 'timestamp',
'NumberValue': 'string',
'StringValue': 'string'}}],
'SourceObjectReference': {'Selector': 'string'},
'TargetObjectReference': {'Selector': 'string'},
'TypedLinkFacet': {'SchemaArn': 'string',
'TypedLinkName': 'string'}}},
'CreateIndex': {'ObjectIdentifier': 'string'},
'DetachFromIndex': {'DetachedObjectIdentifier': 'string'},
'DetachTypedLink': {}}}
Performs all the write operations in a batch. Either all the operations succeed or none. Batch writes supports only object-related operations.
See also: AWS API Documentation
Request Syntax
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'
}
},
'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)
}
},
]
}
}
},
]
)
string
[REQUIRED]
The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.
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.
FacetName (string) --
The name of the facet.
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) -- [REQUIRED]
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 Accessing 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
/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) -- [REQUIRED]
The batch reference name. See Batches 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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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) -- [REQUIRED]
The batch reference name. See Batches 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 Accessing 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
/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 Accessing 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
/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.
FacetName (string) --
The name of the facet.
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 Accessing 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
/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.
FacetName (string) --
The name of the facet.
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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/some/path - Identifies the object based on path
#SomeBatchReference - Identifies the object in a batch call
CreateIndex (dict) --
Creates an index object. See Indexing 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 Accessing 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
/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 Batches 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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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 Accessing 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
/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 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 Accessing 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
/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 Accessing 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
/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 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 Accessing 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
/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 Accessing 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
/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.
dict
Response Syntax
{
'Responses': [
{
'CreateObject': {
'ObjectIdentifier': 'string'
},
'AttachObject': {
'attachedObjectIdentifier': 'string'
},
'DetachObject': {
'detachedObjectIdentifier': 'string'
},
'UpdateObjectAttributes': {
'ObjectIdentifier': 'string'
},
'DeleteObject': {},
'AddFacetToObject': {},
'RemoveFacetFromObject': {},
'AttachPolicy': {},
'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': {}
},
]
}
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.
CreateIndex (dict) --
Creates an index object. See Indexing 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 link.
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 Accessing 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
/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 Accessing 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
/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 link.