# Referencias de API
Amazon API Gateway proporciona API para la creación y la implementación de sus propias API HTTP y de WebSocket. Además, las API de API Gateway están disponibles en los AWS SDK estándar.
Si utiliza un lenguaje para el que existe un AWS SDK, puede que prefiera usar el SDK en lugar de utilizar las API de REST de API Gateway directamente. Los SDK simplifican la autenticación, se integran fácilmente en su entorno de desarrollo y proporcionan acceso sencillo a los comandos de API Gateway.
Aquí puede encontrar la documentación de referencia de API de REST de los AWS SDK y API Gateway:
+ [Herramientas para Amazon Web Services](https://aws.amazon.com/developer/tools/)
+ [Referencia de la API de REST de Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html)
+ [Referencia de la API de Amazon API Gateway de WebSocket y de HTTP](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html)
## Puntos de conexión del servicio de API Gateway
Un punto de conexión es una URL que sirve como punto de entrada para un servicio web de AWS. API Gateway admite los siguientes tipos de puntos de conexión:
+ [Puntos de conexión IPv4](#api-reference-service-endpoints-ipv4)
+ [Puntos de conexión de pila doble](#api-reference-service-endpoints-ipv6) (compatibles con IPv4 e IPv6)
+ [ Puntos de conexión de FIPS](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints)
Al realizar una solicitud, puede especificar el punto de conexión que se va a utilizar. Si no especifica un punto de conexión, se utilizará de forma predeterminada el punto de conexión IPv4. Para utilizar un tipo de punto de conexión diferente, debe especificarlo en la solicitud. Para ver ejemplos prácticos, consulte [Especificación de puntos de conexión](#api-reference-service-endpoints-specify-endpoints). Para ver una tabla de los puntos de conexión disponibles, consulte [Puntos de conexión de Amazon API Gateway](https://docs.aws.amazon.com/general/latest/gr/apigateway.html).
### Puntos de conexión IPv4
Los puntos de conexión IPv4 solo son compatibles con el tráfico IPv4. Los puntos de conexión IPv4 están disponibles para todas las regiones.
Si especifica el punto de conexión general `apigateway.amazonaws.com`, utilizamos el punto de conexión para `us-east-1`. Para utilizar una región diferente, especifique su punto de conexión asociado. Por ejemplo, si especifica `apigateway.us-east-2.amazonaws.com` como punto de conexión, dirigimos su solicitud al punto de conexión `us-east-2`.
Los nombres de puntos de conexión IPv4 utilizan la siguiente convención de nomenclatura:
+ `apigateway.region.amazonaws.com`
Por ejemplo, el nombre del punto de conexión IPv4 para la región `eu-west-1` es `apigateway.eu-west-1.amazonaws.com`.
### Puntos de conexión de pila doble (IPv4 e IPv6)
Los puntos de conexión de pila doble admiten tráfico IPv4 e IPv6. Cuando realiza una solicitud a un punto de conexión de pila doble, la URL del punto de conexión se resuelve en una dirección IPv6 o IPv4, en función del protocolo que utilicen la red y el cliente.
Los nombres de puntos de conexión de doble pila utilizan la siguiente convención de nomenclatura:
+ `apigateway.region.api.aws`
Por ejemplo, el nombre del punto de conexión de doble pila para la región `eu-west-1` es `apigateway.eu-west-1.api.aws`.
### Especificación de puntos de conexión
En los siguientes ejemplos, se muestra cómo especificar un punto de conexión para la región `us-east-2` mediante la AWS CLI para la `apigateway`.
+ **Pila doble**
```
aws apigateway get-rest-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.api.aws
```
+ **IPv4**
```
aws apigateway get-rest-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.amazonaws.com
```
En los siguientes ejemplos, se muestra cómo especificar un punto de conexión para la región `us-east-2` mediante la AWS CLI para la `apigatewayv2`.
+ **Pila doble**
```
aws apigatewayv2 get-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.api.aws
```
+ **IPv4**
```
aws apigatewayv2 get-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.amazonaws.com
```
## Uso de direcciones IPv6 en políticas de IAM
Si utiliza políticas de usuario de IAM o políticas de recursos de API Gateway para controlar el acceso a API Gateway o a cualquier API de API Gateway, confirme que las políticas estén actualizadas para incluir los rangos de direcciones IPv6. Las políticas que no se actualizan para gestionar las direcciones IPv6 pueden afectar al acceso del cliente a API Gateway cuando comiencen a utilizar el punto de conexión de pila doble. Para obtener más información acerca de cómo administrar los permisos de acceso con IAM, consulte [Identity and Access Management para Amazon API Gateway](security-iam.md)
Las políticas de IAM que filtran direcciones IP utilizan [operadores de condición de dirección IP](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IPAddress). La siguiente política de identidad permite a las direcciones IP del rango `54.240.143.*` obtener información acerca de todos los recursos de una API HTTP o de WebSocket con el identificador de `a123456789`. A cualquier dirección IP fuera de este rango se le denegará el acceso a la información de todos los recursos de la API. Dado que todas las direcciones IPv6 están fuera del rango permitido, esta política evita que las direcciones IPv6 puedan acceder a información sobre la API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "IPAllow",
"Effect": "Allow",
"Principal": "*",
"Action": "apigateway:GET",
"Resource": "arn:aws:apigateway:us-east-1::/apis/a123456789/*",
"Condition": {
"IpAddress": {"aws:SourceIp": "54.240.143.0/24"}
}
}
]
}
```
------
Puede modificar el elemento `Condition` de la política de la API para permitir los rangos de direcciones IPv4 (`54.240.143.0/24`) e IPv6 (`2001:DB8:1234:5678::/64`) como se muestra en el siguiente ejemplo. Puede utilizar el mismo tipo de bloque `Condition` que se muestra en el ejemplo para actualizar las políticas de usuario de IAM y políticas de recursos de API Gateway.
```
1. "Condition": {
2. "IpAddress": {
3. "aws:SourceIp": [
4. "54.240.143.0/24",
5. "2001:DB8:1234:5678::/64"
6. ]
7. }
8. }
```