CreateCenRouteMap - : Central de Documentação do Alibaba Cloud

Notas de uso

As políticas de roteamento são classificadas por prioridade. Um valor menor indica uma prioridade mais alta. Cada política de roteamento é um conjunto de instruções condicionais e instruções de execução. A partir da política de roteamento com a prioridade mais alta, o sistema compara as rotas com as condições de correspondência especificadas pelas políticas de roteamento. Se uma rota atender a todas as condições de correspondência de uma política de roteamento, o sistema permitirá ou negará a rota com base na ação especificada na política de roteamento. Você também pode modificar os atributos das rotas permitidas. Por padrão, o sistema permite as rotas que não atendem a nenhuma das condições de correspondência. Para obter mais informações, consulte Visão geral das políticas de roteamento.

CreateCenRouteMap é uma operação assíncrona. Após o envio de uma solicitação, o ID da política de roteamento é retornado, mas a operação ainda está sendo executada em segundo plano no sistema. Você pode chamar DescribeCenRouteMaps para consultar o status de uma política de roteamento.

Se uma política de roteamento estiver no estado Creating, a política de roteamento está sendo criada. Nesse caso, você pode consultar a política de roteamento, mas não pode executar outras operações.
Se uma política de roteamento estiver no estado Active, a política de roteamento foi criada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateCenRouteMap	A operação que você deseja executar. Defina o valor como CreateCenRouteMap.
CenId	String	Sim	cen-7qthudw0ll6jmc****	O ID da instância do CEN.
CenRegionId	String	Sim	cn-hangzhou	O ID da região onde a política de roteamento é aplicada. Você pode chamar a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.
TransmitDirection	String	Sim	RegionIn	A direção na qual a política de roteamento é aplicada. Valores válidos: RegionIn: as rotas são anunciadas para os gateways nas regiões conectadas pela instância do CEN. Por exemplo, as rotas são anunciadas de instâncias de rede implantadas na região atual ou em outras regiões para o gateway implantado na região atual. RegionOut: as rotas são anunciadas a partir dos gateways nas regiões conectadas pela instância do CEN. Por exemplo, as rotas são anunciadas do gateway implantado na região atual para instâncias de rede implantadas na mesma região ou para gateways implantados em outras regiões.
Description	String	Não	desctest	A descrição da política de roteamento. A descrição deve ter de 2 a 256 caracteres e pode conter letras, dígitos, hifens (-), pontos (.) e sublinhados (_). Deve começar com uma letra e não pode começar com `http://` ou `https://`.
Priority	Integer	Sim	3	A prioridade da política de roteamento. Valores válidos: 1 a 100. Um valor menor indica uma prioridade mais alta. null Não é possível especificar a mesma prioridade para políticas de roteamento que se aplicam à mesma região e direção. O sistema compara as rotas com as condições de correspondência das políticas de roteamento em ordem decrescente de prioridade. Um valor menor indica uma prioridade mais alta. Você deve definir as prioridades com valores adequados.
MapResult	String	Sim	Permit	A ação a ser executada em uma rota que atende a todas as condições de correspondência. Valores válidos: Permit: a rota é permitida. Deny: a rota é negada.
NextPriority	Integer	Não	20	A prioridade da política de roteamento que você deseja associar à política atual. Este parâmetro entra em vigor somente quando o parâmetro MapResult está definido como Permit. Dessa forma, a rota permitida é comparada com a próxima política de roteamento. A região e a direção da política de roteamento a ser associada devem ser as mesmas da política de roteamento atual. A prioridade da próxima política de roteamento deve ser menor que a prioridade da política de roteamento atual.
CidrMatchMode	String	Não	Include	O método de correspondência usado para comparar rotas com a lista de prefixos. Valores válidos: Include: correspondência parcial. Uma rota é considerada correspondente se o prefixo da rota estiver incluído nas condições de correspondência. Por exemplo, se você definir a condição de correspondência como 10.10.0.0/16 e a correspondência parcial estiver ativada, a rota cujo prefixo é 10.10.1.0/24 será considerada correspondente. Complete: correspondência exata. Uma rota é considerada correspondente somente se o prefixo da rota for igual ao prefixo especificado na condição de correspondência. Por exemplo, se você definir a condição de correspondência como 10.10.0.0/16 e a correspondência exata estiver ativada, uma rota será considerada correspondente somente se o prefixo for 10.10.0.0/16.
AsPathMatchMode	String	Não	Include	O método de correspondência usado para comparar rotas com os AS paths. Valores válidos: Include: correspondência parcial. Uma rota atende à condição de correspondência se o AS path da rota se sobrepuser aos AS paths especificados na condição de correspondência. Complete: correspondência exata. Uma rota é considerada correspondente somente se o AS path da rota for igual a um AS path especificado na condição de correspondência.
CommunityMatchMode	String	Não	Include	O método de correspondência usado para comparar rotas com a community. Valores válidos: Include: correspondência parcial. Uma rota atende à condição de correspondência se a community da rota se sobrepuser à community especificada na condição de correspondência. Complete: correspondência exata. Uma rota atende à condição de correspondência somente se a community da rota for igual à community especificada na condição de correspondência.
CommunityOperateMode	String	Não	Additive	A ação executada na community. Valores válidos: Additive: adiciona a community à rota. Replace: substitui a community original da rota. Este parâmetro especifica a ação a ser executada quando uma rota atende à condição de correspondência.
Preference	Integer	Não	50	A nova prioridade da rota. Valores válidos: 1 a 100. A prioridade padrão é 50. Um valor menor indica uma prioridade mais alta. Este parâmetro especifica a ação a ser executada quando uma rota atende à condição de correspondência.
SourceInstanceIdsReverseMatch	Boolean	Não	false	Especifica se os IDs das instâncias de rede de origem devem ser excluídos. Valores válidos: false (valor padrão): uma rota é considerada correspondente se o ID da instância de rede de origem estiver na lista especificada por SourceInstanceIds.N. true: uma rota é considerada correspondente se o ID da instância de rede de origem não estiver na lista especificada por SourceInstanceIds.N.
DestinationInstanceIdsReverseMatch	Boolean	Não	false	Especifica se os IDs das instâncias de rede de destino devem ser excluídos. Valores válidos: false (valor padrão): uma rota é considerada correspondente se o ID da instância de rede de destino estiver na lista especificada por DestinationInstanceIds.N. true: uma rota atende à condição de correspondência se o ID da instância de rede de destino não estiver na lista especificada por DestinationInstanceIds.N.
MatchAddressType	String	Não	IPv4	O tipo de endereço IP na condição de correspondência. Valores válidos: IPv4: endereço IPv4 IPv6: endereço IPv6 Este parâmetro pode ficar vazio. Se nenhum valor for especificado, todos os tipos de endereço IP serão considerados correspondentes.
TransitRouterRouteTableId	String	Não	vtb-gw8nx3515m1mbd1z1****	O ID da tabela de rotas do transit router. Se você não especificar um ID de tabela de rotas, a política de roteamento será automaticamente associada à tabela de rotas padrão do transit router.
SourceInstanceIds.N	String	Não	vpc-adeg3544fdf34vf****	Os IDs das instâncias de rede de origem às quais as rotas pertencem. Os seguintes tipos de instância de rede são compatíveis: VPC VBR Instância do CCN Instância do SAG O ID da conexão IPsec. Você pode inserir no máximo 32 IDs.
DestinationInstanceIds.N	String	Não	vpc-afrfs434465fdf****	Os IDs das instâncias de rede de destino às quais as rotas pertencem. Os seguintes tipos de instância de rede são compatíveis: VPC VBR Instância do CCN Instância do SAG O ID da conexão IPsec. Você pode inserir no máximo 32 IDs. null Os IDs das instâncias de rede de destino são válidos somente se a política de roteamento for aplicada a cenários em que as rotas são anunciadas do gateway na região atual para instâncias de rede na região atual.
SourceRouteTableIds.N	String	Não	vtb-adfr233vf34rvd4****	Os IDs das tabelas de rotas de origem a partir das quais as rotas são avaliadas. Você pode inserir no máximo 32 IDs de tabela de rotas.
DestinationRouteTableIds.N	String	Não	vtb-adefrgtr144vf****	Os IDs das tabelas de rotas de destino para as quais as rotas são avaliadas. Você pode inserir no máximo 32 IDs de tabela de rotas. null Os IDs das tabelas de rotas de destino são válidos somente quando a política de roteamento é aplicada a cenários em que as rotas são anunciadas do gateway na região atual para tabelas de rotas na região atual.
SourceRegionIds.N	String	Não	cn-beijing	Os IDs das regiões de origem a partir das quais as rotas são avaliadas. Você pode inserir no máximo 32 IDs de região. Você pode chamar a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.
SourceChildInstanceTypes.N	String	Não	VPC	Os tipos de instância de rede de origem aos quais as rotas pertencem. Os seguintes tipos de instância de rede são compatíveis: VPC: VPC VBR: VBR CCN: instância do CCN VPN: VPN gateway ou conexão IPsec Se a conexão IPsec-VPN ou o cliente SSL estiver associado a um VPN gateway, o VPC associado ao VPN gateway deve estar conectado a um transit router, e o VPN gateway deve usar o roteamento dinâmico BGP. Caso contrário, este parâmetro não entrará em vigor. Este parâmetro entra em vigor se a conexão IPsec estiver conectada diretamente a um transit router. Você pode especificar um ou mais tipos de instância de rede.
DestinationChildInstanceTypes.N	String	Não	VPC	Os tipos de instância de rede de destino aos quais as rotas pertencem. Os seguintes tipos de instância de rede são compatíveis: VPC: VPC VBR: VBR CCN: instância do CCN VPN: conexão IPsec null Este parâmetro não entra em vigor se a conexão IPsec-VPN ou o cliente SSL estiver associado a um transit router por meio de um VPN gateway e um VPC. Este parâmetro entra em vigor somente se a conexão IPsec estiver conectada diretamente ao transit router. Você pode especificar um ou mais tipos de instância de rede. null Os tipos de instância de rede de destino são válidos somente se a política de roteamento for aplicada a cenários em que as rotas são anunciadas do gateway na região atual para instâncias de rede na região atual.
DestinationCidrBlocks.N	String	Não	10.10.10.0/24	A lista de prefixos usada para comparar rotas. Você deve especificar os endereços IP na notação CIDR. Você pode inserir no máximo 32 blocos CIDR.
RouteTypes.N	String	Não	System	O tipo de rota a ser comparado com a condição de correspondência. Os seguintes tipos de rota são compatíveis: System: rotas do sistema geradas automaticamente pelo sistema. Custom: rotas personalizadas adicionadas manualmente. BGP: rotas anunciadas por BGP. Você pode especificar vários tipos de rota.
MatchAsns.N	Long	Não	65501	Os AS paths usados para comparar rotas. Você pode especificar no máximo 32 números AS. null Somente o parâmetro AS-SEQUENCE é compatível. Os parâmetros AS-SET, AS-CONFED-SEQUENCE e AS-CONFED-SET não são compatíveis. Em outras palavras, somente a lista de números AS é compatível. Conjuntos e sublistas não são compatíveis.
MatchCommunitySet.N	String	Não	65501:1	A community usada para comparar rotas. Especifique a community no formato n:m. Valores válidos de n e m: 1 a 65535. Cada community deve estar em conformidade com o padrão RFC 1997. O padrão RFC 8092, que define as grandes communities do Border Gateway Protocol (BGP), não é compatível. Você pode especificar no máximo 32 communities. null Se as configurações das communities estiverem incorretas, as rotas poderão não ser anunciadas para o seu data center.
OperateCommunitySet.N	String	Não	65501:1	O conjunto de communities no qual as ações são executadas. Especifique a community no formato n:m. Valores válidos de n e m: 1 a 65535. Cada community deve estar em conformidade com o RFC 1997. O padrão RFC 8092, que define as grandes communities do BGP, não é compatível. Você pode especificar no máximo 32 communities. null Se as configurações das communities estiverem incorretas, as rotas poderão não ser anunciadas para o seu data center.
PrependAsPath.N	Long	Não	65501	Os AS paths que são prefixados usando uma instrução de ação quando os gateways regionais recebem ou anunciam rotas. Os AS paths variam de acordo com a direção na qual a política de roteamento é aplicada: Se os AS paths forem prefixados a uma política de roteamento aplicada na direção de entrada, você deve especificar os IDs das instâncias de rede de origem e a região de origem na condição de correspondência. Além disso, a região de origem deve ser a mesma região onde a política de roteamento é aplicada. Se os AS paths forem prefixados a uma política de roteamento aplicada na direção de saída, você deve especificar os IDs das instâncias de rede de destino na condição de correspondência. Este parâmetro especifica a ação a ser executada quando uma rota atende à condição de correspondência. Você pode especificar no máximo 32 números AS.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RouteMapId	String	cenrmap-w4yf7toozfol3q****	O ID da política de roteamento.
RequestId	String	62172DD5-6BAC-45DF-8D44-56SDF467BAC	O ID da solicitação.

Exemplos

Exemplos de solicitação

http(s)://[Endpoint]/?Action=CreateCenRouteMap
&CenId=cen-7qthudw0ll6jmc****
&CenRegionId=cn-hangzhou
&Priority=3
&TransmitDirection=RegionIn
&MapResult=Permit
&<Common request parameters>

Exemplo de resposta bem-sucedida

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCenRouteMapResponse>
    <RouteMapId>cenrmap-w4yf7toozfol3q****</RouteMapId>
    <RequestId>62172DD5-6BAC-45DF-8D44-56SDF467BAC</RequestId>
</CreateCenRouteMapResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RouteMapId" : "cenrmap-w4yf7toozfol3q****",
  "RequestId" : "62172DD5-6BAC-45DF-8D44-56SDF467BAC"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	Forbidden.CenRouteMapExist	The specified CEN route map ID already exists.	A mensagem de erro retornada porque a política de roteamento já existe.
400	InvalidOperation.NoEffictiveAction	No effective action be configured.	A mensagem de erro retornada porque a ação especificada é inválida.

Para obter uma lista de códigos de erro, acesse o Centro de erros da API.