CreateHighReliablePhysicalConnection - Express Connect: Central de Documentação do Alibaba Cloud

Cria circuitos do Express Connect em modo de redundância de zona para garantir a estabilidade do acesso multilinha às suas cargas de trabalho no Alibaba Cloud e evitar interrupções de serviço causadas por falhas de linha única por meio de recuperação de desastres multilinha.

Descrição da operação

Ao adquirir portas, você pode selecionar um dos três tipos de combinação a seguir para fornecer recursos de recuperação de desastres para suas cargas de trabalho.\n- Recuperação máxima de desastres: você solicita recursos em dois pontos de acesso e estabelece quatro conexões independentes de circuitos do Express Connect. A disponibilidade de SLA para recuperação máxima de desastres não é inferior a 99,99%.

Recuperação aprimorada de desastres: você solicita recursos em dois pontos de acesso e estabelece duas conexões independentes de circuitos do Express Connect. A disponibilidade de SLA para recuperação aprimorada de desastres não é inferior a 99,95%.
Desenvolvimento e testes: você solicita recursos em um ponto de acesso e estabelece duas conexões independentes de circuitos do Express Connect.

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

vpc:CreateHighReliablePhysicalConnection

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região do circuito do Express Connect. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-shanghai
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor de parâmetro a partir do seu cliente, garantindo que o valor seja único entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o identificador ClientToken. O RequestId é diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o circuito do Express Connect pertence.	rg-acfmxazb4p****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e deve começar com uma letra ou caractere chinês. Pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e deve começar com uma letra ou caractere chinês. Pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua
HighReliableType	string	Sim	O modo de redundância de zona. Valores válidos: MultiApMultiDevice: recuperação máxima de desastres. Este modo oferece suporte a dois pontos de acesso diferentes e dois dispositivos diferentes, fornecendo recuperação máxima de desastres. MultiApSingleDevice: recuperação aprimorada de desastres. Este modo oferece suporte a dois pontos de acesso diferentes e um dispositivo, fornecendo recuperação aprimorada de desastres. SingleApMultiDevice: desenvolvimento e testes. Este modo oferece suporte a um ponto de acesso e dois dispositivos. Este modo é recomendado apenas para desenvolvimento e testes de cargas de trabalho não críticas. SingleApMultiConnection: balanceamento de carga de alta largura de banda. Este modo está disponível apenas para usuários na lista de permissões. Ele oferece suporte a um ponto de acesso, um dispositivo e várias portas físicas. Para usar este modo, entre em contato com o gerente da sua conta.	MultiApMultiDevice
PortType	string	Sim	O tipo de porta do circuito do Express Connect. Valores válidos: 1000Base-LX: porta óptica monomodo GE (10 km). 10GBase-LR: porta óptica monomodo 10 GE (10 km). 40GBase-LR: porta óptica monomodo 40 GE. 100GBase-LR: porta óptica monomodo 100 GE. Nota 40GBase-LR e 100GBase-LR estão sujeitos à disponibilidade real da porta. Para obter informações sobre a disponibilidade da porta, entre em contato com o gerente da sua conta.	1000Base-LX
DeviceAdvancedCapacity	array	Não	A lista de capacidades avançadas do dispositivo.
	string	Não	A capacidade avançada do dispositivo. Valores válidos: SubifRateLimit: limitação de taxa de VBR. DualStack: suporte a IPv6. BFD: Bidirectional Forwarding Detection. CEN: suporte a BGP multiprotocolo. CENv6: suporte a BGPv6 multiprotocolo. QOS: suporte a QoS. MS-HA: suporte a grupo de failover rápido. Multi-MS-HA: suporte a múltiplos grupos de failover.	SubifRateLimit
ApList	array<object>	Sim	A lista de pontos de acesso.
	object	Não	A lista de pontos de acesso.
Name	string	Não	O nome do circuito do Express Connect. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou caractere chinês. Pode conter dígitos, sublinhados (_) e hifens (-), mas não pode começar com `http://` ou `https://`.	test
Description	string	Não	A descrição do circuito do Express Connect. A descrição deve ter de 2 a 256 caracteres e deve começar com uma letra ou caractere chinês, mas não pode começar com `http://` ou `https://`.	description
RegionId	string	Sim	O ID da região do circuito do Express Connect. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-shanghai
LineOperator	string	Sim	O provedor de conectividade do circuito do Express Connect. Valores válidos: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: outras operadoras chinesas. Equinix: Equinix. Other: outras operadoras fora da China continental.	CT
AccessPointId	string	Sim	O ID do ponto de acesso para o circuito do Express Connect. Nota Quando HighReliableType está definido como MultiApMultiDevice ou MultiApSingleDevice, você deve especificar dois pontos de acesso diferentes. Quando HighReliableType está definido como SingleApMultiDevice ou SingleApMultiConnection, você deve especificar um ponto de acesso.	ap-cn-beijing-ft-A
PortNum	integer	Não	O número de portas. Este parâmetro é obrigatório apenas quando HighReliableType está definido como SingleApMultiConnection. Valores válidos: 2 a 16.	2
Type	string	Não	O tipo do circuito do Express Connect. Valor padrão: VPC.	VPC
Bandwidth	integer	Não	A largura de banda dos circuitos compartilhados do Express Connect. Unidade: Mbit/s. Valores válidos: 50, 100, 200, 300, 400, 500, 1000, 2000, 4000, 5000, 8000 e 10000.	50
PeerLocation	string	Não	A localização geográfica do data center local.	XX街道
CircuitCode	string	Não	O código do circuito fornecido pelo provedor de conectividade para o circuito do Express Connect.	longtel001
OpticalModuleModel	string	Não	O modelo do módulo óptico suportado pelo ponto de acesso do circuito do Express Connect. Valores válidos: 1000Base-LX: `SFP-GE-LR-SM1310,10KM` `SFP-GE-ER-SM1310,40KM` `SFP-GE-ZR-SM1550,80KM` 10GBase-LR: `SFP-10G-LR-SM1310,10KM` `SFP-10G-ER-SM1550,40KM` `SFP-10G-ZR-SM1550,80KM` 40GBase-LR: `QSFP-40G-LR4-WDM1300,10KM` `QSFP-40G-ER4-WDM1300,40KM` `QSFP-40G-ZR4-WDM1300,80KM` 100GBase-LR: `QSFP28-100G-LR4-WDM1300,10KM` `QSFP28-100G-ER4-WDM1300,40KM` `QSFP28-100G-ZR4-WDM1300,80KM`.	SFP-GE-LR-SM1310,10KM
DryRun	string	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run sem criar a instância. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e o status da instância. Se a verificação falhar, o código de erro `DRYRUN.FAIL` será retornado junto com a lista de erros correspondente. Se a verificação for bem-sucedida, o código `DRYRUN.SUCCESS` será retornado. false (padrão): envia a solicitação. Após a solicitação passar na verificação, a instância é criada.	false
AcceptLanguage	string	Não	O idioma da resposta. Valores válidos: zh-CN (padrão): chinês. en-US: inglês.	zh-CN

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
PhysicalConnectionList	object
physicalConnectionList	array<object>	A lista de instâncias de circuitos do Express Connect.
	object	A lista de instâncias de circuitos do Express Connect.
InstanceId	string	The instance ID of the Express Connect circuit.	pc-j5e5qqo616p81ncsp****
RegionNo	string	The region ID of the Express Connect circuit instance.	cn-shanghai
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
ErrorInfoList	object
errorInfoList	array<object>	Os códigos de erro e mensagens de erro retornados quando o dry run falha. Todas as informações de erro são retornadas, incluindo: `pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing`: o faturamento de transferência de dados de saída não está ativado para o usuário. `pconn.high.reliable.dryrun.error.incompatable.device.capacity`: nenhum dispositivo no ponto de acesso selecionado atende aos requisitos de capacidade avançada do dispositivo. `pconn.high.reliable.dryrun.error.quota.exceeded`: a cota do usuário é insuficiente. `pconn.high.reliable.dryrun.error.not.enough.resource`: os recursos do ponto de acesso são insuficientes.
	object	O código de erro.
ErrorCode	string	The error code.	pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
ErrorMessage	string	The error message.	pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
InstanceId	string	The instance ID of the Express Connect circuit.	pc-j5e5qqo616p81ncsp****

Exemplos

Resposta de sucesso

JSON formato

{
  "PhysicalConnectionList": {
    "physicalConnectionList": [
      {
        "InstanceId": "pc-j5e5qqo616p81ncsp****",
        "RegionNo": "cn-shanghai"
      }
    ]
  },
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "ErrorInfoList": {
    "errorInfoList": [
      {
        "ErrorCode": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "ErrorMessage": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "InstanceId": "pc-j5e5qqo616p81ncsp****"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.Status	The device or interface status invalid, or has been used..	The Status parameter is set to an invalid value.
400	InvalidType.Malformd	The Type provided was invalid.
400	InvalidPeerLocation.Malformd	The PeerLocation provided was invalid.
400	InvalidLineOperator.Malformd	The LineOperator provided was invalid.
400	InvalidPortType.Malformd	The PortType provided was invalid.
400	InvalidDescription.Malformed	The specifid ?Description? is not valid.	The error message returned because the specified resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400	InvalidRedundantPhysicalConnectionId.NotFound	The RedundantPhysicalConnectionId does not found.
400	InvalidName.Malformed	The specified ?Name? is not valid.
400	QuotaExceeded.pConnPerAP	Physical connection count per ap quota exceed.
400	InvalidBandwidth	invalid physical connection banwidth.
400	InvalidRedundantPhysicalConnection	redundant physical connection doesn't belong to current user.
400	InvalidRedundantPhysicalConnectionStatus	invalid redundant physical connection status.
400	InvalidCircuitCode.Malformed	circuitCode is illegal.
400	QuotaExceeded.freePconnPerAP	free physical connections count excceeded.
400	InvalidPhysicalConnectionOperator.Malformed	Specified PhysicalConnection Operator is not valid.	The operation on the Express Connect circuit is invalid.
400	InvalidPhysicalConnectionPortType.Malformed	Specified PhysicalConnection PortType is not valid.	The port type of the Express Connect circuit is invalid.
400	InvalidPhysicalConnectionBandwidth.Malformed	Specified PhysicalConnection Bandwidth is not valid.	The bandwidth of the Express Connect circuit is set to an invalid value.
400	IllegalParam.ClientToken	Token verify failed because client token length too long.	The ClientToken parameter is set to an invalid value.
400	InvalidPortType.NotFound	Specified port type is not found.	The portType parameter is not set.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	Billing for outbound data transfer is disabled.
400	EcNotSupportRegion	High reliable physical connection is not support in this region.	Highly reliable physical lines are temporarily not supported for sale in the local region.
400	EcFailToGetAp	Fail to get access point details.	Unable to query the corresponding access point information.
400	EcNotEnoughResource	Insufficient access point resources.	Insufficient Access Point Resources
400	IllegalParam.UnsupportedAccessPoint	The access point type does not support the creation of a highly reliable physical connection.	You cannot create a high-availability Express Connect circuit for an access point of this type.
400	ResourceNotFound.AccessPointId	The specified resource of access point id is not found.	The current access point information does not exist. Please check and try again.
400	IllegalParam.%s	The param of %s is illegal.	The parameter is invalid.
404	InvalidPortType.NotFound	There are no resources with the portType.	The specified port type is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.