Todos os produtos
Search
Central de documentação

Virtual Private Cloud:Prefix lists

Última atualização: Sep 22, 2026

As listas de prefixos permitem gerenciar de forma centralizada blocos CIDR usados com frequência, referenciando-os em regras de grupos de segurança e entradas de rota entre diferentes contas. Alterações em uma lista de prefixos são propagadas automaticamente para todos os recursos que a referenciam.

Casos de uso comuns para listas de prefixos incluem:

  • Gerenciamento centralizado de IPs de saída da empresa: uma empresa acessa diversas instâncias ECS pela internet. Sem uma lista de prefixos, cada regra de grupo de segurança precisa ser atualizada individualmente quando o IP de saída muda. Com uma lista de prefixos, basta atualizar o IP uma única vez e todas as regras de grupo de segurança que a referenciam são sincronizadas automaticamente.

  • Manutenção centralizada de faixas de IP de parceiros: quando a comunicação com parceiros envolve faixas de IP específicas, é comum adicionar as mesmas rotas a várias tabelas de rotas. A lista de prefixos elimina essa repetição — edite a lista uma vez e todas as tabelas de rotas referenciadas são atualizadas automaticamente.

image

Limites

  • Tabelas de rotas de gateway e Transit Routers da Basic Edition não podem referenciar listas de prefixos.

  • As listas de prefixos são recursos regionais. Você só pode usar, referenciar ou compartilhar uma lista de prefixos dentro da região em que ela foi criada.

  • Uma lista de prefixos não pode conter blocos CIDR IPv4 e IPv6 simultaneamente.

  • É obrigatório especificar o número máximo de entradas ao criar uma lista de prefixos.

  • Uma lista de prefixos referenciada consome a cota do recurso que a referencia. Tabelas de rotas de VPC e grupos de segurança ECS consomem cota com base no número máximo de entradas. Tabelas de rotas de TR consomem cota com base no número real de entradas. Por exemplo, uma lista de prefixos com máximo de 50 entradas, mas apenas 20 entradas reais, consome 50 unidades de cota em uma tabela de rotas de VPC ou grupo de segurança, mas apenas 20 em uma tabela de rotas de TR.

  • Ao criar um Gateway Endpoint para um cloud service em uma região pela primeira vez, o sistema cria automaticamente uma lista de prefixos contendo as faixas de IP do service e a referencia na tabela de rotas da VPC, com o próximo salto apontando para o Gateway Endpoint. Não é possível referenciar, modificar, excluir ou compartilhar essa lista de prefixos do sistema. No console, o campo Owner é exibido como System Account.

Gerenciar listas de prefixos

Console

Criar uma lista de prefixos

  1. Acesse a página VPC Prefix List no console da VPC. Selecione uma região na barra de navegação superior e clique em Create Prefix List.

  2. No painel Create Prefix List, configure os seguintes parâmetros:

    1. Selecione uma IP Version (IPv4/IPv6).

    2. Defina o Maximum Entries. Esse valor determina o consumo de cota em tabelas de rotas de VPC e grupos de segurança. É possível modificá-lo após a criação.

      Por exemplo, uma lista de prefixos com máximo de 50 entradas consome 50 entradas de rota ou 50 regras de grupo de segurança na cota, mesmo que existam apenas 20 entradas.

      Referência de cota: por padrão, uma tabela de rotas de VPC suporta até 200 entradas de rota personalizadas, e um grupo de segurança suporta até 200 regras.
    3. Configure as Prefix List Entries. Você pode usar um dos seguintes métodos: Manual Input, Batch Import ou Clone from Another List. É possível clonar entradas de uma lista de prefixos em outra região, mas não de uma lista compartilhada ou de sistema.

Adicionar ou excluir entradas

Na página de detalhes da lista de prefixos, acesse a aba Entry:

  • Para adicionar entradas, clique em Create Prefix List.

  • Para excluir entradas, clique em Delete na coluna Actions da entrada desejada, ou selecione várias entradas e clique em Delete in Batches.

Visualizar recursos referenciados

Na página de detalhes da lista de prefixos, clique na aba Association para visualizar todos os recursos que a referenciam.

Excluir uma lista de prefixos

Para excluir uma lista de prefixos, localize-a na lista e clique em Delete na coluna Actions. Também é possível clicar em Delete na página de detalhes.

Antes de excluir uma lista de prefixos, verifique se ela não está referenciada por nenhum recurso nem compartilhada com outras contas.

API

Terraform

Recurso: alicloud_vpc_prefix_list
# Specify the region.
provider "alicloud" {
  region = "cn-hangzhou"
}

# Create a prefix list.
resource "alicloud_vpc_prefix_list" "example_pl" {
  prefix_list_name = "example_pl_name"
  ip_version       = "IPV4" # IP version
  max_entries      = 50     # Maximum number of entries
  entrys {
    cidr = "10.0.1.0/24" # Entry 1
  }
  entrys {
    cidr = "10.0.2.0/24" # Entry 2
  }
}

Referenciar uma lista de prefixos

Você pode referenciar uma lista de prefixos em uma tabela de rotas de VPC, uma tabela de rotas de Transit Router (TR) ou um grupo de segurança ECS. Alterações na lista de prefixos são aplicadas automaticamente a todos os recursos que a referenciam.

Em uma tabela de rotas de VPC

É possível referenciar uma lista de prefixos ao adicionar uma entrada de rota personalizada a uma tabela de rotas de VPC. Observe o seguinte:

  • Evite conflitos de rota com entradas existentes. Se houver conflito, não será possível referenciar a lista de prefixos. Caso um conflito ocorra após o referenciamento, consulte Resolver conflitos de entradas após referenciar uma lista de prefixos.

  • O número máximo de entradas, e não a quantidade real, consome a cota de entradas de rota personalizadas da tabela de rotas de VPC. Para reduzir o risco de estouro de cota, diminua o máximo, mescle faixas de IP adjacentes ou remova entradas não utilizadas.

Console

Acesse a página de detalhes da tabela de rotas. Na aba Route Entry List > Custom Route, clique em Add Route Entry e configure os seguintes parâmetros:

  • Destination CIDR Block: selecione VPC Prefix List na lista suspensa e depois selecione a lista de prefixos que deseja referenciar.

  • Next Hop Type: selecione um tipo de próximo salto e uma instância.

API

Chame CreateRouteEntry e defina o parâmetro DestinationCidrBlock como o ID da lista de prefixos.

Terraform

Recurso: alicloud_route_entry
# Specify the region.
provider "alicloud" {
  region = "cn-hangzhou"
}

# Add a route entry to a VPC route table. The destination of the route entry is a prefix list.
resource "alicloud_route_entry" "example" {
  route_table_id        = "vtb-bp1pa1mwgfd6rqxfxxxxx"    # The ID of the VPC route table.
  destination_cidrblock = "pl-bp1fnjzxkk2m6qrwxxxxx"     # The destination CIDR block. Set this parameter to the ID of the prefix list.
  nexthop_type          = "Ecr"                          # The next hop type.
  nexthop_id            = "ecr-assoc-stwhaft9a371nxxxxx" # The ID of the next hop instance. 
}

Em uma tabela de rotas de TR

Você pode referenciar uma lista de prefixos em uma tabela de rotas de TR Enterprise Edition. O sistema adiciona automaticamente entradas de rota para todos os blocos CIDR da lista de prefixos. Observe o seguinte:

  • Se a propagação de rotas estiver ativada no TR, o sistema propaga automaticamente as entradas de rota correspondentes à lista de prefixos para outras instâncias de rede.

  • As entradas de rota da lista de prefixos não podem conflitar com entradas já existentes na tabela de rotas do TR. Consulte Compatibilidade de rotas para conhecer as regras de conflito. Se um conflito impedir o referenciamento ou ocorrer após o referenciamento, consulte Resolver conflitos de entradas após referenciar uma lista de prefixos.

  • O número real de entradas na lista de prefixos é contabilizado na cota da tabela de rotas do TR. Para evitar o estouro da cota, mescle faixas de IP adjacentes ou remova entradas não utilizadas.

Console

Associar uma lista de prefixos

Acesse a página de detalhes da tabela de rotas do TR, clique na aba CIDR Block e depois clique em Associate With Route Prefix.

  • Route Prefix ID: selecione a lista de prefixos que deseja referenciar.

  • Blackhole Route:

    • Yes: o tráfego correspondente à lista de prefixos é descartado.

    • No: o tráfego correspondente à lista de prefixos é encaminhado para o Next Hop especificado.

Filtrar entradas de rota

Acesse a página de detalhes da tabela de rotas do TR, clique na aba Route Entry e filtre por Route Prefix ID para visualizar as rotas adicionadas a partir de uma lista de prefixos.

Desassociar uma lista de prefixos
Aviso

Ao desassociar uma lista de prefixos, o sistema remove automaticamente todas as entradas de rota relacionadas da tabela de rotas do TR Enterprise Edition. Antes de desassociar uma lista de prefixos, migre o tráfego de seus serviços para evitar interrupções de rede.

Acesse a página Basic Settings da tabela de rotas do TR e clique na aba CIDR Block. Localize a lista de prefixos e clique em Delete na coluna Actions.

API

Terraform

Recurso: alicloud_cen_transit_router_prefix_list_association
# Specify the region.
provider "alicloud" {
  region = "cn-hangzhou"
}

# Reference a prefix list in a Transit Router.
resource "alicloud_cen_transit_router_prefix_list_association" "example" {
  prefix_list_id          = "pl-bp1fnjzxkk2m6qrwxxxxx"  # The ID of the prefix list.
  transit_router_id       = "tr-bp1czv20pflygguoxxxxx"  # The ID of the Transit Router.
  transit_router_table_id = "vtb-bp1v7079o4dwrkgpxxxxx" # The ID of the route table of the Transit Router.
  next_hop_type           = "BlackHole"                 # The next hop type.
  next_hop                = "BlackHole"                 # The ID of the next hop instance.
}

Em um grupo de segurança ECS

Você pode referenciar uma lista de prefixos ao configurar regras de entrada ou saída de um grupo de segurança.

Console

O exemplo a seguir adiciona uma regra de entrada ao grupo de segurança. Acesse a página de detalhes do grupo de segurança no console do ECS. Na aba Rules > Inbound, clique em Add Rule e configure os seguintes parâmetros:

  • Source: selecione Prefix List na lista suspensa e depois selecione a lista de prefixos que deseja referenciar.

  • Demais parâmetros: configure os outros parâmetros conforme necessário.

API

  • Para adicionar uma regra de entrada ao grupo de segurança, chame AuthorizeSecurityGroup e defina o parâmetro SourcePrefixListId como o ID da lista de prefixos.

  • Para adicionar uma regra de saída ao grupo de segurança, chame AuthorizeSecurityGroupEgress e defina o parâmetro DestPrefixListId como o ID da lista de prefixos.

Terraform

Recursos: alicloud_security_group , alicloud_security_group_rule
# Specify the region.
provider "alicloud" {
  region = "cn-hangzhou"
}

# Specify a security group.
resource "alicloud_security_group" "sg_example" {
  security_group_name = "sg_example_name"
  vpc_id              = "vpc-bp1d00iurwfx3pcxxxxx" # The ID of the VPC. 
}

# Reference a prefix list when you create a security group rule. 
resource "alicloud_security_group_rule" "sg_rule_pl_example" {
  security_group_id = alicloud_security_group.sg_example.id
  type              = "ingress"
  ip_protocol       = "tcp"
  policy            = "accept"
  port_range        = "8080/8080"
  prefix_list_id    = "pl-bp1fnjzxkk2m6qrxxxxxx" # The ID of the VPC prefix list.
}

Resolver conflitos de entradas

Após referenciar uma lista de prefixos em uma tabela de rotas de VPC ou de TR, se você modificar a lista de prefixos e a alteração conflitar com uma entrada de rota existente, a alteração não entrará em vigor.

Na aba Association da página de detalhes da lista de prefixos, você pode visualizar os detalhes do conflito. O campo Status do recurso com conflito apresenta o valor Modification failed. Passe o mouse sobre o campo Status para visualizar as entradas conflitantes na mensagem ErrorMessage.

Você pode resolver o conflito de duas maneiras:

Aviso

Antes de modificar uma entrada de rota, certifique-se de que seus serviços não serão afetados.

  • Opção 1: modifique a lista de prefixos. Exclua a entrada conflitante da lista de prefixos. Após a exclusão, o sistema reaplicará automaticamente a lista de prefixos a todos os recursos que a referenciam.

  • Opção 2: modifique a tabela de rotas. Exclua a entrada de rota conflitante da tabela de rotas. Em seguida, reaplique manualmente a lista de prefixos até que o status mude de Modification failed para Delivered.

Para reaplicar manualmente uma lista de prefixos:

Console

  1. Acesse a página VPC Prefix List no console da VPC. Selecione uma região na barra de navegação superior e clique no ID da lista de prefixos.

  2. Clique na aba Association, localize o recurso associado e clique em Retry na coluna Actions.

API

Chame RetryVpcPrefixListAssociation para reaplicar a lista de prefixos.

Terraform

O Terraform não oferece suporte à reaplicação de uma lista de prefixos sem modificar suas entradas.

Compartilhar uma lista de prefixos

Compartilhar uma lista de prefixos permite que múltiplas contas referenciem os mesmos blocos CIDR em grupos de segurança ou rotas, o que reduz a sobrecarga de manutenção e erros de configuração.

No exemplo a seguir, a Conta A (o proprietário) compartilha uma lista de prefixos com a Conta B (o principal).

O proprietário pode compartilhar listas de prefixos com qualquer conta Alibaba Cloud ou restringir o compartilhamento apenas às contas dentro do seu diretório de recursos.

Permissões para compartilhamento de uma lista de prefixos

  • Permissões do principal:

    • O principal pode visualizar a lista de prefixos compartilhada e suas entradas. No console, a coluna Owner de uma lista de prefixos compartilhada indica que ela é compartilhada.

    • O principal não pode modificar a lista de prefixos (como adicionar ou excluir entradas) nem excluí-la.

    • O principal pode referenciar a lista de prefixos compartilhada em seus próprios recursos.

    Permissões do proprietário:

    • O proprietário pode visualizar as contas com as quais a lista de prefixos foi compartilhada.

    • O proprietário pode visualizar os IDs dos recursos do principal que referenciam a lista de prefixos, mas não pode gerenciar esses recursos.

    • O proprietário não pode excluir uma lista de prefixos referenciada por um recurso do principal.

    • Quando o proprietário atualiza uma lista de prefixos, as alterações são propagadas automaticamente para todos os recursos que a referenciam, incluindo os recursos dos principals.

  • Se o proprietário interromper o compartilhamento de uma lista de prefixos:

    • Se a lista de prefixos estiver referenciada por recursos do principal, essas referências permanecem ativas. O proprietário ainda pode visualizá-las.

    • Se a lista de prefixos não estiver referenciada, o principal não poderá mais visualizar a lista de prefixos nem suas entradas, e tampouco poderá referenciá-la em seus recursos.

Console

Ativar compartilhamento

Esta seção descreve como compartilhar uma lista de prefixos com qualquer conta. Para compartilhar recursos apenas dentro de um diretório de recursos, consulte Compartilhar recursos apenas dentro de um diretório de recursos .
  1. Faça login no console do Resource Management com a conta do proprietário e acesse a página Resource Sharing > Shared by Me. Selecione a região do recurso que deseja compartilhar na barra de navegação superior e clique em Create Resource Share. Execute as etapas a seguir:

    1. Step 1: Insira um Resource Share Name. Na seção Resources, selecione VPC Prefix List na lista suspensa e selecione as listas de prefixos que deseja compartilhar.

    2. Step 2: O sistema seleciona a permissão AliyunRSDefaultPermissionPrefixList por padrão.

    3. Step 3: Defina Principal Scope como All Accounts e Method como Add Manually. Insira o ID da conta Alibaba Cloud do principal e clique em Add.

    4. Step 4: Revise as configurações e clique em Confirm.

  2. Faça login no console da Alibaba Cloud como o principal e aceite o convite de compartilhamento:

    1. Acesse a página Resource Sharing > Shared with Me no console do Resource Management.

    2. Na barra de navegação superior, selecione a região do recurso compartilhado, localize o compartilhamento de recursos desejado e clique em Accept na coluna Status.

    3. Após aceitar o convite, você terá acesso à lista de prefixos compartilhada. Convites para novos recursos adicionados a esse compartilhamento são aceitos automaticamente por padrão.

    4. Acesse a página VPC Prefix List no console do VPC. Selecione a região da lista de prefixos compartilhada na barra de navegação superior. Você poderá visualizar as listas de prefixos recebidas. A coluna Owner será exibida como Shared.

    5. Agora você pode referenciar a lista de prefixos compartilhada nas suas tabelas de rotas de VPC, tabelas de rotas de TR e grupos de segurança do ECS. Referenciar uma lista de prefixos.

Gerenciar listas de prefixos compartilhadas e principals

O proprietário da lista de prefixos pode visualizar, adicionar ou remover listas de prefixos compartilhadas e principals:

  1. Faça login no console do Resource Management com a conta do proprietário e acesse a página Resource Sharing > Shared by Me. Na barra de navegação superior, selecione a região onde a lista de prefixos compartilhada está localizada.

  2. Na página Resources I Share, você pode executar as seguintes ações:

    • Visualizar listas de prefixos compartilhadas: Clique na aba Shared Resources.

    • Visualizar principals de uma lista de prefixos compartilhada: Clique na aba Principals.

  3. Clique na aba Resource Shares, localize o compartilhamento de recursos desejado e clique em seu ID.

  4. Clique na aba Resources ou Principals para visualizar as listas de prefixos compartilhadas e os principals dentro desse compartilhamento de recursos.

    Se o Status nas abas Resources e Principals estiver como Associated, o recurso e o principal foram associados com sucesso.

    Motivos comuns para falha na associação

    Se o Status na seção Resources ou Principals estiver como Association Failed, o compartilhamento falhou. Investigue o problema e tente novamente.

    • A conta do principal é a mesma do proprietário. Não é possível compartilhar uma lista de prefixos consigo mesmo.

    • O número de principals com os quais uma lista de prefixos pode ser compartilhada atingiu a cota. A cota padrão é 10.

    • O número de listas de prefixos compartilhadas que um principal pode aceitar atingiu a cota. A cota padrão é 100.

  5. Na página de detalhes do compartilhamento de recursos, clique em Edit Resource Share no canto superior direito. Você pode executar as seguintes ações dentro desse compartilhamento de recursos:

    • Adicionar ou remover listas de prefixos compartilhadas: Em Step 1, marque ou desmarque as caixas de seleção das listas de prefixos.

    • Adicionar ou remover principals: Em Step 3, adicione ou remova IDs de contas.

  6. Após revisar as configurações, em Step 4 da página Edit Resource Share, clique em Confirm.

API

Ativar compartilhamento

  • Método 1: Compartilhar com qualquer conta

    1. Utilize as credenciais do proprietário da lista de prefixos para chamar CreateResourceShare e criar um compartilhamento de recursos. Certifique-se de que o parâmetro AllowExternalTargets esteja definido como True.

    2. Utilize as credenciais do principal da lista de prefixos para chamar ListResourceShareInvitations e consultar os convites de recursos recebidos. Em seguida, chame AcceptResourceShareInvitation para aceitar o convite de compartilhamento de recursos.

  • Método 2: Compartilhar apenas dentro de um diretório de recursos

    Antes de começar, certifique-se de que o proprietário da lista de prefixos e o principal sejam membros do mesmo diretório de recursos.
    1. Utilize as credenciais da conta de gerenciamento do diretório de recursos para chamar EnableSharingWithResourceDirectory e ativar o compartilhamento de recursos dentro do diretório de recursos.

    2. Utilize as credenciais do proprietário da lista de prefixos para chamar CreateResourceShare e criar um compartilhamento de recursos. Certifique-se de que o parâmetro AllowExternalTargets esteja definido como False.

Gerenciar listas de prefixos compartilhadas e principals

Como proprietário da lista de prefixos, chame as seguintes operações para visualizar listas de prefixos compartilhadas e principals:

Como proprietário da lista de prefixos, chame as seguintes operações para gerenciar listas de prefixos compartilhadas e principals dentro de um compartilhamento de recursos:

  • Chame ListResourceShareAssociations para visualizar as listas de prefixos ou principals em um compartilhamento de recursos.

  • Chame AssociateResourceShare para adicionar uma lista de prefixos compartilhada ou um principal a um compartilhamento de recursos.

  • Chame DisassociateResourceShare para remover uma lista de prefixos compartilhada ou um principal de um compartilhamento de recursos.

Terraform

O Terraform permite compartilhar listas de prefixos apenas dentro de um diretório de recursos, não com qualquer conta. Antes de começar, certifique-se de que a conta de gerenciamento do diretório de recursos tenha ativado o compartilhamento para o diretório de recursos .
Recursos: alicloud_resource_manager_resource_share , alicloud_resource_manager_shared_resource , alicloud_resource_manager_shared_target

Utilize as credenciais do proprietário da lista de prefixos para ativar o compartilhamento:

# Specify the region.
provider "alicloud" {
  region = "cn-hangzhou"
}

# Specify the name of the resource share.
resource "alicloud_resource_manager_resource_share" "example_unit" {
  resource_share_name = "example_unit_name"
}

# Specify the prefix list to be shared.
resource "alicloud_resource_manager_shared_resource" "example_vsw" {
  resource_share_id = alicloud_resource_manager_resource_share.example_unit.id
  resource_id       = "pl-bp18t4lsc3e4yd6xxxxx" # The ID of the prefix list to be shared.
  resource_type     = "PrefixList"               # The resource type is PrefixList. 
}

# Specify the principal of the shared prefix list.
resource "alicloud_resource_manager_shared_target" "example_target" {
  resource_share_id = alicloud_resource_manager_resource_share.example_unit.id
  target_id         = "101xxxxxxxxxxxxxxx" # The UID of the prefix list principal.
}

Mais informações

Faturamento

O recurso de lista de prefixos é gratuito.

Regiões compatíveis

Área

Regiões

Ásia-Pacífico - China

China (Hangzhou), China (Shanghai), China (Nanjing - Local Region, Closing Down), China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Ulanqab), China (Shenzhen), China (Heyuan), China (Guangzhou), China (Chengdu), China (Zhongwei), China (Hong Kong), China (Wuhan - Local Region) e China (Fuzhou - Local Region, Closing Down)

Ásia-Pacífico - Outros

Japan (Tokyo), South Korea (Seoul), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Philippines (Manila), Thailand (Bangkok) e Malaysia (Johor)

Europa e Américas

Germany (Frankfurt), UK (London), France (Paris), US (Silicon Valley), US (Virginia), Mexico e Brazil (São Paulo)

Oriente Médio

UAE (Dubai) e SAU (Riyadh - Partner Region)

Cotas

Nome da cota

Descrição

Limite padrão

Ajustável

vpc_quota_prefixlist_num

Número máximo de listas de prefixos que podem ser criadas com uma conta Alibaba Cloud.

10

Sim. Para solicitar um aumento de cota, acesse a página Quota Management ou o Quota Center.

vpc_quota_prefixlist_cidr_num_per_prefixlist

Número máximo de entradas CIDR por lista de prefixos.

50

vpc_quota_prefixlist_accept_shared_prefixlist_num

Número máximo de listas de prefixos compartilhadas que um principal de recurso pode aceitar.

100

vpc_quota_prefixlist_share_user_num_per_prefixlist

Número máximo de principals de recurso com os quais você pode compartilhar uma lista de prefixos.

10

Para cotas de compartilhamento de recursos, consulte Limites de compartilhamento de recursos.