CreateRouteTable - Virtual Private Cloud - Centro de documentación de Alibaba Cloud

Crea una tabla de rutas personalizada.

Descripción de la operación

La API CreateRouteTable es asíncrona, lo que significa que el sistema devuelve un ID de instancia, pero la tabla de rutas personalizada aún no se ha creado por completo y la tarea de creación continúa ejecutándose en segundo plano. Puede llamar a DescribeRouteTableList para consultar el estado de creación de la tabla de rutas personalizada:
- Cuando la tabla de rutas personalizada está en estado Creating, indica que se encuentra en proceso de creación.
- Cuando la tabla de rutas personalizada está en estado Available, indica que su creación ha finalizado.
La API CreateRouteTable no admite la creación concurrente de tablas de rutas personalizadas dentro de la misma VPC.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:CreateRouteTable

create

*RouteTable

acs:vpc:{#regionId}:{#accountId}:routetable/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región de la nube privada virtual (VPC) a la que pertenece la tabla de rutas personalizada. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-zhangjiakou
VpcId	string	Sí	El ID de la VPC a la que pertenece la tabla de rutas personalizada.	vpc-bp1qpo0kug3a20qqe****
RouteTableName	string	No	El nombre de la tabla de rutas. El nombre debe tener entre 1 y 128 caracteres de longitud, y no puede comenzar con `http://` o `https://`.	myRouteTable
Description	string	No	La descripción de la tabla de rutas. La descripción debe tener entre 1 y 256 caracteres de longitud, y no puede comenzar con `http://` o `https://`.	abc
AssociateType	string	No	El tipo de la tabla de rutas. Valores válidos: VSwitch (predeterminado): tabla de rutas de vSwitch Gateway: tabla de rutas de gateway	VSwitch
RegionId	string	Sí	El ID de la región de la nube privada virtual (VPC) a la que pertenece la tabla de rutas personalizada. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-zhangjiakou
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, ClientToken se establece con el valor de RequestId. El valor de RequestId en cada solicitud de API puede ser diferente.	02fb3da4-130e-11e9-8e44-0016e04
Tag	array<object>	No	Las etiquetas del recurso.
	object	No	Las etiquetas.
Key	string	No	La clave de la etiqueta. Puede especificar hasta 20 claves de etiqueta. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 128 caracteres de longitud. No puede comenzar con `aliyun` o `acs:`, y no puede contener `http://` o `https://`.	FinanceDept
Value	string	No	El valor de la etiqueta. Puede especificar hasta 20 valores de etiqueta. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` o `https://`. El valor de la etiqueta no puede comenzar con `aliyun` o `acs:`.	FinanceJoshua

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La información devuelta.
RequestId	string	El ID de la solicitud.	62172DD5-6BAC-45DF-8D44-E11ED28DCAC0
RouteTableId	string	Los ID de las tablas de rutas.	vtb-bp145q7glnuzdvzu2****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "62172DD5-6BAC-45DF-8D44-E11ED28DCAC0",
  "RouteTableId": "vtb-bp145q7glnuzdvzu2****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	UnsupportedRegion	The feature of ipv4Gateway is not supported in the region.	IPv4 gateways are not supported in this region.
400	InvalidParameter.RouteTableName.Malformed	The specified route table name is not valid.
400	InvalidParameter.Description.Malformed	The specified Description is not valid.
400	QuotaExceeded.RouteTable	VPC RouteTable quota exceeded.	The quota of VPC route tables is exhausted.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	The status of the CEN instance is invalid.
400	InvalidVpcId.NotSupport	The vpc is not support.
400	OperationUnsupported.AdvancedFeature	Advanced features of the vpc is unsupported.	This advanced feature is not supported.
400	QuotaExceeded.GatewayRouteTable	The quota of Gateway Route Table is exceeded.	The quota of the gateway route table created for a single VPC has reached the upper limit.
400	MissingParam.vpcId	The parameter vpcId is mandatory.	The vpcId parameter is required.
400	InvalidRegionId.NotFound	Specified value of RegionId is not supported.
400	InvalidParameter.Action	This vpc feature is not supported in this region
404	InvalidVpcId.NotFound	Specified VPC does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.