CreateBasicEndpoints - Global Accelerator - Centro de documentación de Alibaba Cloud

Crea múltiples endpoints para una instancia básica de Global Accelerator (GA).

Descripción de la operación

CreateBasicEndpoints es una operación asíncrona. Después de llamar a esta operación, el sistema devuelve un ID de solicitud y ejecuta la tarea en segundo plano. Puede llamar a la operación ListBasicEndpoints para consultar el estado de los endpoints. - Si uno o más endpoints están en estado init, indica que los endpoints se están creando. En este caso, puede continuar realizando operaciones de consulta sobre los endpoints. Si todos los endpoints están en estado active, indica que los endpoints han sido creados.
No puede volver a llamar a la operación CreateBasicEndpoints en la misma instancia de GA antes de que finalice la operación anterior.

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

ga:CreateBasicEndpoints

create

*BasicEndpoint

acs:ga:{#regionId}:{#accountId}:basicendpoint/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región donde está desplegada la instancia de GA. Establezca el valor en cn-hangzhou.	cn-hangzhou
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el ID de solicitud como token de cliente. El ID de solicitud puede ser diferente para cada solicitud.	123e4567-e89b-12d3-a456-426655440000
AcceleratorId	string	Sí	El ID de la instancia básica de GA.	ga-bp17frjjh0udz4qz****
EndpointGroupId	string	Sí	El ID del grupo de endpoints.	epg-bp1dmlohjjz4kqaun****
Endpoints	array<object>	Sí	Los endpoints.
	object	No	Los endpoints en el grupo de endpoints.
Name	string	No	El nombre del endpoint. El nombre debe tener una longitud de 1 a 128 caracteres y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). Debe comenzar con una letra.	ep01
EndpointType	string	No	El tipo de endpoint. Valores válidos: ENI: interfaz de red elástica (ENI). SLB: instancia de Classic Load Balancer (CLB). ECS: instancia de Elastic Compute Service (ECS). NLB: instancia de Network Load Balancer (NLB). Nota Este parámetro es obligatorio.	ENI
EndpointAddress	string	No	La dirección del endpoint.	eni-bp1a05txelswuj8g****
EndpointSubAddress	string	No	La dirección secundaria del endpoint. Este parámetro es obligatorio solo si establece el tipo de endpoint en ECS, ENI o NLB. Si establece el tipo de endpoint en ECS, puede configurar EndpointSubAddress con la dirección IP privada secundaria de la ENI principal. Si deja este parámetro vacío, se utiliza la dirección IP privada principal de la ENI principal. Si establece el tipo de endpoint en ENI, puede configurar EndpointSubAddress con la dirección IP privada secundaria de la ENI secundaria. Si deja este parámetro vacío, se utiliza la dirección IP privada principal de la ENI secundaria. Si establece el tipo de endpoint en NLB, puede configurar EndpointSubAddress con la dirección IP privada principal del servidor backend del NLB.	172.16.XX.XX
EndpointSubAddressType	string	No	El tipo de dirección secundaria del endpoint. Valores válidos: primary: una dirección IP privada principal. secondary: una dirección IP privada secundaria. Este parámetro es obligatorio solo si establece el tipo de endpoint en ECS, ENI o NLB. Si establece el tipo de endpoint en NLB, solo se admite primary.	primary
EndpointZoneId	string	No	El ID de la zona donde reside el endpoint. Este parámetro es obligatorio solo si establece el tipo de endpoint en NLB.	cn-hangzhou-g

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Una lista de parámetros de respuesta.
RequestId	string	El ID de la solicitud.	04F0F334-1335-436C-A1D7-6C044FE73368
EndpointGroupId	string	El ID del grupo de endpoints.	epg-bp1dmlohjjz4kqaun****
Endpoints	array<object>	Los endpoints en el grupo de endpoints.
	object	Los endpoints en el grupo de endpoints.
EndpointId	string	El ID del endpoint.	ep-bp14sz7ftcwwjgrdm****
EndpointType	string	El tipo de endpoint. Valores válidos: ENI: ENI. SLB: instancia de CLB. ECS: instancia de ECS. NLB: instancia de NLB.	ENI
EndpointAddress	string	La dirección del endpoint.	eni-bp1a05txelswuj8g****
EndpointSubAddress	string	La dirección secundaria del endpoint. Este parámetro se devuelve si el tipo de endpoint es ECS, ENI o NLB. Si el tipo de endpoint es ECS, EndpointSubAddress devuelve la dirección IP privada principal o secundaria de la ENI principal. Si el tipo de endpoint es ENI, EndpointSubAddress devuelve la dirección IP privada principal o secundaria de la ENI secundaria. Si el tipo de endpoint es NLB, EndpointSubAddress devuelve la dirección IP privada principal del servidor backend del NLB.	172.16.XX.XX

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "EndpointGroupId": "epg-bp1dmlohjjz4kqaun****",
  "Endpoints": [
    {
      "EndpointId": "ep-bp14sz7ftcwwjgrdm****",
      "EndpointType": "ENI",
      "EndpointAddress": "eni-bp1a05txelswuj8g****",
      "EndpointSubAddress": "172.16.XX.XX"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	NotExist.Accelerator	The accelerated instance does not exist.	The GA instance does not exist.
400	NotFound.ENIInstance	The ENI instance is not found.	The ENI instance does not exist in the region where the Endpoint Group belongs.
400	Invalidate.SlbAddressType	The SLB instance must be internal-facing.	The SLB instance must be internal-facing.

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.