Todos os produtos
Search
Central de documentação

Data Transmission Service:WhiteIpList

Última atualização: Jun 27, 2026

Consulta os blocos CIDR dos servidores DTS para adição às configurações de segurança de bancos de dados autogerenciados ou de terceiros.

Se a instância de origem ou de destino for um banco de dados autogerenciado ou um banco de dados em nuvem de terceiros, chame esta operação para consultar os blocos CIDR dos servidores DTS e adicione-os às configurações de segurança (por exemplo, o firewall) do banco de dados. Adicionar os blocos CIDR dos servidores DTS às configurações de segurança de bancos de dados locais.

Nota

Se o

banco de dados de origem ou de destino

for uma

instância ApsaraDB

(como RDS ou ApsaraDB for MongoDB) ou um

banco de dados autogerenciado hospedado no ECS

, não é necessário adicionar blocos CIDR manualmente. Ao clicar em

Set Whitelist and Next

no console DTS, o sistema adiciona automaticamente os blocos CIDR do servidor às configurações de segurança da instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura e gera códigos de exemplo do SDK. Recomendamos chamar esta operação no OpenAPI Explorer.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim WhiteIpList

Operação a ser executada. Defina como WhiteIpList.

Region String Sim cn-hangzhou

ID da região da instância de origem. Lista de regiões suportadas.

Nota Se a instância de origem for um banco de dados autogerenciado com endereço IP público ou um banco de dados em nuvem de terceiros, defina o parâmetro como cn-hangzhou ou o ID da região mais próxima.
Type String Sim vpc

Tipo de rede usado para conectar o banco de dados ao DTS. Valores válidos:

  • internet: Conexão pela Internet.
  • vpc: Conexão via Express Connect, VPN Gateway ou Smart Access Gateway.
DestinationRegion String Não cn-hangzhou

ID da região da instância de destino. Lista de regiões suportadas.

Nota
  • Se a instância de destino for um banco de dados autogerenciado com endereço IP público ou um banco de dados em nuvem de terceiros, defina o parâmetro como cn-hangzhou ou o ID da região mais próxima.
  • Parâmetro obrigatório para tarefas de migração ou sincronização de dados do DTS.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
DynamicCode String 403

Código de erro dinâmico. Este parâmetro será removido futuramente.

DynamicMessage String Type

Parte dinâmica da mensagem de erro usada para substituir %s em ErrMessage.

ErrCode String InternalError

Código de erro retornado se a solicitação falhar.

ErrMessage String The Value of Input Parameter %s is not valid.

Mensagem de erro retornada se a solicitação falhar.

HttpStatusCode Integer 200

Código de status HTTP.

IpList String 10.151.12.0/24,47.102.181.0/24,47.101.109.0/24,120.55.129.0/24,11.115.103.0/24,47.102.234.0/24

Blocos CIDR dos servidores DTS, separados por vírgulas (,).

RequestId String AD823BD3-1BA6-4117-A536-165CB280****

ID da solicitação.

Success Boolean true

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: A solicitação foi bem-sucedida.
  • false: A solicitação falhou.

Exemplos

Solicitações de exemplo

http(s)://dts.aliyuncs.com/?Action=WhiteIpList
&Region=cn-hangzhou
&Type=vpc
&DestinationRegion=cn-hangzhou
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

<WhiteIpListResponse>
      <RequestId>AD823BD3-1BA6-4117-A536-165CB280****</RequestId>
      <HttpStatusCode>200</HttpStatusCode>
      <Success>true</Success>
      <IpList>10.151.12.0/24,47.102.181.0/24,47.101.109.0/24,120.55.129.0/24,11.115.103.0/24,47.102.234.0/24</IpList>
</WhiteIpListResponse>

Formato JSON

{
    "RequestId":"AD823BD3-1BA6-4117-A536-165CB280****",
    "HttpStatusCode":200,
    "Success":true,
    "IpList": "10.151.12.0/24,47.102.181.0/24,47.101.109.0/24,120.55.129.0/24,11.115.103.0/24,47.102.234.0/24"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.