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

Notas de uso

ModifyCenRouteMap é uma operação assíncrona. Após enviar uma solicitação, o sistema retorna o ID da solicitação, mas a operação ainda está sendo executada em segundo plano. Chame DescribeCenRouteMaps para consultar o status de uma política de roteamento.

Modifying: indica que o sistema está modificando a política de roteamento. Você pode apenas consultar a política de roteamento, sem executar outras operações.
Active: indica que a política de roteamento foi modificada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar 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	ModifyCenRouteMap	A operação que você deseja executar. Defina o valor como ModifyCenRouteMap.
CenId	String	Sim	cen-7qthudw0ll6jmc****	O ID da instância do Cloud Enterprise Network (CEN).
CenRegionId	String	Sim	cn-hangzhou	O ID da região em que a política de roteamento se aplica. Chame a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.
RouteMapId	String	Sim	cenrmap-abcdedfghij****	O ID da política de roteamento.
Description	String	Não	desctest	A descrição da política de roteamento. A descrição não pode começar com `http://` ou `https://`. Deve começar com uma letra e pode conter letras, dígitos, hifens (-), pontos (.) e sublinhados (_).
MapResult	String	Sim	Permit	A ação executada em uma rota que atende a todas as condições de correspondência. Valores válidos: Permit: permite a rota. Deny: nega a rota.
NextPriority	Integer	Não	20	A prioridade da política de roteamento que você deseja associar à atual. Este parâmetro tem efeito apenas 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 iguais às da política de roteamento atual. A prioridade da política de roteamento a ser associada deve ser inferior à 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 aproximada. Uma rota corresponde 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 aproximada estiver ativada, a rota com o prefixo 10.10.1.0/24 será uma correspondência. Complete: correspondência exata. Uma rota corresponde 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 corresponde 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 aproximada. 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 corresponde 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 aproximada. 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	22	A nova prioridade da rota. Valores válidos: 1 a 100. A prioridade padrão é 50. Um valor menor indica uma prioridade mais alta. Especifica a ação executada quando uma rota atende à condição de correspondência.
Priority	Integer	Sim	10	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 aplicadas na mesma região e direção. O sistema compara 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. Defina as prioridades com valores adequados.
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 corresponde se o ID da instância de rede de origem estiver na lista especificada por SourceInstanceIds.N. true: uma rota corresponde 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 corresponde 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 correspondentes.
SourceInstanceIds.N	String	Não	vpc-afsfdf5435vcvc****	Os IDs das instâncias de rede de origem a partir das quais as rotas são avaliadas. Os seguintes tipos de instância de rede são compatíveis: Virtual Private Cloud (VPC) Virtual Border Router (VBR) Instância do Cloud Connect Network (CCN) Instância do Smart Access Gateway (SAG) O ID da conexão IPsec. É possível inserir no máximo 32 IDs.
DestinationInstanceIds.N	String	Não	vpc-avcdsg34ds****	Os IDs das instâncias de rede de destino para as quais as rotas apontam. 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. É possível inserir no máximo 32 IDs. null Os IDs das instâncias de rede de destino são válidos apenas quando a política de roteamento é 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-acdbvtbr342cd****	Os IDs das tabelas de rotas de origem a partir das quais as rotas são avaliadas. É possível inserir no máximo 32 IDs de tabelas de rotas.
DestinationRouteTableIds.N	String	Não	vtb-adfg53c322v****	Os IDs das tabelas de rotas de destino para as quais as rotas são avaliadas. É possível inserir no máximo 32 IDs de tabelas de rotas. null Os IDs das tabelas de rotas de destino são válidos apenas 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. É possível inserir no máximo 32 IDs de região. Chame 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 Aplicável somente quando a conexão IPsec ou o serviço SSL estiver associado a um VPN gateway, a VPC associada ao VPN gateway estiver conectada ao transit router e o VPN gateway tiver o roteamento dinâmico BGP ativado. Válido quando a conexão IPsec estiver conectada diretamente a um transit router.
DestinationChildInstanceTypes.N	String	Não	VPC	Os tipos de instância de rede de destino para os quais as rotas apontam. 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 Não se aplica quando a conexão IPsec ou o serviço SSL está associado a um VPN gateway e o VPN gateway está conectado ao transit router por meio da VPC associada ao VPN gateway. Entra em vigor somente quando a conexão IPsec está conectada diretamente ao transit router. Os tipos de instância de rede de destino são válidos apenas quando a política de roteamento é 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 correspondência de rotas. Especifique os endereços IP na notação CIDR. É possível inserir no máximo 32 blocos CIDR.
RouteTypes.N	String	Não	System	O tipo de rota a ser comparado com as condições de correspondência. Os seguintes tipos de rota são compatíveis: System: rotas do sistema geradas automaticamente. Custom: rotas personalizadas adicionadas manualmente. BGP: rotas anunciadas pelo Border Gateway Protocol (BGP).
MatchAsns.N	Integer	Não	65501	Os AS paths usados para correspondência de rotas. 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 correspondência de 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 large communities do Border Gateway Protocol (BGP), não é compatível. É possível 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 a RFC 1997. O padrão RFC 8092, que define as large communities do BGP, não é compatível. É possível 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 incluídos via prepend por meio de uma instrução de ação quando os gateways regionais recebem ou anunciam rotas. Os AS paths variam de acordo com a direção em que a política de roteamento é aplicada: Se os AS paths forem adicionados por prepend a uma política de roteamento aplicada na direção de entrada, especifique 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 da região em que a política de roteamento é aplicada. Se os AS paths forem adicionados por prepend a uma política de roteamento aplicada na direção de saída, especifique os IDs das instâncias de rede de destino na condição de correspondência. Define a ação a ser executada quando uma rota atende à condição de correspondência.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B457	O ID da solicitação.

Exemplos

Exemplos de solicitação

http(s)://[Endpoint]/?Action=ModifyCenRouteMap
&CenId=cen-7qthudw0ll6jmc****
&CenRegionId=cn-hangzhou
&MapResult=Permit
&Priority=10
&RouteMapId=cenrmap-abcdedfghij****
&<Common request parameters>

Exemplo de resposta bem-sucedida

Formato XML

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

<ModifyCenRouteMapResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B457	</RequestId>
</ModifyCenRouteMapResponse>

Formato JSON

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B457\t"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidOperation.NoEffictiveAction	No effective action be configured.	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.