# CreateFunctionUrlConfig
<a name="API_CreateFunctionUrlConfig"></a>

Crea una URL de función de Lambda con los parámetros de configuración especificados. Una URL de función es un punto de conexión HTTP(S) dedicado que puede utilizar para invocar la función.

## Sintaxis de la solicitud
<a name="API_CreateFunctionUrlConfig_RequestSyntax"></a>

```
POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateFunctionUrlConfig_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [FunctionName](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-FunctionName"></a>
El nombre de la función de Lambda.  

**Formatos de nombre**
+  **Nombre de la función**: `my-function`.
+  **ARN de la función**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, se limita a 64 caracteres de longitud.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Obligatorio: sí

 ** [Qualifier](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-Qualifier"></a>
El nombre del alias.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.  
Patrón: `(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` 

## Cuerpo de la solicitud
<a name="API_CreateFunctionUrlConfig_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [AuthType](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-AuthType"></a>
El tipo de autenticación que utiliza la URL de función. Establézcalo en `AWS_IAM` si desea restringir el acceso solo a los usuarios autenticados. Establézcalo en `NONE` si desea omitir la autenticación de IAM para crear un punto de conexión público. Para obtener más información, consulte [Modelo de seguridad y autenticación para URL de funciones de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Tipo: cadena  
Valores válidos: `NONE | AWS_IAM`   
Obligatorio: sí

 ** [Cors](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-Cors"></a>
La configuración de [uso compartido de recursos entre orígenes (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) para la URL de función.  
Tipo: objeto [Cors](API_Cors.md)  
Obligatorio: no

 ** [InvokeMode](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-InvokeMode"></a>
Utilice una de las siguientes opciones:  
+  `BUFFERED`: esta es la opción predeterminada. Lambda invoca su función mediante la operación de la API `Invoke`. Los resultados de la invocación estarán disponibles cuando se complete la carga. El tamaño de carga máximo es de 6 MB.
+  `RESPONSE_STREAM`: su función transmite los resultados de la carga a medida que estén disponibles. Lambda invoca su función mediante la operación de la API `InvokeWithResponseStream`. El tamaño máximo de la carga de respuesta es de 20 MB; sin embargo, puede [solicitar un aumento de la cuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).
Tipo: cadena  
Valores válidos: `BUFFERED | RESPONSE_STREAM`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string"
}
```

## Elementos de respuesta
<a name="API_CreateFunctionUrlConfig_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AuthType](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-AuthType"></a>
El tipo de autenticación que utiliza la URL de función. Establézcalo en `AWS_IAM` si desea restringir el acceso solo a los usuarios autenticados. Establézcalo en `NONE` si desea omitir la autenticación de IAM para crear un punto de conexión público. Para obtener más información, consulte [Modelo de seguridad y autenticación para URL de funciones de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Tipo: cadena  
Valores válidos: `NONE | AWS_IAM` 

 ** [Cors](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-Cors"></a>
La configuración de [uso compartido de recursos entre orígenes (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) para la URL de función.  
Tipo: objeto [Cors](API_Cors.md)

 ** [CreationTime](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-CreationTime"></a>
Cuando se creó la URL de función, en [formato ISO-8601](https://www.w3.org/TR/NOTE-datetime) (AAAA-MM-DDThh:mm:ss.sTZD).  
Tipo: cadena

 ** [FunctionArn](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionArn"></a>
El nombre de recurso de Amazon (ARN) de la función.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionUrl](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionUrl"></a>
El punto de conexión de la URL HTTP de la función.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 40. La longitud máxima es de 100 caracteres.

 ** [InvokeMode](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-InvokeMode"></a>
Utilice una de las siguientes opciones:  
+  `BUFFERED`: esta es la opción predeterminada. Lambda invoca su función mediante la operación de la API `Invoke`. Los resultados de la invocación estarán disponibles cuando se complete la carga. El tamaño de carga máximo es de 6 MB.
+  `RESPONSE_STREAM`: su función transmite los resultados de la carga a medida que estén disponibles. Lambda invoca su función mediante la operación de la API `InvokeWithResponseStream`. El tamaño máximo de la carga de respuesta es de 20 MB; sin embargo, puede [solicitar un aumento de la cuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).
Tipo: cadena  
Valores válidos: `BUFFERED | RESPONSE_STREAM` 

## Errores
<a name="API_CreateFunctionUrlConfig_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno de los parámetros de la solicitud no es válido.  
Código de estado HTTP: 400

 ** ResourceConflictException **   
El recurso ya existe o hay otra operación en marcha.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
El recurso especificado en la solicitud no existe.  
Código de estado HTTP: 404

 ** ServiceException **   
El servicio AWS Lambda detectó un error interno.  
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_CreateFunctionUrlConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunctionUrlConfig)