CreateIpamResourceDiscovery - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Cria uma instância de descoberta de recursos de um tipo personalizado.

Descrição da operação

Cada conta do Alibaba Cloud pode ter apenas uma instância de descoberta de recursos em cada região.
Esta operação cria apenas instâncias de descoberta de recursos de um tipo personalizado.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	A região da solicitação. Nota A região da solicitação é a região hospedeira da instância de descoberta de recursos.	cn-hangzhou
IpamResourceDiscoveryName	string	Não	O nome da descoberta de recursos.	name
IpamResourceDiscoveryDescription	string	Não	A descrição da descoberta de recursos.	description
OperatingRegionList	array	Sim	A lista de regiões nas quais a descoberta de recursos é efetiva.
	string	Não	A região na qual a descoberta de recursos é efetiva. Nota A região da solicitação deve ser incluída.	cn-hangzhou
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aek2sermdd6****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: Envia uma solicitação de verificação sem criar a instância de descoberta de recursos. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a verificação falhar, um erro será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false (padrão): Envia uma solicitação normal. Após a solicitação passar na verificação, um código de status HTTP 2xx é retornado e a instância de descoberta de recursos é criada.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor de parâmetro exclusivo a partir do seu cliente. O token de cliente 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 é diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
Tag	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag. 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. Deve começar com uma letra ou um caractere chinês. Pode conter dígitos, pontos (.), underscores (_) 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. 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. Não pode conter `http://` ou `https://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	BB2C39DE-CEB8-595A-981A-F2EFCBE7324E
IpamResourceDiscoveryId	string	O ID da instância de descoberta de recursos.	ipam-res-disco-jt5f2af2u6nk2z321****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E",
  "IpamResourceDiscoveryId": "ipam-res-disco-jt5f2af2u6nk2z321****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.OperatingRegion	The operating region is invalid.	The operating region is invalid.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	OperationDenied.OperatingRegionsNeedIncludeHomeRegion	The operating regions do not contain home region.	The operating regions do not contain home region.
400	QuotaExceeded.IpamResourceDiscoveryQuotaPerRegion	The number of non-shared IPAM resource discoveries owned by the user in this region exceeds the limit.	The number of non-shared IPAM resource discoveries owned by the user in this region exceeds the limit.
400	OperationDenied.UnexpectedType	The operation is not allowed because the input type is unexpected.	The operation is not allowed because the input type is unexpected.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.