Estrutura de dados para criação dos ECS
Notas
As API do ECS podem ser V1 ou V1.1. As API V1 só podem ser usadas para criar os ECS pagos por uso, enquanto as API V1.1 podem ser usadas para criar os ECS pagos por uso e anuais/mensais.
Para os campos descritos nesta seção, use as API V1.1 para os ECS anuais/mensais.
Conteúdo
- Descrição do Campo publicip
- descrição do campo security_groups
- Descrição do campo eip
- bandwidth descrição do campo
- Descrição do Campo ipv6_bandwidth
- Descrição do campo extendparam para atribuição dos EIP
- Descrição do Campo extendparam para Criação de Discos
- Descrição do Campo extendparam para Criação dos ECS
- Descrição do campo de metadata para criação de discos
- Descrição do campo de metadados para criação dos ECS
- Descrição do campo os:scheduler_hints
- descrição do campo server_tags
Descrição do Campo publicip
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id |
Não |
String |
Especifica a ID do EIP existente atribuído ao ECS a ser criado. O valor está no formato UUID. Somente os EIP no estado DOWN podem ser atribuídos. |
eip |
Não |
Object |
Especifica um EIP que será atribuído automaticamente a um ECS. Para mais detalhes, consulte Tabela 3. |
delete_on_termination |
Não |
Boolean |
Especifica se o EIP é liberado quando o ECS ao qual o EIP está vinculado é excluído.
O valor padrão é false.
NOTA:
Esse parâmetro está disponível apenas para os EIP de pagamento por uso. |
id ou eip no campo publicip podem ser configurados.
descrição do campo security_groups
Este campo é usado pelas seguintes API:
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id |
Não |
String |
Especifica o ID do grupo de segurança ao qual um ECS deve ser adicionado. A configuração terá efeito nas NIC do ECS. Você precisa especificar o ID de um grupo de segurança existente no formato UUID. Caso contrário, o grupo de segurança padrão será usado na camada subjacente. |
Descrição do campo eip
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
iptype |
Sim |
String |
Especifica o tipo de EIP. Para obter detalhes, consulte a descrição do campo publicip em Atribuição de um EIP. |
bandwidth |
Sim |
Object |
Especifica a largura de banda EIP. Para mais detalhes, consulte bandwidth descrição do campo. |
bandwidth descrição do campo
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
size |
Sim |
Integer |
Especifica o tamanho da largura de banda. Especifica a largura de banda (Mbit/s). O valor varia de 1 a 300. O intervalo específico pode variar dependendo da configuração em cada região. Você pode ver a faixa de largura de banda de cada região no console de gerenciamento.
O incremento mínimo para ajuste de largura de banda varia dependendo da faixa de largura de banda.
NOTA:
Este parâmetro é obrigatório quando sharetype é definido como PER e é opcional quando sharetype é definido como WHOLE com um ID especificado. |
sharetype |
Sim |
String |
Especifica o tipo de compartilhamento de largura de banda. Valores enumerados: PER (indica largura de banda exclusiva) e WHOLE (indica compartilhamento) |
chargemode |
Não |
String |
Especifica o modo de faturamento da largura de banda.
|
Descrição do Campo ipv6_bandwidth
- Criação dos ECS: /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id |
Não |
String |
Especifica a ID de uma largura de banda IPv6. |
Descrição do campo extendparam para atribuição dos EIP
Este campo é usado pela seguinte API:
Criando os ECS /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
chargingMode |
Não |
String |
Especifica o modo de faturamento de um EIP. Opções:
|
Descrição do Campo extendparam para Criação de Discos
Este campo é usado pelas seguintes API:
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
resourceSpecCode |
Não |
String |
Especifica o código das especificações do disco, como SATA, SAS ou SSD.
NOTA:
Este campo foi descartado. |
resourceType |
Não |
String |
Especifica o tipo de recurso.
NOTA:
Este campo foi descartado. |
snapshotId |
Não |
String |
Especifica o ID do instantâneo ou o ID do disco de dados original contido na imagem ECS completa. Cenários de Aplicação: Esse parâmetro é usado se um ECS for criado usando uma imagem ECS completa e a imagem contiver um ou mais discos de dados. Se você usar uma imagem ECS completa para criar um ECS, o sistema restaurará automaticamente o tipo de dados e os dados dos discos de dados na imagem. O parâmetro snapshotId permite especificar o tipo de disco para o disco de dados original após a restauração.
NOTA:
Regras de trabalho: O snapshotId identifica exclusivamente um disco de dados original contido em uma imagem ECS completa. Você pode usar snapshotId para obter as informações do disco de dados original para restauração de dados. Obtendo snapshotId por meio do console de gerenciamento: Faça login no console de gerenciamento, escolha Elastic Volume Service > Snapshot. Em seguida, use o nome do disco de dados original para localizar o ID do instantâneo ou o ID do disco original. Obtenção de snapshotId por meio da API:
Se você obteve o ID de imagem do ECS completo, obtenha o ID de backup do CBR (Cloud Backup and Recovery) ou do CSBS (Cloud Server Backup Service) associado ao ID de imagem do ECS completo seguindo as instruções fornecidas na API para consultar os detalhes da imagem.
|
Descrição do Campo extendparam para Criação dos ECS
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
chargingMode |
Não |
Integer |
Especifica o modo de cobrança.
|
regionID |
Não |
String |
Especifica a ID da região em que o ECS reside. Consulte Regiões e Endpoints. |
CB_CSBS_BACKUP |
Não |
String |
Especifica uma ID de política CSBS e uma ID de cofre CSBS. Por exemplo, um ID de política CSBS obtido no console é fdcaa27d-5be4-4f61-afe3-09ff79162c04. Um ID de cofre CSBS é 332a9408-463f-436a-9e92-78dad95d1ac4. O valor CB_CSBS_BACKUP é "{\"policy_id\":\"fdcaa27d-5be4-4f61-afe3-09ff79162c04\",\"vault_id\":\"332a9408-463f-436a-9e92-78dad95d1ac4\"}". |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
chargingMode |
Não |
String |
Especifica o modo de cobrança. Opções:
|
regionID |
Não |
String |
Especifica a ID da região onde o ECS reside. Consulte Regiões e Endpoints. |
periodType |
Não |
String |
Especifica o período de subscrição. Opções:
|
periodNum |
Não |
Integer |
Especifica o número de períodos de assinatura. Opções:
|
isAutoRenew |
Não |
String |
Especifica se a renovação automática está ativada.
|
isAutoPay |
Não |
String |
Especifica se o pedido é pago automática ou manualmente.
NOTA:
Este parâmetro é válido quando chargingMode está definido como prePaid. Se este parâmetro não for especificado, a ordem deve ser paga manualmente por padrão. |
support_auto_recovery |
Não |
Boolean |
Especifica se a recuperação automática do ECS deve ser ativada.
NOTA:
Este parâmetro é do tipo booleano. Se um caractere não-booleano for importado, o valor do parâmetro será definido como false. |
marketType |
Não |
String |
Especifica um ECS spot. Ao criar um ECS spot, defina o valor do parâmetro como spot.
NOTA:
Este parâmetro entra em vigor apenas quando chargingMode está definido para postPaid e marketType está definido para spot. |
spotPrice |
Não |
String |
Especifica o preço mais alto por hora aceito para um ECS spot.
NOTA:
|
Descrição do campo de metadata para criação de discos
Este campo é usado pelas seguintes API:
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
__system__encrypted |
Não |
String |
Especifica a criptografia em metadata. O valor pode ser 0 (criptografia desativada) ou 1 (criptografia ativada). Se este parâmetro não existir, o disco não será criptografado por padrão. |
__system__cmkid |
Não |
String |
Especifica o ID CMK, que indica criptografia nos metadata. Este parâmetro é usado com __system__encrypted.
NOTA:
Para obter detalhes sobre como obter o ID de CMK, consulte Consulta da lista dos CMK. |
Descrição do campo de metadados para criação dos ECS
Este campo é usado pelas seguintes API:
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
op_svc_userid |
Não |
String |
Especifica o ID do usuário.
NOTA:
Quando chargingMode no parâmetro extendparam está definido como prePaid (indicando que o ECS criado é faturado em pagamentos anuais/mensais) e o ECS estiver logado usando uma chave SSH, esse campo é obrigatório. |
agency_name |
Não |
String |
Especifica o nome da agência do IAM. Uma agência é criada por um administrador de locatários no Identity and Access Management (IAM) para fornecer credenciais temporárias para que os ECS acessem os serviços em nuvem. |
Descrição do campo os:scheduler_hints
- Criando os ECS /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
- Criação de ECSs (API nativa): /v2.1/{project_id}/servers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
group |
Não |
String |
Especifica uma ID de grupo ECS, que está no formato UUID. Obtenha o valor do parâmetro no console ou executando as operações fornecidas em Consulta de grupos de ECS.
NOTA:
Verifique se o grupo ECS usa a política de antiafinidade. Você não é aconselhado a usar outras políticas. |
tenancy |
Não |
String |
Cria os ECS em um host dedicado ou compartilhado. O valor deste parâmetro pode ser dedicated ou shared. |
dedicated_host_id |
Não |
String |
Especifica o ID do host dedicado.
NOTA:
Um ID de DeH entra em vigor somente quando o tenancy é definido como dedicated. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
group |
Array of strings |
Especifica uma ID de grupo de ECS, que está no formato UUID. Obtenha o valor do parâmetro no console ou executando as operações fornecidas em Consulta de grupos de ECS. |
tenancy |
Array of strings |
Cria os ECS em um host dedicado ou compartilhado. O valor deste parâmetro pode ser dedicated ou shared. |
dedicated_host_id |
Array of strings |
Especifica o ID do host dedicado.
NOTA:
Um ID de DeH entra em vigor somente quando o tenancy é definido como dedicated. |
descrição do campo server_tags
- Criação dos ECS: /v1/{project_id}/cloudservers
- Criação dos ECS: /v1.1/{project_id}/cloudservers
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
key |
Sim |
String |
Especifica a chave de marcação. A chave pode conter um máximo de 36 caracteres Unicode. Não pode ser deixado em branco ou conter ASCII (0-31) ou os seguintes caracteres: =*<>\,|/ A chave de tag de um ECS deve ser exclusiva. |
value |
Sim |
String |
Especifica o valor da tag. O valor pode conter um máximo de 43 caracteres Unicode e pode ser deixado em branco. Não pode conter ASCII (0-31) ou os seguintes caracteres: =*<>\,|/ |