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

Observações de uso

Não chame a operação CreateVpcPrefixList repetidamente para criar uma lista de prefixos em uma região dentro do período especificado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateVpcPrefixList	Operação a ser executada. Defina o valor como CreateVpcPrefixList.
PrefixListName	String	Não	name	Nome da lista de prefixos. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.
PrefixListDescription	String	Não	description	Descrição da lista de prefixos. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente, mas garanta que ele seja exclusivo entre solicitações diferentes. O token aceita apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como token de cliente. O ID da solicitação pode variar a cada chamada.
DryRun	Boolean	Não	false	Define se o sistema deve executar apenas uma simulação, sem enviar a solicitação real. Valores válidos: true: execute a simulação. O sistema verifica possíveis problemas na solicitação, como valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a verificação falhar, o sistema retorna uma mensagem de erro. Se for bem-sucedida, retorna o código de erro `DryRunOperation`. false (padrão): execute a simulação e envia a solicitação. Se a simulação for bem-sucedida, o sistema retorna um código de status HTTP 2xx e executa a operação.
MaxEntries	Integer	Não	50	Número máximo de blocos CIDR permitidos na lista de prefixos. Valor padrão: 50.
PrefixListEntries.N.Cidr	String	Não	192.168.0.0/16	Bloco CIDR especificado na lista de prefixos.
PrefixListEntries.N.Description	String	Não	CIDR	Descrição do bloco CIDR especificado na lista de prefixos. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.
ResourceGroupId	String	Não	rg-bp67acfmxazb4ph****	ID do grupo de recursos ao qual a lista de prefixos pertence.
RegionId	String	Sim	cn-hangzhou	ID da região onde criar a lista de prefixos. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
IpVersion	String	Não	IPv4	Versão do IP. Valores válidos: IPv4 (padrão) IPv6
Tag.N.Key	String	Não	FinanceDept	Chave da tag N a adicionar ao recurso. Limite de 20 chaves. A chave não pode ser uma string vazia. A chave da tag aceita até 128 caracteres. Não pode começar com `aliyun` ou `acs:`, nem conter `http://` ou `https://`.
Tag.N.Value	String	Não	FinanceJoshua	Valor da tag N a adicionar ao recurso. Limite de 20 valores. O valor pode ser uma string vazia. O valor da tag aceita até 128 caracteres. Não pode começar com `acs:` ou `aliyun`, nem conter `http://` ou `https://`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PrefixListId	String	pl-0b700s2ee3***	ID da lista de prefixos.
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	ID da solicitação.
ResourceGroupId	String	rg-bp67acfmxazb4ph****	ID do grupo de recursos ao qual a lista de prefixos pertence.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateVpcPrefixList
&PrefixListName=name
&PrefixListDescription=description
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&DryRun=false
&MaxEntries=50
&PrefixListEntries=[{"Cidr":"192.168.0.0/16","Description":"CIDR"}]
&ResourceGroupId=rg-bp67acfmxazb4ph****
&RegionId=cn-hangzhou
&IpVersion=IPv4
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateVpcPrefixListResponse>
    <PrefixListId>pl-0b700s2ee3***</PrefixListId>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <ResourceGroupId>rg-bp67acfmxazb4ph****</ResourceGroupId>
</CreateVpcPrefixListResponse>

Formato JSON

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

{
  "PrefixListId" : "pl-0b700s2ee3***",
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ResourceGroupId" : "rg-bp67acfmxazb4ph****"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	O parâmetro ipVersion foi definido com um valor inválido.
400	QuotaExceeded.PrefixListCidrCount	The quota of prefixListMaxEntry count is exceeded.	O valor do parâmetro entryCount excede o limite superior.
400	OperationFailed.CidrCountExceedMaxCount	The operation is failed because of cidrCountExceedMaxCount.	O número de blocos CIDR especificados excede o limite superior definido pelo parâmetro cidrMaxCount.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.	O parâmetro cidrBlock foi definido com um valor inválido.
400	IllegalParam.CidrName	The param of cidrName is illegal.	O parâmetro cidrName foi definido com um valor inválido.
400	DuplicatedParam.CidrBlock	The param of cidrBlock is duplicated.	Um bloco CIDR duplicado foi especificado.
400	QuotaExceeded.PrefixListCount	The quota of prefixList count is exceeded.	O valor do parâmetro prefixList excede o limite superior.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.