Uso de las acciones de API de Cloud Directory - Amazon Cloud Directory

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de las acciones de API de Cloud Directory

Amazon Cloud Directory incluye un conjunto de operaciones de API que habilitan el acceso mediante programación a las funcionalidades de Cloud Directory. Puede utilizarAmazon Cloud Directory API Reference GuidePara obtener información sobre cómo realizar solicitudes a la API de Cloud Directory para crear y administrar los distintos elementos. También se tratan los componentes de las solicitudes, el contenido de las respuestas y cómo autenticar las solicitudes.

Cloud Directory proporciona todas las operaciones API necesarias para que los desarrolladores puedan crear aplicaciones nuevas. Proporciona llamadas al API dentro de las siguientes categorías:

  • Operaciones de creación, lectura, actualización y eliminación (CRUD) en esquemas

  • Operaciones CRUD en facetas

  • Operaciones CRUD en directorios

  • Operaciones CRUD en objetos (nodos, políticas, etc.)

  • Operaciones CRUD en definición de índices

  • Operaciones de lectura y escritura por lotes

Cómo funciona la facturación con las API de Cloud Directory

La facturación de las llamadas a la API varía en función de los tipos específicos de llamadas a la API que se realicen. Existen tarifas de facturación específicas para las llamadas a la API de lectura consistente final, las llamadas a la API de lectura consistente alta y llamadas a la API de escritura. Las llamadas a la API de metadatos son gratuitas.

Las operaciones consistentes altas se utilizan para la consistencia de lectura tras la escritura al leer un valor. Las operaciones consistentes finales se utilizan para recuperar un valor mientras se realizan actualizaciones. Con las operaciones consistentes finales, es posible que los resultados recuperados no sean los más precisos, porque el host específico desde el que se está leyendo el valor aún está procesando las actualizaciones. Sin embargo, la latencia de dichas operaciones de lectura es baja al recuperar una llamada de desempeño.

Al leer datos de Cloud Directory, debe especificar una operación de tipo de lectura consistente final o lectura consistente alta. El tipo de lectura se basa en el nivel de consistencia. Los dos niveles de consistencia son EVENTUAL para lecturas consistentes finales y SERIALIZABLE para lecturas consistentes altas. Para obtener más información, consulte Niveles de coherencia.

En la siguiente tabla se muestran todas las API de Cloud Directory y cómo pueden influir en la facturación de su cuenta de AWS.

API Lectura consistente final 1 Lectura consistente alta 2 Escritura 3 Metadatos 4
AddFacetToObject X
ApplySchema X
AttachObject X
AttachPolicy X
AttachToIndex X
AttachTypedLink X
BatchRead X X
BatchWrite X
CreateDirectory X
CreateFacet X
CreateIndex X
CreateObject X
CreateSchema X
CreateTypedLinkFacet X
DeleteDirectory X
DeleteFacet X
DeleteObject X
DeleteSchema X
DetachFromIndex X
DetachObject X
DetachPolicy X
DetachTypedLink X
DeleteTypedLinkFacet X
DisableDirectory X
EnableDirectory X
GetAppliedSchemaVersion X
GetDirectory X
GetFacet X
GetLinkAttributes X X
GetObjectAttributes X X
GetObjectInformation X X
GetSchemaAsJson X
GetTypedLinkFacetInformation X
ListAppliedSchemaArns X
ListAttachedIndices X X
ListDevelopmentSchemaArns X
ListDirectories X
ListFacetAttributes X
ListFacetNames X
ListIncomingTypedLinks X X
ListIndex X X
ListManagedSchemaArns X
ListObjectAttributes X X
ListObjectChildren X X
ListObjectParentPaths X
ListObjectParents X X
ListObjectPolicies X X
ListOutgoingTypedLinks X X
ListPolicyAttachments X X
ListPublishedSchemaArns X
ListTagsForResource X
ListTypedLinkFacetAttributes X
ListTypedLinkFacetNames X
LookupPolicy X
PublishSchema X
PutSchemaFromJson X
RemoveFacetFromObject X
TagResource X
UntagResource X
UpdateFacet X
UpdateLinkAttributes X
UpdateObjectAttributes X
UpdateSchema X
UpdateTypedLinkFacet X
UpgradeAppliedSchema X
UpgradePublishedSchema X

1 A las API de lectura consistente final se les llama con el nivel de consistencia EVENTUAL

2 A las API de lectura consistente alta se les llama con el nivel de consistencia SERIALIZABLE

3 Las API de escritura se facturan como llamadas a la API de escritura

4 Las API de metadatos NO se facturan, sino que se clasifican como llamadas a la API de metadatos

Para obtener más información sobre facturación, consultePrecios de Amazon Cloud Directory.