BatchSendMessageToGlobe - Short Message Service - Centro de documentación de Alibaba Cloud

Descripción de la operación

Esta operación no admite el envío de mensajes de texto a China continental.
La operación BatchSendMessageToGlobe se utiliza principalmente para enviar lotes pequeños de mensajes de texto promocionales y de notificación. Para enviar mensajes de texto en lotes grandes, utilice la función de envío rápido en la consola de Short Message Service (SMS).
Si tiene requisitos de oportunidad de entrega para los mensajes de texto, utilice la operación SendMessageToGlobe.
En una sola solicitud, puede enviar mensajes de texto hasta a 1,000 números de teléfono celular.

Límite de QPS

El límite de consultas por segundo (QPS) para un solo usuario (la misma cuenta de Alibaba Cloud) es de 1 llamada por segundo. Si se supera el límite, las llamadas a la API se restringen, lo que puede afectar a su negocio. Realice llamadas a la API con una frecuencia razonable.

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

dysms:BatchSendMessageToGlobe

create

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
To	string	Sí	El número de destinatario. El formato del número es: código de país + número de teléfono. Para obtener más información sobre los códigos de país, consulte Códigos de marcación.	[\"931520581**\",\"931530581\",\"931540581\",\"931550581**\"]
From	string	No	El ID de remitente. Se admiten los ID de remitente y solo pueden contener dígitos y letras. Un ID de remitente que contiene letras puede tener hasta 11 caracteres de longitud, y un ID de remitente que solo contiene dígitos puede tener hasta 15 caracteres de longitud.	Alicloud321
Message	string	Sí	El contenido del mensaje.	[\"message to 931520581**\",\"message to 931530581\",\"message to 931540581\",\"message to 931550581**\"]
Type	string	No	El tipo de mensaje. Valores válidos: NOTIFY: mensaje de notificación. MKT: mensaje promocional.	NOTIFY
TaskId	string	No	El ID de la tarea. El valor puede tener hasta 255 caracteres de longitud. Puede obtener el ID de la tarea del campo TaskId en el recibo del mensaje de texto.	123789****
ValidityPeriod	integer	No	El periodo de validez del mensaje de texto. Unidad: segundos.	600
ChannelId	string	No	El ID del canal de mensajes de texto.	sms-djnfjn344

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
ResponseCode	string	El código de respuesta. El valor OK indica que la solicitud se realizó correctamente. Para otros códigos de error, consulte Códigos de error.	OK
RequestId	string	El ID de la solicitud.	F655A8D5-B967-440B-8683-DAD6FF8D28D3
FailedList	string	La lista de números a los que no se pudieron enviar los mensajes de texto.	["931520581**","931530581**"]
ResponseDescription	string	La descripción del código de respuesta.	The SMS Send Request was accepted
From	string	El ID de remitente. El valor es el ID de remitente que especificó en la solicitud.	Alicloud321
MessageIdList	string	Los ID de los mensajes que se enviaron correctamente.	["123**","124**"]
SuccessCount	string	El número de mensajes de texto que se enviaron correctamente.	2

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ResponseCode": "OK",
  "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8D28D3",
  "FailedList": "[\"931520581****\",\"931530581****\"]",
  "ResponseDescription": "La solicitud de envío de SMS fue aceptada",
  "From": "Alicloud321",
  "MessageIdList": "[\"123****\",\"124****\"]",
  "SuccessCount": "2"
}

Códigos de error

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.