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

Modifica uma política de roteamento chamando a operação ModifyCenRouteMap.

Descrição da operação

A operação ModifyCenRouteMap é assíncrona. Após o envio da solicitação, o sistema retorna um RequestId, mas a política de roteamento ainda não foi modificada. A tarefa de modificação é executada em segundo plano. Você pode chamar a operação DescribeCenRouteMaps para consultar o status da política de roteamento.

Se a política de roteamento estiver no estado Modifying, ela está sendo modificada. Nesse estado, apenas operações de consulta podem ser realizadas.
Se a política de roteamento estiver no estado Active, ela já foi modificada.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cen:ModifyCenRouteMap

update

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CenId	string	Sim	O ID da instância do Cloud Enterprise Network (CEN).	cen-7qthudw0ll6jmc****
CenRegionId	string	Sim	O ID da região onde a política de roteamento é aplicada. Você pode chamar a operação DescribeChildInstanceRegions para consultar os IDs das regiões.	cn-hangzhou
RouteMapId	string	Sim	O ID da política de roteamento.	cenrmap-abcdedfghij****
Description	string	Não	A descrição da política de roteamento. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	desctest
MapResult	string	Sim	A ação a ser executada em uma rota que corresponda a todas as condições de correspondência. Valores válidos: Permit: A rota tem permissão para passar. Deny: A rota é impedida de passar. Valores válidos: Permit : Permit. Deny : Deny.	Permit
NextPriority	integer	Não	Prioridade da política da próxima política de roteamento associada. Você pode definir a prioridade da política da próxima política de roteamento associada somente quando MapResult estiver definido como Permit. Apenas as rotas com permissão para passar continuam a corresponder à próxima política de roteamento associada. A próxima política de roteamento associada deve ter a mesma região e direção da política de roteamento atual. A prioridade da política da próxima política de roteamento associada deve ser inferior (um número maior) à prioridade da política da política de roteamento atual.	20
CidrMatchMode	string	Não	O modo de correspondência da lista de prefixos. Valores válidos: Include: correspondência aproximada. A correspondência será bem-sucedida se o prefixo de rota na condição de correspondência contiver o prefixo de rota da rota a ser correspondida. Por exemplo, uma política que define 10.10.0.0/16 pode corresponder aproximadamente à rota 10.10.1.0/24. Complete: correspondência exata. A correspondência será bem-sucedida apenas se o prefixo de rota na condição de correspondência for igual ao prefixo de rota da rota a ser correspondida. Por exemplo, uma política que define 10.10.0.0/16 pode corresponder exatamente apenas à rota 10.10.0.0/16. Valores válidos: Complete : correspondência exata. Include : correspondência aproximada.	Include
AsPathMatchMode	string	Não	O modo de correspondência da lista de caminhos AS. Valores válidos: Include: correspondência aproximada. A correspondência será bem-sucedida se o caminho AS na condição de correspondência se sobrepor ao caminho AS da rota a ser correspondida. Complete: correspondência exata. A correspondência será bem-sucedida apenas se o caminho AS na condição de correspondência for igual ao caminho AS da rota a ser correspondida. Valores válidos: Complete : correspondência exata. Include : correspondência aproximada.	Include
CommunityMatchMode	string	Não	O modo de correspondência da Community. Valores válidos: Include: correspondência aproximada. A correspondência será bem-sucedida se a Community na condição de correspondência se sobrepor à Community da rota a ser correspondida. Complete: correspondência exata. A correspondência será bem-sucedida apenas se a Community na condição de correspondência for igual à Community da rota a ser correspondida. Contain: correspondência de contenção. A correspondência será bem-sucedida apenas se a Community da rota a ser correspondida contiver todas as Communities especificadas na condição de correspondência. Valores válidos: Complete : correspondência exata. Include : correspondência aproximada. Contain : correspondência de contenção.	Include
CommunityOperateMode	string	Não	A ação a ser 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 em uma rota após a rota corresponder às condições de correspondência. Valores válidos: Replace : Replace. Additive : Additive.	Additive
Preference	integer	Não	A prioridade da rota a ser modificada. Valores válidos: 1 a 100. A prioridade padrão de uma rota é 50. Um valor menor indica uma prioridade mais alta. Este parâmetro especifica a ação a ser executada em uma rota após a rota corresponder às condições de correspondência.	22
Priority	integer	Sim	Prioridade da política de roteamento. Valores válidos: 1 a 100. Um valor menor indica uma prioridade mais alta. Nota A prioridade da política das políticas de roteamento na mesma região e com a mesma direção deve ser única. Quando o sistema executa políticas de roteamento, ele começa a corresponder às instruções condicionais a partir da política de roteamento com o menor número de prioridade. Especifique a prioridade da política com base na ordem de correspondência esperada.	10
SourceInstanceIdsReverseMatch	boolean	Não	Especifica se deve usar o modo de correspondência reversa para a lista de IDs de instância de origem. Valores válidos: false (padrão): Não. A correspondência será bem-sucedida se o ID da instância de origem da rota estiver em SourceInstanceIds.N. true: Sim. A correspondência será bem-sucedida se o ID da instância de origem da rota não estiver em SourceInstanceIds.N.	false
DestinationInstanceIdsReverseMatch	boolean	Não	Especifica se deve usar o modo de correspondência reversa para a lista de IDs de instância de destino. Valores válidos: false (padrão): Não. A correspondência será bem-sucedida se o ID da instância de destino da rota estiver em DestinationInstanceIds.N. true: Sim. A correspondência será bem-sucedida se o ID da instância de destino da rota não estiver em DestinationInstanceIds.N.	false
MatchAddressType	string	Não	O tipo de endereço IP ao qual a rota deve corresponder. Valores válidos: IPv4: corresponde apenas a rotas IPv4. IPv6: corresponde apenas a rotas IPv6. Este parâmetro pode ser deixado vazio, o que indica que todos os tipos de rotas são correspondidos.	IPv4
SourceInstanceIds	array	Não	A lista de IDs de instância de origem aos quais a rota deve corresponder. Os seguintes tipos de IDs de instância são suportados: ID de instância de Virtual Private Cloud (VPC) ID de instância de Virtual Border Router (VBR) ID de instância de Cloud Connect Network (CCN) ID de instância de Smart Access Gateway ID de conexão IPsec Podem ser especificados no máximo 64 IDs de instância.	vpc-afsfdf5435vcvc****
	string	Não	A lista de IDs de instância de origem aos quais a rota deve corresponder. Os seguintes tipos de IDs de instância são suportados: ID de instância de Virtual Private Cloud (VPC) ID de instância de Virtual Border Router (VBR) ID de instância de Cloud Connect Network (CCN) ID de instância de Smart Access Gateway ID de conexão IPsec Podem ser especificados no máximo 64 IDs de instância.	vpc-afsfdf5435vcvc****
DestinationInstanceIds	array	Não	A lista de IDs de instância de destino aos quais a rota deve corresponder. Os seguintes tipos de IDs de instância são suportados: ID de instância de Virtual Private Cloud (VPC) ID de instância de Virtual Border Router (VBR) ID de instância de Cloud Connect Network (CCN) ID de instância de Smart Access Gateway ID de conexão IPsec Podem ser especificados no máximo 64 IDs de instância. Nota A lista de IDs de instância de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os IDs de instância de destino estão na região local.	vpc-avcdsg34ds****
	string	Não	A lista de IDs de instância de destino aos quais a rota deve corresponder. Os seguintes tipos de IDs de instância são suportados: ID de instância de Virtual Private Cloud (VPC) ID de instância de Virtual Border Router (VBR) ID de instância de Cloud Connect Network (CCN) ID de instância de Smart Access Gateway ID de conexão IPsec Podem ser especificados no máximo 64 IDs de instância. Nota A lista de IDs de instância de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os IDs de instância de destino estão na região local.	vpc-avcdsg34ds****
SourceRouteTableIds	array	Não	A lista de IDs de tabela de rotas de origem aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de tabela de rotas.	vtb-acdbvtbr342cd****
	string	Não	A lista de IDs de tabela de rotas de origem aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de tabela de rotas.	vtb-acdbvtbr342cd****
DestinationRouteTableIds	array	Não	A lista de IDs de tabela de rotas de destino aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de tabela de rotas. Nota A lista de IDs de tabela de rotas de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os IDs de tabela de rotas de destino são IDs de tabela de rotas de instâncias de rede na região local.	vtb-adfg53c322v****
	string	Não	A lista de IDs de tabela de rotas de destino aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de tabela de rotas. Nota A lista de IDs de tabela de rotas de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os IDs de tabela de rotas de destino são IDs de tabela de rotas de instâncias de rede na região local.	vtb-adfg53c322v****
SourceRegionIds	array	Não	A lista de IDs de região de origem aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de região. Você pode chamar a operação DescribeChildInstanceRegions para consultar os IDs das regiões.	cn-beijing
	string	Não	A lista de IDs de região de origem aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de região. Você pode chamar a operação DescribeChildInstanceRegions para consultar os IDs das regiões.	cn-beijing
SourceChildInstanceTypes	array	Não	A lista de tipos de instância de origem aos quais a rota deve corresponder. Os seguintes tipos de instância são suportados: VPC: instância VPC. VBR: instância de border router. CCN: instância CCN. VPN: instância de gateway VPN ou conexão IPsec. Se a conexão IPsec ou servidor SSL estiver anexado a uma instância de gateway VPN, a VPC associada à instância de gateway VPN deve estar conectada a uma instância de transit router, e a instância de gateway VPN deve executar o protocolo de roteamento dinâmico BGP para que este parâmetro entre em vigor. Se a conexão IPsec estiver anexada diretamente a uma instância de transit router, este parâmetro entrará em vigor.	VPC
	string	Não	A lista de tipos de instância de origem aos quais a rota deve corresponder. Os seguintes tipos de instância são suportados: VPC: instância VPC. VBR: instância de border router. CCN: instância CCN. VPN: instância de gateway VPN ou conexão IPsec. Se a conexão IPsec ou servidor SSL estiver anexado a uma instância de gateway VPN, a VPC associada à instância de gateway VPN deve estar conectada a uma instância de transit router, e a instância de gateway VPN deve executar o protocolo de roteamento dinâmico BGP para que este parâmetro entre em vigor. Se a conexão IPsec estiver anexada diretamente a uma instância de transit router, este parâmetro entrará em vigor.	VPC
DestinationChildInstanceTypes	array	Não	A lista de tipos de instância de destino aos quais a rota deve corresponder. Os seguintes tipos de instância são suportados: VPC: instância VPC. VBR: instância VBR. CCN: instância CCN. VPN: conexão IPsec. Nota Se a conexão IPsec ou servidor SSL estiver vinculado a uma instância de gateway VPN e conectado a uma instância de transit router por meio da VPC associada à instância de gateway VPN, este parâmetro não entrará em vigor. Este parâmetro entra em vigor apenas quando a conexão IPsec está vinculada diretamente a uma instância de transit router. A lista de tipos de instância de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os tipos de instância de destino são tipos de instância na região local.	VPC
	string	Não	A lista de tipos de instância de destino aos quais a rota deve corresponder. Os seguintes tipos de instância são suportados: VPC: instância VPC. VBR: instância VBR. CCN: instância CCN. VPN: conexão IPsec. Nota Se a conexão IPsec ou servidor SSL estiver vinculado a uma instância de gateway VPN e conectado a uma instância de transit router por meio da VPC associada à instância de gateway VPN, este parâmetro não entrará em vigor. Este parâmetro entra em vigor apenas quando a conexão IPsec está vinculada diretamente a uma instância de transit router. A lista de tipos de instância de destino entra em vigor apenas quando a direção da política de roteamento é Export from Regional Gateway e os tipos de instância de destino são tipos de instância na região local.	VPC
DestinationCidrBlocks	array	Não	A lista de prefixos à qual a rota deve corresponder. Os intervalos de endereços IP na lista de prefixos estão no formato CIDR. Podem ser especificados no máximo 64 intervalos de endereços IP.	10.10.10.0/24
	string	Não	A lista de prefixos à qual a rota deve corresponder. Os intervalos de endereços IP na lista de prefixos estão no formato CIDR. Podem ser especificados no máximo 64 intervalos de endereços IP.	10.10.10.0/24
RouteTypes	array	Não	A lista de tipos de roteamento aos quais a rota deve corresponder. Os seguintes tipos de roteamento são suportados: System: rotas de sistema geradas automaticamente pelo sistema. Custom: rotas personalizadas adicionadas manualmente pelos usuários. BGP: rotas BGP propagadas por meio do protocolo de roteamento BGP.	System
	string	Não	A lista de tipos de roteamento aos quais a rota deve corresponder. Os seguintes tipos de roteamento são suportados: System: rotas de sistema geradas automaticamente pelo sistema. Custom: rotas personalizadas adicionadas manualmente pelos usuários. BGP: rotas BGP propagadas por meio do protocolo de roteamento BGP.	System
MatchAsns	array	Não	A lista de caminhos AS à qual a rota deve corresponder. Nota Apenas AS SEQUENCE é suportado. AS SET, AS CONFED SEQUENCE e AS CONFED SET não são suportados. Especificamente, apenas listas de números AS são suportadas. Conjuntos e sublistas não são suportados.	65501
	integer	Não	A lista de caminhos AS à qual a rota deve corresponder. Nota Apenas AS SEQUENCE é suportado. AS SET, AS CONFED SEQUENCE e AS CONFED SET não são suportados. Especificamente, apenas listas de números AS são suportadas. Conjuntos e sublistas não são suportados.	65501
MatchCommunitySet	array	Não	O conjunto de Community ao qual a rota deve corresponder. Cada Community está no formato n:m, onde os intervalos de valores de n e m são de 1 a 65535. As Communities devem estar em conformidade com a RFC 1997. Large Communities (RFC 8092) não são suportadas. Podem ser especificadas no máximo 64 Communities. Nota Configurações incorretas de Community podem fazer com que as rotas não sejam anunciadas para data centers on-premises.	65501:1
	string	Não	O conjunto de Community ao qual a rota deve corresponder. Cada Community está no formato n:m, onde os intervalos de valores de n e m são de 1 a 65535. As Communities devem estar em conformidade com a RFC 1997. Large Communities (RFC 8092) não são suportadas. Podem ser especificadas no máximo 64 Communities. Nota Configurações incorretas de Community podem fazer com que as rotas não sejam anunciadas para data centers on-premises.	65501:1
OperateCommunitySet	array	Não	O conjunto de Community a ser executado. Cada Community está no formato n:m, onde os intervalos de valores de n e m são de 1 a 65535. As Communities devem estar em conformidade com a RFC 1997. Large Communities (RFC 8092) não são suportadas. Podem ser especificadas no máximo 32 Communities. Nota Configurações incorretas de Community podem fazer com que as rotas não sejam anunciadas para data centers on-premises.	65501:1
	string	Não	O conjunto de Community a ser executado. Cada Community está no formato n:m, onde os intervalos de valores de n e m são de 1 a 65535. As Communities devem estar em conformidade com a RFC 1997. Large Communities (RFC 8092) não são suportadas. Podem ser especificadas no máximo 32 Communities. Nota Configurações incorretas de Community podem fazer com que as rotas não sejam anunciadas para data centers on-premises.	65501:1
PrependAsPath	array	Não	O caminho AS que é prependido quando o gateway regional recebe ou publica entradas de rota. Os requisitos para configurar o caminho AS prependido variam de acordo com a direção da política de roteamento: Ao configurar o caminho AS prependido para a direção Import to Regional Gateway, você deve configurar a lista de IDs de instância de origem e a região de origem nas condições de correspondência, e a região de origem deve ser a mesma região onde a política de roteamento é aplicada. Ao configurar o caminho AS prependido para a direção Export from Regional Gateway, você deve configurar a lista de IDs de instância de destino nas condições de correspondência. Este parâmetro especifica a ação a ser executada em uma rota após a rota corresponder às condições de correspondência.	65501
	integer	Não	O caminho AS que é prependido quando o gateway regional recebe ou publica entradas de rota. Os requisitos para configurar o caminho AS prependido variam de acordo com a direção da política de roteamento: Ao configurar o caminho AS prependido para a direção Import to Regional Gateway, você deve configurar a lista de IDs de instância de origem e a região de origem nas condições de correspondência, e a região de origem deve ser a mesma região onde a política de roteamento é aplicada. Ao configurar o caminho AS prependido para a direção Export from Regional Gateway, você deve configurar a lista de IDs de instância de destino nas condições de correspondência. Este parâmetro especifica a ação a ser executada em uma rota após a rota corresponder às condições de correspondência.	65501
DestinationRegionIds	array	Não	A lista de IDs de região de destino aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de região.
	string	Não	A lista de IDs de região de destino aos quais a rota deve corresponder. Podem ser especificados no máximo 64 IDs de região.	cn-beijing

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	54B48E3D-DF70-471B-AA93-08E683A1B457

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidOperation.NoEffictiveAction	No effective action be configured.	Nenhuma Action válida existe.
400	InvalidOperation.CenRouteMapExist	Operation is invalid because an route map config exist.	Existe um mapa de rotas. A operação atual não é suportada.
400	Invid.Parameter	When using GatewayRegionId, SourceRegionId must not be null	GatewayRegionId e SourceRegionId não podem estar na mesma região.
400	InvalidName	Name is invalid.	O nome é inválido.
400	InvalidDescription	Description is invalid.	A descrição é inválida.
400	InvalidParam.DestinationInstanceIds	When using "PrependAsPath" in the "RegionOut", "DestinationInstanceIds" must be local region instances.	Quando a opção PrependAsPath é usada na configuração RegionOut, as instâncias de destino DestinationInstanceIds devem estar na região local.
400	Forbidden.NoMedAuthorized	Med operation is unauthorized.	A política de rota Med especificada não pode ser operada.
400	InvalidOperation.MedRouteMapExist	Operation is invalid because the default med route map already exist.	A operação é inválida porque já existe um mapa de rotas MED com o próximo salto apontando para esta instância ECR.
400	InvalidOperation.MedRouteMapNotAllowedOtherAction	Operation is invalid because the default med not allowed other action.	Um mapa de rotas configurado com uma política MED não permite que outras políticas sejam configuradas.
400	InvalidOperation.MedRouteMapActionMustPermit	Operation is invalid because the default med map result must be permit.	A operação é inválida. A ação de política do mapa de rotas MED deve ser Allow.
400	InvalidParameter.MedRouteMapDestInstanceIds	Param DestInstanceIds must be ecr instance id.	A lista de instâncias de destino do mapa de rotas MED deve conter instâncias ECR.
400	InvalidParameter.MedRouteMapDestInstanceType	Param DestChildInstanceTypes must be ecr.	O tipo de instância de destino do mapa de rotas MED deve ser ECR.
400	InvalidOperation.PrependAsPathWithInvalidSourceRegionId	When using PrependAsPath in the RegionIn direction, SourceRegionId must be local region ID.	Ao configurar o prepending de AS Path na direção de entrada do gateway da região, o ID da região de origem deve ser o ID da região local.
400	InvalidOperation.PrependAsPathWithInvalidSourceInstanceIds	When using PrependAsPath in the RegionIn direction, SourceInstanceIds must be local instance ids.	Ao configurar o prepending de AS Path na direção de entrada do gateway da região, o ID da instância de origem deve ser uma instância da região local.
400	InvalidOperation.TransitRouterNotExist	Operation is invalid because the transit router not exist.	O roteador de trânsito não existe.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.
400	InvalidParameter.RouteMapId	The specified parameter RouteMapId is invalid.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.