Después de iniciar el servicio de datos REST de eXtreme Scale, puede utilizar cualquier cliente HTTP para interactuar con él. Se puede utilizar un navegador web, un cliente PHP, un cliente Java o un cliente de WCF Data Services
para emitir cualquiera de las operaciones de solicitud soportadas.
El servicio REST implementa un subconjunto de la especificación Microsoft Atom
Publishing Protocol: Data Services URI and Payload Extensions, Versión 1.0, que forma parte del protocolo OData.
Este tema describe qué características de la especificación están soportadas y cómo se correlacionan con eXtreme Scale.
URI de la raíz de servicio
Microsoft WCF Data Services define normalmente un servicio por origen de datos o modelo de entidad. El servicio de datos REST de eXtreme Scale define un servicio por cada ObjectGrid definida. Cada ObjectGrid definida en el archivo XML de sustitución de cliente ObjectGrid de eXtreme Scale se expone automáticamente como raíz del servicio REST independiente.
El URI de la raíz de servicio es:
http://host:puerto/raízcontexto/restservice/nombrecuadrícula
Donde:
- raízcontexto se define al desplegar la aplicación de servicio de datos REST
y depende del servidor de aplicaciones
- nombrecuadrícula es el nombre del ObjectGrid
Tipos de solicitud
La lista siguiente describe los tipos de solicitud de
Microsoft WCF Data Services que el servicio de datos REST
de eXtreme Scale soporta. Para obtener información detallada sobre
cada tipo de solicitud que WCF Data Services soporta, consulte MSDN: Request Types
- Tipos de solicitudes de inserción
Los clientes pueden insertar recursos utilizando el verbo HTTP POST con las limitaciones siguientes:
- Solicitud InsertEntity: Soportada.
- Solicitud InsertLink: Soportada.
- Solicitud InsertMediaResource: No soportada debido a la restricción de soporte de recursos de medios.
Para obtener información adicional, consulte:
MSDN: Insert Request Types.
- Tipos de solicitudes de actualización
Los clientes pueden actualizar recursos utilizando los verbos HTTP PUT y MERGE con las limitaciones siguientes:
- Solicitud UpdateEntity: Soportada.
- Solicitud UpdateComplexType: No soportada debido a la restricción de tipo complejo.
- Solicitud UpdatePrimitiveProperty: Soportada.
- Solicitud UpdateValue: Soportada.
- Solicitud UpdateLink: Soportada.
- Solicitud UpdateMediaResource: No soportada debido a la restricción de soporte de recursos de medios.
Para obtener información adicional, consulte:
MSDN: Insert Request types.
- Tipos de solicitudes de supresión
Los clientes pueden suprimir recursos utilizando el verbo HTTP DELETE con las limitaciones siguientes:
- Solicitud DeleteEntity: Soportada.
- Solicitud DeleteLink: Soportada.
- Solicitud DeleteValue: Soportada.
Para obtener información adicional, consulte:
MSDN: Delete Request Types.
- Tipos de solicitudes de recuperación
Los clientes pueden recuperar recursos utilizando el verbo HTTP GET con las limitaciones siguientes:
- Solicitud RetrieveEntitySet: Soportada.
- Solicitud RetrieveEntity: Soportada.
- Solicitud RetrieveComplexType: No soportada debido a la restricción de tipo complejo.
- Solicitud RetrievePrimitiveProperty: Soportada.
- Solicitud RetrieveValue: Soportada.
- Solicitud RetrieveServiceMetadata: Soportada.
- Solicitud RetrieveServiceDocument: Soportada.
- Solicitud RetrieveLink: Soportada.
- Solicitud Retrieve que contiene una correlación de canal de información personalizable: No soportada
- RetrieveMediaResource: No soportada debido a la restricción de recursos de medios.
Para obtener información adicional, consulte:
MSDN: Retrieve Request Types.
- Opciones de consulta del sistema
Hay consultas soportadas que permiten que los clientes identifiquen una colección de entidades o una sola entidad. Las opciones de consulta del sistema se especifican en un URI de servicio de datos y están soportadas con las limitaciones siguientes:
- $expand: Soportada.
- $filter: Soportada.
- $orderby: Soportada.
- $format: No soportada. El formato aceptable se identifica en la cabecera de solicitud HTTP Accept.
- $skip: Soportada.
- $top: Soportada.
Para obtener información adicional, consulte:
MSDN: System Query Options.
- Direccionamiento de particiones
El direccionamiento de particiones se basa en la entidad raíz.
Un URI de solicitud deduce una entidad raíz si su vía de acceso de recurso empieza con una entidad raíz o con una entidad que tenga una asociación directa o indirecta con la entidad. En un entorno particionado, cualquier solicitud que no pueda deducir una entidad raíz se rechazará. Cualquier solicitud que deduzca una entidad raíz se direccionará a la partición correcta.
Para obtener información adicional sobre la definición de un esquema con asociaciones y entidades raíz, consulte Modelo de datos escalable de eXtreme Scale y Particionamiento.
Solicitud de invocación
Las solicitudes de invocación no están soportadas.Para obtener información adicional, consulte: MSDN: Invoke RequestTypes.
Solicitud por lotes
Los clientes pueden realizar por lotes varios conjuntos de cambios u operaciones de consulta en una sola solicitud. Esto puede reducir el número de transmisiones de ida y vuelta al servidor y permite la participación de varias solicitudes en una sola transacción. Para obtener información adicional, consulte: MSDN: Batch Request.
Solicitudes a través de túnel
Las solicitudes a través de túnel no están soportadas. Para obtener información adicional, consulte: MSDN: Tunneled Requests.